@unbrained/pm-cli 2026.7.16 → 2026.7.17

package/dist/sdk/search-refresh-worker.d.ts

@@ -0,0 +1,2 @@
+/** Drain the active workspace's pending semantic-refresh queue. */
+export declare function runSearchRefreshWorkerEntrypoint(): Promise<void>;

package/dist/sdk/search-refresh-worker.js

@@ -0,0 +1,19 @@
+/**
+ * @module sdk/search-refresh-worker
+ *
+ * Owns the detached semantic-refresh worker entry used by custom mutation hosts.
+ */
+
+!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]="cca3fa99-e06d-5fac-80a5-d5f186291907")}catch(e){}}();
+import { runSemanticRefreshWorker } from "../core/search/background-refresh.js";
+import { refreshSemanticEmbeddingsForMutatedItems } from "../core/search/cache.js";
+import { resolvePmRoot } from "../core/store/paths.js";
+/** Drain the active workspace's pending semantic-refresh queue. */
+export async function runSearchRefreshWorkerEntrypoint() {
+    const pmRoot = resolvePmRoot(process.cwd(), process.env.PM_PATH);
+    await runSemanticRefreshWorker(pmRoot, (root, itemIds) => refreshSemanticEmbeddingsForMutatedItems(root, itemIds, {
+        apply_runtime_defaults: true,
+    }));
+}
+//# sourceMappingURL=search-refresh-worker.js.map
+//# debugId=cca3fa99-e06d-5fac-80a5-d5f186291907

package/dist/sdk/search-refresh-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-refresh-worker.js","sources":["sdk/search-refresh-worker.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/search-refresh-worker\n *\n * Owns the detached semantic-refresh worker entry used by custom mutation hosts.\n */\nimport { runSemanticRefreshWorker } from \"../core/search/background-refresh.js\";\nimport { refreshSemanticEmbeddingsForMutatedItems } from \"../core/search/cache.js\";\nimport { resolvePmRoot } from \"../core/store/paths.js\";\n\n/** Drain the active workspace's pending semantic-refresh queue. */\nexport async function runSearchRefreshWorkerEntrypoint(): Promise<void> {\n  const pmRoot = resolvePmRoot(process.cwd(), process.env.PM_PATH);\n  await runSemanticRefreshWorker(pmRoot, (root, itemIds) =>\n    refreshSemanticEmbeddingsForMutatedItems(root, itemIds, {\n      apply_runtime_defaults: true,\n    }),\n  );\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,wCAAwC,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,gCAAgC;IACpD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,wBAAwB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACvD,wCAAwC,CAAC,IAAI,EAAE,OAAO,EAAE;QACtD,sBAAsB,EAAE,IAAI;KAC7B,CAAC,CACH,CAAC;AACJ,CAAC","debugId":"cca3fa99-e06d-5fac-80a5-d5f186291907"}

package/dist/sdk/stats.d.ts

@@ -0,0 +1,66 @@
+import { type ContentFieldUtilizationReport } from "../core/governance/content-fields.js";
+import { type GroupedBreakdown, type MetadataCoverageReport } from "../core/governance/metadata-coverage.js";
+import { type HistoryStorageStats } from "../core/history/history-storage-stats.js";
+import type { GlobalOptions } from "../core/shared/command-types.js";
+import type { ItemStatus, ItemType } from "../types/index.js";
+/** Documents the stats command options payload exchanged by command, SDK, and package integrations. */
+export interface StatsCommandOptions {
+    /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */
+    storage?: boolean;
+    /** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */
+    metadataCoverage?: boolean;
+    /** Include a lifecycle-bucketed breakdown grouped by assignee. */
+    byAssignee?: boolean;
+    /** Include a lifecycle-bucketed breakdown grouped by tag (optionally filtered by --tag-prefix). */
+    byTag?: boolean;
+    /** Include a lifecycle-bucketed breakdown grouped by priority. */
+    byPriority?: boolean;
+    /** With --by-tag: only consider tags starting with this prefix (e.g. "domain:"). */
+    tagPrefix?: string;
+    /** Include a content-field utilization breakdown (notes/learnings/files/docs/tests/comments/deps/body usage rates). */
+    fieldUtilization?: boolean;
+}
+/** Documents the stats result payload exchanged by command, SDK, and package integrations. */
+export interface StatsResult {
+    /** Value that configures or reports totals for this contract. */
+    totals: {
+        items: number;
+        history_streams: number;
+        history_entries: number;
+    };
+    /** Schema type that determines the shape and validation rules for this value. */
+    by_type: Record<ItemType, number>;
+    /** Lifecycle state reported for bythe record. */
+    by_status: Record<ItemStatus, number>;
+    /** Present only with --metadata-coverage: per-field coverage overall and by type. */
+    metadata_coverage?: MetadataCoverageReport;
+    /** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */
+    breakdowns?: {
+        assignee?: GroupedBreakdown;
+        tag?: GroupedBreakdown;
+        priority?: GroupedBreakdown;
+    };
+    /** Present only with --storage: aggregate history-stream metrics for compaction/planning. */
+    storage?: HistoryStorageStats;
+    /** Present only with --field-utilization: content-field utilization rates across all items. */
+    field_utilization?: ContentFieldUtilizationReport;
+    /** ISO 8601 timestamp recording when generated occurred. */
+    generated_at: string;
+}
+declare function zeroByType(itemTypes: string[]): Record<ItemType, number>;
+declare function zeroByStatus(statuses: string[]): Record<ItemStatus, number>;
+declare function countNonEmptyLines(raw: string): number;
+declare function readHistoryStreamContents(pmRoot: string): Promise<Array<{
+    id: string;
+    raw: string;
+}>>;
+/** Public contract for test only, shared by SDK and presentation-layer consumers. */
+export declare const _testOnly: {
+    zeroByType: typeof zeroByType;
+    zeroByStatus: typeof zeroByStatus;
+    countNonEmptyLines: typeof countNonEmptyLines;
+    readHistoryStreamContents: typeof readHistoryStreamContents;
+};
+/** Implements run stats for the public runtime surface of this module. */
+export declare function runStats(global: GlobalOptions, options?: StatsCommandOptions): Promise<StatsResult>;
+export {};

package/dist/sdk/stats.js

@@ -0,0 +1,151 @@
+/**
+ * @module sdk/stats
+ *
+ * Implements the pm stats command surface and its agent-facing runtime behavior.
+ */
+
+!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]="3abba5c6-fe9b-55de-bafb-3f3c604df10c")}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, readFileIfExists } 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;
+}
+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);
+        const raw = await readFileIfExists(historyPath);
+        if (raw === null) {
+            continue;
+        }
+        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(),
+    };
+}
+//# sourceMappingURL=stats.js.map
+//# debugId=3abba5c6-fe9b-55de-bafb-3f3c604df10c

package/dist/sdk/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sources":["sdk/stats.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/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, readFileIfExists } 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\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    const raw = await readFileIfExists(historyPath);\n    if (raw === null) {\n      continue;\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":"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","debugId":"3abba5c6-fe9b-55de-bafb-3f3c604df10c"}

package/dist/sdk/telemetry-flush.d.ts

@@ -0,0 +1,2 @@
+/** Flush the durable telemetry queue immediately. */
+export declare function flushTelemetryQueue(): Promise<void>;

package/dist/sdk/telemetry-flush.js

@@ -0,0 +1,14 @@
+/**
+ * @module sdk/telemetry-flush
+ *
+ * Owns explicit telemetry queue draining for embedded and detached hosts.
+ */
+
+!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]="d95fe0b9-ee51-57b5-85ac-104857fb5ad4")}catch(e){}}();
+import { flushTelemetryQueueNow } from "../core/telemetry/runtime.js";
+/** Flush the durable telemetry queue immediately. */
+export async function flushTelemetryQueue() {
+    await flushTelemetryQueueNow();
+}
+//# sourceMappingURL=telemetry-flush.js.map
+//# debugId=d95fe0b9-ee51-57b5-85ac-104857fb5ad4

package/dist/sdk/telemetry-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-flush.js","sources":["sdk/telemetry-flush.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/telemetry-flush\n *\n * Owns explicit telemetry queue draining for embedded and detached hosts.\n */\nimport { flushTelemetryQueueNow } from \"../core/telemetry/runtime.js\";\n\n/** Flush the durable telemetry queue immediately. */\nexport async function flushTelemetryQueue(): Promise<void> {\n  await flushTelemetryQueueNow();\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,sBAAsB,EAAE,CAAC;AACjC,CAAC","debugId":"d95fe0b9-ee51-57b5-85ac-104857fb5ad4"}

package/dist/sdk/telemetry.d.ts

@@ -0,0 +1,14 @@
+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 const runTelemetry: (options: TelemetryCommandOptions, _global: GlobalOptions) => Promise<Record<string, unknown>>;