@peakinfer/cli 1.0.133

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 (367) hide show
  1. package/.claude/settings.local.json +8 -0
  2. package/.env.example +6 -0
  3. package/.github/workflows/peakinfer.yml +64 -0
  4. package/CHANGELOG.md +31 -0
  5. package/LICENSE +190 -0
  6. package/README.md +335 -0
  7. package/data/inferencemax.json +274 -0
  8. package/dist/agent-analyzer.d.ts +45 -0
  9. package/dist/agent-analyzer.d.ts.map +1 -0
  10. package/dist/agent-analyzer.js +374 -0
  11. package/dist/agent-analyzer.js.map +1 -0
  12. package/dist/agent.d.ts +76 -0
  13. package/dist/agent.d.ts.map +1 -0
  14. package/dist/agent.js +965 -0
  15. package/dist/agent.js.map +1 -0
  16. package/dist/agents/correlation-analyzer.d.ts +34 -0
  17. package/dist/agents/correlation-analyzer.d.ts.map +1 -0
  18. package/dist/agents/correlation-analyzer.js +261 -0
  19. package/dist/agents/correlation-analyzer.js.map +1 -0
  20. package/dist/agents/index.d.ts +91 -0
  21. package/dist/agents/index.d.ts.map +1 -0
  22. package/dist/agents/index.js +111 -0
  23. package/dist/agents/index.js.map +1 -0
  24. package/dist/agents/runtime-analyzer.d.ts +38 -0
  25. package/dist/agents/runtime-analyzer.d.ts.map +1 -0
  26. package/dist/agents/runtime-analyzer.js +244 -0
  27. package/dist/agents/runtime-analyzer.js.map +1 -0
  28. package/dist/analysis-types.d.ts +500 -0
  29. package/dist/analysis-types.d.ts.map +1 -0
  30. package/dist/analysis-types.js +11 -0
  31. package/dist/analysis-types.js.map +1 -0
  32. package/dist/analytics.d.ts +25 -0
  33. package/dist/analytics.d.ts.map +1 -0
  34. package/dist/analytics.js +94 -0
  35. package/dist/analytics.js.map +1 -0
  36. package/dist/analyzer.d.ts +48 -0
  37. package/dist/analyzer.d.ts.map +1 -0
  38. package/dist/analyzer.js +547 -0
  39. package/dist/analyzer.js.map +1 -0
  40. package/dist/artifacts.d.ts +44 -0
  41. package/dist/artifacts.d.ts.map +1 -0
  42. package/dist/artifacts.js +165 -0
  43. package/dist/artifacts.js.map +1 -0
  44. package/dist/benchmarks/index.d.ts +88 -0
  45. package/dist/benchmarks/index.d.ts.map +1 -0
  46. package/dist/benchmarks/index.js +205 -0
  47. package/dist/benchmarks/index.js.map +1 -0
  48. package/dist/cli.d.ts +3 -0
  49. package/dist/cli.d.ts.map +1 -0
  50. package/dist/cli.js +427 -0
  51. package/dist/cli.js.map +1 -0
  52. package/dist/commands/ci.d.ts +19 -0
  53. package/dist/commands/ci.d.ts.map +1 -0
  54. package/dist/commands/ci.js +253 -0
  55. package/dist/commands/ci.js.map +1 -0
  56. package/dist/commands/config.d.ts +16 -0
  57. package/dist/commands/config.d.ts.map +1 -0
  58. package/dist/commands/config.js +249 -0
  59. package/dist/commands/config.js.map +1 -0
  60. package/dist/commands/demo.d.ts +15 -0
  61. package/dist/commands/demo.d.ts.map +1 -0
  62. package/dist/commands/demo.js +106 -0
  63. package/dist/commands/demo.js.map +1 -0
  64. package/dist/commands/export.d.ts +14 -0
  65. package/dist/commands/export.d.ts.map +1 -0
  66. package/dist/commands/export.js +209 -0
  67. package/dist/commands/export.js.map +1 -0
  68. package/dist/commands/history.d.ts +15 -0
  69. package/dist/commands/history.d.ts.map +1 -0
  70. package/dist/commands/history.js +389 -0
  71. package/dist/commands/history.js.map +1 -0
  72. package/dist/commands/template.d.ts +14 -0
  73. package/dist/commands/template.d.ts.map +1 -0
  74. package/dist/commands/template.js +341 -0
  75. package/dist/commands/template.js.map +1 -0
  76. package/dist/commands/validate-map.d.ts +12 -0
  77. package/dist/commands/validate-map.d.ts.map +1 -0
  78. package/dist/commands/validate-map.js +274 -0
  79. package/dist/commands/validate-map.js.map +1 -0
  80. package/dist/commands/whatif.d.ts +17 -0
  81. package/dist/commands/whatif.d.ts.map +1 -0
  82. package/dist/commands/whatif.js +206 -0
  83. package/dist/commands/whatif.js.map +1 -0
  84. package/dist/comparison.d.ts +38 -0
  85. package/dist/comparison.d.ts.map +1 -0
  86. package/dist/comparison.js +223 -0
  87. package/dist/comparison.js.map +1 -0
  88. package/dist/config.d.ts +42 -0
  89. package/dist/config.d.ts.map +1 -0
  90. package/dist/config.js +158 -0
  91. package/dist/config.js.map +1 -0
  92. package/dist/connectors/helicone.d.ts +9 -0
  93. package/dist/connectors/helicone.d.ts.map +1 -0
  94. package/dist/connectors/helicone.js +106 -0
  95. package/dist/connectors/helicone.js.map +1 -0
  96. package/dist/connectors/index.d.ts +37 -0
  97. package/dist/connectors/index.d.ts.map +1 -0
  98. package/dist/connectors/index.js +65 -0
  99. package/dist/connectors/index.js.map +1 -0
  100. package/dist/connectors/langsmith.d.ts +9 -0
  101. package/dist/connectors/langsmith.d.ts.map +1 -0
  102. package/dist/connectors/langsmith.js +122 -0
  103. package/dist/connectors/langsmith.js.map +1 -0
  104. package/dist/connectors/types.d.ts +83 -0
  105. package/dist/connectors/types.d.ts.map +1 -0
  106. package/dist/connectors/types.js +98 -0
  107. package/dist/connectors/types.js.map +1 -0
  108. package/dist/cost-estimator.d.ts +46 -0
  109. package/dist/cost-estimator.d.ts.map +1 -0
  110. package/dist/cost-estimator.js +104 -0
  111. package/dist/cost-estimator.js.map +1 -0
  112. package/dist/costs.d.ts +57 -0
  113. package/dist/costs.d.ts.map +1 -0
  114. package/dist/costs.js +251 -0
  115. package/dist/costs.js.map +1 -0
  116. package/dist/counterfactuals.d.ts +29 -0
  117. package/dist/counterfactuals.d.ts.map +1 -0
  118. package/dist/counterfactuals.js +448 -0
  119. package/dist/counterfactuals.js.map +1 -0
  120. package/dist/enhancement-prompts.d.ts +41 -0
  121. package/dist/enhancement-prompts.d.ts.map +1 -0
  122. package/dist/enhancement-prompts.js +88 -0
  123. package/dist/enhancement-prompts.js.map +1 -0
  124. package/dist/envelopes.d.ts +20 -0
  125. package/dist/envelopes.d.ts.map +1 -0
  126. package/dist/envelopes.js +790 -0
  127. package/dist/envelopes.js.map +1 -0
  128. package/dist/format-normalizer.d.ts +71 -0
  129. package/dist/format-normalizer.d.ts.map +1 -0
  130. package/dist/format-normalizer.js +1331 -0
  131. package/dist/format-normalizer.js.map +1 -0
  132. package/dist/history.d.ts +79 -0
  133. package/dist/history.d.ts.map +1 -0
  134. package/dist/history.js +313 -0
  135. package/dist/history.js.map +1 -0
  136. package/dist/html.d.ts +11 -0
  137. package/dist/html.d.ts.map +1 -0
  138. package/dist/html.js +463 -0
  139. package/dist/html.js.map +1 -0
  140. package/dist/impact.d.ts +42 -0
  141. package/dist/impact.d.ts.map +1 -0
  142. package/dist/impact.js +443 -0
  143. package/dist/impact.js.map +1 -0
  144. package/dist/index.d.ts +26 -0
  145. package/dist/index.d.ts.map +1 -0
  146. package/dist/index.js +34 -0
  147. package/dist/index.js.map +1 -0
  148. package/dist/insights.d.ts +5 -0
  149. package/dist/insights.d.ts.map +1 -0
  150. package/dist/insights.js +271 -0
  151. package/dist/insights.js.map +1 -0
  152. package/dist/joiner.d.ts +9 -0
  153. package/dist/joiner.d.ts.map +1 -0
  154. package/dist/joiner.js +247 -0
  155. package/dist/joiner.js.map +1 -0
  156. package/dist/orchestrator.d.ts +34 -0
  157. package/dist/orchestrator.d.ts.map +1 -0
  158. package/dist/orchestrator.js +827 -0
  159. package/dist/orchestrator.js.map +1 -0
  160. package/dist/pdf.d.ts +26 -0
  161. package/dist/pdf.d.ts.map +1 -0
  162. package/dist/pdf.js +84 -0
  163. package/dist/pdf.js.map +1 -0
  164. package/dist/prediction.d.ts +33 -0
  165. package/dist/prediction.d.ts.map +1 -0
  166. package/dist/prediction.js +316 -0
  167. package/dist/prediction.js.map +1 -0
  168. package/dist/prompts/loader.d.ts +38 -0
  169. package/dist/prompts/loader.d.ts.map +1 -0
  170. package/dist/prompts/loader.js +60 -0
  171. package/dist/prompts/loader.js.map +1 -0
  172. package/dist/renderer.d.ts +64 -0
  173. package/dist/renderer.d.ts.map +1 -0
  174. package/dist/renderer.js +923 -0
  175. package/dist/renderer.js.map +1 -0
  176. package/dist/runid.d.ts +57 -0
  177. package/dist/runid.d.ts.map +1 -0
  178. package/dist/runid.js +199 -0
  179. package/dist/runid.js.map +1 -0
  180. package/dist/runtime.d.ts +29 -0
  181. package/dist/runtime.d.ts.map +1 -0
  182. package/dist/runtime.js +366 -0
  183. package/dist/runtime.js.map +1 -0
  184. package/dist/scanner.d.ts +11 -0
  185. package/dist/scanner.d.ts.map +1 -0
  186. package/dist/scanner.js +426 -0
  187. package/dist/scanner.js.map +1 -0
  188. package/dist/templates.d.ts +120 -0
  189. package/dist/templates.d.ts.map +1 -0
  190. package/dist/templates.js +429 -0
  191. package/dist/templates.js.map +1 -0
  192. package/dist/tools/index.d.ts +153 -0
  193. package/dist/tools/index.d.ts.map +1 -0
  194. package/dist/tools/index.js +177 -0
  195. package/dist/tools/index.js.map +1 -0
  196. package/dist/types.d.ts +3647 -0
  197. package/dist/types.d.ts.map +1 -0
  198. package/dist/types.js +703 -0
  199. package/dist/types.js.map +1 -0
  200. package/dist/version.d.ts +7 -0
  201. package/dist/version.d.ts.map +1 -0
  202. package/dist/version.js +23 -0
  203. package/dist/version.js.map +1 -0
  204. package/docs/demo-guide.md +423 -0
  205. package/docs/events-format.md +295 -0
  206. package/docs/inferencemap-spec.md +344 -0
  207. package/docs/migration-v2.md +293 -0
  208. package/fixtures/demo/precomputed.json +142 -0
  209. package/fixtures/demo-project/README.md +52 -0
  210. package/fixtures/demo-project/ai-service.ts +65 -0
  211. package/fixtures/demo-project/sample-events.jsonl +15 -0
  212. package/fixtures/demo-project/src/ai-service.ts +128 -0
  213. package/fixtures/demo-project/src/llm-client.ts +155 -0
  214. package/package.json +65 -0
  215. package/prompts/agent-analyzer.yaml +47 -0
  216. package/prompts/ci-gate.yaml +98 -0
  217. package/prompts/correlation-analyzer.yaml +178 -0
  218. package/prompts/format-normalizer.yaml +46 -0
  219. package/prompts/peak-performance.yaml +180 -0
  220. package/prompts/pr-comment.yaml +111 -0
  221. package/prompts/runtime-analyzer.yaml +189 -0
  222. package/prompts/unified-analyzer.yaml +241 -0
  223. package/schemas/inference-map.v0.1.json +215 -0
  224. package/scripts/benchmark.ts +394 -0
  225. package/scripts/demo-v1.5.sh +158 -0
  226. package/scripts/sync-from-site.sh +197 -0
  227. package/scripts/validate-sync.sh +178 -0
  228. package/src/agent-analyzer.ts +481 -0
  229. package/src/agent.ts +1232 -0
  230. package/src/agents/correlation-analyzer.ts +353 -0
  231. package/src/agents/index.ts +235 -0
  232. package/src/agents/runtime-analyzer.ts +343 -0
  233. package/src/analysis-types.ts +558 -0
  234. package/src/analytics.ts +100 -0
  235. package/src/analyzer.ts +692 -0
  236. package/src/artifacts.ts +218 -0
  237. package/src/benchmarks/index.ts +309 -0
  238. package/src/cli.ts +503 -0
  239. package/src/commands/ci.ts +336 -0
  240. package/src/commands/config.ts +288 -0
  241. package/src/commands/demo.ts +175 -0
  242. package/src/commands/export.ts +297 -0
  243. package/src/commands/history.ts +425 -0
  244. package/src/commands/template.ts +385 -0
  245. package/src/commands/validate-map.ts +324 -0
  246. package/src/commands/whatif.ts +272 -0
  247. package/src/comparison.ts +283 -0
  248. package/src/config.ts +188 -0
  249. package/src/connectors/helicone.ts +164 -0
  250. package/src/connectors/index.ts +93 -0
  251. package/src/connectors/langsmith.ts +179 -0
  252. package/src/connectors/types.ts +180 -0
  253. package/src/cost-estimator.ts +146 -0
  254. package/src/costs.ts +347 -0
  255. package/src/counterfactuals.ts +516 -0
  256. package/src/enhancement-prompts.ts +118 -0
  257. package/src/envelopes.ts +814 -0
  258. package/src/format-normalizer.ts +1486 -0
  259. package/src/history.ts +400 -0
  260. package/src/html.ts +512 -0
  261. package/src/impact.ts +522 -0
  262. package/src/index.ts +83 -0
  263. package/src/insights.ts +341 -0
  264. package/src/joiner.ts +289 -0
  265. package/src/orchestrator.ts +1015 -0
  266. package/src/pdf.ts +110 -0
  267. package/src/prediction.ts +392 -0
  268. package/src/prompts/loader.ts +88 -0
  269. package/src/renderer.ts +1045 -0
  270. package/src/runid.ts +261 -0
  271. package/src/runtime.ts +450 -0
  272. package/src/scanner.ts +508 -0
  273. package/src/templates.ts +561 -0
  274. package/src/tools/index.ts +214 -0
  275. package/src/types.ts +873 -0
  276. package/src/version.ts +24 -0
  277. package/templates/context-accumulation.yaml +23 -0
  278. package/templates/cost-concentration.yaml +20 -0
  279. package/templates/dead-code.yaml +20 -0
  280. package/templates/latency-explainer.yaml +23 -0
  281. package/templates/optimizations/ab-testing-framework.yaml +74 -0
  282. package/templates/optimizations/api-gateway-optimization.yaml +81 -0
  283. package/templates/optimizations/api-model-routing-strategy.yaml +126 -0
  284. package/templates/optimizations/auto-scaling-optimization.yaml +85 -0
  285. package/templates/optimizations/batch-utilization-diagnostic.yaml +142 -0
  286. package/templates/optimizations/comprehensive-apm.yaml +76 -0
  287. package/templates/optimizations/context-window-optimization.yaml +91 -0
  288. package/templates/optimizations/cost-sensitive-batch-processing.yaml +77 -0
  289. package/templates/optimizations/distributed-training-optimization.yaml +77 -0
  290. package/templates/optimizations/document-analysis-edge.yaml +77 -0
  291. package/templates/optimizations/document-pipeline-optimization.yaml +78 -0
  292. package/templates/optimizations/domain-specific-distillation.yaml +78 -0
  293. package/templates/optimizations/error-handling-optimization.yaml +76 -0
  294. package/templates/optimizations/gptq-4bit-quantization.yaml +96 -0
  295. package/templates/optimizations/long-context-memory-management.yaml +78 -0
  296. package/templates/optimizations/max-tokens-optimization.yaml +76 -0
  297. package/templates/optimizations/memory-bandwidth-optimization.yaml +73 -0
  298. package/templates/optimizations/multi-framework-resilience.yaml +75 -0
  299. package/templates/optimizations/multi-tenant-optimization.yaml +75 -0
  300. package/templates/optimizations/prompt-caching-optimization.yaml +143 -0
  301. package/templates/optimizations/pytorch-to-onnx-migration.yaml +109 -0
  302. package/templates/optimizations/quality-monitoring.yaml +74 -0
  303. package/templates/optimizations/realtime-budget-controls.yaml +74 -0
  304. package/templates/optimizations/realtime-latency-optimization.yaml +74 -0
  305. package/templates/optimizations/sglang-concurrency-optimization.yaml +78 -0
  306. package/templates/optimizations/smart-model-routing.yaml +96 -0
  307. package/templates/optimizations/streaming-batch-selection.yaml +167 -0
  308. package/templates/optimizations/system-prompt-optimization.yaml +75 -0
  309. package/templates/optimizations/tensorrt-llm-performance.yaml +77 -0
  310. package/templates/optimizations/vllm-high-throughput-optimization.yaml +93 -0
  311. package/templates/optimizations/vllm-migration-memory-bound.yaml +78 -0
  312. package/templates/overpowered-extraction.yaml +32 -0
  313. package/templates/overpowered-model.yaml +31 -0
  314. package/templates/prompt-bloat.yaml +24 -0
  315. package/templates/retry-explosion.yaml +28 -0
  316. package/templates/schema/insight.schema.json +113 -0
  317. package/templates/schema/optimization.schema.json +180 -0
  318. package/templates/streaming-drift.yaml +30 -0
  319. package/templates/throughput-gap.yaml +21 -0
  320. package/templates/token-underutilization.yaml +28 -0
  321. package/templates/untested-fallback.yaml +21 -0
  322. package/tests/accuracy/drift-detection.test.ts +184 -0
  323. package/tests/accuracy/false-positives.test.ts +166 -0
  324. package/tests/accuracy/templates.test.ts +205 -0
  325. package/tests/action/commands.test.ts +125 -0
  326. package/tests/action/comments.test.ts +347 -0
  327. package/tests/cli.test.ts +203 -0
  328. package/tests/comparison.test.ts +309 -0
  329. package/tests/correlation-analyzer.test.ts +534 -0
  330. package/tests/counterfactuals.test.ts +347 -0
  331. package/tests/fixtures/events/missing-id.jsonl +1 -0
  332. package/tests/fixtures/events/missing-input.jsonl +1 -0
  333. package/tests/fixtures/events/missing-latency.jsonl +1 -0
  334. package/tests/fixtures/events/missing-model.jsonl +1 -0
  335. package/tests/fixtures/events/missing-output.jsonl +1 -0
  336. package/tests/fixtures/events/missing-provider.jsonl +1 -0
  337. package/tests/fixtures/events/missing-ts.jsonl +1 -0
  338. package/tests/fixtures/events/valid.csv +3 -0
  339. package/tests/fixtures/events/valid.json +1 -0
  340. package/tests/fixtures/events/valid.jsonl +2 -0
  341. package/tests/fixtures/events/with-callsite.jsonl +1 -0
  342. package/tests/fixtures/events/with-intent.jsonl +1 -0
  343. package/tests/fixtures/events/wrong-type.jsonl +1 -0
  344. package/tests/fixtures/repos/empty/.gitkeep +0 -0
  345. package/tests/fixtures/repos/hybrid-router/router.py +35 -0
  346. package/tests/fixtures/repos/saas-anthropic/agent.ts +27 -0
  347. package/tests/fixtures/repos/saas-openai/assistant.js +33 -0
  348. package/tests/fixtures/repos/saas-openai/client.py +26 -0
  349. package/tests/fixtures/repos/self-hosted-vllm/inference.py +22 -0
  350. package/tests/github-action.test.ts +292 -0
  351. package/tests/insights.test.ts +878 -0
  352. package/tests/joiner.test.ts +168 -0
  353. package/tests/performance/action-latency.test.ts +132 -0
  354. package/tests/performance/benchmark.test.ts +189 -0
  355. package/tests/performance/cli-latency.test.ts +102 -0
  356. package/tests/pr-comment.test.ts +313 -0
  357. package/tests/prediction.test.ts +296 -0
  358. package/tests/runtime-analyzer.test.ts +375 -0
  359. package/tests/runtime.test.ts +205 -0
  360. package/tests/scanner.test.ts +122 -0
  361. package/tests/template-conformance.test.ts +526 -0
  362. package/tests/unit/cost-calculator.test.ts +303 -0
  363. package/tests/unit/credits.test.ts +180 -0
  364. package/tests/unit/inference-map.test.ts +276 -0
  365. package/tests/unit/schema.test.ts +300 -0
  366. package/tsconfig.json +20 -0
  367. package/vitest.config.ts +14 -0
@@ -0,0 +1,309 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import {
3
+ compareSnapshots,
4
+ formatComparisonSummary,
5
+ hasSignificantChanges,
6
+ type AnalysisSnapshot,
7
+ } from '../src/comparison.js';
8
+ import type { Callsite, Insight } from '../src/types.js';
9
+
10
+ // =============================================================================
11
+ // TEST FIXTURES
12
+ // =============================================================================
13
+
14
+ function createCallsite(overrides: Partial<Callsite> = {}): Callsite {
15
+ return {
16
+ id: `cs_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`,
17
+ file: 'src/agent.ts',
18
+ line: 42,
19
+ col: 10,
20
+ provider: 'openai',
21
+ model: 'gpt-4o',
22
+ framework: null,
23
+ runtime: null,
24
+ patterns: {},
25
+ confidence: 0.9,
26
+ ...overrides,
27
+ };
28
+ }
29
+
30
+ function createInsight(overrides: Partial<Insight> = {}): Insight {
31
+ return {
32
+ id: `insight_${Date.now()}`,
33
+ severity: 'warning',
34
+ category: 'cost',
35
+ headline: 'Test insight',
36
+ evidence: 'Test evidence',
37
+ recommendation: 'Test recommendation',
38
+ source: 'rules',
39
+ ...overrides,
40
+ } as Insight;
41
+ }
42
+
43
+ function createSnapshot(
44
+ callsites: Callsite[],
45
+ insights: Insight[] = [],
46
+ runId = 'run_test'
47
+ ): AnalysisSnapshot {
48
+ return {
49
+ runId,
50
+ timestamp: new Date().toISOString(),
51
+ callsites,
52
+ insights,
53
+ };
54
+ }
55
+
56
+ // =============================================================================
57
+ // TESTS
58
+ // =============================================================================
59
+
60
+ describe('comparison', () => {
61
+ describe('compareSnapshots', () => {
62
+ it('should detect added inference points', () => {
63
+ const baseline = createSnapshot([
64
+ createCallsite({ file: 'src/a.ts', line: 10 }),
65
+ ]);
66
+
67
+ const current = createSnapshot([
68
+ createCallsite({ file: 'src/a.ts', line: 10 }),
69
+ createCallsite({ file: 'src/b.ts', line: 20 }),
70
+ ]);
71
+
72
+ const result = compareSnapshots(baseline, current);
73
+
74
+ expect(result.added.length).toBe(1);
75
+ expect(result.added[0].file).toBe('src/b.ts');
76
+ expect(result.metrics.addedCount).toBe(1);
77
+ });
78
+
79
+ it('should detect removed inference points', () => {
80
+ const baseline = createSnapshot([
81
+ createCallsite({ file: 'src/a.ts', line: 10 }),
82
+ createCallsite({ file: 'src/b.ts', line: 20 }),
83
+ ]);
84
+
85
+ const current = createSnapshot([
86
+ createCallsite({ file: 'src/a.ts', line: 10 }),
87
+ ]);
88
+
89
+ const result = compareSnapshots(baseline, current);
90
+
91
+ expect(result.removed.length).toBe(1);
92
+ expect(result.removed[0].file).toBe('src/b.ts');
93
+ expect(result.metrics.removedCount).toBe(1);
94
+ });
95
+
96
+ it('should detect changed inference points', () => {
97
+ const baseline = createSnapshot([
98
+ createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4' }),
99
+ ]);
100
+
101
+ const current = createSnapshot([
102
+ createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4o' }),
103
+ ]);
104
+
105
+ const result = compareSnapshots(baseline, current);
106
+
107
+ expect(result.changed.length).toBe(1);
108
+ expect(result.changed[0].changes.length).toBeGreaterThan(0);
109
+ expect(result.changed[0].changes[0].field).toBe('model');
110
+ expect(result.changed[0].changes[0].before).toBe('gpt-4');
111
+ expect(result.changed[0].changes[0].after).toBe('gpt-4o');
112
+ });
113
+
114
+ it('should detect pattern changes', () => {
115
+ const baseline = createSnapshot([
116
+ createCallsite({
117
+ file: 'src/a.ts',
118
+ line: 10,
119
+ patterns: { streaming: false },
120
+ }),
121
+ ]);
122
+
123
+ const current = createSnapshot([
124
+ createCallsite({
125
+ file: 'src/a.ts',
126
+ line: 10,
127
+ patterns: { streaming: true },
128
+ }),
129
+ ]);
130
+
131
+ const result = compareSnapshots(baseline, current);
132
+
133
+ expect(result.changed.length).toBe(1);
134
+ const patternChange = result.changed[0].changes.find(c => c.field === 'patterns.streaming');
135
+ expect(patternChange).toBeDefined();
136
+ expect(patternChange?.before).toBe(false);
137
+ expect(patternChange?.after).toBe(true);
138
+ });
139
+
140
+ it('should calculate correct metrics', () => {
141
+ const baseline = createSnapshot([
142
+ createCallsite({ file: 'src/a.ts', line: 10 }),
143
+ createCallsite({ file: 'src/b.ts', line: 20 }),
144
+ createCallsite({ file: 'src/c.ts', line: 30 }),
145
+ ]);
146
+
147
+ const current = createSnapshot([
148
+ createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4o-mini' }),
149
+ // b.ts removed
150
+ createCallsite({ file: 'src/d.ts', line: 40 }), // new
151
+ ]);
152
+
153
+ const result = compareSnapshots(baseline, current);
154
+
155
+ expect(result.metrics.totalBefore).toBe(3);
156
+ expect(result.metrics.totalAfter).toBe(2);
157
+ expect(result.metrics.addedCount).toBe(1);
158
+ expect(result.metrics.removedCount).toBe(2); // b.ts and c.ts
159
+ expect(result.metrics.changedCount).toBe(1); // a.ts model changed
160
+ expect(result.metrics.netChange).toBe(-1); // 1 added - 2 removed
161
+ });
162
+
163
+ it('should handle empty snapshots', () => {
164
+ const baseline = createSnapshot([]);
165
+ const current = createSnapshot([]);
166
+
167
+ const result = compareSnapshots(baseline, current);
168
+
169
+ expect(result.added.length).toBe(0);
170
+ expect(result.removed.length).toBe(0);
171
+ expect(result.changed.length).toBe(0);
172
+ expect(result.metrics.netChange).toBe(0);
173
+ });
174
+
175
+ it('should compare insights when enabled', () => {
176
+ const baseline = createSnapshot(
177
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
178
+ [
179
+ createInsight({ id: 'i1', severity: 'critical' }),
180
+ createInsight({ id: 'i2', severity: 'warning' }),
181
+ ]
182
+ );
183
+
184
+ const current = createSnapshot(
185
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
186
+ [
187
+ createInsight({ id: 'i1', severity: 'critical' }), // kept
188
+ createInsight({ id: 'i3', severity: 'critical' }), // new critical
189
+ createInsight({ id: 'i4', severity: 'warning' }), // new warning
190
+ ]
191
+ );
192
+
193
+ const result = compareSnapshots(baseline, current, { compareInsights: true });
194
+
195
+ expect(result.insightDeltas).toBeDefined();
196
+ expect(result.insightDeltas?.newCritical).toBe(1);
197
+ expect(result.insightDeltas?.newWarnings).toBe(1);
198
+ expect(result.insightDeltas?.resolvedWarnings).toBe(1); // i2 resolved
199
+ });
200
+ });
201
+
202
+ describe('formatComparisonSummary', () => {
203
+ it('should format added/removed/changed counts', () => {
204
+ const comparison = compareSnapshots(
205
+ createSnapshot([
206
+ createCallsite({ file: 'src/a.ts', line: 10 }),
207
+ createCallsite({ file: 'src/b.ts', line: 20 }),
208
+ ]),
209
+ createSnapshot([
210
+ createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4o-mini' }),
211
+ createCallsite({ file: 'src/c.ts', line: 30 }),
212
+ ])
213
+ );
214
+
215
+ const summary = formatComparisonSummary(comparison);
216
+
217
+ expect(summary).toContain('1 new inference point');
218
+ expect(summary).toContain('1 removed inference point');
219
+ expect(summary).toContain('1 modified inference point');
220
+ });
221
+
222
+ it('should show "No changes" when nothing changed', () => {
223
+ const callsite = createCallsite({ file: 'src/a.ts', line: 10 });
224
+ const comparison = compareSnapshots(
225
+ createSnapshot([callsite]),
226
+ createSnapshot([callsite])
227
+ );
228
+
229
+ const summary = formatComparisonSummary(comparison);
230
+
231
+ expect(summary).toContain('No changes detected');
232
+ });
233
+
234
+ it('should show insight deltas', () => {
235
+ const baseline = createSnapshot(
236
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
237
+ [createInsight({ id: 'i1', severity: 'critical' })]
238
+ );
239
+
240
+ const current = createSnapshot(
241
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
242
+ [
243
+ createInsight({ id: 'i1', severity: 'critical' }),
244
+ createInsight({ id: 'i2', severity: 'critical' }),
245
+ ]
246
+ );
247
+
248
+ const comparison = compareSnapshots(baseline, current, { compareInsights: true });
249
+ const summary = formatComparisonSummary(comparison);
250
+
251
+ expect(summary).toContain('1 new critical issue');
252
+ });
253
+ });
254
+
255
+ describe('hasSignificantChanges', () => {
256
+ it('should return true when points are added', () => {
257
+ const comparison = compareSnapshots(
258
+ createSnapshot([]),
259
+ createSnapshot([createCallsite({ file: 'src/a.ts', line: 10 })])
260
+ );
261
+
262
+ expect(hasSignificantChanges(comparison)).toBe(true);
263
+ });
264
+
265
+ it('should return true when points are removed', () => {
266
+ const comparison = compareSnapshots(
267
+ createSnapshot([createCallsite({ file: 'src/a.ts', line: 10 })]),
268
+ createSnapshot([])
269
+ );
270
+
271
+ expect(hasSignificantChanges(comparison)).toBe(true);
272
+ });
273
+
274
+ it('should return true when points are changed', () => {
275
+ const comparison = compareSnapshots(
276
+ createSnapshot([createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4' })]),
277
+ createSnapshot([createCallsite({ file: 'src/a.ts', line: 10, model: 'gpt-4o' })])
278
+ );
279
+
280
+ expect(hasSignificantChanges(comparison)).toBe(true);
281
+ });
282
+
283
+ it('should return true when new critical insights', () => {
284
+ const baseline = createSnapshot(
285
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
286
+ []
287
+ );
288
+
289
+ const current = createSnapshot(
290
+ [createCallsite({ file: 'src/a.ts', line: 10 })],
291
+ [createInsight({ id: 'i1', severity: 'critical' })]
292
+ );
293
+
294
+ const comparison = compareSnapshots(baseline, current, { compareInsights: true });
295
+
296
+ expect(hasSignificantChanges(comparison)).toBe(true);
297
+ });
298
+
299
+ it('should return false when nothing changed', () => {
300
+ const callsite = createCallsite({ file: 'src/a.ts', line: 10 });
301
+ const comparison = compareSnapshots(
302
+ createSnapshot([callsite]),
303
+ createSnapshot([callsite])
304
+ );
305
+
306
+ expect(hasSignificantChanges(comparison)).toBe(false);
307
+ });
308
+ });
309
+ });