@unbrained/pm-cli 2026.7.16 → 2026.7.17

package/dist/cli/commands/stats.js

@@ -1,163 +1,10 @@
 /**
  * @module cli/commands/stats
  *
- * Implements the pm stats command surface and its agent-facing runtime behavior.
+ * Compatibility export for SDK-owned tracker statistics.
  */
 
-!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]="f76ffd47-6478-5a3f-b18f-990a9332c774")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, } from "../../core/extensions/index.js";
-import { computeContentFieldUtilization, } from "../../core/governance/content-fields.js";
-import { computeMetadataCoverage, groupItemsByDimension, lifecycleClassifierFromStatusRegistry, } from "../../core/governance/metadata-coverage.js";
-import { pathExists } from "../../core/fs/fs-utils.js";
-import { enforceHistoryStreamPolicyForItems } from "../../core/history/history-stream-policy.js";
-import { computeHistoryStorageStats, } from "../../core/history/history-storage-stats.js";
-import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
-import { resolveRuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { nowIso } from "../../core/shared/time.js";
-import { listAllItemMetadataLight, listAllItemMetadataWithBody, } from "../../core/store/item-store.js";
-import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.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;
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    zeroByType,
-    zeroByStatus,
-    countNonEmptyLines,
-    readHistoryStreamContents,
-};
-/** Implements run stats for the public runtime surface of this module. */
-export 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);
-    // Field utilization needs the heavy collections (notes/learnings/files/docs/
-    // tests/comments/deps) AND the body, which the light reader drops — so when it
-    // is requested we read the WithBody rows and use them for every section.
-    const items = options.fieldUtilization
-        ? await listAllItemMetadataWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema)
-        : await listAllItemMetadataLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, 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));
-    // zeroByType/zeroByStatus pre-seed a bucket for every registry type/status, and
-    // the light item-metadata reader drops any item whose type/status falls outside
-    // the active registry (parse rejects them) — so every item's bucket is already
-    // present here and no on-the-fly initialization is reachable.
-    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)
-        : undefined;
-    const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);
-    const metadataCoverage = options.metadataCoverage
-        ? computeMetadataCoverage(items, classifier)
-        : undefined;
-    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)
-        : undefined;
-    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(),
-    };
-}
+!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]="81afc203-9f08-5d9d-ac28-566f521ccfba")}catch(e){}}();
+export * from "../../sdk/stats.js";
 //# sourceMappingURL=stats.js.map
-//# debugId=f76ffd47-6478-5a3f-b18f-990a9332c774
+//# debugId=81afc203-9f08-5d9d-ac28-566f521ccfba

package/dist/cli/commands/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sources":["cli/commands/stats.ts"],"sourceRoot":"/","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 {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n} 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 {\n  computeHistoryStorageStats,\n  type HistoryStorageStats,\n} 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 {\n  listAllItemMetadataLight,\n  listAllItemMetadataWithBody,\n} 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/** Documents the stats command options payload exchanged by command, SDK, and package integrations. */\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/** Documents the stats result payload exchanged by command, SDK, and package integrations. */\nexport interface StatsResult {\n  /** Value that configures or reports totals for this contract. */\n  totals: {\n    items: number;\n    history_streams: number;\n    history_entries: number;\n  };\n  /** Schema type that determines the shape and validation rules for this value. */\n  by_type: Record<ItemType, number>;\n  /** Lifecycle state reported for bythe record. */\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  /** ISO 8601 timestamp recording when generated occurred. */\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.split(/\\r?\\n/u).filter((line) => line.trim().length > 0).length;\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: unknown }).code === \"ENOENT\"\n  );\n}\n\nasync function readHistoryStreamContents(\n  pmRoot: string,\n): 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\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  zeroByType,\n  zeroByStatus,\n  countNonEmptyLines,\n  readHistoryStreamContents,\n};\n\n/** Implements run stats for the public runtime surface of this module. */\nexport async function runStats(\n  global: GlobalOptions,\n  options: StatsCommandOptions = {},\n): Promise<StatsResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(\n    settings,\n    getActiveExtensionRegistrations(),\n  );\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 listAllItemMetadataWithBody(\n        pmRoot,\n        settings.item_format,\n        typeRegistry.type_to_folder,\n        undefined,\n        settings.schema,\n      )\n    : await listAllItemMetadataLight(\n        pmRoot,\n        settings.item_format,\n        typeRegistry.type_to_folder,\n        undefined,\n        settings.schema,\n      );\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(\n    statusRegistry.definitions.map((definition) => definition.id),\n  );\n  // zeroByType/zeroByStatus pre-seed a bucket for every registry type/status, and\n  // the light item-metadata 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\n    ? computeHistoryStorageStats(streams)\n    : undefined;\n\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const metadataCoverage = options.metadataCoverage\n    ? computeMetadataCoverage(items, classifier)\n    : 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, {\n      tagPrefix: options.tagPrefix,\n    });\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\n    ? computeContentFieldUtilization(items)\n    : 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"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,8BAA8B,GAE/B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,qCAAqC,GAGtC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EACL,0BAA0B,GAE3B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAiD5D,SAAS,UAAU,CAAC,SAAmB;IACrC,OAAO,SAAS,CAAC,MAAM,CACrB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAA8B,CAC/B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAkB;IACtC,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACf,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAAgC,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,MAAc;IAEd,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,oBAAoB,CAAC;QACzB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,oBAAoB,CAAC;YACzB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,YAAY;IACZ,kBAAkB;IAClB,yBAAyB;CAC1B,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqB,EACrB,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,iCAAiC,MAAM,sBAAsB,EAC7D,SAAS,CAAC,SAAS,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,uBAAuB,CAC1C,QAAQ,EACR,+BAA+B,EAAE,CAClC,CAAC;IACF,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,6EAA6E;IAC7E,+EAA+E;IAC/E,yEAAyE;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB;QACpC,CAAC,CAAC,MAAM,2BAA2B,CAC/B,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,YAAY,CAAC,cAAc,EAC3B,SAAS,EACT,QAAQ,CAAC,MAAM,CAChB;QACH,CAAC,CAAC,MAAM,wBAAwB,CAC5B,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,YAAY,CAAC,cAAc,EAC3B,SAAS,EACT,QAAQ,CAAC,MAAM,CAChB,CAAC;IACN,MAAM,kCAAkC,CAAC;QACvC,MAAM;QACN,QAAQ;QACR,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,YAAY,EAAE,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAC3B,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAC9D,CAAC;IACF,gFAAgF;IAChF,gFAAgF;IAChF,+EAA+E;IAC/E,8DAA8D;IAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,cAAc,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;QAC7B,CAAC,CAAC,0BAA0B,CAAC,OAAO,CAAC;QACrC,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,UAAU,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IACzE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB;QAC/C,CAAC,CAAC,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,UAAU,GAA2C,EAAE,CAAC;IAC9D,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,UAAU,CAAC,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,UAAU,CAAC,GAAG,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE;YAC/D,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,UAAU,CAAC,QAAQ,GAAG,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB;QAC/C,CAAC,CAAC,8BAA8B,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,eAAe,EAAE,OAAO,CAAC,MAAM;YAC/B,eAAe,EAAE,cAAc;SAChC;QACD,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,QAAQ;QACnB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,YAAY,EAAE,MAAM,EAAE;KACvB,CAAC;AACJ,CAAC","debugId":"f76ffd47-6478-5a3f-b18f-990a9332c774"}
+{"version":3,"file":"stats.js","sources":["cli/commands/stats.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/stats\n *\n * Compatibility export for SDK-owned tracker statistics.\n */\nexport * from \"../../sdk/stats.js\";\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,cAAc,oBAAoB,CAAC","debugId":"81afc203-9f08-5d9d-ac28-566f521ccfba"}

package/dist/cli/commands/telemetry.d.ts

@@ -1,14 +1,6 @@
-import type { GlobalOptions } from "../../core/shared/command-types.js";
-/** Public contract for telemetry subcommands, shared by SDK and presentation-layer consumers. */
-export declare const TELEMETRY_SUBCOMMANDS: readonly ["status", "flush", "stats", "clear"];
-/** Restricts telemetry subcommand values accepted by command, SDK, and storage contracts. */
-export type TelemetrySubcommand = (typeof TELEMETRY_SUBCOMMANDS)[number];
-/** Documents the telemetry command options payload exchanged by command, SDK, and package integrations. */
-export interface TelemetryCommandOptions {
-    /** Value that configures or reports subcommand for this contract. */
-    subcommand?: string;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string | number;
-}
-/** Implements run telemetry for the public runtime surface of this module. */
-export declare function runTelemetry(options: TelemetryCommandOptions, _global: GlobalOptions): Promise<Record<string, unknown>>;
+/**
+ * @module cli/commands/telemetry
+ *
+ * Compatibility export for SDK-owned telemetry diagnostics.
+ */
+export * from "../../sdk/telemetry.js";

package/dist/cli/commands/telemetry.js

@@ -1,355 +1,10 @@
 /**
  * @module cli/commands/telemetry
  *
- * Implements the pm telemetry command surface and its agent-facing runtime behavior.
+ * Compatibility export for SDK-owned telemetry diagnostics.
  */
 
-!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]="a0a5873e-adac-517e-901b-9462c208164c")}catch(e){}}();
-import fs from "node:fs/promises";
-import path from "node:path";
-import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { nowIso } from "../../core/shared/time.js";
-import { resolveGlobalPmRoot } from "../../core/store/paths.js";
-import { readSettings, writeSettings } from "../../core/store/settings.js";
-import { flushTelemetryQueueNow } from "../../core/telemetry/runtime.js";
-const TELEMETRY_QUEUE_RELATIVE_PATH = path.join("runtime", "telemetry", "events.jsonl");
-const TELEMETRY_STATE_RELATIVE_PATH = path.join("runtime", "telemetry", "state.json");
-const TELEMETRY_RUNTIME_RELATIVE_PATH = path.join("runtime", "telemetry");
-const DEFAULT_STATS_LIMIT = 20;
-/** Public contract for telemetry subcommands, shared by SDK and presentation-layer consumers. */
-export const TELEMETRY_SUBCOMMANDS = [
-    "status",
-    "flush",
-    "stats",
-    "clear",
-];
-/**
- * Returns the nearest-rank percentile of an ascending-sorted, non-empty array.
- *
- * Uses the nearest-rank method (rank = ceil(fraction × n), 1-based, clamped into
- * range) so the result is always an observed sample value with no interpolation.
- */
-function nearestRankPercentile(sortedAscending, fraction) {
-    const rank = Math.ceil(fraction * sortedAscending.length);
-    const index = Math.min(sortedAscending.length - 1, Math.max(0, rank - 1));
-    return sortedAscending[index];
-}
-function normalizeTelemetryQueueEntry(entry) {
-    const command = typeof entry.event.command === "string" &&
-        entry.event.command.trim().length > 0
-        ? entry.event.command
-        : "<unknown>";
-    const eventType = typeof entry.event.event_type === "string" &&
-        entry.event.event_type.trim().length > 0
-        ? entry.event.event_type
-        : "unknown";
-    const eventSchemaVersion = typeof entry.event.schema_version === "number" &&
-        Number.isFinite(entry.event.schema_version)
-        ? Math.trunc(entry.event.schema_version)
-        : undefined;
-    const clientSchemaVersion = typeof entry.client_schema_version === "number" &&
-        Number.isFinite(entry.client_schema_version)
-        ? Math.trunc(entry.client_schema_version)
-        : undefined;
-    return { command, eventType, eventSchemaVersion, clientSchemaVersion };
-}
-function createTelemetryStatsAccumulator() {
-    return {
-        count: 0,
-        max_attempts: 0,
-        event_type_counts: {},
-        event_schema_versions: new Set(),
-        client_schema_versions: new Set(),
-        finish_durations_ms: [],
-        ok_count: 0,
-        error_count: 0,
-        resolution_counts: {},
-    };
-}
-function recordTelemetryFinishPayload(current, payload) {
-    const durationMs = typeof payload?.duration_ms === "number" &&
-        Number.isFinite(payload.duration_ms)
-        ? payload.duration_ms
-        : undefined;
-    if (durationMs !== undefined) {
-        current.finish_durations_ms.push(durationMs);
-    }
-    if (payload?.ok === true) {
-        current.ok_count += 1;
-    }
-    else {
-        current.error_count += 1;
-    }
-    const resolution = typeof payload?.command_resolution === "string" &&
-        payload.command_resolution.trim().length > 0
-        ? payload.command_resolution
-        : undefined;
-    if (resolution !== undefined) {
-        current.resolution_counts[resolution] =
-            (current.resolution_counts[resolution] ?? 0) + 1;
-    }
-}
-function recordTelemetryQueueEntry(grouped, entry) {
-    const normalized = normalizeTelemetryQueueEntry(entry);
-    const current = grouped.get(normalized.command) ?? createTelemetryStatsAccumulator();
-    const attempts = Number.isFinite(entry.attempts)
-        ? Math.max(0, Math.trunc(entry.attempts))
-        : 0;
-    current.count += 1;
-    current.max_attempts = Math.max(current.max_attempts, attempts);
-    current.event_type_counts[normalized.eventType] =
-        (current.event_type_counts[normalized.eventType] ?? 0) + 1;
-    if (normalized.eventSchemaVersion !== undefined) {
-        current.event_schema_versions.add(normalized.eventSchemaVersion);
-    }
-    if (normalized.clientSchemaVersion !== undefined) {
-        current.client_schema_versions.add(normalized.clientSchemaVersion);
-    }
-    if (normalized.eventType === "command_finish") {
-        recordTelemetryFinishPayload(current, entry.event.payload);
-    }
-    grouped.set(normalized.command, current);
-}
-function buildTelemetryStatsBucket(command, value) {
-    const finishCount = value.ok_count + value.error_count;
-    const sortedDurations = [...value.finish_durations_ms].sort((left, right) => left - right);
-    const resolutionEntries = Object.entries(value.resolution_counts).sort((left, right) => left[0].localeCompare(right[0]));
-    return {
-        command,
-        count: value.count,
-        event_type_counts: Object.fromEntries(Object.entries(value.event_type_counts).sort((left, right) => left[0].localeCompare(right[0]))),
-        max_attempts: value.max_attempts,
-        event_schema_versions: [...value.event_schema_versions].sort((left, right) => left - right),
-        client_schema_versions: [...value.client_schema_versions].sort((left, right) => left - right),
-        ...(sortedDurations.length > 0
-            ? {
-                duration_p50_ms: nearestRankPercentile(sortedDurations, 0.5),
-                duration_p95_ms: nearestRankPercentile(sortedDurations, 0.95),
-                duration_max_ms: sortedDurations[sortedDurations.length - 1],
-            }
-            : {}),
-        ...(finishCount > 0
-            ? {
-                ok_count: value.ok_count,
-                error_count: value.error_count,
-                error_rate: value.error_count / finishCount,
-            }
-            : {}),
-        ...(resolutionEntries.length > 0
-            ? { command_resolution_counts: Object.fromEntries(resolutionEntries) }
-            : {}),
-    };
-}
-function normalizeTelemetrySubcommand(value) {
-    const normalized = (value ?? "status").trim().toLowerCase();
-    if (TELEMETRY_SUBCOMMANDS.includes(normalized)) {
-        return normalized;
-    }
-    // `value` is always a defined string here: an undefined subcommand normalizes
-    // to "status" above (a valid value) and never reaches this throw.
-    throw new PmCliError(`Unknown pm telemetry subcommand "${value}". Allowed: ${TELEMETRY_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
-        code: "unknown_subcommand",
-        examples: [
-            "pm telemetry status",
-            "pm telemetry flush",
-            "pm telemetry stats --limit 10",
-            "pm telemetry clear",
-        ],
-    });
-}
-function parseTelemetryStatsLimit(raw) {
-    if (raw === undefined) {
-        return DEFAULT_STATS_LIMIT;
-    }
-    if (typeof raw === "number") {
-        if (!Number.isFinite(raw) || !Number.isInteger(raw) || raw <= 0) {
-            throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
-        }
-        return raw;
-    }
-    const trimmed = raw.trim();
-    if (trimmed.length === 0 || !/^\d+$/.test(trimmed)) {
-        throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
-    }
-    const parsed = Number.parseInt(trimmed, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        throw new PmCliError("--limit must be a positive integer", EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-function parseTelemetryQueue(raw) {
-    if (raw === null || raw.trim().length === 0) {
-        return {
-            rows_total: 0,
-            valid_entries: 0,
-            invalid_rows: 0,
-            entries: [],
-        };
-    }
-    const entries = [];
-    let rowsTotal = 0;
-    let invalidRows = 0;
-    for (const line of raw.split("\n")) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0) {
-            continue;
-        }
-        rowsTotal += 1;
-        try {
-            const parsed = JSON.parse(trimmed);
-            if (typeof parsed === "object" &&
-                parsed !== null &&
-                typeof parsed.attempts === "number" &&
-                typeof parsed.event === "object" &&
-                parsed.event !== null) {
-                entries.push(parsed);
-            }
-            else {
-                invalidRows += 1;
-            }
-        }
-        catch {
-            invalidRows += 1;
-        }
-    }
-    return {
-        rows_total: rowsTotal,
-        valid_entries: entries.length,
-        invalid_rows: invalidRows,
-        entries,
-    };
-}
-async function readTelemetryRuntimeState(statePath) {
-    const stateRaw = await readFileIfExists(statePath);
-    if (stateRaw === null || stateRaw.trim().length === 0) {
-        return {};
-    }
-    try {
-        const parsed = JSON.parse(stateRaw);
-        if (typeof parsed === "object" &&
-            parsed !== null &&
-            !Array.isArray(parsed)) {
-            return parsed;
-        }
-    }
-    catch {
-        // Ignore malformed state files; status command is observational.
-    }
-    return {};
-}
-async function buildTelemetryStatusSummary(globalPmRoot) {
-    const settings = await readSettings(globalPmRoot);
-    const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);
-    const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);
-    const queueRaw = await readFileIfExists(queuePath);
-    const queue = parseTelemetryQueue(queueRaw);
-    const runtimeState = await readTelemetryRuntimeState(statePath);
-    return {
-        enabled: settings.telemetry.enabled,
-        endpoint: settings.telemetry.endpoint,
-        queue_path: queuePath,
-        state_path: statePath,
-        queue_rows_total: queue.rows_total,
-        queue_entries: queue.valid_entries,
-        queue_invalid_rows: queue.invalid_rows,
-        queue_size_bytes: queueRaw === null ? 0 : Buffer.byteLength(queueRaw, "utf8"),
-        last_attempted_flush_at: runtimeState.last_attempted_flush_at ?? null,
-        last_successful_flush_at: runtimeState.last_successful_flush_at ?? null,
-        last_failed_flush_at: runtimeState.last_failed_flush_at ?? null,
-        last_failed_flush_error: runtimeState.last_failed_flush_error ?? null,
-    };
-}
-function buildTelemetryStatsBuckets(entries) {
-    const grouped = new Map();
-    for (const entry of entries) {
-        // Latency + outcome distribution come from command_finish payloads only:
-        // command_finish always carries duration_ms/ok/command_resolution at every
-        // capture level, while start/error events do not.
-        recordTelemetryQueueEntry(grouped, entry);
-    }
-    return [...grouped.entries()]
-        .map(([command, value]) => buildTelemetryStatsBucket(command, value))
-        .sort((left, right) => right.count - left.count || left.command.localeCompare(right.command));
-}
-/** Implements run telemetry for the public runtime surface of this module. */
-export async function runTelemetry(options, _global) {
-    void _global;
-    const subcommand = normalizeTelemetrySubcommand(options.subcommand);
-    const globalPmRoot = resolveGlobalPmRoot(process.cwd());
-    const queuePath = path.join(globalPmRoot, TELEMETRY_QUEUE_RELATIVE_PATH);
-    const statePath = path.join(globalPmRoot, TELEMETRY_STATE_RELATIVE_PATH);
-    if (subcommand === "status") {
-        return {
-            action: "telemetry",
-            subcommand,
-            status: await buildTelemetryStatusSummary(globalPmRoot),
-            generated_at: nowIso(),
-        };
-    }
-    if (subcommand === "flush") {
-        const before = await buildTelemetryStatusSummary(globalPmRoot);
-        await flushTelemetryQueueNow(globalPmRoot);
-        const after = await buildTelemetryStatusSummary(globalPmRoot);
-        return {
-            action: "telemetry",
-            subcommand,
-            queue_entries_before: before.queue_entries,
-            queue_entries_after: after.queue_entries,
-            queue_drained: after.queue_entries < before.queue_entries,
-            status: after,
-            generated_at: nowIso(),
-        };
-    }
-    if (subcommand === "stats") {
-        const limit = parseTelemetryStatsLimit(options.limit);
-        const queueRaw = await readFileIfExists(queuePath);
-        const queue = parseTelemetryQueue(queueRaw);
-        const buckets = buildTelemetryStatsBuckets(queue.entries);
-        const selected = buckets.slice(0, limit);
-        return {
-            action: "telemetry",
-            subcommand,
-            limit,
-            total_commands: buckets.length,
-            queue_entries: queue.valid_entries,
-            queue_invalid_rows: queue.invalid_rows,
-            queue_rows_total: queue.rows_total,
-            truncated: buckets.length > selected.length,
-            stats: selected,
-            generated_at: nowIso(),
-        };
-    }
-    const settings = await readSettings(globalPmRoot);
-    const previousEnabled = settings.telemetry.enabled;
-    const previousInstallationId = settings.telemetry.installation_id;
-    const previousFirstRunPromptCompleted = settings.telemetry.first_run_prompt_completed;
-    settings.telemetry.enabled = false;
-    settings.telemetry.first_run_prompt_completed = true;
-    settings.telemetry.installation_id = "";
-    const settingsChanged = previousEnabled !== settings.telemetry.enabled ||
-        previousInstallationId !== settings.telemetry.installation_id ||
-        previousFirstRunPromptCompleted !==
-            settings.telemetry.first_run_prompt_completed;
-    if (settingsChanged) {
-        await writeSettings(globalPmRoot, settings, "telemetry:clear");
-    }
-    const telemetryRuntimePath = path.join(globalPmRoot, TELEMETRY_RUNTIME_RELATIVE_PATH);
-    const existed = await pathExists(telemetryRuntimePath);
-    await fs.rm(telemetryRuntimePath, { recursive: true, force: true });
-    const queueExistsAfter = await pathExists(queuePath);
-    const stateExistsAfter = await pathExists(statePath);
-    return {
-        action: "telemetry",
-        subcommand,
-        settings_changed: settingsChanged,
-        runtime_dir_removed: existed && !(await pathExists(telemetryRuntimePath)),
-        queue_exists_after: queueExistsAfter,
-        state_exists_after: stateExistsAfter,
-        status: await buildTelemetryStatusSummary(globalPmRoot),
-        generated_at: nowIso(),
-    };
-}
+!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]="d305520e-3ead-55e7-8382-3a12e9692e93")}catch(e){}}();
+export * from "../../sdk/telemetry.js";
 //# sourceMappingURL=telemetry.js.map
-//# debugId=a0a5873e-adac-517e-901b-9462c208164c
+//# debugId=d305520e-3ead-55e7-8382-3a12e9692e93