@x12i/countex 1.0.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (317) hide show
  1. package/README.md +215 -4
  2. package/dist/backup/export.d.ts +2 -0
  3. package/dist/backup/export.d.ts.map +1 -1
  4. package/dist/backup/export.js +2 -0
  5. package/dist/backup/export.js.map +1 -1
  6. package/dist/backup/manifest.d.ts +49 -0
  7. package/dist/backup/manifest.d.ts.map +1 -0
  8. package/dist/backup/manifest.js +103 -0
  9. package/dist/backup/manifest.js.map +1 -0
  10. package/dist/backup/snapshot-encoding.d.ts +8 -0
  11. package/dist/backup/snapshot-encoding.d.ts.map +1 -0
  12. package/dist/backup/snapshot-encoding.js +27 -0
  13. package/dist/backup/snapshot-encoding.js.map +1 -0
  14. package/dist/cli.d.ts +12 -0
  15. package/dist/cli.d.ts.map +1 -0
  16. package/dist/cli.js +206 -0
  17. package/dist/cli.js.map +1 -0
  18. package/dist/core/buffer.d.ts +4 -3
  19. package/dist/core/buffer.d.ts.map +1 -1
  20. package/dist/core/buffer.js +65 -9
  21. package/dist/core/buffer.js.map +1 -1
  22. package/dist/core/countex.d.ts +14 -1
  23. package/dist/core/countex.d.ts.map +1 -1
  24. package/dist/core/countex.js +171 -48
  25. package/dist/core/countex.js.map +1 -1
  26. package/dist/core/extraction.d.ts +14 -6
  27. package/dist/core/extraction.d.ts.map +1 -1
  28. package/dist/core/extraction.js +117 -1
  29. package/dist/core/extraction.js.map +1 -1
  30. package/dist/core/mapping.d.ts +5 -0
  31. package/dist/core/mapping.d.ts.map +1 -1
  32. package/dist/core/mapping.js +71 -1
  33. package/dist/core/mapping.js.map +1 -1
  34. package/dist/core/timeframe.d.ts +7 -0
  35. package/dist/core/timeframe.d.ts.map +1 -1
  36. package/dist/core/timeframe.js +88 -0
  37. package/dist/core/timeframe.js.map +1 -1
  38. package/dist/index.d.ts +4 -1
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +13 -1
  41. package/dist/index.js.map +1 -1
  42. package/dist/insights/advisors/fanout-health.d.ts +3 -0
  43. package/dist/insights/advisors/fanout-health.d.ts.map +1 -0
  44. package/dist/insights/advisors/fanout-health.js +3 -0
  45. package/dist/insights/advisors/fanout-health.js.map +1 -0
  46. package/dist/insights/advisors/map-health.d.ts +6 -0
  47. package/dist/insights/advisors/map-health.d.ts.map +1 -0
  48. package/dist/insights/advisors/map-health.js +154 -0
  49. package/dist/insights/advisors/map-health.js.map +1 -0
  50. package/dist/insights/advisors/resource-advisor.d.ts +4 -0
  51. package/dist/insights/advisors/resource-advisor.d.ts.map +1 -0
  52. package/dist/insights/advisors/resource-advisor.js +102 -0
  53. package/dist/insights/advisors/resource-advisor.js.map +1 -0
  54. package/dist/insights/advisors/retention-advisor.d.ts +2 -0
  55. package/dist/insights/advisors/retention-advisor.d.ts.map +1 -0
  56. package/dist/insights/advisors/retention-advisor.js +6 -0
  57. package/dist/insights/advisors/retention-advisor.js.map +1 -0
  58. package/dist/insights/advisors-subpath.d.ts +4 -0
  59. package/dist/insights/advisors-subpath.d.ts.map +1 -0
  60. package/dist/insights/advisors-subpath.js +10 -0
  61. package/dist/insights/advisors-subpath.js.map +1 -0
  62. package/dist/insights/anomaly/baseline.d.ts +4 -0
  63. package/dist/insights/anomaly/baseline.d.ts.map +1 -0
  64. package/dist/insights/anomaly/baseline.js +54 -0
  65. package/dist/insights/anomaly/baseline.js.map +1 -0
  66. package/dist/insights/anomaly/detect-anomalies.d.ts +6 -0
  67. package/dist/insights/anomaly/detect-anomalies.d.ts.map +1 -0
  68. package/dist/insights/anomaly/detect-anomalies.js +245 -0
  69. package/dist/insights/anomaly/detect-anomalies.js.map +1 -0
  70. package/dist/insights/anomaly/ewma.d.ts +2 -0
  71. package/dist/insights/anomaly/ewma.d.ts.map +1 -0
  72. package/dist/insights/anomaly/ewma.js +15 -0
  73. package/dist/insights/anomaly/ewma.js.map +1 -0
  74. package/dist/insights/anomaly/missing-activity.d.ts +3 -0
  75. package/dist/insights/anomaly/missing-activity.d.ts.map +1 -0
  76. package/dist/insights/anomaly/missing-activity.js +8 -0
  77. package/dist/insights/anomaly/missing-activity.js.map +1 -0
  78. package/dist/insights/anomaly/robust-zscore.d.ts +2 -0
  79. package/dist/insights/anomaly/robust-zscore.d.ts.map +1 -0
  80. package/dist/insights/anomaly/robust-zscore.js +9 -0
  81. package/dist/insights/anomaly/robust-zscore.js.map +1 -0
  82. package/dist/insights/anomaly-subpath.d.ts +7 -0
  83. package/dist/insights/anomaly-subpath.d.ts.map +1 -0
  84. package/dist/insights/anomaly-subpath.js +20 -0
  85. package/dist/insights/anomaly-subpath.js.map +1 -0
  86. package/dist/insights/comparison/compare-periods.d.ts +5 -0
  87. package/dist/insights/comparison/compare-periods.d.ts.map +1 -0
  88. package/dist/insights/comparison/compare-periods.js +64 -0
  89. package/dist/insights/comparison/compare-periods.js.map +1 -0
  90. package/dist/insights/comparison/growth-rate.d.ts +3 -0
  91. package/dist/insights/comparison/growth-rate.d.ts.map +1 -0
  92. package/dist/insights/comparison/growth-rate.js +3 -0
  93. package/dist/insights/comparison/growth-rate.js.map +1 -0
  94. package/dist/insights/comparison/moving-average.d.ts +2 -0
  95. package/dist/insights/comparison/moving-average.d.ts.map +1 -0
  96. package/dist/insights/comparison/moving-average.js +6 -0
  97. package/dist/insights/comparison/moving-average.js.map +1 -0
  98. package/dist/insights/comparison/trend.d.ts +5 -0
  99. package/dist/insights/comparison/trend.d.ts.map +1 -0
  100. package/dist/insights/comparison/trend.js +84 -0
  101. package/dist/insights/comparison/trend.js.map +1 -0
  102. package/dist/insights/errors.d.ts +25 -0
  103. package/dist/insights/errors.d.ts.map +1 -0
  104. package/dist/insights/errors.js +54 -0
  105. package/dist/insights/errors.js.map +1 -0
  106. package/dist/insights/forecast/budget.d.ts +2 -0
  107. package/dist/insights/forecast/budget.d.ts.map +1 -0
  108. package/dist/insights/forecast/budget.js +6 -0
  109. package/dist/insights/forecast/budget.js.map +1 -0
  110. package/dist/insights/forecast/capacity.d.ts +2 -0
  111. package/dist/insights/forecast/capacity.d.ts.map +1 -0
  112. package/dist/insights/forecast/capacity.js +3 -0
  113. package/dist/insights/forecast/capacity.js.map +1 -0
  114. package/dist/insights/forecast/forecast.d.ts +5 -0
  115. package/dist/insights/forecast/forecast.d.ts.map +1 -0
  116. package/dist/insights/forecast/forecast.js +103 -0
  117. package/dist/insights/forecast/forecast.js.map +1 -0
  118. package/dist/insights/forecast/retention.d.ts +2 -0
  119. package/dist/insights/forecast/retention.d.ts.map +1 -0
  120. package/dist/insights/forecast/retention.js +3 -0
  121. package/dist/insights/forecast/retention.js.map +1 -0
  122. package/dist/insights/index.d.ts +4 -0
  123. package/dist/insights/index.d.ts.map +1 -0
  124. package/dist/insights/index.js +23 -0
  125. package/dist/insights/index.js.map +1 -0
  126. package/dist/insights/insights-client.d.ts +33 -0
  127. package/dist/insights/insights-client.d.ts.map +1 -0
  128. package/dist/insights/insights-client.js +344 -0
  129. package/dist/insights/insights-client.js.map +1 -0
  130. package/dist/insights/llm-subpath.d.ts +4 -0
  131. package/dist/insights/llm-subpath.d.ts.map +1 -0
  132. package/dist/insights/llm-subpath.js +10 -0
  133. package/dist/insights/llm-subpath.js.map +1 -0
  134. package/dist/insights/optimization/cost-optimizer.d.ts +6 -0
  135. package/dist/insights/optimization/cost-optimizer.d.ts.map +1 -0
  136. package/dist/insights/optimization/cost-optimizer.js +98 -0
  137. package/dist/insights/optimization/cost-optimizer.js.map +1 -0
  138. package/dist/insights/optimization/latency-optimizer.d.ts +3 -0
  139. package/dist/insights/optimization/latency-optimizer.d.ts.map +1 -0
  140. package/dist/insights/optimization/latency-optimizer.js +3 -0
  141. package/dist/insights/optimization/latency-optimizer.js.map +1 -0
  142. package/dist/insights/optimization/threshold-advisor.d.ts +2 -0
  143. package/dist/insights/optimization/threshold-advisor.d.ts.map +1 -0
  144. package/dist/insights/optimization/threshold-advisor.js +3 -0
  145. package/dist/insights/optimization/threshold-advisor.js.map +1 -0
  146. package/dist/insights/optimization/token-optimizer.d.ts +4 -0
  147. package/dist/insights/optimization/token-optimizer.d.ts.map +1 -0
  148. package/dist/insights/optimization/token-optimizer.js +133 -0
  149. package/dist/insights/optimization/token-optimizer.js.map +1 -0
  150. package/dist/insights/ranking/contribution.d.ts +2 -0
  151. package/dist/insights/ranking/contribution.d.ts.map +1 -0
  152. package/dist/insights/ranking/contribution.js +6 -0
  153. package/dist/insights/ranking/contribution.js.map +1 -0
  154. package/dist/insights/ranking/helpers.d.ts +22 -0
  155. package/dist/insights/ranking/helpers.d.ts.map +1 -0
  156. package/dist/insights/ranking/helpers.js +88 -0
  157. package/dist/insights/ranking/helpers.js.map +1 -0
  158. package/dist/insights/ranking/pareto.d.ts +2 -0
  159. package/dist/insights/ranking/pareto.d.ts.map +1 -0
  160. package/dist/insights/ranking/pareto.js +6 -0
  161. package/dist/insights/ranking/pareto.js.map +1 -0
  162. package/dist/insights/ranking/slices.d.ts +2 -0
  163. package/dist/insights/ranking/slices.d.ts.map +1 -0
  164. package/dist/insights/ranking/slices.js +6 -0
  165. package/dist/insights/ranking/slices.js.map +1 -0
  166. package/dist/insights/ranking/top-bottom.d.ts +2 -0
  167. package/dist/insights/ranking/top-bottom.d.ts.map +1 -0
  168. package/dist/insights/ranking/top-bottom.js +7 -0
  169. package/dist/insights/ranking/top-bottom.js.map +1 -0
  170. package/dist/insights/recommendations/evidence.d.ts +2 -0
  171. package/dist/insights/recommendations/evidence.d.ts.map +1 -0
  172. package/dist/insights/recommendations/evidence.js +3 -0
  173. package/dist/insights/recommendations/evidence.js.map +1 -0
  174. package/dist/insights/recommendations/recommendation.d.ts +6 -0
  175. package/dist/insights/recommendations/recommendation.d.ts.map +1 -0
  176. package/dist/insights/recommendations/recommendation.js +25 -0
  177. package/dist/insights/recommendations/recommendation.js.map +1 -0
  178. package/dist/insights/recommendations/severity.d.ts +2 -0
  179. package/dist/insights/recommendations/severity.d.ts.map +1 -0
  180. package/dist/insights/recommendations/severity.js +3 -0
  181. package/dist/insights/recommendations/severity.js.map +1 -0
  182. package/dist/insights/rules/evaluate-rules.d.ts +5 -0
  183. package/dist/insights/rules/evaluate-rules.d.ts.map +1 -0
  184. package/dist/insights/rules/evaluate-rules.js +156 -0
  185. package/dist/insights/rules/evaluate-rules.js.map +1 -0
  186. package/dist/insights/types.d.ts +405 -0
  187. package/dist/insights/types.d.ts.map +1 -0
  188. package/dist/insights/types.js +3 -0
  189. package/dist/insights/types.js.map +1 -0
  190. package/dist/insights/utils/formatting.d.ts +4 -0
  191. package/dist/insights/utils/formatting.d.ts.map +1 -0
  192. package/dist/insights/utils/formatting.js +21 -0
  193. package/dist/insights/utils/formatting.js.map +1 -0
  194. package/dist/insights/utils/grouping.d.ts +2 -0
  195. package/dist/insights/utils/grouping.d.ts.map +1 -0
  196. package/dist/insights/utils/grouping.js +8 -0
  197. package/dist/insights/utils/grouping.js.map +1 -0
  198. package/dist/insights/utils/query-builder.d.ts +21 -0
  199. package/dist/insights/utils/query-builder.d.ts.map +1 -0
  200. package/dist/insights/utils/query-builder.js +107 -0
  201. package/dist/insights/utils/query-builder.js.map +1 -0
  202. package/dist/insights/utils/row-value.d.ts +5 -0
  203. package/dist/insights/utils/row-value.d.ts.map +1 -0
  204. package/dist/insights/utils/row-value.js +36 -0
  205. package/dist/insights/utils/row-value.js.map +1 -0
  206. package/dist/insights/utils/stats.d.ts +28 -0
  207. package/dist/insights/utils/stats.d.ts.map +1 -0
  208. package/dist/insights/utils/stats.js +125 -0
  209. package/dist/insights/utils/stats.js.map +1 -0
  210. package/dist/query/formatter.d.ts +2 -2
  211. package/dist/query/formatter.d.ts.map +1 -1
  212. package/dist/query/formatter.js +211 -30
  213. package/dist/query/formatter.js.map +1 -1
  214. package/dist/query/planner.d.ts +10 -2
  215. package/dist/query/planner.d.ts.map +1 -1
  216. package/dist/query/planner.js +55 -4
  217. package/dist/query/planner.js.map +1 -1
  218. package/dist/simulation/context.d.ts +5 -0
  219. package/dist/simulation/context.d.ts.map +1 -0
  220. package/dist/simulation/context.js +56 -0
  221. package/dist/simulation/context.js.map +1 -0
  222. package/dist/simulation/events.d.ts +3 -0
  223. package/dist/simulation/events.d.ts.map +1 -0
  224. package/dist/simulation/events.js +67 -0
  225. package/dist/simulation/events.js.map +1 -0
  226. package/dist/simulation/index.d.ts +7 -0
  227. package/dist/simulation/index.d.ts.map +1 -0
  228. package/dist/simulation/index.js +16 -0
  229. package/dist/simulation/index.js.map +1 -0
  230. package/dist/simulation/prng.d.ts +4 -0
  231. package/dist/simulation/prng.d.ts.map +1 -0
  232. package/dist/simulation/prng.js +18 -0
  233. package/dist/simulation/prng.js.map +1 -0
  234. package/dist/simulation/resource-estimate.d.ts +6 -0
  235. package/dist/simulation/resource-estimate.d.ts.map +1 -0
  236. package/dist/simulation/resource-estimate.js +11 -0
  237. package/dist/simulation/resource-estimate.js.map +1 -0
  238. package/dist/simulation/simulator.d.ts +15 -0
  239. package/dist/simulation/simulator.d.ts.map +1 -0
  240. package/dist/simulation/simulator.js +67 -0
  241. package/dist/simulation/simulator.js.map +1 -0
  242. package/dist/simulation/tracker.d.ts +8 -0
  243. package/dist/simulation/tracker.d.ts.map +1 -0
  244. package/dist/simulation/tracker.js +18 -0
  245. package/dist/simulation/tracker.js.map +1 -0
  246. package/dist/simulation/types.d.ts +49 -0
  247. package/dist/simulation/types.d.ts.map +1 -0
  248. package/dist/simulation/types.js +21 -0
  249. package/dist/simulation/types.js.map +1 -0
  250. package/dist/storage/memory.d.ts +3 -0
  251. package/dist/storage/memory.d.ts.map +1 -1
  252. package/dist/storage/memory.js +113 -4
  253. package/dist/storage/memory.js.map +1 -1
  254. package/dist/storage/mongo.d.ts +5 -0
  255. package/dist/storage/mongo.d.ts.map +1 -1
  256. package/dist/storage/mongo.js +129 -17
  257. package/dist/storage/mongo.js.map +1 -1
  258. package/dist/storage/redis.d.ts +12 -9
  259. package/dist/storage/redis.d.ts.map +1 -1
  260. package/dist/storage/redis.js +126 -47
  261. package/dist/storage/redis.js.map +1 -1
  262. package/dist/types/index.d.ts +139 -4
  263. package/dist/types/index.d.ts.map +1 -1
  264. package/docs/DEPLOYMENT.md +40 -2
  265. package/docs/INSIGHTS.md +59 -0
  266. package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -0
  267. package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -0
  268. package/docs/INSIGHTS_RESOURCE_ADVISOR.md +31 -0
  269. package/docs/countex_gap_analysis_complete_checklist.md +1340 -0
  270. package/docs/guides/README.md +34 -0
  271. package/docs/guides/adapter-memory.md +48 -0
  272. package/docs/guides/adapter-mongo.md +62 -0
  273. package/docs/guides/adapter-redis.md +53 -0
  274. package/docs/guides/backup-export.md +83 -0
  275. package/docs/guides/cardinality.md +50 -0
  276. package/docs/guides/cli.md +53 -0
  277. package/docs/guides/client-events.md +49 -0
  278. package/docs/guides/counter-maps.md +122 -0
  279. package/docs/guides/idempotency.md +39 -0
  280. package/docs/guides/ingestion-and-flush.md +67 -0
  281. package/docs/guides/insights-advisors-and-optimization.md +39 -0
  282. package/docs/guides/insights-anomalies-and-rules.md +48 -0
  283. package/docs/guides/insights-comparison-and-trends.md +47 -0
  284. package/docs/guides/insights-forecasting-and-budget.md +61 -0
  285. package/docs/guides/insights-overview.md +82 -0
  286. package/docs/guides/insights-ranking.md +81 -0
  287. package/docs/guides/measures.md +71 -0
  288. package/docs/guides/querying.md +119 -0
  289. package/docs/guides/simulation-profiles.md +33 -0
  290. package/docs/guides/simulation-resource-estimation.md +30 -0
  291. package/docs/guides/simulation.md +36 -0
  292. package/docs/guides/timeframes-and-bucketing.md +55 -0
  293. package/docs/internals/README.md +21 -0
  294. package/docs/internals/internal-architecture-overview.md +65 -0
  295. package/docs/internals/internal-backup-stream.md +23 -0
  296. package/docs/internals/internal-buffer-merge-and-flush.md +51 -0
  297. package/docs/internals/internal-cardinality.md +30 -0
  298. package/docs/internals/internal-dimension-hash.md +34 -0
  299. package/docs/internals/internal-idempotency.md +36 -0
  300. package/docs/internals/internal-ingest-pipeline.md +52 -0
  301. package/docs/internals/internal-insights-layer.md +36 -0
  302. package/docs/internals/internal-mapping-validation-and-extraction.md +59 -0
  303. package/docs/internals/internal-measures-and-scales.md +35 -0
  304. package/docs/internals/internal-query-path.md +46 -0
  305. package/docs/internals/internal-storage-memory.md +13 -0
  306. package/docs/internals/internal-storage-mongo.md +24 -0
  307. package/docs/internals/internal-storage-redis.md +31 -0
  308. package/docs/internals/internal-timeframe-bucketing.md +33 -0
  309. package/docs/use-cases/README.md +56 -0
  310. package/docs/use-cases/audit-security-log-counts.md +550 -0
  311. package/docs/use-cases/llm-cost-and-token-metering.md +255 -0
  312. package/docs/use-cases/multi-tenant-isolation.md +203 -0
  313. package/docs/use-cases/ops-dashboard-daily-rollups.md +255 -0
  314. package/docs/use-cases/processing-workflow-activity.md +165 -0
  315. package/docs/use-cases/product-feature-usage.md +240 -0
  316. package/docs/use-cases/webhook-idempotent-ingestion.md +188 -0
  317. package/package.json +61 -2
@@ -0,0 +1,102 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runEstimateResourcesFromActuals = runEstimateResourcesFromActuals;
4
+ const timeframe_js_1 = require("../../core/timeframe.js");
5
+ const recommendation_js_1 = require("../recommendations/recommendation.js");
6
+ const errors_js_1 = require("../errors.js");
7
+ async function runEstimateResourcesFromActuals(durable, input, maxBuckets) {
8
+ const buckets = (0, timeframe_js_1.bucketRange)(input.sampleWindow.type, input.sampleWindow.from, input.sampleWindow.to);
9
+ if (buckets.length > maxBuckets) {
10
+ throw new errors_js_1.InsightQueryTooBroadError("Resource advisor sample window spans too many buckets.", {
11
+ bucketCount: buckets.length,
12
+ maxBuckets,
13
+ });
14
+ }
15
+ const filter = {
16
+ scope: input.scope,
17
+ counterId: input.counterId,
18
+ timeframe: input.sampleWindow,
19
+ };
20
+ let cellCount = 0;
21
+ const keysPerDay = new Map();
22
+ for await (const cell of durable.streamCells(filter, input.signal ? { signal: input.signal } : undefined)) {
23
+ cellCount++;
24
+ const dayKey = cell.timeframeKey;
25
+ keysPerDay.set(dayKey, (keysPerDay.get(dayKey) ?? 0) + 1);
26
+ }
27
+ const sampleDays = Math.max(1, keysPerDay.size);
28
+ const cellsPerDayAvg = cellCount / sampleDays;
29
+ const counts = [...keysPerDay.values()].sort((a, b) => a - b);
30
+ const cellsPerDayP95 = counts[Math.floor(counts.length * 0.95)] ?? cellsPerDayAvg;
31
+ const redisB = input.constants?.redisBytesPerCell ?? 150;
32
+ const mongoB = input.constants?.mongoBytesPerCell ?? 750;
33
+ const dictB = input.constants?.dictionaryBytesPerKey ?? 200;
34
+ const ret = input.targetRetention;
35
+ let durableMultiplier = 0;
36
+ if (ret.day)
37
+ durableMultiplier += ret.day;
38
+ if (ret.week)
39
+ durableMultiplier += ret.week * 7;
40
+ if (ret.month)
41
+ durableMultiplier += ret.month * 30;
42
+ if (ret.quarter)
43
+ durableMultiplier += ret.quarter * 90;
44
+ if (ret.year)
45
+ durableMultiplier += ret.year * 365;
46
+ if (ret.all)
47
+ durableMultiplier += 365;
48
+ if (durableMultiplier === 0)
49
+ durableMultiplier = 92;
50
+ const hotCells = Math.ceil(cellsPerDayP95 * Math.min(7, sampleDays));
51
+ const durableCells = Math.ceil(cellsPerDayAvg * durableMultiplier);
52
+ const redisBytes = hotCells * redisB;
53
+ const mongoBytes = durableCells * mongoB;
54
+ const dictionaryKeys = Math.ceil(cellCount * 0.1);
55
+ const dictionaryBytes = dictionaryKeys * dictB;
56
+ const assumptions = {
57
+ durableMultiplier,
58
+ sampleDays,
59
+ note: "Dictionary key estimate is heuristic (10% of cells).",
60
+ };
61
+ const recommendations = cellsPerDayAvg > 100_000
62
+ ? [
63
+ (0, recommendation_js_1.recommendation)({
64
+ type: "retention_optimization",
65
+ severity: "medium",
66
+ confidence: "low",
67
+ scope: input.scope,
68
+ counterId: input.counterId,
69
+ title: "High daily cell churn — review retention rollups",
70
+ explanation: `Observed ~${Math.round(cellsPerDayAvg)} cells/day in the sample window.`,
71
+ evidence: { values: { cellsPerDayAvg, cellCount } },
72
+ suggestedAction: {
73
+ kind: "change_retention",
74
+ payload: { minute: 2, hour: 30, day: ret.day ?? 92 },
75
+ },
76
+ }),
77
+ ]
78
+ : [];
79
+ return {
80
+ observed: {
81
+ sampleDays,
82
+ cellsPerDayAvg,
83
+ cellsPerDayP95,
84
+ dictionaryKeys,
85
+ },
86
+ projected: {
87
+ hotCells,
88
+ durableCells,
89
+ redisBytes,
90
+ mongoBytes,
91
+ dictionaryBytes,
92
+ },
93
+ recommended: {
94
+ redisRamGb: redisBytes / 1024 ** 3,
95
+ mongoDiskGb: mongoBytes / 1024 ** 3,
96
+ workerRamMb: Math.ceil(hotCells / 10_000) * 64,
97
+ },
98
+ assumptions,
99
+ recommendations,
100
+ };
101
+ }
102
+ //# sourceMappingURL=resource-advisor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resource-advisor.js","sourceRoot":"","sources":["../../../src/insights/advisors/resource-advisor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export { runEstimateResourcesFromActuals } from "./resource-advisor.js";
2
+ //# sourceMappingURL=retention-advisor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention-advisor.d.ts","sourceRoot":"","sources":["../../../src/insights/advisors/retention-advisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,6 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runEstimateResourcesFromActuals = void 0;
4
+ var resource_advisor_js_1 = require("./resource-advisor.js");
5
+ Object.defineProperty(exports, "runEstimateResourcesFromActuals", { enumerable: true, get: function () { return resource_advisor_js_1.runEstimateResourcesFromActuals; } });
6
+ //# sourceMappingURL=retention-advisor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retention-advisor.js","sourceRoot":"","sources":["../../../src/insights/advisors/retention-advisor.ts"],"names":[],"mappings":";;;AAAA,6DAAwE;AAA/D,sIAAA,+BAA+B,OAAA"}
@@ -0,0 +1,4 @@
1
+ /** Focused exports for `@x12i/countex/insights/advisors`. */
2
+ export { runAnalyzeMapHealth, cardStatus } from "./advisors/map-health.js";
3
+ export { runEstimateResourcesFromActuals } from "./advisors/resource-advisor.js";
4
+ //# sourceMappingURL=advisors-subpath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"advisors-subpath.d.ts","sourceRoot":"","sources":["../../src/insights/advisors-subpath.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runEstimateResourcesFromActuals = exports.cardStatus = exports.runAnalyzeMapHealth = void 0;
4
+ /** Focused exports for `@x12i/countex/insights/advisors`. */
5
+ var map_health_js_1 = require("./advisors/map-health.js");
6
+ Object.defineProperty(exports, "runAnalyzeMapHealth", { enumerable: true, get: function () { return map_health_js_1.runAnalyzeMapHealth; } });
7
+ Object.defineProperty(exports, "cardStatus", { enumerable: true, get: function () { return map_health_js_1.cardStatus; } });
8
+ var resource_advisor_js_1 = require("./advisors/resource-advisor.js");
9
+ Object.defineProperty(exports, "runEstimateResourcesFromActuals", { enumerable: true, get: function () { return resource_advisor_js_1.runEstimateResourcesFromActuals; } });
10
+ //# sourceMappingURL=advisors-subpath.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"advisors-subpath.js","sourceRoot":"","sources":["../../src/insights/advisors-subpath.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAC7D,0DAA2E;AAAlE,oHAAA,mBAAmB,OAAA;AAAE,2GAAA,UAAU,OAAA;AACxC,sEAAiF;AAAxE,sIAAA,+BAA+B,OAAA"}
@@ -0,0 +1,4 @@
1
+ import type { TimeframeRange, TimeframeType } from "../../types/index.js";
2
+ export declare function parseLookbackToBucketCount(lookback: string | undefined, type: TimeframeType): number;
3
+ export declare function baselineTimeframeBefore(evalTf: TimeframeRange, bucketCount: number): TimeframeRange;
4
+ //# sourceMappingURL=baseline.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/baseline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1E,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAuBpG;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAYnG"}
@@ -0,0 +1,54 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.parseLookbackToBucketCount = parseLookbackToBucketCount;
4
+ exports.baselineTimeframeBefore = baselineTimeframeBefore;
5
+ const timeframe_js_1 = require("../../core/timeframe.js");
6
+ function parseLookbackToBucketCount(lookback, type) {
7
+ if (!lookback)
8
+ return 14;
9
+ const m = /^(\d+)(d|h|w)$/i.exec(lookback.trim());
10
+ if (!m)
11
+ return 14;
12
+ const n = Number(m[1]);
13
+ const u = m[2].toLowerCase();
14
+ if (u === "d") {
15
+ if (type === "day")
16
+ return Math.max(1, n);
17
+ if (type === "hour")
18
+ return Math.max(1, n * 24);
19
+ if (type === "minute")
20
+ return Math.max(1, n * 24 * 60);
21
+ return Math.max(1, n);
22
+ }
23
+ if (u === "h") {
24
+ if (type === "hour")
25
+ return Math.max(1, n);
26
+ if (type === "minute")
27
+ return Math.max(1, n * 60);
28
+ return Math.max(1, n);
29
+ }
30
+ if (u === "w") {
31
+ if (type === "week")
32
+ return Math.max(1, n);
33
+ if (type === "day")
34
+ return Math.max(1, n * 7);
35
+ return Math.max(1, n * 7);
36
+ }
37
+ return 14;
38
+ }
39
+ function baselineTimeframeBefore(evalTf, bucketCount) {
40
+ if (evalTf.type === "all")
41
+ return evalTf;
42
+ const evalBuckets = (0, timeframe_js_1.bucketRange)(evalTf.type, evalTf.from, evalTf.to);
43
+ if (evalBuckets.length === 0)
44
+ return evalTf;
45
+ const first = (0, timeframe_js_1.parseBucket)(evalTf.type, evalBuckets[0]);
46
+ let cursor = first;
47
+ const keys = [];
48
+ for (let i = 0; i < bucketCount; i++) {
49
+ cursor = (0, timeframe_js_1.retreatOne)(evalTf.type, cursor);
50
+ keys.unshift((0, timeframe_js_1.bucketKey)(evalTf.type, cursor));
51
+ }
52
+ return { type: evalTf.type, from: keys[0], to: keys[keys.length - 1] };
53
+ }
54
+ //# sourceMappingURL=baseline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../../src/insights/anomaly/baseline.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { TimeseriesPoint } from "../../types/index.js";
2
+ import type { AnomalyResult, DetectAnomaliesInput } from "../types.js";
3
+ import type { ParsedMeasure } from "../utils/query-builder.js";
4
+ export declare function anomaliesFromTimeseries(evalPts: TimeseriesPoint[], baselinePts: TimeseriesPoint[], parsed: ParsedMeasure, input: DetectAnomaliesInput, minBaselineBuckets: number): AnomalyResult["anomalies"];
5
+ export declare function resolveBaselineTimeframe(input: DetectAnomaliesInput): import("../../types/index.js").TimeframeRange;
6
+ //# sourceMappingURL=detect-anomalies.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detect-anomalies.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/detect-anomalies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA6D/D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EAAE,EAC1B,WAAW,EAAE,eAAe,EAAE,EAC9B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,oBAAoB,EAC3B,kBAAkB,EAAE,MAAM,GACzB,aAAa,CAAC,WAAW,CAAC,CAuL5B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,sBAAsB,EAAE,cAAc,CAGnH"}
@@ -0,0 +1,245 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.anomaliesFromTimeseries = anomaliesFromTimeseries;
4
+ exports.resolveBaselineTimeframe = resolveBaselineTimeframe;
5
+ const stats_js_1 = require("../utils/stats.js");
6
+ const formatting_js_1 = require("../utils/formatting.js");
7
+ const timeframe_js_1 = require("../../core/timeframe.js");
8
+ const baseline_js_1 = require("./baseline.js");
9
+ const missing_activity_js_1 = require("./missing-activity.js");
10
+ function tsValue(pt, parsed) {
11
+ if (parsed.kind === "count")
12
+ return pt.count;
13
+ if (parsed.kind === "rate")
14
+ return pt.rate ?? 0;
15
+ const m = pt.measures?.[parsed.name];
16
+ if (!m)
17
+ return 0;
18
+ switch (parsed.agg) {
19
+ case "sum":
20
+ return m.sum ?? 0;
21
+ case "count":
22
+ return m.count ?? 0;
23
+ case "min":
24
+ return m.min ?? 0;
25
+ case "max":
26
+ return m.max ?? 0;
27
+ case "avg":
28
+ if (m.avg !== undefined)
29
+ return m.avg;
30
+ if (m.sum !== undefined && m.count !== undefined && m.count !== 0)
31
+ return m.sum / m.count;
32
+ return 0;
33
+ default:
34
+ return 0;
35
+ }
36
+ }
37
+ function seriesKey(pt) {
38
+ return (0, formatting_js_1.stableSerializedGroupKeys)(pt.keys);
39
+ }
40
+ function filterBaselineByCompare(pts, evalKey, compareBy, evalTfType) {
41
+ if (compareBy === "same-hour-of-day" && evalTfType !== "all") {
42
+ const evalDate = (0, timeframe_js_1.parseBucket)(evalTfType, evalKey);
43
+ const eh = evalDate.getUTCHours();
44
+ return pts.filter((p) => (0, timeframe_js_1.parseBucket)(evalTfType, p.timeframeKey).getUTCHours() === eh);
45
+ }
46
+ if (compareBy === "same-day-of-week" && evalTfType !== "all") {
47
+ const evalDate = (0, timeframe_js_1.parseBucket)(evalTfType, evalKey);
48
+ const ed = evalDate.getUTCDay();
49
+ return pts.filter((p) => (0, timeframe_js_1.parseBucket)(evalTfType, p.timeframeKey).getUTCDay() === ed);
50
+ }
51
+ return pts;
52
+ }
53
+ function severityFromZ(z, threshold) {
54
+ const a = Math.abs(z);
55
+ if (a >= threshold + 2)
56
+ return "critical";
57
+ if (a >= threshold + 1)
58
+ return "high";
59
+ if (a >= threshold)
60
+ return "medium";
61
+ return "low";
62
+ }
63
+ function anomaliesFromTimeseries(evalPts, baselinePts, parsed, input, minBaselineBuckets) {
64
+ const method = input.method ?? "robust-zscore";
65
+ const sensitivity = input.sensitivity ?? "medium";
66
+ const threshold = (0, stats_js_1.zScoreThreshold)(sensitivity);
67
+ const compareBy = input.baseline?.compareBy ?? "rolling";
68
+ const types = input.anomalyTypes ?? ["spike", "drop", "missing"];
69
+ const minExpected = sensitivity === "high" ? 1 : sensitivity === "medium" ? 5 : 10;
70
+ const evalClusters = new Map();
71
+ for (const p of evalPts) {
72
+ const k = seriesKey(p);
73
+ const arr = evalClusters.get(k) ?? [];
74
+ arr.push(p);
75
+ evalClusters.set(k, arr);
76
+ }
77
+ const baselineClusters = new Map();
78
+ for (const p of baselinePts) {
79
+ const k = seriesKey(p);
80
+ const arr = baselineClusters.get(k) ?? [];
81
+ arr.push(p);
82
+ baselineClusters.set(k, arr);
83
+ }
84
+ const out = [];
85
+ for (const [keyStr, series] of evalClusters) {
86
+ series.sort((a, b) => (a.timeframeKey < b.timeframeKey ? -1 : 1));
87
+ const baseRaw = baselineClusters.get(keyStr) ?? [];
88
+ for (const pt of series) {
89
+ const observed = tsValue(pt, parsed);
90
+ const pool = filterBaselineByCompare(baseRaw, pt.timeframeKey, compareBy, input.timeframe.type).map((p) => tsValue(p, parsed));
91
+ if (pool.length < minBaselineBuckets)
92
+ continue;
93
+ if (method === "robust-zscore" || method === "zscore") {
94
+ let z;
95
+ let median;
96
+ let mad = 0;
97
+ let mean = 0;
98
+ let stddev = 0;
99
+ if (method === "robust-zscore") {
100
+ const r = (0, stats_js_1.robustZScore)(observed, pool);
101
+ z = r.z;
102
+ median = r.median;
103
+ mad = r.mad;
104
+ }
105
+ else {
106
+ mean = pool.reduce((a, b) => a + b, 0) / pool.length;
107
+ stddev = Math.sqrt(pool.reduce((s, x) => s + (x - mean) ** 2, 0) / pool.length);
108
+ z = stddev === 0 ? (observed === mean ? 0 : Number.POSITIVE_INFINITY) : (observed - mean) / stddev;
109
+ median = mean;
110
+ }
111
+ if (types.includes("missing") && (0, missing_activity_js_1.isMissingActivity)(observed, (0, stats_js_1.medianUnsorted)(pool), minExpected)) {
112
+ out.push({
113
+ type: "missing",
114
+ severity: "high",
115
+ keys: (pt.keys ?? {}),
116
+ timeframeKey: pt.timeframeKey,
117
+ observed,
118
+ expected: median,
119
+ baseline: {
120
+ median,
121
+ mean: method === "zscore" ? mean : undefined,
122
+ stddev: method === "zscore" ? stddev : undefined,
123
+ mad: method === "robust-zscore" ? mad : undefined,
124
+ bucketCount: pool.length,
125
+ },
126
+ score: z,
127
+ explanation: `Activity near zero while baseline median is ${median.toFixed(2)}.`,
128
+ });
129
+ continue;
130
+ }
131
+ if (mad === 0 && method === "robust-zscore" && Math.abs(observed - median) > minExpected) {
132
+ const sev = Math.abs(observed - median) > median * 2 ? "high" : "medium";
133
+ if (observed > median && types.includes("spike")) {
134
+ out.push({
135
+ type: "spike",
136
+ severity: sev,
137
+ keys: (pt.keys ?? {}),
138
+ timeframeKey: pt.timeframeKey,
139
+ observed,
140
+ expected: median,
141
+ baseline: { median, mad: 0, bucketCount: pool.length },
142
+ explanation: `Observed ${observed} vs baseline median ${median} (MAD=0 fallback).`,
143
+ });
144
+ }
145
+ else if (observed < median && types.includes("drop")) {
146
+ out.push({
147
+ type: "drop",
148
+ severity: sev,
149
+ keys: (pt.keys ?? {}),
150
+ timeframeKey: pt.timeframeKey,
151
+ observed,
152
+ expected: median,
153
+ baseline: { median, mad: 0, bucketCount: pool.length },
154
+ explanation: `Observed ${observed} vs baseline median ${median} (MAD=0 fallback).`,
155
+ });
156
+ }
157
+ continue;
158
+ }
159
+ if (Math.abs(z) >= threshold) {
160
+ const ty = z > 0 ? "spike" : "drop";
161
+ if (!types.includes(ty))
162
+ continue;
163
+ out.push({
164
+ type: ty,
165
+ severity: severityFromZ(z, threshold),
166
+ keys: (pt.keys ?? {}),
167
+ timeframeKey: pt.timeframeKey,
168
+ observed,
169
+ expected: median,
170
+ baseline: {
171
+ median,
172
+ mean: method === "zscore" ? mean : undefined,
173
+ stddev: method === "zscore" ? stddev : undefined,
174
+ mad: method === "robust-zscore" ? mad : undefined,
175
+ bucketCount: pool.length,
176
+ },
177
+ score: z,
178
+ explanation: `${ty === "spike" ? "Elevated" : "Reduced"} value (score ${z.toFixed(2)}) vs baseline of ${pool.length} buckets.`,
179
+ });
180
+ }
181
+ }
182
+ else if (method === "threshold") {
183
+ const med = (0, stats_js_1.medianUnsorted)(pool);
184
+ if (types.includes("missing") && (0, missing_activity_js_1.isMissingActivity)(observed, med, minExpected)) {
185
+ out.push({
186
+ type: "missing",
187
+ severity: "high",
188
+ keys: (pt.keys ?? {}),
189
+ timeframeKey: pt.timeframeKey,
190
+ observed,
191
+ expected: med,
192
+ baseline: { median: med, bucketCount: pool.length },
193
+ explanation: `Activity near zero while baseline median is ${med.toFixed(2)}.`,
194
+ });
195
+ }
196
+ else if (types.includes("spike") && observed > med * 2) {
197
+ out.push({
198
+ type: "spike",
199
+ severity: "medium",
200
+ keys: (pt.keys ?? {}),
201
+ timeframeKey: pt.timeframeKey,
202
+ observed,
203
+ expected: med,
204
+ baseline: { median: med, bucketCount: pool.length },
205
+ explanation: `Observed ${observed} exceeds 2× baseline median ${med.toFixed(2)}.`,
206
+ });
207
+ }
208
+ else if (types.includes("drop") && observed < med * 0.5) {
209
+ out.push({
210
+ type: "drop",
211
+ severity: "medium",
212
+ keys: (pt.keys ?? {}),
213
+ timeframeKey: pt.timeframeKey,
214
+ observed,
215
+ expected: med,
216
+ baseline: { median: med, bucketCount: pool.length },
217
+ explanation: `Observed ${observed} below 0.5× baseline median ${med.toFixed(2)}.`,
218
+ });
219
+ }
220
+ }
221
+ else if (method === "ewma") {
222
+ const med = (0, stats_js_1.medianUnsorted)(pool);
223
+ const deviation = Math.abs(observed - med);
224
+ if (deviation > Math.max(med * 0.5, minExpected) && types.includes("spike") && observed > med) {
225
+ out.push({
226
+ type: "spike",
227
+ severity: "medium",
228
+ keys: (pt.keys ?? {}),
229
+ timeframeKey: pt.timeframeKey,
230
+ observed,
231
+ expected: med,
232
+ baseline: { median: med, bucketCount: pool.length },
233
+ explanation: `EWMA-style check: large deviation from baseline median.`,
234
+ });
235
+ }
236
+ }
237
+ }
238
+ }
239
+ return out;
240
+ }
241
+ function resolveBaselineTimeframe(input) {
242
+ const n = (0, baseline_js_1.parseLookbackToBucketCount)(input.baseline?.lookback, input.timeframe.type);
243
+ return (0, baseline_js_1.baselineTimeframeBefore)(input.timeframe, n);
244
+ }
245
+ //# sourceMappingURL=detect-anomalies.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detect-anomalies.js","sourceRoot":"","sources":["../../../src/insights/anomaly/detect-anomalies.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function ewma(series: number[], alpha: number): number[];
2
+ //# sourceMappingURL=ewma.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ewma.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/ewma.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D"}
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ewma = ewma;
4
+ function ewma(series, alpha) {
5
+ if (series.length === 0)
6
+ return [];
7
+ const out = [];
8
+ let e = series[0];
9
+ for (const x of series) {
10
+ e = alpha * x + (1 - alpha) * e;
11
+ out.push(e);
12
+ }
13
+ return out;
14
+ }
15
+ //# sourceMappingURL=ewma.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ewma.js","sourceRoot":"","sources":["../../../src/insights/anomaly/ewma.ts"],"names":[],"mappings":";;AAAA,oBASC;AATD,SAAgB,IAAI,CAAC,MAAgB,EAAE,KAAa;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** Heuristic: baseline median above floor while observed is near zero. */
2
+ export declare function isMissingActivity(observed: number, baselineMedian: number, minExpected: number): boolean;
3
+ //# sourceMappingURL=missing-activity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"missing-activity.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/missing-activity.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAET"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isMissingActivity = isMissingActivity;
4
+ /** Heuristic: baseline median above floor while observed is near zero. */
5
+ function isMissingActivity(observed, baselineMedian, minExpected) {
6
+ return baselineMedian >= minExpected && observed <= minExpected * 0.05;
7
+ }
8
+ //# sourceMappingURL=missing-activity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"missing-activity.js","sourceRoot":"","sources":["../../../src/insights/anomaly/missing-activity.ts"],"names":[],"mappings":";;AACA,8CAMC;AAPD,0EAA0E;AAC1E,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,cAAsB,EACtB,WAAmB;IAEnB,OAAO,cAAc,IAAI,WAAW,IAAI,QAAQ,IAAI,WAAW,GAAG,IAAI,CAAC;AACzE,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { robustZScore, zScoreThreshold, medianUnsorted, madFromMedian } from "../utils/stats.js";
2
+ //# sourceMappingURL=robust-zscore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"robust-zscore.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/robust-zscore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.madFromMedian = exports.medianUnsorted = exports.zScoreThreshold = exports.robustZScore = void 0;
4
+ var stats_js_1 = require("../utils/stats.js");
5
+ Object.defineProperty(exports, "robustZScore", { enumerable: true, get: function () { return stats_js_1.robustZScore; } });
6
+ Object.defineProperty(exports, "zScoreThreshold", { enumerable: true, get: function () { return stats_js_1.zScoreThreshold; } });
7
+ Object.defineProperty(exports, "medianUnsorted", { enumerable: true, get: function () { return stats_js_1.medianUnsorted; } });
8
+ Object.defineProperty(exports, "madFromMedian", { enumerable: true, get: function () { return stats_js_1.madFromMedian; } });
9
+ //# sourceMappingURL=robust-zscore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"robust-zscore.js","sourceRoot":"","sources":["../../../src/insights/anomaly/robust-zscore.ts"],"names":[],"mappings":";;;AAAA,8CAAiG;AAAxF,wGAAA,YAAY,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA"}
@@ -0,0 +1,7 @@
1
+ /** Focused exports for `@x12i/countex/insights/anomaly`. */
2
+ export { anomaliesFromTimeseries, resolveBaselineTimeframe } from "./anomaly/detect-anomalies.js";
3
+ export { baselineTimeframeBefore, parseLookbackToBucketCount } from "./anomaly/baseline.js";
4
+ export { robustZScore, zScoreThreshold, medianUnsorted, madFromMedian } from "./utils/stats.js";
5
+ export { ewma } from "./anomaly/ewma.js";
6
+ export { isMissingActivity } from "./anomaly/missing-activity.js";
7
+ //# sourceMappingURL=anomaly-subpath.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anomaly-subpath.d.ts","sourceRoot":"","sources":["../../src/insights/anomaly-subpath.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isMissingActivity = exports.ewma = exports.madFromMedian = exports.medianUnsorted = exports.zScoreThreshold = exports.robustZScore = exports.parseLookbackToBucketCount = exports.baselineTimeframeBefore = exports.resolveBaselineTimeframe = exports.anomaliesFromTimeseries = void 0;
4
+ /** Focused exports for `@x12i/countex/insights/anomaly`. */
5
+ var detect_anomalies_js_1 = require("./anomaly/detect-anomalies.js");
6
+ Object.defineProperty(exports, "anomaliesFromTimeseries", { enumerable: true, get: function () { return detect_anomalies_js_1.anomaliesFromTimeseries; } });
7
+ Object.defineProperty(exports, "resolveBaselineTimeframe", { enumerable: true, get: function () { return detect_anomalies_js_1.resolveBaselineTimeframe; } });
8
+ var baseline_js_1 = require("./anomaly/baseline.js");
9
+ Object.defineProperty(exports, "baselineTimeframeBefore", { enumerable: true, get: function () { return baseline_js_1.baselineTimeframeBefore; } });
10
+ Object.defineProperty(exports, "parseLookbackToBucketCount", { enumerable: true, get: function () { return baseline_js_1.parseLookbackToBucketCount; } });
11
+ var stats_js_1 = require("./utils/stats.js");
12
+ Object.defineProperty(exports, "robustZScore", { enumerable: true, get: function () { return stats_js_1.robustZScore; } });
13
+ Object.defineProperty(exports, "zScoreThreshold", { enumerable: true, get: function () { return stats_js_1.zScoreThreshold; } });
14
+ Object.defineProperty(exports, "medianUnsorted", { enumerable: true, get: function () { return stats_js_1.medianUnsorted; } });
15
+ Object.defineProperty(exports, "madFromMedian", { enumerable: true, get: function () { return stats_js_1.madFromMedian; } });
16
+ var ewma_js_1 = require("./anomaly/ewma.js");
17
+ Object.defineProperty(exports, "ewma", { enumerable: true, get: function () { return ewma_js_1.ewma; } });
18
+ var missing_activity_js_1 = require("./anomaly/missing-activity.js");
19
+ Object.defineProperty(exports, "isMissingActivity", { enumerable: true, get: function () { return missing_activity_js_1.isMissingActivity; } });
20
+ //# sourceMappingURL=anomaly-subpath.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"anomaly-subpath.js","sourceRoot":"","sources":["../../src/insights/anomaly-subpath.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC5D,qEAAkG;AAAzF,8HAAA,uBAAuB,OAAA;AAAE,+HAAA,wBAAwB,OAAA;AAC1D,qDAA4F;AAAnF,sHAAA,uBAAuB,OAAA;AAAE,yHAAA,0BAA0B,OAAA;AAC5D,6CAAgG;AAAvF,wGAAA,YAAY,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AACrE,6CAAyC;AAAhC,+FAAA,IAAI,OAAA;AACb,qEAAkE;AAAzD,wHAAA,iBAAiB,OAAA"}
@@ -0,0 +1,5 @@
1
+ import type { QueryRow } from "../../types/index.js";
2
+ import type { ComparePeriodsResult } from "../types.js";
3
+ import type { ParsedMeasure } from "../utils/query-builder.js";
4
+ export declare function mergeComparePeriods(currentRows: QueryRow[], previousRows: QueryRow[], parsed: ParsedMeasure, minAbs?: number, minPct?: number): ComparePeriodsResult["rows"];
5
+ //# sourceMappingURL=compare-periods.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compare-periods.d.ts","sourceRoot":"","sources":["../../../src/insights/comparison/compare-periods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAW/D,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,QAAQ,EAAE,EACvB,YAAY,EAAE,QAAQ,EAAE,EACxB,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAAC,MAAM,CAAC,CA+C9B"}