agent-os-kernel 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

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 (1051) hide show
  1. agent_os/__init__.py +66 -4
  2. agent_os/agents_compat.py +286 -0
  3. agent_os/base_agent.py +308 -0
  4. agent_os/cli.py +1079 -19
  5. agent_os/integrations/__init__.py +37 -2
  6. agent_os/integrations/openai_adapter.py +502 -0
  7. agent_os/integrations/semantic_kernel_adapter.py +569 -0
  8. agent_os/stateless.py +349 -0
  9. agent_os_kernel-1.2.0.dist-info/METADATA +676 -0
  10. agent_os_kernel-1.2.0.dist-info/RECORD +1053 -0
  11. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/entry_points.txt +0 -1
  12. modules/amb/.github/workflows/ci.yml +102 -0
  13. modules/amb/.github/workflows/publish.yml +146 -0
  14. modules/amb/.gitignore +134 -0
  15. modules/amb/CHANGELOG.md +118 -0
  16. modules/amb/CONTRIBUTING.md +141 -0
  17. modules/amb/LICENSE +21 -0
  18. modules/amb/README.md +188 -0
  19. modules/amb/amb_core/__init__.py +175 -0
  20. modules/amb/amb_core/adapters/__init__.py +55 -0
  21. modules/amb/amb_core/adapters/aws_sqs_broker.py +374 -0
  22. modules/amb/amb_core/adapters/azure_servicebus_broker.py +338 -0
  23. modules/amb/amb_core/adapters/kafka_broker.py +258 -0
  24. modules/amb/amb_core/adapters/nats_broker.py +283 -0
  25. modules/amb/amb_core/adapters/rabbitmq_broker.py +233 -0
  26. modules/amb/amb_core/adapters/redis_broker.py +260 -0
  27. modules/amb/amb_core/broker.py +143 -0
  28. modules/amb/amb_core/bus.py +479 -0
  29. modules/amb/amb_core/cloudevents.py +507 -0
  30. modules/amb/amb_core/dlq.py +343 -0
  31. modules/amb/amb_core/hf_utils.py +534 -0
  32. modules/amb/amb_core/memory_broker.py +408 -0
  33. modules/amb/amb_core/models.py +139 -0
  34. modules/amb/amb_core/persistence.py +527 -0
  35. modules/amb/amb_core/schema.py +292 -0
  36. modules/amb/amb_core/tracing.py +356 -0
  37. modules/amb/examples/advanced_features.py +223 -0
  38. modules/amb/examples/backpressure_demo.py +225 -0
  39. modules/amb/examples/basic_usage.py +117 -0
  40. modules/amb/examples/tracing_demo.py +104 -0
  41. modules/amb/experiments/README.md +52 -0
  42. modules/amb/experiments/reproduce_results.py +467 -0
  43. modules/amb/experiments/results.json +324 -0
  44. modules/amb/paper/README.md +40 -0
  45. modules/amb/paper/paper.tex +365 -0
  46. modules/amb/paper/whitepaper.md +377 -0
  47. modules/amb/pyproject.toml +117 -0
  48. modules/amb/tests/__init__.py +1 -0
  49. modules/amb/tests/test_backpressure_priority.py +280 -0
  50. modules/amb/tests/test_bus.py +198 -0
  51. modules/amb/tests/test_cloudevents.py +443 -0
  52. modules/amb/tests/test_features.py +531 -0
  53. modules/amb/tests/test_models.py +74 -0
  54. modules/amb/tests/test_tracing.py +254 -0
  55. modules/atr/.github/workflows/ci.yml +101 -0
  56. modules/atr/.github/workflows/publish.yml +140 -0
  57. modules/atr/.gitignore +134 -0
  58. modules/atr/.pre-commit-config.yaml +37 -0
  59. modules/atr/CHANGELOG.md +39 -0
  60. modules/atr/CONTRIBUTING.md +96 -0
  61. modules/atr/IMPLEMENTATION_SUMMARY.md +143 -0
  62. modules/atr/README.md +180 -0
  63. modules/atr/atr/__init__.py +638 -0
  64. modules/atr/atr/access.py +346 -0
  65. modules/atr/atr/composition.py +643 -0
  66. modules/atr/atr/decorator.py +355 -0
  67. modules/atr/atr/executor.py +382 -0
  68. modules/atr/atr/health.py +555 -0
  69. modules/atr/atr/hf_utils.py +447 -0
  70. modules/atr/atr/injection.py +420 -0
  71. modules/atr/atr/metrics.py +438 -0
  72. modules/atr/atr/policies.py +401 -0
  73. modules/atr/atr/py.typed +2 -0
  74. modules/atr/atr/registry.py +450 -0
  75. modules/atr/atr/schema.py +478 -0
  76. modules/atr/atr/tools/safe/__init__.py +73 -0
  77. modules/atr/atr/tools/safe/calculator.py +380 -0
  78. modules/atr/atr/tools/safe/datetime_tool.py +441 -0
  79. modules/atr/atr/tools/safe/file_reader.py +400 -0
  80. modules/atr/atr/tools/safe/http_client.py +314 -0
  81. modules/atr/atr/tools/safe/json_parser.py +372 -0
  82. modules/atr/atr/tools/safe/text_tool.py +526 -0
  83. modules/atr/atr/tools/safe/toolkit.py +173 -0
  84. modules/atr/docs/PYPI_SETUP.md +113 -0
  85. modules/atr/examples/README.md +27 -0
  86. modules/atr/examples/demo.py +144 -0
  87. modules/atr/examples/sandbox_demo.py +218 -0
  88. modules/atr/experiments/README.md +69 -0
  89. modules/atr/experiments/reproduce_results.py +509 -0
  90. modules/atr/experiments/results/.gitkeep +0 -0
  91. modules/atr/experiments/results/results_20260123_140334.json +71 -0
  92. modules/atr/paper/README.md +36 -0
  93. modules/atr/paper/figures/.gitkeep +0 -0
  94. modules/atr/paper/references.bib +84 -0
  95. modules/atr/paper/structure.tex +293 -0
  96. modules/atr/paper/whitepaper.md +234 -0
  97. modules/atr/pyproject.toml +148 -0
  98. modules/atr/requirements.txt +1 -0
  99. modules/atr/setup.py +30 -0
  100. modules/atr/tests/__init__.py +1 -0
  101. modules/atr/tests/test_decorator.py +317 -0
  102. modules/atr/tests/test_executor.py +245 -0
  103. modules/atr/tests/test_integration_executor.py +184 -0
  104. modules/atr/tests/test_registry.py +312 -0
  105. modules/atr/tests/test_schema.py +182 -0
  106. modules/atr/tests/test_v2_features.py +708 -0
  107. modules/caas/.dockerignore +63 -0
  108. modules/caas/.github/ISSUE_TEMPLATE/bug_report.md +38 -0
  109. modules/caas/.github/ISSUE_TEMPLATE/custom.md +10 -0
  110. modules/caas/.github/ISSUE_TEMPLATE/feature_request.md +20 -0
  111. modules/caas/.github/workflows/ci.yml +100 -0
  112. modules/caas/.github/workflows/lint.yml +39 -0
  113. modules/caas/.github/workflows/publish-pypi.yml +124 -0
  114. modules/caas/.gitignore +73 -0
  115. modules/caas/.pre-commit-config.yaml +33 -0
  116. modules/caas/CHANGELOG.md +58 -0
  117. modules/caas/CONTRIBUTING.md +346 -0
  118. modules/caas/Dockerfile +41 -0
  119. modules/caas/LICENSE +21 -0
  120. modules/caas/MANIFEST.in +11 -0
  121. modules/caas/README.md +158 -0
  122. modules/caas/benchmarks/README.md +255 -0
  123. modules/caas/benchmarks/create_hf_dataset.py +502 -0
  124. modules/caas/benchmarks/data/sample_corpus/README.md +86 -0
  125. modules/caas/benchmarks/data/sample_corpus/auth_module.py +211 -0
  126. modules/caas/benchmarks/data/sample_corpus/contribution_guide.md +185 -0
  127. modules/caas/benchmarks/data/sample_corpus/remote_work_policy.html +57 -0
  128. modules/caas/benchmarks/hf_dataset/README.md +214 -0
  129. modules/caas/benchmarks/hf_dataset/caas_benchmark_corpus.py +73 -0
  130. modules/caas/benchmarks/hf_dataset/corpus_preview.json +193 -0
  131. modules/caas/benchmarks/results/README.md +66 -0
  132. modules/caas/benchmarks/results/evaluation_2026-01-20.json +121 -0
  133. modules/caas/benchmarks/run_evaluation.py +561 -0
  134. modules/caas/benchmarks/statistical_tests.py +289 -0
  135. modules/caas/benchmarks/verify_sample_corpus.py +83 -0
  136. modules/caas/docker-compose.yml +38 -0
  137. modules/caas/docs/CONTEXT_TRIAD.md +462 -0
  138. modules/caas/docs/CONTRIBUTING.md +346 -0
  139. modules/caas/docs/ETHICS_AND_LIMITATIONS.md +336 -0
  140. modules/caas/docs/HEURISTIC_ROUTER.md +442 -0
  141. modules/caas/docs/IMPLEMENTATION_SUMMARY.md +363 -0
  142. modules/caas/docs/IMPLEMENTATION_SUMMARY_CONTEXT_TRIAD.md +277 -0
  143. modules/caas/docs/IMPLEMENTATION_SUMMARY_HEURISTIC_ROUTER.md +231 -0
  144. modules/caas/docs/IMPLEMENTATION_SUMMARY_METADATA_INJECTION.md +258 -0
  145. modules/caas/docs/IMPLEMENTATION_SUMMARY_PRAGMATIC_TRUTH.md +212 -0
  146. modules/caas/docs/IMPLEMENTATION_SUMMARY_TRUST_GATEWAY.md +319 -0
  147. modules/caas/docs/LAYER_1_PRIMITIVE.md +202 -0
  148. modules/caas/docs/METADATA_INJECTION.md +404 -0
  149. modules/caas/docs/PRAGMATIC_TRUTH.md +431 -0
  150. modules/caas/docs/RELATED_WORK.md +312 -0
  151. modules/caas/docs/RELEASE_CHECKLIST.md +219 -0
  152. modules/caas/docs/RELEASE_GUIDE.md +285 -0
  153. modules/caas/docs/REPRODUCIBILITY.md +386 -0
  154. modules/caas/docs/SLIDING_WINDOW.md +387 -0
  155. modules/caas/docs/STRUCTURE_AWARE_INDEXING.md +158 -0
  156. modules/caas/docs/TESTING.md +259 -0
  157. modules/caas/docs/THREAT_MODEL.md +247 -0
  158. modules/caas/docs/TRUST_GATEWAY.md +575 -0
  159. modules/caas/docs/VFS.md +298 -0
  160. modules/caas/examples/agents/enterprise_security_agent.py +414 -0
  161. modules/caas/examples/agents/intelligent_document_analyzer.py +380 -0
  162. modules/caas/examples/demos/demo.py +309 -0
  163. modules/caas/examples/demos/demo_context_triad.py +225 -0
  164. modules/caas/examples/demos/demo_conversation_manager.py +285 -0
  165. modules/caas/examples/demos/demo_heuristic_router.py +133 -0
  166. modules/caas/examples/demos/demo_metadata_injection.py +198 -0
  167. modules/caas/examples/demos/demo_pragmatic_truth.py +303 -0
  168. modules/caas/examples/demos/demo_structure_aware.py +140 -0
  169. modules/caas/examples/demos/demo_time_decay.py +247 -0
  170. modules/caas/examples/demos/demo_trust_gateway.py +383 -0
  171. modules/caas/examples/multi_agent/README.md +159 -0
  172. modules/caas/examples/multi_agent/research_team.py +369 -0
  173. modules/caas/examples/multi_agent/vfs_collaboration.py +393 -0
  174. modules/caas/examples/usage/auth_module.py +142 -0
  175. modules/caas/examples/usage/usage_example.py +173 -0
  176. modules/caas/experiments/README.md +42 -0
  177. modules/caas/experiments/reproduce_results.py +462 -0
  178. modules/caas/paper/ARXIV_METADATA.md +145 -0
  179. modules/caas/paper/ARXIV_README.md +47 -0
  180. modules/caas/paper/CHECKLIST.md +103 -0
  181. modules/caas/paper/GITHUB_RELEASE_NOTES.md +105 -0
  182. modules/caas/paper/README.md +71 -0
  183. modules/caas/paper/abstract.md +24 -0
  184. modules/caas/paper/arxiv_submission.tar +0 -0
  185. modules/caas/paper/arxiv_submission.zip +0 -0
  186. modules/caas/paper/build_pdf.py +355 -0
  187. modules/caas/paper/experiments.md +149 -0
  188. modules/caas/paper/figures/.gitkeep +0 -0
  189. modules/caas/paper/figures/README.md +237 -0
  190. modules/caas/paper/figures/fig1_system_architecture.png +0 -0
  191. modules/caas/paper/figures/fig1_system_architecture.svg +198 -0
  192. modules/caas/paper/figures/fig2_context_triad.png +0 -0
  193. modules/caas/paper/figures/fig2_context_triad.svg +105 -0
  194. modules/caas/paper/figures/fig3_ablation_results.png +0 -0
  195. modules/caas/paper/figures/fig3_ablation_results.svg +113 -0
  196. modules/caas/paper/figures/fig4_routing_latency.png +0 -0
  197. modules/caas/paper/figures/fig4_routing_latency.svg +97 -0
  198. modules/caas/paper/intro.md +103 -0
  199. modules/caas/paper/latex/figures/fig1_system_architecture.png +0 -0
  200. modules/caas/paper/latex/figures/fig2_context_triad.png +0 -0
  201. modules/caas/paper/latex/figures/fig3_ablation_results.png +0 -0
  202. modules/caas/paper/latex/figures/fig4_routing_latency.png +0 -0
  203. modules/caas/paper/latex/main.tex +468 -0
  204. modules/caas/paper/latex/references.bib +140 -0
  205. modules/caas/paper/method.md +350 -0
  206. modules/caas/paper/outline.md +123 -0
  207. modules/caas/paper/related_work.md +101 -0
  208. modules/caas/paper/tables/.gitkeep +0 -0
  209. modules/caas/paper/tables/results_tables.md +50 -0
  210. modules/caas/pyproject.toml +172 -0
  211. modules/caas/requirements.txt +11 -0
  212. modules/caas/src/caas/__init__.py +232 -0
  213. modules/caas/src/caas/api/__init__.py +7 -0
  214. modules/caas/src/caas/api/server.py +1326 -0
  215. modules/caas/src/caas/caching.py +832 -0
  216. modules/caas/src/caas/cli.py +208 -0
  217. modules/caas/src/caas/conversation.py +221 -0
  218. modules/caas/src/caas/decay.py +118 -0
  219. modules/caas/src/caas/detection/__init__.py +7 -0
  220. modules/caas/src/caas/detection/detector.py +236 -0
  221. modules/caas/src/caas/enrichment.py +127 -0
  222. modules/caas/src/caas/gateway/__init__.py +24 -0
  223. modules/caas/src/caas/gateway/trust_gateway.py +471 -0
  224. modules/caas/src/caas/hf_utils.py +477 -0
  225. modules/caas/src/caas/ingestion/__init__.py +21 -0
  226. modules/caas/src/caas/ingestion/processors.py +251 -0
  227. modules/caas/src/caas/ingestion/structure_parser.py +185 -0
  228. modules/caas/src/caas/models.py +354 -0
  229. modules/caas/src/caas/pragmatic_truth.py +441 -0
  230. modules/caas/src/caas/routing/__init__.py +8 -0
  231. modules/caas/src/caas/routing/heuristic_router.py +242 -0
  232. modules/caas/src/caas/storage/__init__.py +7 -0
  233. modules/caas/src/caas/storage/store.py +450 -0
  234. modules/caas/src/caas/triad.py +472 -0
  235. modules/caas/src/caas/tuning/__init__.py +7 -0
  236. modules/caas/src/caas/tuning/tuner.py +322 -0
  237. modules/caas/src/caas/vfs/__init__.py +12 -0
  238. modules/caas/src/caas/vfs/filesystem.py +450 -0
  239. modules/caas/tests/__init__.py +3 -0
  240. modules/caas/tests/conftest.py +8 -0
  241. modules/caas/tests/test_caching.py +628 -0
  242. modules/caas/tests/test_context_triad.py +385 -0
  243. modules/caas/tests/test_conversation_manager.py +289 -0
  244. modules/caas/tests/test_functionality.py +215 -0
  245. modules/caas/tests/test_heuristic_router.py +370 -0
  246. modules/caas/tests/test_metadata_injection.py +328 -0
  247. modules/caas/tests/test_pragmatic_truth.py +322 -0
  248. modules/caas/tests/test_structure_aware_indexing.py +283 -0
  249. modules/caas/tests/test_time_decay.py +268 -0
  250. modules/caas/tests/test_trust_gateway.py +445 -0
  251. modules/caas/tests/test_vfs.py +298 -0
  252. modules/cmvk/.github/FUNDING.yml +9 -0
  253. modules/cmvk/.github/dependabot.yml +54 -0
  254. modules/cmvk/.github/workflows/ci.yml +205 -0
  255. modules/cmvk/.github/workflows/publish.yml +143 -0
  256. modules/cmvk/.gitignore +147 -0
  257. modules/cmvk/.pre-commit-config.yaml +58 -0
  258. modules/cmvk/CHANGELOG.md +146 -0
  259. modules/cmvk/CITATION.cff +48 -0
  260. modules/cmvk/CONTRIBUTING.md +229 -0
  261. modules/cmvk/Dockerfile +87 -0
  262. modules/cmvk/HF_MODEL_CARD.md +185 -0
  263. modules/cmvk/LICENSE +21 -0
  264. modules/cmvk/README.md +149 -0
  265. modules/cmvk/SECURITY.md +114 -0
  266. modules/cmvk/config/prompts/generator_v1.txt +23 -0
  267. modules/cmvk/config/prompts/verifier_hostile.txt +32 -0
  268. modules/cmvk/config/settings.yaml +40 -0
  269. modules/cmvk/coverage_html/.gitignore +2 -0
  270. modules/cmvk/coverage_html/class_index.html +658 -0
  271. modules/cmvk/coverage_html/coverage_html_cb_188fc9a4.js +735 -0
  272. modules/cmvk/coverage_html/favicon_32_cb_c827f16f.png +0 -0
  273. modules/cmvk/coverage_html/function_index.html +1978 -0
  274. modules/cmvk/coverage_html/index.html +255 -0
  275. modules/cmvk/coverage_html/keybd_closed_cb_900cfef5.png +0 -0
  276. modules/cmvk/coverage_html/status.json +1 -0
  277. modules/cmvk/coverage_html/style_cb_5c747636.css +389 -0
  278. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38___init___py.html +315 -0
  279. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_audit_py.html +499 -0
  280. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_benchmarks_py.html +575 -0
  281. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_constitutional_py.html +1001 -0
  282. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_hf_utils_py.html +398 -0
  283. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_metrics_py.html +570 -0
  284. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_profiles_py.html +397 -0
  285. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_types_py.html +109 -0
  286. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_verification_py.html +1053 -0
  287. modules/cmvk/docs/DIAGRAMS.md +325 -0
  288. modules/cmvk/docs/architecture.md +345 -0
  289. modules/cmvk/docs/features.md +308 -0
  290. modules/cmvk/docs/getting_started.md +279 -0
  291. modules/cmvk/docs/innovation_layer.md +377 -0
  292. modules/cmvk/docs/safety.md +281 -0
  293. modules/cmvk/docs/traceability.md +150 -0
  294. modules/cmvk/examples/basic_example.py +62 -0
  295. modules/cmvk/examples/demo_complete_pipeline.py +209 -0
  296. modules/cmvk/examples/demo_innovation_layer.py +197 -0
  297. modules/cmvk/examples/example.py +112 -0
  298. modules/cmvk/examples/model_diversity_comparison.py +110 -0
  299. modules/cmvk/examples/real_api_integration.py +121 -0
  300. modules/cmvk/examples/test_full_pipeline.py +303 -0
  301. modules/cmvk/experiments/FEATURE_2_LATERAL_THINKING.md +187 -0
  302. modules/cmvk/experiments/README.md +216 -0
  303. modules/cmvk/experiments/ablation_runner.py +666 -0
  304. modules/cmvk/experiments/baseline_runner.py +158 -0
  305. modules/cmvk/experiments/blind_spot_benchmark.py +364 -0
  306. modules/cmvk/experiments/datasets/README.md +85 -0
  307. modules/cmvk/experiments/datasets/humaneval_50.json +352 -0
  308. modules/cmvk/experiments/datasets/humaneval_full.json +1150 -0
  309. modules/cmvk/experiments/datasets/humaneval_sample.json +32 -0
  310. modules/cmvk/experiments/datasets/sabotage.json +262 -0
  311. modules/cmvk/experiments/datasets/sample.json +40 -0
  312. modules/cmvk/experiments/demo_with_traces.py +110 -0
  313. modules/cmvk/experiments/efficiency_curve.py +259 -0
  314. modules/cmvk/experiments/experiment_runner.py +243 -0
  315. modules/cmvk/experiments/paper_data_generator.py +183 -0
  316. modules/cmvk/experiments/reproduce_results.py +407 -0
  317. modules/cmvk/experiments/reproducible_runner.py +352 -0
  318. modules/cmvk/experiments/sabotage_stress_test.py +311 -0
  319. modules/cmvk/experiments/test_lateral_thinking.py +116 -0
  320. modules/cmvk/experiments/test_prosecutor.py +41 -0
  321. modules/cmvk/experiments/visualize_results.py +735 -0
  322. modules/cmvk/logs/traces/demo_HumanEval_0_20260121-204900.json +36 -0
  323. modules/cmvk/notebooks/analysis.ipynb +124 -0
  324. modules/cmvk/paper/PAPER.md +561 -0
  325. modules/cmvk/paper/arxiv_checklist.md +230 -0
  326. modules/cmvk/paper/cmvk_neurips.aux +77 -0
  327. modules/cmvk/paper/cmvk_neurips.bbl +81 -0
  328. modules/cmvk/paper/cmvk_neurips.blg +48 -0
  329. modules/cmvk/paper/cmvk_neurips.out +16 -0
  330. modules/cmvk/paper/cmvk_neurips.pdf +0 -0
  331. modules/cmvk/paper/cmvk_neurips.tex +309 -0
  332. modules/cmvk/paper/figures/ablation.png +0 -0
  333. modules/cmvk/paper/figures/ablation.svg +39 -0
  334. modules/cmvk/paper/figures/architecture.png +0 -0
  335. modules/cmvk/paper/figures/architecture.svg +115 -0
  336. modules/cmvk/paper/figures/results_bar.png +0 -0
  337. modules/cmvk/paper/figures/results_bar.svg +70 -0
  338. modules/cmvk/paper/generate_figures.py +383 -0
  339. modules/cmvk/paper/neurips_2024.sty +101 -0
  340. modules/cmvk/paper/references.bib +98 -0
  341. modules/cmvk/paper/structure.tex +200 -0
  342. modules/cmvk/pyproject.toml +189 -0
  343. modules/cmvk/requirements-dev.txt +19 -0
  344. modules/cmvk/requirements.txt +14 -0
  345. modules/cmvk/src/cmvk/__init__.py +216 -0
  346. modules/cmvk/src/cmvk/audit.py +400 -0
  347. modules/cmvk/src/cmvk/benchmarks.py +476 -0
  348. modules/cmvk/src/cmvk/constitutional.py +902 -0
  349. modules/cmvk/src/cmvk/hf_utils.py +299 -0
  350. modules/cmvk/src/cmvk/metrics.py +471 -0
  351. modules/cmvk/src/cmvk/profiles.py +298 -0
  352. modules/cmvk/src/cmvk/py.typed +0 -0
  353. modules/cmvk/src/cmvk/types.py +10 -0
  354. modules/cmvk/src/cmvk/verification.py +954 -0
  355. modules/cmvk/src/cross_model_verification_kernel/__init__.py +91 -0
  356. modules/cmvk/src/cross_model_verification_kernel/__main__.py +10 -0
  357. modules/cmvk/src/cross_model_verification_kernel/agents/__init__.py +16 -0
  358. modules/cmvk/src/cross_model_verification_kernel/agents/base_agent.py +142 -0
  359. modules/cmvk/src/cross_model_verification_kernel/agents/generator_openai.py +223 -0
  360. modules/cmvk/src/cross_model_verification_kernel/agents/verifier_anthropic.py +448 -0
  361. modules/cmvk/src/cross_model_verification_kernel/agents/verifier_gemini.py +481 -0
  362. modules/cmvk/src/cross_model_verification_kernel/cli.py +570 -0
  363. modules/cmvk/src/cross_model_verification_kernel/core/__init__.py +26 -0
  364. modules/cmvk/src/cross_model_verification_kernel/core/graph_memory.py +308 -0
  365. modules/cmvk/src/cross_model_verification_kernel/core/kernel.py +413 -0
  366. modules/cmvk/src/cross_model_verification_kernel/core/trace_logger.py +75 -0
  367. modules/cmvk/src/cross_model_verification_kernel/core/types.py +121 -0
  368. modules/cmvk/src/cross_model_verification_kernel/datasets/__init__.py +20 -0
  369. modules/cmvk/src/cross_model_verification_kernel/datasets/humaneval_loader.py +271 -0
  370. modules/cmvk/src/cross_model_verification_kernel/generator.py +118 -0
  371. modules/cmvk/src/cross_model_verification_kernel/kernel.py +292 -0
  372. modules/cmvk/src/cross_model_verification_kernel/models.py +111 -0
  373. modules/cmvk/src/cross_model_verification_kernel/py.typed +1 -0
  374. modules/cmvk/src/cross_model_verification_kernel/simple_kernel.py +185 -0
  375. modules/cmvk/src/cross_model_verification_kernel/tools/__init__.py +94 -0
  376. modules/cmvk/src/cross_model_verification_kernel/tools/huggingface_upload.py +394 -0
  377. modules/cmvk/src/cross_model_verification_kernel/tools/sandbox.py +159 -0
  378. modules/cmvk/src/cross_model_verification_kernel/tools/statistics.py +468 -0
  379. modules/cmvk/src/cross_model_verification_kernel/tools/visualizer.py +312 -0
  380. modules/cmvk/src/cross_model_verification_kernel/tools/web_search.py +86 -0
  381. modules/cmvk/src/cross_model_verification_kernel/verifier.py +257 -0
  382. modules/cmvk/tests/__init__.py +3 -0
  383. modules/cmvk/tests/conftest.py +61 -0
  384. modules/cmvk/tests/integration/__init__.py +1 -0
  385. modules/cmvk/tests/integration/test_anthropic_verifier.py +269 -0
  386. modules/cmvk/tests/integration/test_integration.py +53 -0
  387. modules/cmvk/tests/integration/test_lateral_thinking_integration.py +199 -0
  388. modules/cmvk/tests/integration/test_lateral_thinking_witness.py +208 -0
  389. modules/cmvk/tests/integration/test_prosecutor_mode.py +131 -0
  390. modules/cmvk/tests/test_constitutional.py +611 -0
  391. modules/cmvk/tests/test_enhanced_features.py +603 -0
  392. modules/cmvk/tests/test_verification.py +255 -0
  393. modules/cmvk/tests/unit/__init__.py +1 -0
  394. modules/cmvk/tests/unit/test_agents.py +64 -0
  395. modules/cmvk/tests/unit/test_cli.py +224 -0
  396. modules/cmvk/tests/unit/test_core.py +126 -0
  397. modules/cmvk/tests/unit/test_humaneval_loader.py +197 -0
  398. modules/cmvk/tests/unit/test_kernel.py +255 -0
  399. modules/cmvk/tests/unit/test_reproducibility.py +160 -0
  400. modules/cmvk/tests/unit/test_trace_logger.py +115 -0
  401. modules/cmvk/tests/unit/test_visualizer.py +218 -0
  402. modules/control-plane/.github/ISSUE_TEMPLATE/bug_report.yml +82 -0
  403. modules/control-plane/.github/ISSUE_TEMPLATE/config.yml +11 -0
  404. modules/control-plane/.github/ISSUE_TEMPLATE/feature_request.yml +104 -0
  405. modules/control-plane/.github/ISSUE_TEMPLATE/question.yml +70 -0
  406. modules/control-plane/.github/ISSUE_TEMPLATE/security_vulnerability.yml +84 -0
  407. modules/control-plane/.github/discussions.yml +73 -0
  408. modules/control-plane/.github/pull_request_template.md +82 -0
  409. modules/control-plane/.github/workflows/publish.yml +146 -0
  410. modules/control-plane/.github/workflows/release.yml +39 -0
  411. modules/control-plane/.github/workflows/tests.yml +58 -0
  412. modules/control-plane/.gitignore +55 -0
  413. modules/control-plane/CHANGELOG.md +203 -0
  414. modules/control-plane/CONTRIBUTING.md +311 -0
  415. modules/control-plane/CONTRIBUTORS.md +88 -0
  416. modules/control-plane/Dockerfile +82 -0
  417. modules/control-plane/LICENSE +21 -0
  418. modules/control-plane/MANIFEST.in +17 -0
  419. modules/control-plane/README.md +1264 -0
  420. modules/control-plane/ROADMAP.md +228 -0
  421. modules/control-plane/SECURITY.md +210 -0
  422. modules/control-plane/SUPPORT.md +106 -0
  423. modules/control-plane/acp-cli.py +212 -0
  424. modules/control-plane/benchmark/README.md +257 -0
  425. modules/control-plane/benchmark/__init__.py +19 -0
  426. modules/control-plane/benchmark/red_team_dataset.py +517 -0
  427. modules/control-plane/benchmark.py +563 -0
  428. modules/control-plane/build_and_publish.sh +130 -0
  429. modules/control-plane/docker-compose.yml +74 -0
  430. modules/control-plane/docs/ABLATION_STUDIES.md +528 -0
  431. modules/control-plane/docs/ADAPTER_GUIDE.md +544 -0
  432. modules/control-plane/docs/ADVANCED_FEATURES.md +543 -0
  433. modules/control-plane/docs/AIOS_COMPARISON.md +296 -0
  434. modules/control-plane/docs/BIBLIOGRAPHY.md +367 -0
  435. modules/control-plane/docs/CASE_STUDIES.md +645 -0
  436. modules/control-plane/docs/DOCKER_DEPLOYMENT.md +184 -0
  437. modules/control-plane/docs/ECOSYSTEM_STATUS.md +98 -0
  438. modules/control-plane/docs/HF_MODEL_CARD.md +168 -0
  439. modules/control-plane/docs/KERNEL_V1_RELEASE.md +454 -0
  440. modules/control-plane/docs/LAYER3_FRAMEWORK.md +227 -0
  441. modules/control-plane/docs/LIMITATIONS.md +523 -0
  442. modules/control-plane/docs/PYPI_PUBLISHING.md +195 -0
  443. modules/control-plane/docs/README.md +58 -0
  444. modules/control-plane/docs/RELATED_WORK.md +319 -0
  445. modules/control-plane/docs/RELEASE_v1.1.0.md +252 -0
  446. modules/control-plane/docs/REPRODUCIBILITY.md +540 -0
  447. modules/control-plane/docs/RESEARCH_FOUNDATION.md +197 -0
  448. modules/control-plane/docs/api/CORE.md +270 -0
  449. modules/control-plane/docs/architecture/architecture.md +120 -0
  450. modules/control-plane/docs/community/ANNOUNCEMENT_TEMPLATES.md +52 -0
  451. modules/control-plane/docs/guides/IMPLEMENTATION.md +225 -0
  452. modules/control-plane/docs/guides/PHILOSOPHY.md +354 -0
  453. modules/control-plane/docs/guides/QUICKSTART.md +217 -0
  454. modules/control-plane/examples/README.md +138 -0
  455. modules/control-plane/examples/a2a_demo.py +410 -0
  456. modules/control-plane/examples/adapter_demo.py +347 -0
  457. modules/control-plane/examples/advanced_features.py +403 -0
  458. modules/control-plane/examples/basic_usage.py +261 -0
  459. modules/control-plane/examples/benchmark_demo.py +186 -0
  460. modules/control-plane/examples/compliance_demo.py +333 -0
  461. modules/control-plane/examples/configuration.py +265 -0
  462. modules/control-plane/examples/getting_started.py +178 -0
  463. modules/control-plane/examples/hibernation_and_time_travel_demo.py +406 -0
  464. modules/control-plane/examples/interactive_tutorial.ipynb +497 -0
  465. modules/control-plane/examples/kernel_interceptor_demo.py +202 -0
  466. modules/control-plane/examples/kernel_v1_demo.py +273 -0
  467. modules/control-plane/examples/langchain_demo.py +281 -0
  468. modules/control-plane/examples/lifecycle_demo.py +724 -0
  469. modules/control-plane/examples/mcp_demo.py +378 -0
  470. modules/control-plane/examples/ml_safety_demo.py +157 -0
  471. modules/control-plane/examples/multimodal_demo.py +347 -0
  472. modules/control-plane/examples/observability_demo.py +370 -0
  473. modules/control-plane/examples/use_cases.py +336 -0
  474. modules/control-plane/experiments/long_horizon_purge.py +235 -0
  475. modules/control-plane/experiments/multi_agent_rag.py +165 -0
  476. modules/control-plane/experiments/reproduce_results.py +667 -0
  477. modules/control-plane/paper/ARXIV_SUBMISSION_INFO.txt +122 -0
  478. modules/control-plane/paper/ETHICS_STATEMENT.md +248 -0
  479. modules/control-plane/paper/PAPER_CHECKLIST.md +72 -0
  480. modules/control-plane/paper/Paper.pdf +0 -0
  481. modules/control-plane/paper/README.md +71 -0
  482. modules/control-plane/paper/appendix.md +152 -0
  483. modules/control-plane/paper/architecture.md +15 -0
  484. modules/control-plane/paper/arxiv/figures/ablation_chart.png +0 -0
  485. modules/control-plane/paper/arxiv/figures/architecture.png +0 -0
  486. modules/control-plane/paper/arxiv/figures/constraint_graphs.png +0 -0
  487. modules/control-plane/paper/arxiv/figures/results_chart.png +0 -0
  488. modules/control-plane/paper/arxiv/main.aux +97 -0
  489. modules/control-plane/paper/arxiv/main.bbl +112 -0
  490. modules/control-plane/paper/arxiv/main.blg +48 -0
  491. modules/control-plane/paper/arxiv/main.out +33 -0
  492. modules/control-plane/paper/arxiv/main.pdf +0 -0
  493. modules/control-plane/paper/arxiv/main.tex +479 -0
  494. modules/control-plane/paper/arxiv/references.bib +234 -0
  495. modules/control-plane/paper/arxiv_submission.tar +0 -0
  496. modules/control-plane/paper/arxiv_submission.zip +0 -0
  497. modules/control-plane/paper/build.sh +68 -0
  498. modules/control-plane/paper/figures/README.md +47 -0
  499. modules/control-plane/paper/figures/ablation_chart.pdf +0 -0
  500. modules/control-plane/paper/figures/ablation_chart.png +0 -0
  501. modules/control-plane/paper/figures/architecture.pdf +0 -0
  502. modules/control-plane/paper/figures/architecture.png +0 -0
  503. modules/control-plane/paper/figures/constraint_graphs.pdf +0 -0
  504. modules/control-plane/paper/figures/constraint_graphs.png +0 -0
  505. modules/control-plane/paper/figures/generate_figures.py +252 -0
  506. modules/control-plane/paper/figures/results_chart.pdf +0 -0
  507. modules/control-plane/paper/figures/results_chart.png +0 -0
  508. modules/control-plane/paper/main.md +273 -0
  509. modules/control-plane/paper/main.tex +214 -0
  510. modules/control-plane/paper/main_arxiv.aux +53 -0
  511. modules/control-plane/paper/main_arxiv.out +17 -0
  512. modules/control-plane/paper/main_arxiv.pdf +0 -0
  513. modules/control-plane/paper/main_arxiv.tex +264 -0
  514. modules/control-plane/paper/references.bib +234 -0
  515. modules/control-plane/pyproject.toml +124 -0
  516. modules/control-plane/reproducibility/ABLATIONS.md +136 -0
  517. modules/control-plane/reproducibility/README.md +288 -0
  518. modules/control-plane/reproducibility/commands.md +467 -0
  519. modules/control-plane/reproducibility/docker_config/Dockerfile +39 -0
  520. modules/control-plane/reproducibility/experiment_configs/purge_config.json +46 -0
  521. modules/control-plane/reproducibility/experiment_configs/rag_config.json +36 -0
  522. modules/control-plane/reproducibility/hardware_specs.md +317 -0
  523. modules/control-plane/reproducibility/requirements_frozen.txt +0 -0
  524. modules/control-plane/reproducibility/run_all_experiments.sh +45 -0
  525. modules/control-plane/reproducibility/seeds.json +106 -0
  526. modules/control-plane/scripts/prepare_pypi.py +46 -0
  527. modules/control-plane/scripts/prepare_release.py +176 -0
  528. modules/control-plane/scripts/upload_dataset_to_hf.py +316 -0
  529. modules/control-plane/setup.py +69 -0
  530. modules/control-plane/src/agent_control_plane/__init__.py +639 -0
  531. modules/control-plane/src/agent_control_plane/a2a_adapter.py +541 -0
  532. modules/control-plane/src/agent_control_plane/adapter.py +415 -0
  533. modules/control-plane/src/agent_control_plane/agent_hibernation.py +364 -0
  534. modules/control-plane/src/agent_control_plane/agent_kernel.py +464 -0
  535. modules/control-plane/src/agent_control_plane/compliance.py +718 -0
  536. modules/control-plane/src/agent_control_plane/constraint_graphs.py +475 -0
  537. modules/control-plane/src/agent_control_plane/control_plane.py +848 -0
  538. modules/control-plane/src/agent_control_plane/example_executors.py +193 -0
  539. modules/control-plane/src/agent_control_plane/execution_engine.py +229 -0
  540. modules/control-plane/src/agent_control_plane/flight_recorder.py +600 -0
  541. modules/control-plane/src/agent_control_plane/governance_layer.py +432 -0
  542. modules/control-plane/src/agent_control_plane/hf_utils.py +561 -0
  543. modules/control-plane/src/agent_control_plane/interfaces/__init__.py +53 -0
  544. modules/control-plane/src/agent_control_plane/interfaces/kernel_interface.py +359 -0
  545. modules/control-plane/src/agent_control_plane/interfaces/plugin_interface.py +495 -0
  546. modules/control-plane/src/agent_control_plane/interfaces/protocol_interfaces.py +385 -0
  547. modules/control-plane/src/agent_control_plane/kernel_space.py +707 -0
  548. modules/control-plane/src/agent_control_plane/langchain_adapter.py +422 -0
  549. modules/control-plane/src/agent_control_plane/lifecycle.py +3111 -0
  550. modules/control-plane/src/agent_control_plane/mcp_adapter.py +517 -0
  551. modules/control-plane/src/agent_control_plane/ml_safety.py +560 -0
  552. modules/control-plane/src/agent_control_plane/multimodal.py +724 -0
  553. modules/control-plane/src/agent_control_plane/mute_agent.py +419 -0
  554. modules/control-plane/src/agent_control_plane/observability.py +785 -0
  555. modules/control-plane/src/agent_control_plane/orchestrator.py +480 -0
  556. modules/control-plane/src/agent_control_plane/plugin_registry.py +748 -0
  557. modules/control-plane/src/agent_control_plane/policy_engine.py +525 -0
  558. modules/control-plane/src/agent_control_plane/shadow_mode.py +307 -0
  559. modules/control-plane/src/agent_control_plane/signals.py +491 -0
  560. modules/control-plane/src/agent_control_plane/supervisor_agents.py +427 -0
  561. modules/control-plane/src/agent_control_plane/time_travel_debugger.py +554 -0
  562. modules/control-plane/src/agent_control_plane/tool_registry.py +350 -0
  563. modules/control-plane/src/agent_control_plane/vfs.py +695 -0
  564. modules/control-plane/tests/README.md +33 -0
  565. modules/control-plane/tests/test_a2a_adapter.py +336 -0
  566. modules/control-plane/tests/test_adapter.py +422 -0
  567. modules/control-plane/tests/test_advanced_features.py +389 -0
  568. modules/control-plane/tests/test_benchmark.py +223 -0
  569. modules/control-plane/tests/test_compliance.py +214 -0
  570. modules/control-plane/tests/test_control_plane.py +295 -0
  571. modules/control-plane/tests/test_hibernation.py +274 -0
  572. modules/control-plane/tests/test_kernel_interception.py +284 -0
  573. modules/control-plane/tests/test_langchain_adapter.py +258 -0
  574. modules/control-plane/tests/test_lifecycle.py +1174 -0
  575. modules/control-plane/tests/test_mcp_adapter.py +293 -0
  576. modules/control-plane/tests/test_ml_safety.py +142 -0
  577. modules/control-plane/tests/test_multimodal.py +317 -0
  578. modules/control-plane/tests/test_new_features.py +435 -0
  579. modules/control-plane/tests/test_observability.py +338 -0
  580. modules/control-plane/tests/test_time_travel.py +387 -0
  581. modules/emk/.github/workflows/ci.yml +105 -0
  582. modules/emk/.github/workflows/publish.yml +144 -0
  583. modules/emk/.gitignore +74 -0
  584. modules/emk/CHANGELOG.md +41 -0
  585. modules/emk/CONTRIBUTING.md +295 -0
  586. modules/emk/IMPLEMENTATION.md +174 -0
  587. modules/emk/LICENSE +21 -0
  588. modules/emk/MANIFEST.in +8 -0
  589. modules/emk/README.md +135 -0
  590. modules/emk/RELEASE_NOTES.md +82 -0
  591. modules/emk/SECURITY.md +52 -0
  592. modules/emk/codecov.yml +39 -0
  593. modules/emk/docs/MEMORY_MANAGEMENT.md +285 -0
  594. modules/emk/emk/__init__.py +106 -0
  595. modules/emk/emk/hf_utils.py +419 -0
  596. modules/emk/emk/indexer.py +144 -0
  597. modules/emk/emk/py.typed +0 -0
  598. modules/emk/emk/schema.py +204 -0
  599. modules/emk/emk/sleep_cycle.py +345 -0
  600. modules/emk/emk/store.py +479 -0
  601. modules/emk/examples/basic_usage.py +123 -0
  602. modules/emk/examples/memory_features_demo.py +154 -0
  603. modules/emk/experiments/README.md +59 -0
  604. modules/emk/experiments/reproduce_results.py +461 -0
  605. modules/emk/experiments/results.json +61 -0
  606. modules/emk/paper/structure.tex +192 -0
  607. modules/emk/paper/whitepaper.md +273 -0
  608. modules/emk/pyproject.toml +91 -0
  609. modules/emk/setup.py +5 -0
  610. modules/emk/tests/test_file_adapter.py +195 -0
  611. modules/emk/tests/test_indexer.py +174 -0
  612. modules/emk/tests/test_init.py +55 -0
  613. modules/emk/tests/test_negative_memory.py +83 -0
  614. modules/emk/tests/test_schema.py +150 -0
  615. modules/emk/tests/test_semantic_rules.py +175 -0
  616. modules/emk/tests/test_sleep_cycle.py +335 -0
  617. modules/emk/tests/test_store_anti_patterns.py +239 -0
  618. modules/iatp/.github/workflows/docker-build.yml +124 -0
  619. modules/iatp/.github/workflows/publish.yml +174 -0
  620. modules/iatp/.github/workflows/python-package.yml +121 -0
  621. modules/iatp/.gitignore +67 -0
  622. modules/iatp/.pre-commit-config.yaml +64 -0
  623. modules/iatp/CHANGELOG.md +120 -0
  624. modules/iatp/Dockerfile +91 -0
  625. modules/iatp/IMPLEMENTATION_SUMMARY.md +218 -0
  626. modules/iatp/MANIFEST.in +9 -0
  627. modules/iatp/README.md +180 -0
  628. modules/iatp/docker/Dockerfile.agent +27 -0
  629. modules/iatp/docker/Dockerfile.sidecar-python +86 -0
  630. modules/iatp/docker/README.md +258 -0
  631. modules/iatp/docker-compose.yml +194 -0
  632. modules/iatp/docs/ARCHITECTURE.md +243 -0
  633. modules/iatp/docs/CLI_GUIDE.md +220 -0
  634. modules/iatp/docs/DEPLOYMENT.md +304 -0
  635. modules/iatp/examples/README.md +132 -0
  636. modules/iatp/examples/backend_agent.py +39 -0
  637. modules/iatp/examples/client.py +168 -0
  638. modules/iatp/examples/demo_attestation_reputation.py +274 -0
  639. modules/iatp/examples/demo_client.py +240 -0
  640. modules/iatp/examples/demo_rbac.py +143 -0
  641. modules/iatp/examples/integration_demo.py +245 -0
  642. modules/iatp/examples/manifests/coder_agent.json +20 -0
  643. modules/iatp/examples/manifests/reviewer_agent.json +19 -0
  644. modules/iatp/examples/manifests/secure_bank.json +14 -0
  645. modules/iatp/examples/manifests/standard_agent.json +14 -0
  646. modules/iatp/examples/manifests/untrusted_honeypot.json +14 -0
  647. modules/iatp/examples/run_secure_bank_sidecar.py +85 -0
  648. modules/iatp/examples/run_sidecar.py +105 -0
  649. modules/iatp/examples/run_untrusted_sidecar.py +77 -0
  650. modules/iatp/examples/secure_bank_agent.py +138 -0
  651. modules/iatp/examples/test_untrusted.py +82 -0
  652. modules/iatp/examples/untrusted_agent.py +119 -0
  653. modules/iatp/experiments/README.md +58 -0
  654. modules/iatp/experiments/cascading_hallucination/README.md +149 -0
  655. modules/iatp/experiments/cascading_hallucination/agent_a_user.py +41 -0
  656. modules/iatp/experiments/cascading_hallucination/agent_b_summarizer.py +54 -0
  657. modules/iatp/experiments/cascading_hallucination/agent_c_database.py +47 -0
  658. modules/iatp/experiments/cascading_hallucination/proof_of_concept.py +290 -0
  659. modules/iatp/experiments/cascading_hallucination/run_experiment.py +226 -0
  660. modules/iatp/experiments/cascading_hallucination/sidecar_c.py +61 -0
  661. modules/iatp/experiments/reproduce_results.py +574 -0
  662. modules/iatp/experiments/results.json +2336 -0
  663. modules/iatp/iatp/__init__.py +164 -0
  664. modules/iatp/iatp/attestation.py +401 -0
  665. modules/iatp/iatp/cli.py +253 -0
  666. modules/iatp/iatp/hf_utils.py +469 -0
  667. modules/iatp/iatp/ipc_pipes.py +578 -0
  668. modules/iatp/iatp/main.py +410 -0
  669. modules/iatp/iatp/models/__init__.py +445 -0
  670. modules/iatp/iatp/policy_engine.py +335 -0
  671. modules/iatp/iatp/py.typed +2 -0
  672. modules/iatp/iatp/recovery.py +319 -0
  673. modules/iatp/iatp/security/__init__.py +268 -0
  674. modules/iatp/iatp/sidecar/__init__.py +517 -0
  675. modules/iatp/iatp/telemetry/__init__.py +162 -0
  676. modules/iatp/iatp/tests/__init__.py +1 -0
  677. modules/iatp/iatp/tests/test_attestation.py +368 -0
  678. modules/iatp/iatp/tests/test_cli.py +129 -0
  679. modules/iatp/iatp/tests/test_models.py +128 -0
  680. modules/iatp/iatp/tests/test_policy_engine.py +345 -0
  681. modules/iatp/iatp/tests/test_recovery.py +279 -0
  682. modules/iatp/iatp/tests/test_security.py +220 -0
  683. modules/iatp/iatp/tests/test_sidecar.py +165 -0
  684. modules/iatp/iatp/tests/test_telemetry.py +173 -0
  685. modules/iatp/paper/BLOG.md +307 -0
  686. modules/iatp/paper/PAPER.md +236 -0
  687. modules/iatp/paper/RFC_SUBMISSION.md +299 -0
  688. modules/iatp/paper/whitepaper.md +369 -0
  689. modules/iatp/proto/README.md +200 -0
  690. modules/iatp/proto/generate_stubs.py +81 -0
  691. modules/iatp/proto/iatp.proto +552 -0
  692. modules/iatp/pyproject.toml +180 -0
  693. modules/iatp/requirements-dev.txt +2 -0
  694. modules/iatp/requirements.txt +6 -0
  695. modules/iatp/setup.py +60 -0
  696. modules/iatp/sidecar/README.md +487 -0
  697. modules/iatp/sidecar/go/Dockerfile +32 -0
  698. modules/iatp/sidecar/go/README.md +237 -0
  699. modules/iatp/sidecar/go/go.mod +8 -0
  700. modules/iatp/sidecar/go/main.go +488 -0
  701. modules/iatp/spec/001-handshake.md +436 -0
  702. modules/iatp/spec/002-reversibility.md +394 -0
  703. modules/iatp/spec/schema/capability_manifest.json +266 -0
  704. modules/iatp/test_integration.py +310 -0
  705. modules/mcp-kernel-server/README.md +261 -0
  706. modules/mcp-kernel-server/pyproject.toml +60 -0
  707. modules/mcp-kernel-server/src/mcp_kernel_server/__init__.py +26 -0
  708. modules/mcp-kernel-server/src/mcp_kernel_server/cli.py +229 -0
  709. modules/mcp-kernel-server/src/mcp_kernel_server/resources.py +215 -0
  710. modules/mcp-kernel-server/src/mcp_kernel_server/server.py +562 -0
  711. modules/mcp-kernel-server/src/mcp_kernel_server/tools.py +1172 -0
  712. modules/mute-agent/.github/workflows/safety_check.yml +45 -0
  713. modules/mute-agent/.gitignore +53 -0
  714. modules/mute-agent/ARCHITECTURE.md +531 -0
  715. modules/mute-agent/BENCHMARK_GUIDE.md +384 -0
  716. modules/mute-agent/COMPLETION_SUMMARY.md +293 -0
  717. modules/mute-agent/EXPERIMENT_SUMMARY.md +318 -0
  718. modules/mute-agent/IMPLEMENTATION_SUMMARY.md +212 -0
  719. modules/mute-agent/LICENSE +21 -0
  720. modules/mute-agent/PHASE3_SUMMARY.md +297 -0
  721. modules/mute-agent/README.md +360 -0
  722. modules/mute-agent/STEEL_MAN_RESULTS.md +353 -0
  723. modules/mute-agent/USAGE.md +505 -0
  724. modules/mute-agent/V2_IMPLEMENTATION_SUMMARY.md +253 -0
  725. modules/mute-agent/V2_STEEL_MAN_IMPLEMENTATION.md +274 -0
  726. modules/mute-agent/VERIFICATION_REPORT.md +435 -0
  727. modules/mute-agent/charts/cost_comparison.png +0 -0
  728. modules/mute-agent/charts/cost_vs_ambiguity.png +0 -0
  729. modules/mute-agent/charts/metrics_comparison.png +0 -0
  730. modules/mute-agent/charts/scenario_breakdown.png +0 -0
  731. modules/mute-agent/charts/trace_attack_blocked.html +140 -0
  732. modules/mute-agent/charts/trace_attack_blocked.png +0 -0
  733. modules/mute-agent/charts/trace_failure.html +140 -0
  734. modules/mute-agent/charts/trace_failure.png +0 -0
  735. modules/mute-agent/charts/trace_success.html +140 -0
  736. modules/mute-agent/charts/trace_success.png +0 -0
  737. modules/mute-agent/examples/__init__.py +1 -0
  738. modules/mute-agent/examples/advanced_example.py +384 -0
  739. modules/mute-agent/examples/graph_debugger_demo.py +241 -0
  740. modules/mute-agent/examples/listener_example.py +297 -0
  741. modules/mute-agent/examples/simple_example.py +242 -0
  742. modules/mute-agent/examples/steel_man_demo.py +297 -0
  743. modules/mute-agent/experiments/README.md +135 -0
  744. modules/mute-agent/experiments/__init__.py +3 -0
  745. modules/mute-agent/experiments/agent_comparison.csv +6 -0
  746. modules/mute-agent/experiments/agent_comparison_50runs.csv +6 -0
  747. modules/mute-agent/experiments/ambiguity_test.py +335 -0
  748. modules/mute-agent/experiments/ambiguity_test_results.csv +31 -0
  749. modules/mute-agent/experiments/ambiguity_test_results_50runs.csv +51 -0
  750. modules/mute-agent/experiments/baseline_agent.py +189 -0
  751. modules/mute-agent/experiments/benchmark.py +402 -0
  752. modules/mute-agent/experiments/demo.py +172 -0
  753. modules/mute-agent/experiments/generate_cost_curve.py +474 -0
  754. modules/mute-agent/experiments/jailbreak_test.py +137 -0
  755. modules/mute-agent/experiments/latent_state_scenario.py +361 -0
  756. modules/mute-agent/experiments/mute_agent_experiment.py +349 -0
  757. modules/mute-agent/experiments/run_extended_experiment.py +40 -0
  758. modules/mute-agent/experiments/run_v2_experiments.py +266 -0
  759. modules/mute-agent/experiments/run_v2_experiments_auto.py +247 -0
  760. modules/mute-agent/experiments/v2_scenarios/README.md +214 -0
  761. modules/mute-agent/experiments/v2_scenarios/__init__.py +4 -0
  762. modules/mute-agent/experiments/v2_scenarios/scenario_1_deep_dependency.py +325 -0
  763. modules/mute-agent/experiments/v2_scenarios/scenario_2_adversarial.py +328 -0
  764. modules/mute-agent/experiments/v2_scenarios/scenario_3_false_positive.py +303 -0
  765. modules/mute-agent/experiments/v2_scenarios/scenario_4_performance.py +319 -0
  766. modules/mute-agent/experiments/visualize.py +400 -0
  767. modules/mute-agent/mute_agent/__init__.py +66 -0
  768. modules/mute-agent/mute_agent/core/__init__.py +1 -0
  769. modules/mute-agent/mute_agent/core/execution_agent.py +164 -0
  770. modules/mute-agent/mute_agent/core/handshake_protocol.py +199 -0
  771. modules/mute-agent/mute_agent/core/reasoning_agent.py +236 -0
  772. modules/mute-agent/mute_agent/knowledge_graph/__init__.py +1 -0
  773. modules/mute-agent/mute_agent/knowledge_graph/graph_elements.py +63 -0
  774. modules/mute-agent/mute_agent/knowledge_graph/multidimensional_graph.py +168 -0
  775. modules/mute-agent/mute_agent/knowledge_graph/subgraph.py +222 -0
  776. modules/mute-agent/mute_agent/listener/__init__.py +41 -0
  777. modules/mute-agent/mute_agent/listener/adapters/__init__.py +29 -0
  778. modules/mute-agent/mute_agent/listener/adapters/base_adapter.py +187 -0
  779. modules/mute-agent/mute_agent/listener/adapters/caas_adapter.py +342 -0
  780. modules/mute-agent/mute_agent/listener/adapters/control_plane_adapter.py +434 -0
  781. modules/mute-agent/mute_agent/listener/adapters/iatp_adapter.py +330 -0
  782. modules/mute-agent/mute_agent/listener/adapters/scak_adapter.py +249 -0
  783. modules/mute-agent/mute_agent/listener/listener.py +608 -0
  784. modules/mute-agent/mute_agent/listener/state_observer.py +434 -0
  785. modules/mute-agent/mute_agent/listener/threshold_config.py +311 -0
  786. modules/mute-agent/mute_agent/super_system/__init__.py +1 -0
  787. modules/mute-agent/mute_agent/super_system/router.py +202 -0
  788. modules/mute-agent/mute_agent/visualization/__init__.py +8 -0
  789. modules/mute-agent/mute_agent/visualization/graph_debugger.py +495 -0
  790. modules/mute-agent/requirements-dev.txt +6 -0
  791. modules/mute-agent/requirements.txt +9 -0
  792. modules/mute-agent/setup.py +64 -0
  793. modules/mute-agent/src/__init__.py +0 -0
  794. modules/mute-agent/src/agents/__init__.py +0 -0
  795. modules/mute-agent/src/agents/baseline_agent.py +524 -0
  796. modules/mute-agent/src/agents/interactive_agent.py +113 -0
  797. modules/mute-agent/src/agents/mute_agent.py +622 -0
  798. modules/mute-agent/src/benchmarks/__init__.py +0 -0
  799. modules/mute-agent/src/benchmarks/evaluator.py +481 -0
  800. modules/mute-agent/src/benchmarks/scenarios.json +985 -0
  801. modules/mute-agent/src/core/__init__.py +0 -0
  802. modules/mute-agent/src/core/mock_state.py +320 -0
  803. modules/mute-agent/src/core/tools.py +441 -0
  804. modules/nexus/__init__.py +49 -0
  805. modules/nexus/arbiter.py +357 -0
  806. modules/nexus/client.py +464 -0
  807. modules/nexus/dmz.py +417 -0
  808. modules/nexus/escrow.py +428 -0
  809. modules/nexus/exceptions.py +284 -0
  810. modules/nexus/registry.py +391 -0
  811. modules/nexus/reputation.py +423 -0
  812. modules/nexus/schemas/__init__.py +49 -0
  813. modules/nexus/schemas/compliance.py +274 -0
  814. modules/nexus/schemas/escrow.py +249 -0
  815. modules/nexus/schemas/manifest.py +223 -0
  816. modules/nexus/schemas/receipt.py +206 -0
  817. modules/observability/README.md +192 -0
  818. modules/observability/alertmanager/alertmanager.yml +116 -0
  819. modules/observability/alerts/agent-os-alerts.yaml +197 -0
  820. modules/observability/docker-compose.yml +128 -0
  821. modules/observability/grafana/dashboards/agent-os-amb.json +448 -0
  822. modules/observability/grafana/dashboards/agent-os-cmvk.json +441 -0
  823. modules/observability/grafana/dashboards/agent-os-overview.json +268 -0
  824. modules/observability/grafana/dashboards/agent-os-performance.json +15 -0
  825. modules/observability/grafana/dashboards/agent-os-safety.json +50 -0
  826. modules/observability/grafana/provisioning/dashboards/dashboards.yml +15 -0
  827. modules/observability/grafana/provisioning/datasources/datasources.yml +33 -0
  828. modules/observability/otel/otel-collector-config.yml +61 -0
  829. modules/observability/prometheus/prometheus.yml +63 -0
  830. modules/observability/pyproject.toml +53 -0
  831. modules/observability/scripts/export_dashboards.py +55 -0
  832. modules/observability/src/agent_os_observability/__init__.py +25 -0
  833. modules/observability/src/agent_os_observability/dashboards.py +896 -0
  834. modules/observability/src/agent_os_observability/metrics.py +396 -0
  835. modules/observability/src/agent_os_observability/server.py +221 -0
  836. modules/observability/src/agent_os_observability/tracer.py +226 -0
  837. modules/primitives/.gitignore +8 -0
  838. modules/primitives/README.md +62 -0
  839. modules/primitives/agent_primitives/__init__.py +22 -0
  840. modules/primitives/agent_primitives/failures.py +82 -0
  841. modules/primitives/agent_primitives/py.typed +0 -0
  842. modules/primitives/pyproject.toml +68 -0
  843. modules/scak/.github/copilot-instructions.md +396 -0
  844. modules/scak/.github/workflows/release.yml +117 -0
  845. modules/scak/.gitignore +32 -0
  846. modules/scak/CHANGELOG.md +173 -0
  847. modules/scak/CITATION.cff +62 -0
  848. modules/scak/CONTRIBUTING.md +429 -0
  849. modules/scak/Dockerfile +58 -0
  850. modules/scak/ENTERPRISE_FEATURES.md +518 -0
  851. modules/scak/IMPLEMENTATION_SUMMARY.md +206 -0
  852. modules/scak/LIMITATIONS.md +565 -0
  853. modules/scak/MANIFEST.in +16 -0
  854. modules/scak/NOVELTY.md +535 -0
  855. modules/scak/README.md +928 -0
  856. modules/scak/RESEARCH.md +670 -0
  857. modules/scak/agent_kernel/__init__.py +66 -0
  858. modules/scak/agent_kernel/analyzer.py +432 -0
  859. modules/scak/agent_kernel/auditor.py +31 -0
  860. modules/scak/agent_kernel/completeness_auditor.py +234 -0
  861. modules/scak/agent_kernel/detector.py +200 -0
  862. modules/scak/agent_kernel/kernel.py +741 -0
  863. modules/scak/agent_kernel/memory_manager.py +82 -0
  864. modules/scak/agent_kernel/models.py +372 -0
  865. modules/scak/agent_kernel/nudge_mechanism.py +260 -0
  866. modules/scak/agent_kernel/outcome_analyzer.py +335 -0
  867. modules/scak/agent_kernel/patcher.py +579 -0
  868. modules/scak/agent_kernel/semantic_analyzer.py +313 -0
  869. modules/scak/agent_kernel/semantic_purge.py +346 -0
  870. modules/scak/agent_kernel/simulator.py +447 -0
  871. modules/scak/agent_kernel/teacher.py +82 -0
  872. modules/scak/agent_kernel/triage.py +149 -0
  873. modules/scak/build_and_publish.ps1 +74 -0
  874. modules/scak/build_and_publish.sh +74 -0
  875. modules/scak/cli.py +471 -0
  876. modules/scak/dashboard.py +462 -0
  877. modules/scak/datasets/DATASET_CARD.md +219 -0
  878. modules/scak/datasets/README.md +143 -0
  879. modules/scak/datasets/gaia_vague_queries/vague_queries.json +262 -0
  880. modules/scak/datasets/hf_upload/README.md +219 -0
  881. modules/scak/datasets/hf_upload/scak_gaia_laziness.jsonl +50 -0
  882. modules/scak/datasets/prepare_hf_datasets.py +145 -0
  883. modules/scak/datasets/red_team/jailbreak_patterns.json +202 -0
  884. modules/scak/docker-compose.yml +99 -0
  885. modules/scak/docs/Adaptive-Memory-Hierarchy.md +319 -0
  886. modules/scak/docs/Data-Contracts-and-Schemas.md +285 -0
  887. modules/scak/docs/Dual-Loop-Architecture.md +344 -0
  888. modules/scak/docs/Enhanced-Features.md +612 -0
  889. modules/scak/docs/LANGCHAIN_INTEGRATION.md +572 -0
  890. modules/scak/docs/README.md +128 -0
  891. modules/scak/docs/Reference-Implementations.md +163 -0
  892. modules/scak/docs/SCAK_V2.md +374 -0
  893. modules/scak/docs/Three-Failure-Types.md +178 -0
  894. modules/scak/examples/basic_example.py +155 -0
  895. modules/scak/examples/circuit_breaker_lazy_eval_demo.py +243 -0
  896. modules/scak/examples/langchain_integration_example.py +339 -0
  897. modules/scak/examples/layer4_demo.py +243 -0
  898. modules/scak/examples/production_features_demo.py +353 -0
  899. modules/scak/examples/quick_demo.py +79 -0
  900. modules/scak/examples/scak_v2_demo.py +252 -0
  901. modules/scak/experiments/README.md +438 -0
  902. modules/scak/experiments/ablation_studies/README.md +192 -0
  903. modules/scak/experiments/ablation_studies/ablation_no_audit.py +116 -0
  904. modules/scak/experiments/ablation_studies/ablation_no_purge.py +133 -0
  905. modules/scak/experiments/chaos_engineering/README.md +332 -0
  906. modules/scak/experiments/context_efficiency_test.py +328 -0
  907. modules/scak/experiments/gaia_benchmark/README.md +208 -0
  908. modules/scak/experiments/laziness_benchmark.py +179 -0
  909. modules/scak/experiments/long_horizon_task_experiment.py +252 -0
  910. modules/scak/experiments/multi_agent_rag_experiment.py +284 -0
  911. modules/scak/experiments/results/ablation_table.md +12 -0
  912. modules/scak/experiments/results/long_horizon.json +36 -0
  913. modules/scak/experiments/results/multi_agent_rag.json +66 -0
  914. modules/scak/experiments/run_comprehensive_ablations.py +332 -0
  915. modules/scak/experiments/test_auditor_patcher_integration.py +251 -0
  916. modules/scak/notebooks/getting_started.ipynb +33 -0
  917. modules/scak/paper/ARXIV_SUBMISSION_METADATA.txt +109 -0
  918. modules/scak/paper/PAPER_CHECKLIST.md +304 -0
  919. modules/scak/paper/Paper.pdf +0 -0
  920. modules/scak/paper/README.md +113 -0
  921. modules/scak/paper/appendix.md +351 -0
  922. modules/scak/paper/arxiv/bibliography.bib +284 -0
  923. modules/scak/paper/arxiv/fig1_ooda_architecture.pdf +0 -0
  924. modules/scak/paper/arxiv/fig2_memory_hierarchy.pdf +0 -0
  925. modules/scak/paper/arxiv/fig3_gaia_results.pdf +0 -0
  926. modules/scak/paper/arxiv/fig4_ablation_heatmap.pdf +0 -0
  927. modules/scak/paper/arxiv/fig5_context_reduction.pdf +0 -0
  928. modules/scak/paper/arxiv/fig6_mttr_boxplot.pdf +0 -0
  929. modules/scak/paper/arxiv/main.aux +103 -0
  930. modules/scak/paper/arxiv/main.bbl +113 -0
  931. modules/scak/paper/arxiv/main.blg +55 -0
  932. modules/scak/paper/arxiv/main.out +31 -0
  933. modules/scak/paper/arxiv/main.pdf +0 -0
  934. modules/scak/paper/arxiv/main.tex +482 -0
  935. modules/scak/paper/arxiv_submission/bibliography.bib +284 -0
  936. modules/scak/paper/arxiv_submission/fig1_ooda_architecture.pdf +0 -0
  937. modules/scak/paper/arxiv_submission/fig2_memory_hierarchy.pdf +0 -0
  938. modules/scak/paper/arxiv_submission/fig3_gaia_results.pdf +0 -0
  939. modules/scak/paper/arxiv_submission/fig4_ablation_heatmap.pdf +0 -0
  940. modules/scak/paper/arxiv_submission/fig5_context_reduction.pdf +0 -0
  941. modules/scak/paper/arxiv_submission/fig6_mttr_boxplot.pdf +0 -0
  942. modules/scak/paper/arxiv_submission/main.aux +103 -0
  943. modules/scak/paper/arxiv_submission/main.bbl +113 -0
  944. modules/scak/paper/arxiv_submission/main.blg +55 -0
  945. modules/scak/paper/arxiv_submission/main.out +31 -0
  946. modules/scak/paper/arxiv_submission/main.pdf +0 -0
  947. modules/scak/paper/arxiv_submission/main.tex +482 -0
  948. modules/scak/paper/arxiv_submission.tar.gz +0 -0
  949. modules/scak/paper/bibliography.bib +284 -0
  950. modules/scak/paper/build.sh +55 -0
  951. modules/scak/paper/figures/README.md +32 -0
  952. modules/scak/paper/figures/fig1_ooda_architecture.md +75 -0
  953. modules/scak/paper/figures/fig1_ooda_architecture.pdf +0 -0
  954. modules/scak/paper/figures/fig1_ooda_architecture.png +0 -0
  955. modules/scak/paper/figures/fig2_memory_hierarchy.md +83 -0
  956. modules/scak/paper/figures/fig2_memory_hierarchy.pdf +0 -0
  957. modules/scak/paper/figures/fig2_memory_hierarchy.png +0 -0
  958. modules/scak/paper/figures/fig3_gaia_results.md +64 -0
  959. modules/scak/paper/figures/fig3_gaia_results.pdf +0 -0
  960. modules/scak/paper/figures/fig3_gaia_results.png +0 -0
  961. modules/scak/paper/figures/fig4_ablation_heatmap.md +64 -0
  962. modules/scak/paper/figures/fig4_ablation_heatmap.pdf +0 -0
  963. modules/scak/paper/figures/fig4_ablation_heatmap.png +0 -0
  964. modules/scak/paper/figures/fig5_context_reduction.md +71 -0
  965. modules/scak/paper/figures/fig5_context_reduction.pdf +0 -0
  966. modules/scak/paper/figures/fig5_context_reduction.png +0 -0
  967. modules/scak/paper/figures/fig6_mttr_boxplot.md +80 -0
  968. modules/scak/paper/figures/fig6_mttr_boxplot.pdf +0 -0
  969. modules/scak/paper/figures/fig6_mttr_boxplot.png +0 -0
  970. modules/scak/paper/figures/generate_figures.py +463 -0
  971. modules/scak/paper/main.aux +103 -0
  972. modules/scak/paper/main.bbl +113 -0
  973. modules/scak/paper/main.blg +55 -0
  974. modules/scak/paper/main.md +192 -0
  975. modules/scak/paper/main.out +31 -0
  976. modules/scak/paper/main.pdf +0 -0
  977. modules/scak/paper/main.tex +482 -0
  978. modules/scak/reproducibility/ABLATIONS.md +225 -0
  979. modules/scak/reproducibility/Dockerfile.reproducibility +34 -0
  980. modules/scak/reproducibility/README.md +421 -0
  981. modules/scak/reproducibility/requirements-pinned.txt +32 -0
  982. modules/scak/reproducibility/run_all_experiments.py +395 -0
  983. modules/scak/reproducibility/seed_control.py +53 -0
  984. modules/scak/reproducibility/statistical_analysis.py +302 -0
  985. modules/scak/requirements.txt +50 -0
  986. modules/scak/setup.py +93 -0
  987. modules/scak/src/__init__.py +124 -0
  988. modules/scak/src/agents/__init__.py +13 -0
  989. modules/scak/src/agents/conflict_resolution.py +732 -0
  990. modules/scak/src/agents/orchestrator.py +761 -0
  991. modules/scak/src/agents/pubsub.py +484 -0
  992. modules/scak/src/agents/shadow_teacher.py +344 -0
  993. modules/scak/src/agents/swarm.py +661 -0
  994. modules/scak/src/agents/worker.py +357 -0
  995. modules/scak/src/integrations/__init__.py +81 -0
  996. modules/scak/src/integrations/cmvk_adapter.py +430 -0
  997. modules/scak/src/integrations/control_plane_adapter.py +601 -0
  998. modules/scak/src/integrations/langchain_integration.py +902 -0
  999. modules/scak/src/interfaces/__init__.py +59 -0
  1000. modules/scak/src/interfaces/llm_clients.py +505 -0
  1001. modules/scak/src/interfaces/openapi_tools.py +611 -0
  1002. modules/scak/src/interfaces/plugin_system.py +605 -0
  1003. modules/scak/src/interfaces/protocols.py +365 -0
  1004. modules/scak/src/interfaces/telemetry.py +464 -0
  1005. modules/scak/src/interfaces/tool_registry.py +547 -0
  1006. modules/scak/src/kernel/__init__.py +100 -0
  1007. modules/scak/src/kernel/auditor.py +305 -0
  1008. modules/scak/src/kernel/circuit_breaker.py +398 -0
  1009. modules/scak/src/kernel/core.py +724 -0
  1010. modules/scak/src/kernel/distributed.py +667 -0
  1011. modules/scak/src/kernel/evolution.py +455 -0
  1012. modules/scak/src/kernel/failover.py +621 -0
  1013. modules/scak/src/kernel/governance.py +710 -0
  1014. modules/scak/src/kernel/governance_v2.py +603 -0
  1015. modules/scak/src/kernel/lazy_evaluator.py +514 -0
  1016. modules/scak/src/kernel/load_testing.py +633 -0
  1017. modules/scak/src/kernel/memory.py +945 -0
  1018. modules/scak/src/kernel/patcher.py +581 -0
  1019. modules/scak/src/kernel/rubric.py +419 -0
  1020. modules/scak/src/kernel/schemas.py +390 -0
  1021. modules/scak/src/kernel/skill_mapper.py +309 -0
  1022. modules/scak/src/kernel/triage.py +149 -0
  1023. modules/scak/src/mocks/__init__.py +99 -0
  1024. modules/scak/tests/__init__.py +1 -0
  1025. modules/scak/tests/test_circuit_breaker.py +403 -0
  1026. modules/scak/tests/test_conflict_resolution.py +287 -0
  1027. modules/scak/tests/test_dual_loop.py +463 -0
  1028. modules/scak/tests/test_enhanced_features.py +421 -0
  1029. modules/scak/tests/test_failover_and_load.py +438 -0
  1030. modules/scak/tests/test_governance.py +185 -0
  1031. modules/scak/tests/test_kernel.py +359 -0
  1032. modules/scak/tests/test_langchain_integration.py +451 -0
  1033. modules/scak/tests/test_lazy_evaluator.py +465 -0
  1034. modules/scak/tests/test_llm_clients.py +122 -0
  1035. modules/scak/tests/test_memory_controller.py +528 -0
  1036. modules/scak/tests/test_orchestrator.py +181 -0
  1037. modules/scak/tests/test_phase3_integration.py +265 -0
  1038. modules/scak/tests/test_pubsub_swarm.py +203 -0
  1039. modules/scak/tests/test_reference_implementations.py +240 -0
  1040. modules/scak/tests/test_rubric.py +363 -0
  1041. modules/scak/tests/test_scak_v2.py +651 -0
  1042. modules/scak/tests/test_skill_mapper.py +217 -0
  1043. modules/scak/tests/test_specific_failures.py +393 -0
  1044. modules/scak/tests/test_tool_registry.py +264 -0
  1045. modules/scak/tests/test_tools_and_plugins.py +303 -0
  1046. modules/scak/tests/test_triage.py +596 -0
  1047. modules/scak/tests/test_write_through.py +319 -0
  1048. agent_os_kernel-1.1.0.dist-info/METADATA +0 -400
  1049. agent_os_kernel-1.1.0.dist-info/RECORD +0 -12
  1050. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/WHEEL +0 -0
  1051. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/licenses/LICENSE +0 -0
modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_verification_py.html ADDED
@@ -0,0 +1,1053 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
+ <title>Coverage for src\cmvk\verification.py: 13%</title>
6
+ <link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
7
+ <link rel="stylesheet" href="style_cb_5c747636.css" type="text/css">
8
+ <script src="coverage_html_cb_188fc9a4.js" defer></script>
9
+ </head>
10
+ <body class="pyfile">
11
+ <header>
12
+ <div class="content">
13
+ <h1>
14
+ <span class="text">Coverage for </span><b>src&#8201;\&#8201;cmvk&#8201;\&#8201;verification.py</b>:
15
+ <span class="pc_cov">13%</span>
16
+ </h1>
17
+ <aside id="help_panel_wrapper">
18
+ <input id="help_panel_state" type="checkbox">
19
+ <label for="help_panel_state">
20
+ <img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
21
+ </label>
22
+ <div id="help_panel">
23
+ <p class="legend">Shortcuts on this page</p>
24
+ <div class="keyhelp">
25
+ <p>
26
+ <kbd>r</kbd>
27
+ <kbd>m</kbd>
28
+ <kbd>x</kbd>
29
+ <kbd>p</kbd>
30
+ &nbsp; toggle line displays
31
+ </p>
32
+ <p>
33
+ <kbd>j</kbd>
34
+ <kbd>k</kbd>
35
+ &nbsp; next/prev highlighted chunk
36
+ </p>
37
+ <p>
38
+ <kbd>0</kbd> &nbsp; (zero) top of page
39
+ </p>
40
+ <p>
41
+ <kbd>1</kbd> &nbsp; (one) first highlighted chunk
42
+ </p>
43
+ <p>
44
+ <kbd>[</kbd>
45
+ <kbd>]</kbd>
46
+ &nbsp; prev/next file
47
+ </p>
48
+ <p>
49
+ <kbd>u</kbd> &nbsp; up to the index
50
+ </p>
51
+ <p>
52
+ <kbd>?</kbd> &nbsp; show/hide this help
53
+ </p>
54
+ </div>
55
+ </div>
56
+ </aside>
57
+ <h2>
58
+ <span class="text">285 statements &nbsp;</span>
59
+ <button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">49<span class="text"> run</span></button>
60
+ <button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">236<span class="text"> missing</span></button>
61
+ <button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">2<span class="text"> excluded</span></button>
62
+ <button type="button" class="par run show_par button_toggle_par" value="par" data-shortcut="p" title="Toggle lines partially run">0<span class="text"> partial</span></button>
63
+ </h2>
64
+ <p class="text">
65
+ <a id="prevFileLink" class="nav" href="z_2c49bd2ed3e01e38_types_py.html">&#xab; prev</a> &nbsp; &nbsp;
66
+ <a id="indexLink" class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
67
+ <a id="nextFileLink" class="nav" href="index.html">&#xbb; next</a>
68
+ &nbsp; &nbsp; &nbsp;
69
+ <a class="nav" href="https://coverage.readthedocs.io/en/7.13.1">coverage.py v7.13.1</a>,
70
+ created at 2026-02-02 21:04 -0800
71
+ </p>
72
+ <aside class="hidden">
73
+ <button type="button" class="button_next_chunk" data-shortcut="j"></button>
74
+ <button type="button" class="button_prev_chunk" data-shortcut="k"></button>
75
+ <button type="button" class="button_top_of_page" data-shortcut="0"></button>
76
+ <button type="button" class="button_first_chunk" data-shortcut="1"></button>
77
+ <button type="button" class="button_prev_file" data-shortcut="["></button>
78
+ <button type="button" class="button_next_file" data-shortcut="]"></button>
79
+ <button type="button" class="button_to_index" data-shortcut="u"></button>
80
+ <button type="button" class="button_show_hide_help" data-shortcut="?"></button>
81
+ </aside>
82
+ </div>
83
+ </header>
84
+ <main id="source">
85
+ <p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
86
+ <p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"><span class="str">CMVK Verification Module - Pure Mathematical Functions</span>&nbsp;</span><span class="r"></span></p>
87
+ <p class="pln"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
88
+ <p class="pln"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="str">This module provides pure functions for calculating drift/hallucination scores</span>&nbsp;</span><span class="r"></span></p>
89
+ <p class="pln"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="str">between two outputs. These functions have no side effects and use only</span>&nbsp;</span><span class="r"></span></p>
90
+ <p class="pln"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="str">numpy/scipy for mathematical operations.</span>&nbsp;</span><span class="r"></span></p>
91
+ <p class="pln"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
92
+ <p class="pln"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"><span class="str">Layer 1: The Primitive - Mathematical and adversarial verification.</span>&nbsp;</span><span class="r"></span></p>
93
+ <p class="pln"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
94
+ <p class="pln"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="str">Enhanced Features (v0.2.0):</span>&nbsp;</span><span class="r"></span></p>
95
+ <p class="pln"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="str"> - Configurable distance metrics (cosine, euclidean, manhattan, etc.)</span>&nbsp;</span><span class="r"></span></p>
96
+ <p class="pln"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="str"> - Dimensional weighting for importance-based drift calculation</span>&nbsp;</span><span class="r"></span></p>
97
+ <p class="pln"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="str"> - Threshold profiles for domain-specific verification</span>&nbsp;</span><span class="r"></span></p>
98
+ <p class="pln"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="str"> - Explainable drift with per-dimension contributions</span>&nbsp;</span><span class="r"></span></p>
99
+ <p class="pln"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t"><span class="str"> - Batch verification for efficiency</span>&nbsp;</span><span class="r"></span></p>
100
+ <p class="pln"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"><span class="str"> - Audit trail integration</span>&nbsp;</span><span class="r"></span></p>
101
+ <p class="pln"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
102
+ <p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
103
+ <p class="run"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"><span class="key">from</span> <span class="nam">__future__</span> <span class="key">import</span> <span class="nam">annotations</span>&nbsp;</span><span class="r"></span></p>
104
+ <p class="pln"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
105
+ <p class="run"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="key">from</span> <span class="nam">collections</span><span class="op">.</span><span class="nam">abc</span> <span class="key">import</span> <span class="nam">Sequence</span>&nbsp;</span><span class="r"></span></p>
106
+ <p class="run"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="key">from</span> <span class="nam">dataclasses</span> <span class="key">import</span> <span class="nam">dataclass</span>&nbsp;</span><span class="r"></span></p>
107
+ <p class="run"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="key">from</span> <span class="nam">enum</span> <span class="key">import</span> <span class="nam">Enum</span>&nbsp;</span><span class="r"></span></p>
108
+ <p class="run"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"><span class="key">from</span> <span class="nam">typing</span> <span class="key">import</span> <span class="nam">TYPE_CHECKING</span><span class="op">,</span> <span class="nam">Any</span>&nbsp;</span><span class="r"></span></p>
109
+ <p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
110
+ <p class="run"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"><span class="key">import</span> <span class="nam">numpy</span> <span class="key">as</span> <span class="nam">np</span>&nbsp;</span><span class="r"></span></p>
111
+ <p class="run"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"><span class="key">from</span> <span class="nam">numpy</span><span class="op">.</span><span class="nam">typing</span> <span class="key">import</span> <span class="nam">ArrayLike</span>&nbsp;</span><span class="r"></span></p>
112
+ <p class="pln"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
113
+ <p class="run"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"><span class="key">try</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
114
+ <p class="run"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t"> <span class="key">from</span> <span class="nam">scipy</span> <span class="key">import</span> <span class="nam">stats</span>&nbsp;</span><span class="r"></span></p>
115
+ <p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
116
+ <p class="run"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"> <span class="nam">HAS_SCIPY</span> <span class="op">=</span> <span class="key">True</span>&nbsp;</span><span class="r"></span></p>
117
+ <p class="mis show_mis"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"><span class="key">except</span> <span class="nam">ImportError</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
118
+ <p class="mis show_mis"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"> <span class="nam">HAS_SCIPY</span> <span class="op">=</span> <span class="key">False</span>&nbsp;</span><span class="r"></span></p>
119
+ <p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
120
+ <p class="exc show_exc"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"><span class="key">if</span> <span class="nam">TYPE_CHECKING</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
121
+ <p class="exc show_exc"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">audit</span> <span class="key">import</span> <span class="nam">AuditTrail</span>&nbsp;</span><span class="r"></span></p>
122
+ <p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
123
+ <p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
124
+ <p class="run"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="key">class</span> <span class="nam">DriftType</span><span class="op">(</span><span class="nam">Enum</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
125
+ <p class="pln"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"> <span class="str">"""Types of drift/divergence detected between outputs."""</span>&nbsp;</span><span class="r"></span></p>
126
+ <p class="pln"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
127
+ <p class="run"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"> <span class="nam">SEMANTIC</span> <span class="op">=</span> <span class="str">"semantic"</span>&nbsp;</span><span class="r"></span></p>
128
+ <p class="run"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"> <span class="nam">STRUCTURAL</span> <span class="op">=</span> <span class="str">"structural"</span>&nbsp;</span><span class="r"></span></p>
129
+ <p class="run"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"> <span class="nam">NUMERICAL</span> <span class="op">=</span> <span class="str">"numerical"</span>&nbsp;</span><span class="r"></span></p>
130
+ <p class="run"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"> <span class="nam">LEXICAL</span> <span class="op">=</span> <span class="str">"lexical"</span>&nbsp;</span><span class="r"></span></p>
131
+ <p class="pln"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
132
+ <p class="pln"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
133
+ <p class="run"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span><span class="op">(</span><span class="nam">frozen</span><span class="op">=</span><span class="key">True</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
134
+ <p class="run"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"><span class="key">class</span> <span class="nam">VerificationScore</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
135
+ <p class="pln"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
136
+ <p class="pln"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"><span class="str"> Immutable result of verification between two outputs.</span>&nbsp;</span><span class="r"></span></p>
137
+ <p class="pln"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
138
+ <p class="pln"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
139
+ <p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t"><span class="str"> drift_score: Overall drift score between 0.0 (identical) and 1.0 (completely different)</span>&nbsp;</span><span class="r"></span></p>
140
+ <p class="pln"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"><span class="str"> confidence: Confidence in the score (0.0 to 1.0)</span>&nbsp;</span><span class="r"></span></p>
141
+ <p class="pln"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"><span class="str"> drift_type: Primary type of drift detected</span>&nbsp;</span><span class="r"></span></p>
142
+ <p class="pln"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"><span class="str"> details: Dictionary with component scores</span>&nbsp;</span><span class="r"></span></p>
143
+ <p class="pln"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"><span class="str"> explanation: Optional drift explanation with dimension contributions (CMVK-010)</span>&nbsp;</span><span class="r"></span></p>
144
+ <p class="pln"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
145
+ <p class="pln"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
146
+ <p class="run"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">:</span> <span class="nam">float</span>&nbsp;</span><span class="r"></span></p>
147
+ <p class="run"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"> <span class="nam">confidence</span><span class="op">:</span> <span class="nam">float</span>&nbsp;</span><span class="r"></span></p>
148
+ <p class="run"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">:</span> <span class="nam">DriftType</span>&nbsp;</span><span class="r"></span></p>
149
+ <p class="run"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"> <span class="nam">details</span><span class="op">:</span> <span class="nam">dict</span>&nbsp;</span><span class="r"></span></p>
150
+ <p class="run"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"> <span class="nam">explanation</span><span class="op">:</span> <span class="nam">dict</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
151
+ <p class="pln"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
152
+ <p class="run"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"> <span class="key">def</span> <span class="nam">passed</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">threshold</span><span class="op">:</span> <span class="nam">float</span> <span class="op">=</span> <span class="num">0.3</span><span class="op">)</span> <span class="op">-></span> <span class="nam">bool</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
153
+ <p class="pln"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"> <span class="str">"""Check if drift is within acceptable threshold."""</span>&nbsp;</span><span class="r"></span></p>
154
+ <p class="mis show_mis"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">drift_score</span> <span class="op">&lt;=</span> <span class="nam">threshold</span>&nbsp;</span><span class="r"></span></p>
155
+ <p class="pln"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
156
+ <p class="run"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
157
+ <p class="pln"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"> <span class="str">"""Convert to dictionary for serialization."""</span>&nbsp;</span><span class="r"></span></p>
158
+ <p class="mis show_mis"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
159
+ <p class="mis mis2 show_mis"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> <span class="str">"drift_score"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">drift_score</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
160
+ <p class="mis mis2 show_mis"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"> <span class="str">"confidence"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
161
+ <p class="mis mis2 show_mis"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"> <span class="str">"drift_type"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">drift_type</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
162
+ <p class="mis mis2 show_mis"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t"> <span class="str">"details"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">details</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
163
+ <p class="mis mis2 show_mis"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t"> <span class="str">"explanation"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">explanation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
164
+ <p class="mis mis2 show_mis"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
165
+ <p class="pln"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
166
+ <p class="pln"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
167
+ <p class="run"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span><span class="op">(</span><span class="nam">frozen</span><span class="op">=</span><span class="key">True</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
168
+ <p class="run"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"><span class="key">class</span> <span class="nam">DriftExplanation</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
169
+ <p class="pln"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
170
+ <p class="pln"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"><span class="str"> Detailed explanation of drift between two vectors (CMVK-010).</span>&nbsp;</span><span class="r"></span></p>
171
+ <p class="pln"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
172
+ <p class="pln"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
173
+ <p class="pln"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"><span class="str"> primary_drift_dimension: Index or name of dimension with highest contribution</span>&nbsp;</span><span class="r"></span></p>
174
+ <p class="pln"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"><span class="str"> dimension_contributions: Mapping of dimension to its contribution percentage</span>&nbsp;</span><span class="r"></span></p>
175
+ <p class="pln"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"><span class="str"> top_contributors: List of top N contributing dimensions</span>&nbsp;</span><span class="r"></span></p>
176
+ <p class="pln"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"><span class="str"> metric_used: The distance metric used</span>&nbsp;</span><span class="r"></span></p>
177
+ <p class="pln"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"><span class="str"> interpretation: Human-readable interpretation of the drift</span>&nbsp;</span><span class="r"></span></p>
178
+ <p class="pln"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
179
+ <p class="pln"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
180
+ <p class="run"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"> <span class="nam">primary_drift_dimension</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span>&nbsp;</span><span class="r"></span></p>
181
+ <p class="run"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"> <span class="nam">dimension_contributions</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
182
+ <p class="run"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"> <span class="nam">top_contributors</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">tuple</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
183
+ <p class="run"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"> <span class="nam">metric_used</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
184
+ <p class="run"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t"> <span class="nam">interpretation</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
185
+ <p class="pln"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
186
+ <p class="run"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
187
+ <p class="pln"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t"> <span class="str">"""Convert to dictionary."""</span>&nbsp;</span><span class="r"></span></p>
188
+ <p class="mis show_mis"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
189
+ <p class="mis mis2 show_mis"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"> <span class="str">"primary_drift_dimension"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">primary_drift_dimension</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
190
+ <p class="mis mis2 show_mis"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"> <span class="str">"dimension_contributions"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">dimension_contributions</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
191
+ <p class="mis mis2 show_mis"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"> <span class="str">"top_contributors"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">top_contributors</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
192
+ <p class="mis mis2 show_mis"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"> <span class="str">"metric_used"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">metric_used</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
193
+ <p class="mis mis2 show_mis"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"> <span class="str">"interpretation"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">interpretation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
194
+ <p class="mis mis2 show_mis"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
195
+ <p class="pln"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
196
+ <p class="pln"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
197
+ <p class="run"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t"><span class="key">def</span> <span class="nam">verify</span><span class="op">(</span><span class="nam">output_a</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">output_b</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">VerificationScore</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
198
+ <p class="pln"><span class="n"><a id="t114" href="#t114">114</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
199
+ <p class="pln"><span class="n"><a id="t115" href="#t115">115</a></span><span class="t"><span class="str"> Calculate drift/hallucination score between two outputs.</span>&nbsp;</span><span class="r"></span></p>
200
+ <p class="pln"><span class="n"><a id="t116" href="#t116">116</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
201
+ <p class="pln"><span class="n"><a id="t117" href="#t117">117</a></span><span class="t"><span class="str"> This is the primary verification function - a pure function with no side effects.</span>&nbsp;</span><span class="r"></span></p>
202
+ <p class="pln"><span class="n"><a id="t118" href="#t118">118</a></span><span class="t"><span class="str"> Takes two outputs and returns a score indicating their divergence.</span>&nbsp;</span><span class="r"></span></p>
203
+ <p class="pln"><span class="n"><a id="t119" href="#t119">119</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
204
+ <p class="pln"><span class="n"><a id="t120" href="#t120">120</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
205
+ <p class="pln"><span class="n"><a id="t121" href="#t121">121</a></span><span class="t"><span class="str"> output_a: First output (typically from model A / generator)</span>&nbsp;</span><span class="r"></span></p>
206
+ <p class="pln"><span class="n"><a id="t122" href="#t122">122</a></span><span class="t"><span class="str"> output_b: Second output (typically from model B / verifier)</span>&nbsp;</span><span class="r"></span></p>
207
+ <p class="pln"><span class="n"><a id="t123" href="#t123">123</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
208
+ <p class="pln"><span class="n"><a id="t124" href="#t124">124</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
209
+ <p class="pln"><span class="n"><a id="t125" href="#t125">125</a></span><span class="t"><span class="str"> VerificationScore with drift score, confidence, and details</span>&nbsp;</span><span class="r"></span></p>
210
+ <p class="pln"><span class="n"><a id="t126" href="#t126">126</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
211
+ <p class="pln"><span class="n"><a id="t127" href="#t127">127</a></span><span class="t"><span class="str"> Example:</span>&nbsp;</span><span class="r"></span></p>
212
+ <p class="pln"><span class="n"><a id="t128" href="#t128">128</a></span><span class="t"><span class="str"> >>> score = verify("def add(a, b): return a + b", "def add(x, y): return x + y")</span>&nbsp;</span><span class="r"></span></p>
213
+ <p class="pln"><span class="n"><a id="t129" href="#t129">129</a></span><span class="t"><span class="str"> >>> score.drift_score # Low score - semantically similar</span>&nbsp;</span><span class="r"></span></p>
214
+ <p class="pln"><span class="n"><a id="t130" href="#t130">130</a></span><span class="t"><span class="str"> 0.15</span>&nbsp;</span><span class="r"></span></p>
215
+ <p class="pln"><span class="n"><a id="t131" href="#t131">131</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
216
+ <p class="mis show_mis"><span class="n"><a id="t132" href="#t132">132</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">output_a</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">output_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
217
+ <p class="mis show_mis"><span class="n"><a id="t133" href="#t133">133</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
218
+ <p class="mis mis2 show_mis"><span class="n"><a id="t134" href="#t134">134</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="num">0.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
219
+ <p class="mis mis2 show_mis"><span class="n"><a id="t135" href="#t135">135</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
220
+ <p class="mis mis2 show_mis"><span class="n"><a id="t136" href="#t136">136</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">LEXICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
221
+ <p class="mis mis2 show_mis"><span class="n"><a id="t137" href="#t137">137</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span><span class="str">"reason"</span><span class="op">:</span> <span class="str">"both_empty"</span><span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
222
+ <p class="mis mis2 show_mis"><span class="n"><a id="t138" href="#t138">138</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
223
+ <p class="pln"><span class="n"><a id="t139" href="#t139">139</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
224
+ <p class="mis show_mis"><span class="n"><a id="t140" href="#t140">140</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">output_a</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">output_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
225
+ <p class="mis show_mis"><span class="n"><a id="t141" href="#t141">141</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
226
+ <p class="mis mis2 show_mis"><span class="n"><a id="t142" href="#t142">142</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
227
+ <p class="mis mis2 show_mis"><span class="n"><a id="t143" href="#t143">143</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
228
+ <p class="mis mis2 show_mis"><span class="n"><a id="t144" href="#t144">144</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">STRUCTURAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
229
+ <p class="mis mis2 show_mis"><span class="n"><a id="t145" href="#t145">145</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span><span class="str">"reason"</span><span class="op">:</span> <span class="str">"one_empty"</span><span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
230
+ <p class="mis mis2 show_mis"><span class="n"><a id="t146" href="#t146">146</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
231
+ <p class="pln"><span class="n"><a id="t147" href="#t147">147</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
232
+ <p class="pln"><span class="n"><a id="t148" href="#t148">148</a></span><span class="t"> <span class="com"># Calculate multiple drift components</span>&nbsp;</span><span class="r"></span></p>
233
+ <p class="mis show_mis"><span class="n"><a id="t149" href="#t149">149</a></span><span class="t"> <span class="nam">lexical_drift</span> <span class="op">=</span> <span class="nam">_lexical_drift</span><span class="op">(</span><span class="nam">output_a</span><span class="op">,</span> <span class="nam">output_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
234
+ <p class="mis show_mis"><span class="n"><a id="t150" href="#t150">150</a></span><span class="t"> <span class="nam">structural_drift</span> <span class="op">=</span> <span class="nam">_structural_drift</span><span class="op">(</span><span class="nam">output_a</span><span class="op">,</span> <span class="nam">output_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
235
+ <p class="mis show_mis"><span class="n"><a id="t151" href="#t151">151</a></span><span class="t"> <span class="nam">numerical_drift</span> <span class="op">=</span> <span class="nam">_numerical_drift</span><span class="op">(</span><span class="nam">output_a</span><span class="op">,</span> <span class="nam">output_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
236
+ <p class="pln"><span class="n"><a id="t152" href="#t152">152</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
237
+ <p class="pln"><span class="n"><a id="t153" href="#t153">153</a></span><span class="t"> <span class="com"># Weighted combination</span>&nbsp;</span><span class="r"></span></p>
238
+ <p class="mis show_mis"><span class="n"><a id="t154" href="#t154">154</a></span><span class="t"> <span class="nam">weights</span> <span class="op">=</span> <span class="op">{</span><span class="str">"lexical"</span><span class="op">:</span> <span class="num">0.3</span><span class="op">,</span> <span class="str">"structural"</span><span class="op">:</span> <span class="num">0.4</span><span class="op">,</span> <span class="str">"numerical"</span><span class="op">:</span> <span class="num">0.3</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
239
+ <p class="pln"><span class="n"><a id="t155" href="#t155">155</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
240
+ <p class="mis show_mis"><span class="n"><a id="t156" href="#t156">156</a></span><span class="t"> <span class="nam">combined_drift</span> <span class="op">=</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
241
+ <p class="mis mis2 show_mis"><span class="n"><a id="t157" href="#t157">157</a></span><span class="t"> <span class="nam">weights</span><span class="op">[</span><span class="str">"lexical"</span><span class="op">]</span> <span class="op">*</span> <span class="nam">lexical_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
242
+ <p class="mis mis2 show_mis"><span class="n"><a id="t158" href="#t158">158</a></span><span class="t"> <span class="op">+</span> <span class="nam">weights</span><span class="op">[</span><span class="str">"structural"</span><span class="op">]</span> <span class="op">*</span> <span class="nam">structural_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
243
+ <p class="mis mis2 show_mis"><span class="n"><a id="t159" href="#t159">159</a></span><span class="t"> <span class="op">+</span> <span class="nam">weights</span><span class="op">[</span><span class="str">"numerical"</span><span class="op">]</span> <span class="op">*</span> <span class="nam">numerical_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
244
+ <p class="mis mis2 show_mis"><span class="n"><a id="t160" href="#t160">160</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
245
+ <p class="pln"><span class="n"><a id="t161" href="#t161">161</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
246
+ <p class="pln"><span class="n"><a id="t162" href="#t162">162</a></span><span class="t"> <span class="com"># Determine primary drift type</span>&nbsp;</span><span class="r"></span></p>
247
+ <p class="mis show_mis"><span class="n"><a id="t163" href="#t163">163</a></span><span class="t"> <span class="nam">scores</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
248
+ <p class="mis mis2 show_mis"><span class="n"><a id="t164" href="#t164">164</a></span><span class="t"> <span class="nam">DriftType</span><span class="op">.</span><span class="nam">LEXICAL</span><span class="op">:</span> <span class="nam">lexical_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
249
+ <p class="mis mis2 show_mis"><span class="n"><a id="t165" href="#t165">165</a></span><span class="t"> <span class="nam">DriftType</span><span class="op">.</span><span class="nam">STRUCTURAL</span><span class="op">:</span> <span class="nam">structural_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
250
+ <p class="mis mis2 show_mis"><span class="n"><a id="t166" href="#t166">166</a></span><span class="t"> <span class="nam">DriftType</span><span class="op">.</span><span class="nam">NUMERICAL</span><span class="op">:</span> <span class="nam">numerical_drift</span><span class="op">[</span><span class="str">"score"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
251
+ <p class="mis mis2 show_mis"><span class="n"><a id="t167" href="#t167">167</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
252
+ <p class="mis show_mis"><span class="n"><a id="t168" href="#t168">168</a></span><span class="t"> <span class="nam">primary_drift</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">scores</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">lambda</span> <span class="nam">k</span><span class="op">:</span> <span class="nam">scores</span><span class="op">[</span><span class="nam">k</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
253
+ <p class="pln"><span class="n"><a id="t169" href="#t169">169</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
254
+ <p class="pln"><span class="n"><a id="t170" href="#t170">170</a></span><span class="t"> <span class="com"># Calculate confidence based on agreement between methods</span>&nbsp;</span><span class="r"></span></p>
255
+ <p class="mis show_mis"><span class="n"><a id="t171" href="#t171">171</a></span><span class="t"> <span class="nam">score_values</span> <span class="op">=</span> <span class="nam">list</span><span class="op">(</span><span class="nam">scores</span><span class="op">.</span><span class="nam">values</span><span class="op">(</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
256
+ <p class="mis show_mis"><span class="n"><a id="t172" href="#t172">172</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">np</span><span class="op">.</span><span class="nam">std</span><span class="op">(</span><span class="nam">score_values</span><span class="op">)</span> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">score_values</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span> <span class="key">else</span> <span class="num">0.8</span>&nbsp;</span><span class="r"></span></p>
257
+ <p class="pln"><span class="n"><a id="t173" href="#t173">173</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
258
+ <p class="mis show_mis"><span class="n"><a id="t174" href="#t174">174</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
259
+ <p class="mis mis2 show_mis"><span class="n"><a id="t175" href="#t175">175</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">combined_drift</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
260
+ <p class="mis mis2 show_mis"><span class="n"><a id="t176" href="#t176">176</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">confidence</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
261
+ <p class="mis mis2 show_mis"><span class="n"><a id="t177" href="#t177">177</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">primary_drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
262
+ <p class="mis mis2 show_mis"><span class="n"><a id="t178" href="#t178">178</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
263
+ <p class="mis mis2 show_mis"><span class="n"><a id="t179" href="#t179">179</a></span><span class="t"> <span class="str">"lexical"</span><span class="op">:</span> <span class="nam">lexical_drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
264
+ <p class="mis mis2 show_mis"><span class="n"><a id="t180" href="#t180">180</a></span><span class="t"> <span class="str">"structural"</span><span class="op">:</span> <span class="nam">structural_drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
265
+ <p class="mis mis2 show_mis"><span class="n"><a id="t181" href="#t181">181</a></span><span class="t"> <span class="str">"numerical"</span><span class="op">:</span> <span class="nam">numerical_drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
266
+ <p class="mis mis2 show_mis"><span class="n"><a id="t182" href="#t182">182</a></span><span class="t"> <span class="str">"weights"</span><span class="op">:</span> <span class="nam">weights</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
267
+ <p class="mis mis2 show_mis"><span class="n"><a id="t183" href="#t183">183</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
268
+ <p class="mis mis2 show_mis"><span class="n"><a id="t184" href="#t184">184</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
269
+ <p class="pln"><span class="n"><a id="t185" href="#t185">185</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
270
+ <p class="pln"><span class="n"><a id="t186" href="#t186">186</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
271
+ <p class="run"><span class="n"><a id="t187" href="#t187">187</a></span><span class="t"><span class="key">def</span> <span class="nam">verify_embeddings</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
272
+ <p class="run run2"><span class="n"><a id="t188" href="#t188">188</a></span><span class="t"> <span class="nam">embedding_a</span><span class="op">:</span> <span class="nam">ArrayLike</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
273
+ <p class="run run2"><span class="n"><a id="t189" href="#t189">189</a></span><span class="t"> <span class="nam">embedding_b</span><span class="op">:</span> <span class="nam">ArrayLike</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
274
+ <p class="run run2"><span class="n"><a id="t190" href="#t190">190</a></span><span class="t"> <span class="nam">metric</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"cosine"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
275
+ <p class="run run2"><span class="n"><a id="t191" href="#t191">191</a></span><span class="t"> <span class="nam">weights</span><span class="op">:</span> <span class="nam">ArrayLike</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
276
+ <p class="run run2"><span class="n"><a id="t192" href="#t192">192</a></span><span class="t"> <span class="nam">threshold_profile</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
277
+ <p class="run run2"><span class="n"><a id="t193" href="#t193">193</a></span><span class="t"> <span class="nam">explain</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">False</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
278
+ <p class="run run2"><span class="n"><a id="t194" href="#t194">194</a></span><span class="t"> <span class="nam">dimension_names</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
279
+ <p class="run run2"><span class="n"><a id="t195" href="#t195">195</a></span><span class="t"> <span class="nam">audit_trail</span><span class="op">:</span> <span class="nam">AuditTrail</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
280
+ <p class="run run2"><span class="n"><a id="t196" href="#t196">196</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">VerificationScore</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
281
+ <p class="pln"><span class="n"><a id="t197" href="#t197">197</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
282
+ <p class="pln"><span class="n"><a id="t198" href="#t198">198</a></span><span class="t"><span class="str"> Calculate drift score between two embedding vectors.</span>&nbsp;</span><span class="r"></span></p>
283
+ <p class="pln"><span class="n"><a id="t199" href="#t199">199</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
284
+ <p class="pln"><span class="n"><a id="t200" href="#t200">200</a></span><span class="t"><span class="str"> Enhanced verification function with configurable metrics, weighting,</span>&nbsp;</span><span class="r"></span></p>
285
+ <p class="pln"><span class="n"><a id="t201" href="#t201">201</a></span><span class="t"><span class="str"> threshold profiles, and explainability (CMVK-001 through CMVK-010).</span>&nbsp;</span><span class="r"></span></p>
286
+ <p class="pln"><span class="n"><a id="t202" href="#t202">202</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
287
+ <p class="pln"><span class="n"><a id="t203" href="#t203">203</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
288
+ <p class="pln"><span class="n"><a id="t204" href="#t204">204</a></span><span class="t"><span class="str"> embedding_a: Embedding vector for output A (e.g., claimed values)</span>&nbsp;</span><span class="r"></span></p>
289
+ <p class="pln"><span class="n"><a id="t205" href="#t205">205</a></span><span class="t"><span class="str"> embedding_b: Embedding vector for output B (e.g., observed values)</span>&nbsp;</span><span class="r"></span></p>
290
+ <p class="pln"><span class="n"><a id="t206" href="#t206">206</a></span><span class="t"><span class="str"> metric: Distance metric to use. Options:</span>&nbsp;</span><span class="r"></span></p>
291
+ <p class="pln"><span class="n"><a id="t207" href="#t207">207</a></span><span class="t"><span class="str"> - "cosine": Cosine distance (default, normalizes vectors)</span>&nbsp;</span><span class="r"></span></p>
292
+ <p class="pln"><span class="n"><a id="t208" href="#t208">208</a></span><span class="t"><span class="str"> - "euclidean": Euclidean distance (preserves magnitude - CMVK-001)</span>&nbsp;</span><span class="r"></span></p>
293
+ <p class="pln"><span class="n"><a id="t209" href="#t209">209</a></span><span class="t"><span class="str"> - "manhattan": Manhattan/L1 distance</span>&nbsp;</span><span class="r"></span></p>
294
+ <p class="pln"><span class="n"><a id="t210" href="#t210">210</a></span><span class="t"><span class="str"> - "chebyshev": Maximum absolute difference</span>&nbsp;</span><span class="r"></span></p>
295
+ <p class="pln"><span class="n"><a id="t211" href="#t211">211</a></span><span class="t"><span class="str"> - "mahalanobis": Mahalanobis distance</span>&nbsp;</span><span class="r"></span></p>
296
+ <p class="pln"><span class="n"><a id="t212" href="#t212">212</a></span><span class="t"><span class="str"> weights: Optional weights for each dimension (CMVK-008).</span>&nbsp;</span><span class="r"></span></p>
297
+ <p class="pln"><span class="n"><a id="t213" href="#t213">213</a></span><span class="t"><span class="str"> Higher weights increase that dimension's contribution to drift.</span>&nbsp;</span><span class="r"></span></p>
298
+ <p class="pln"><span class="n"><a id="t214" href="#t214">214</a></span><span class="t"><span class="str"> threshold_profile: Name of threshold profile to use (CMVK-005).</span>&nbsp;</span><span class="r"></span></p>
299
+ <p class="pln"><span class="n"><a id="t215" href="#t215">215</a></span><span class="t"><span class="str"> Options: "carbon", "financial", "medical", "general", "strict"</span>&nbsp;</span><span class="r"></span></p>
300
+ <p class="pln"><span class="n"><a id="t216" href="#t216">216</a></span><span class="t"><span class="str"> explain: If True, include detailed drift explanation (CMVK-010)</span>&nbsp;</span><span class="r"></span></p>
301
+ <p class="pln"><span class="n"><a id="t217" href="#t217">217</a></span><span class="t"><span class="str"> dimension_names: Optional names for dimensions (for explainability)</span>&nbsp;</span><span class="r"></span></p>
302
+ <p class="pln"><span class="n"><a id="t218" href="#t218">218</a></span><span class="t"><span class="str"> audit_trail: Optional AuditTrail instance for logging (CMVK-006)</span>&nbsp;</span><span class="r"></span></p>
303
+ <p class="pln"><span class="n"><a id="t219" href="#t219">219</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
304
+ <p class="pln"><span class="n"><a id="t220" href="#t220">220</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
305
+ <p class="pln"><span class="n"><a id="t221" href="#t221">221</a></span><span class="t"><span class="str"> VerificationScore with drift score, confidence, and optional explanation</span>&nbsp;</span><span class="r"></span></p>
306
+ <p class="pln"><span class="n"><a id="t222" href="#t222">222</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
307
+ <p class="pln"><span class="n"><a id="t223" href="#t223">223</a></span><span class="t"><span class="str"> Example:</span>&nbsp;</span><span class="r"></span></p>
308
+ <p class="pln"><span class="n"><a id="t224" href="#t224">224</a></span><span class="t"><span class="str"> >>> # Basic usage</span>&nbsp;</span><span class="r"></span></p>
309
+ <p class="pln"><span class="n"><a id="t225" href="#t225">225</a></span><span class="t"><span class="str"> >>> score = verify_embeddings(claim_vec, obs_vec)</span>&nbsp;</span><span class="r"></span></p>
310
+ <p class="pln"><span class="n"><a id="t226" href="#t226">226</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
311
+ <p class="pln"><span class="n"><a id="t227" href="#t227">227</a></span><span class="t"><span class="str"> >>> # With Euclidean distance for magnitude-sensitive comparison</span>&nbsp;</span><span class="r"></span></p>
312
+ <p class="pln"><span class="n"><a id="t228" href="#t228">228</a></span><span class="t"><span class="str"> >>> score = verify_embeddings(</span>&nbsp;</span><span class="r"></span></p>
313
+ <p class="pln"><span class="n"><a id="t229" href="#t229">229</a></span><span class="t"><span class="str"> ... claim_vec, obs_vec,</span>&nbsp;</span><span class="r"></span></p>
314
+ <p class="pln"><span class="n"><a id="t230" href="#t230">230</a></span><span class="t"><span class="str"> ... metric="euclidean",</span>&nbsp;</span><span class="r"></span></p>
315
+ <p class="pln"><span class="n"><a id="t231" href="#t231">231</a></span><span class="t"><span class="str"> ... threshold_profile="carbon",</span>&nbsp;</span><span class="r"></span></p>
316
+ <p class="pln"><span class="n"><a id="t232" href="#t232">232</a></span><span class="t"><span class="str"> ... explain=True</span>&nbsp;</span><span class="r"></span></p>
317
+ <p class="pln"><span class="n"><a id="t233" href="#t233">233</a></span><span class="t"><span class="str"> ... )</span>&nbsp;</span><span class="r"></span></p>
318
+ <p class="pln"><span class="n"><a id="t234" href="#t234">234</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
319
+ <p class="pln"><span class="n"><a id="t235" href="#t235">235</a></span><span class="t"><span class="str"> >>> # With dimensional weighting</span>&nbsp;</span><span class="r"></span></p>
320
+ <p class="pln"><span class="n"><a id="t236" href="#t236">236</a></span><span class="t"><span class="str"> >>> score = verify_embeddings(</span>&nbsp;</span><span class="r"></span></p>
321
+ <p class="pln"><span class="n"><a id="t237" href="#t237">237</a></span><span class="t"><span class="str"> ... claim_vec, obs_vec,</span>&nbsp;</span><span class="r"></span></p>
322
+ <p class="pln"><span class="n"><a id="t238" href="#t238">238</a></span><span class="t"><span class="str"> ... metric="euclidean",</span>&nbsp;</span><span class="r"></span></p>
323
+ <p class="pln"><span class="n"><a id="t239" href="#t239">239</a></span><span class="t"><span class="str"> ... weights=[0.6, 0.4], # NDVI more important than carbon</span>&nbsp;</span><span class="r"></span></p>
324
+ <p class="pln"><span class="n"><a id="t240" href="#t240">240</a></span><span class="t"><span class="str"> ... explain=True,</span>&nbsp;</span><span class="r"></span></p>
325
+ <p class="pln"><span class="n"><a id="t241" href="#t241">241</a></span><span class="t"><span class="str"> ... dimension_names=["ndvi", "carbon_stock"]</span>&nbsp;</span><span class="r"></span></p>
326
+ <p class="pln"><span class="n"><a id="t242" href="#t242">242</a></span><span class="t"><span class="str"> ... )</span>&nbsp;</span><span class="r"></span></p>
327
+ <p class="pln"><span class="n"><a id="t243" href="#t243">243</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
328
+ <p class="mis show_mis"><span class="n"><a id="t244" href="#t244">244</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">metrics</span> <span class="key">import</span> <span class="nam">calculate_distance</span><span class="op">,</span> <span class="nam">calculate_weighted_distance</span>&nbsp;</span><span class="r"></span></p>
329
+ <p class="pln"><span class="n"><a id="t245" href="#t245">245</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
330
+ <p class="mis show_mis"><span class="n"><a id="t246" href="#t246">246</a></span><span class="t"> <span class="nam">vec_a</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">asarray</span><span class="op">(</span><span class="nam">embedding_a</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">float64</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
331
+ <p class="mis show_mis"><span class="n"><a id="t247" href="#t247">247</a></span><span class="t"> <span class="nam">vec_b</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">asarray</span><span class="op">(</span><span class="nam">embedding_b</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">float64</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
332
+ <p class="pln"><span class="n"><a id="t248" href="#t248">248</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
333
+ <p class="pln"><span class="n"><a id="t249" href="#t249">249</a></span><span class="t"> <span class="com"># Load threshold profile if specified</span>&nbsp;</span><span class="r"></span></p>
334
+ <p class="mis show_mis"><span class="n"><a id="t250" href="#t250">250</a></span><span class="t"> <span class="nam">profile</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
335
+ <p class="mis show_mis"><span class="n"><a id="t251" href="#t251">251</a></span><span class="t"> <span class="key">if</span> <span class="nam">threshold_profile</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
336
+ <p class="mis show_mis"><span class="n"><a id="t252" href="#t252">252</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">profiles</span> <span class="key">import</span> <span class="nam">get_profile</span>&nbsp;</span><span class="r"></span></p>
337
+ <p class="pln"><span class="n"><a id="t253" href="#t253">253</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
338
+ <p class="mis show_mis"><span class="n"><a id="t254" href="#t254">254</a></span><span class="t"> <span class="nam">profile</span> <span class="op">=</span> <span class="nam">get_profile</span><span class="op">(</span><span class="nam">threshold_profile</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
339
+ <p class="pln"><span class="n"><a id="t255" href="#t255">255</a></span><span class="t"> <span class="com"># Use profile's default metric if none specified</span>&nbsp;</span><span class="r"></span></p>
340
+ <p class="mis show_mis"><span class="n"><a id="t256" href="#t256">256</a></span><span class="t"> <span class="key">if</span> <span class="nam">metric</span> <span class="op">==</span> <span class="str">"cosine"</span> <span class="key">and</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">default_metric</span> <span class="op">!=</span> <span class="str">"cosine"</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
341
+ <p class="mis show_mis"><span class="n"><a id="t257" href="#t257">257</a></span><span class="t"> <span class="nam">metric</span> <span class="op">=</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">default_metric</span>&nbsp;</span><span class="r"></span></p>
342
+ <p class="pln"><span class="n"><a id="t258" href="#t258">258</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
343
+ <p class="pln"><span class="n"><a id="t259" href="#t259">259</a></span><span class="t"> <span class="com"># Shape validation</span>&nbsp;</span><span class="r"></span></p>
344
+ <p class="mis show_mis"><span class="n"><a id="t260" href="#t260">260</a></span><span class="t"> <span class="key">if</span> <span class="nam">vec_a</span><span class="op">.</span><span class="nam">shape</span> <span class="op">!=</span> <span class="nam">vec_b</span><span class="op">.</span><span class="nam">shape</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
345
+ <p class="mis show_mis"><span class="n"><a id="t261" href="#t261">261</a></span><span class="t"> <span class="nam">result</span> <span class="op">=</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
346
+ <p class="mis mis2 show_mis"><span class="n"><a id="t262" href="#t262">262</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
347
+ <p class="mis mis2 show_mis"><span class="n"><a id="t263" href="#t263">263</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">0.5</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
348
+ <p class="mis mis2 show_mis"><span class="n"><a id="t264" href="#t264">264</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">STRUCTURAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
349
+ <p class="mis mis2 show_mis"><span class="n"><a id="t265" href="#t265">265</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span><span class="str">"reason"</span><span class="op">:</span> <span class="str">"shape_mismatch"</span><span class="op">,</span> <span class="str">"shape_a"</span><span class="op">:</span> <span class="nam">vec_a</span><span class="op">.</span><span class="nam">shape</span><span class="op">,</span> <span class="str">"shape_b"</span><span class="op">:</span> <span class="nam">vec_b</span><span class="op">.</span><span class="nam">shape</span><span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
350
+ <p class="mis mis2 show_mis"><span class="n"><a id="t266" href="#t266">266</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
351
+ <p class="mis show_mis"><span class="n"><a id="t267" href="#t267">267</a></span><span class="t"> <span class="key">if</span> <span class="nam">audit_trail</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
352
+ <p class="mis show_mis"><span class="n"><a id="t268" href="#t268">268</a></span><span class="t"> <span class="nam">_log_to_audit</span><span class="op">(</span><span class="nam">audit_trail</span><span class="op">,</span> <span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">result</span><span class="op">,</span> <span class="nam">metric</span><span class="op">,</span> <span class="nam">threshold_profile</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
353
+ <p class="mis show_mis"><span class="n"><a id="t269" href="#t269">269</a></span><span class="t"> <span class="key">return</span> <span class="nam">result</span>&nbsp;</span><span class="r"></span></p>
354
+ <p class="pln"><span class="n"><a id="t270" href="#t270">270</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
355
+ <p class="pln"><span class="n"><a id="t271" href="#t271">271</a></span><span class="t"> <span class="com"># Calculate distance with appropriate function</span>&nbsp;</span><span class="r"></span></p>
356
+ <p class="mis show_mis"><span class="n"><a id="t272" href="#t272">272</a></span><span class="t"> <span class="key">if</span> <span class="nam">weights</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
357
+ <p class="mis show_mis"><span class="n"><a id="t273" href="#t273">273</a></span><span class="t"> <span class="nam">metric_result</span> <span class="op">=</span> <span class="nam">calculate_weighted_distance</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">weights</span><span class="op">=</span><span class="nam">weights</span><span class="op">,</span> <span class="nam">metric</span><span class="op">=</span><span class="nam">metric</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
358
+ <p class="pln"><span class="n"><a id="t274" href="#t274">274</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
359
+ <p class="mis show_mis"><span class="n"><a id="t275" href="#t275">275</a></span><span class="t"> <span class="nam">metric_result</span> <span class="op">=</span> <span class="nam">calculate_distance</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">metric</span><span class="op">=</span><span class="nam">metric</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
360
+ <p class="pln"><span class="n"><a id="t276" href="#t276">276</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
361
+ <p class="pln"><span class="n"><a id="t277" href="#t277">277</a></span><span class="t"> <span class="com"># Build drift score from normalized distance</span>&nbsp;</span><span class="r"></span></p>
362
+ <p class="mis show_mis"><span class="n"><a id="t278" href="#t278">278</a></span><span class="t"> <span class="nam">drift_score</span> <span class="op">=</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">metric_result</span><span class="op">.</span><span class="nam">normalized</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
363
+ <p class="pln"><span class="n"><a id="t279" href="#t279">279</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
364
+ <p class="pln"><span class="n"><a id="t280" href="#t280">280</a></span><span class="t"> <span class="com"># Calculate confidence based on vector properties</span>&nbsp;</span><span class="r"></span></p>
365
+ <p class="mis show_mis"><span class="n"><a id="t281" href="#t281">281</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">=</span> <span class="nam">_calculate_embedding_confidence</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
366
+ <p class="pln"><span class="n"><a id="t282" href="#t282">282</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
367
+ <p class="pln"><span class="n"><a id="t283" href="#t283">283</a></span><span class="t"> <span class="com"># Build explanation if requested</span>&nbsp;</span><span class="r"></span></p>
368
+ <p class="mis show_mis"><span class="n"><a id="t284" href="#t284">284</a></span><span class="t"> <span class="nam">explanation_dict</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
369
+ <p class="mis show_mis"><span class="n"><a id="t285" href="#t285">285</a></span><span class="t"> <span class="key">if</span> <span class="nam">explain</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
370
+ <p class="mis show_mis"><span class="n"><a id="t286" href="#t286">286</a></span><span class="t"> <span class="nam">explanation</span> <span class="op">=</span> <span class="nam">_build_drift_explanation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
371
+ <p class="mis mis2 show_mis"><span class="n"><a id="t287" href="#t287">287</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">metric_result</span><span class="op">,</span> <span class="nam">weights</span><span class="op">,</span> <span class="nam">dimension_names</span>&nbsp;</span><span class="r"></span></p>
372
+ <p class="mis mis2 show_mis"><span class="n"><a id="t288" href="#t288">288</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
373
+ <p class="mis show_mis"><span class="n"><a id="t289" href="#t289">289</a></span><span class="t"> <span class="nam">explanation_dict</span> <span class="op">=</span> <span class="nam">explanation</span><span class="op">.</span><span class="nam">to_dict</span><span class="op">(</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
374
+ <p class="pln"><span class="n"><a id="t290" href="#t290">290</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
375
+ <p class="pln"><span class="n"><a id="t291" href="#t291">291</a></span><span class="t"> <span class="com"># Build details</span>&nbsp;</span><span class="r"></span></p>
376
+ <p class="mis show_mis"><span class="n"><a id="t292" href="#t292">292</a></span><span class="t"> <span class="nam">details</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
377
+ <p class="mis mis2 show_mis"><span class="n"><a id="t293" href="#t293">293</a></span><span class="t"> <span class="str">"metric"</span><span class="op">:</span> <span class="nam">metric</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
378
+ <p class="mis mis2 show_mis"><span class="n"><a id="t294" href="#t294">294</a></span><span class="t"> <span class="str">"raw_distance"</span><span class="op">:</span> <span class="nam">metric_result</span><span class="op">.</span><span class="nam">distance</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
379
+ <p class="mis mis2 show_mis"><span class="n"><a id="t295" href="#t295">295</a></span><span class="t"> <span class="str">"normalized_distance"</span><span class="op">:</span> <span class="nam">metric_result</span><span class="op">.</span><span class="nam">normalized</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
380
+ <p class="mis mis2 show_mis"><span class="n"><a id="t296" href="#t296">296</a></span><span class="t"> <span class="op">**</span><span class="nam">metric_result</span><span class="op">.</span><span class="nam">details</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
381
+ <p class="mis mis2 show_mis"><span class="n"><a id="t297" href="#t297">297</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
382
+ <p class="pln"><span class="n"><a id="t298" href="#t298">298</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
383
+ <p class="pln"><span class="n"><a id="t299" href="#t299">299</a></span><span class="t"> <span class="com"># Add profile info if used</span>&nbsp;</span><span class="r"></span></p>
384
+ <p class="mis show_mis"><span class="n"><a id="t300" href="#t300">300</a></span><span class="t"> <span class="key">if</span> <span class="nam">profile</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
385
+ <p class="mis show_mis"><span class="n"><a id="t301" href="#t301">301</a></span><span class="t"> <span class="nam">passed</span> <span class="op">=</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">is_within_threshold</span><span class="op">(</span><span class="nam">drift_score</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
386
+ <p class="mis show_mis"><span class="n"><a id="t302" href="#t302">302</a></span><span class="t"> <span class="nam">severity</span> <span class="op">=</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">get_severity</span><span class="op">(</span><span class="nam">drift_score</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
387
+ <p class="mis show_mis"><span class="n"><a id="t303" href="#t303">303</a></span><span class="t"> <span class="nam">details</span><span class="op">[</span><span class="str">"profile"</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
388
+ <p class="mis mis2 show_mis"><span class="n"><a id="t304" href="#t304">304</a></span><span class="t"> <span class="str">"name"</span><span class="op">:</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
389
+ <p class="mis mis2 show_mis"><span class="n"><a id="t305" href="#t305">305</a></span><span class="t"> <span class="str">"drift_threshold"</span><span class="op">:</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">drift_threshold</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
390
+ <p class="mis mis2 show_mis"><span class="n"><a id="t306" href="#t306">306</a></span><span class="t"> <span class="str">"passed"</span><span class="op">:</span> <span class="nam">passed</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
391
+ <p class="mis mis2 show_mis"><span class="n"><a id="t307" href="#t307">307</a></span><span class="t"> <span class="str">"severity"</span><span class="op">:</span> <span class="nam">severity</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
392
+ <p class="mis mis2 show_mis"><span class="n"><a id="t308" href="#t308">308</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
393
+ <p class="pln"><span class="n"><a id="t309" href="#t309">309</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
394
+ <p class="mis show_mis"><span class="n"><a id="t310" href="#t310">310</a></span><span class="t"> <span class="nam">result</span> <span class="op">=</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
395
+ <p class="mis mis2 show_mis"><span class="n"><a id="t311" href="#t311">311</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="nam">drift_score</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
396
+ <p class="mis mis2 show_mis"><span class="n"><a id="t312" href="#t312">312</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
397
+ <p class="mis mis2 show_mis"><span class="n"><a id="t313" href="#t313">313</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">SEMANTIC</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
398
+ <p class="mis mis2 show_mis"><span class="n"><a id="t314" href="#t314">314</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="nam">details</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
399
+ <p class="mis mis2 show_mis"><span class="n"><a id="t315" href="#t315">315</a></span><span class="t"> <span class="nam">explanation</span><span class="op">=</span><span class="nam">explanation_dict</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
400
+ <p class="mis mis2 show_mis"><span class="n"><a id="t316" href="#t316">316</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
401
+ <p class="pln"><span class="n"><a id="t317" href="#t317">317</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
402
+ <p class="pln"><span class="n"><a id="t318" href="#t318">318</a></span><span class="t"> <span class="com"># Log to audit trail if provided</span>&nbsp;</span><span class="r"></span></p>
403
+ <p class="mis show_mis"><span class="n"><a id="t319" href="#t319">319</a></span><span class="t"> <span class="key">if</span> <span class="nam">audit_trail</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
404
+ <p class="mis show_mis"><span class="n"><a id="t320" href="#t320">320</a></span><span class="t"> <span class="nam">_log_to_audit</span><span class="op">(</span><span class="nam">audit_trail</span><span class="op">,</span> <span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">result</span><span class="op">,</span> <span class="nam">metric</span><span class="op">,</span> <span class="nam">threshold_profile</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
405
+ <p class="pln"><span class="n"><a id="t321" href="#t321">321</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
406
+ <p class="mis show_mis"><span class="n"><a id="t322" href="#t322">322</a></span><span class="t"> <span class="key">return</span> <span class="nam">result</span>&nbsp;</span><span class="r"></span></p>
407
+ <p class="pln"><span class="n"><a id="t323" href="#t323">323</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
408
+ <p class="pln"><span class="n"><a id="t324" href="#t324">324</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
409
+ <p class="run"><span class="n"><a id="t325" href="#t325">325</a></span><span class="t"><span class="key">def</span> <span class="nam">verify_embeddings_batch</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
410
+ <p class="run run2"><span class="n"><a id="t326" href="#t326">326</a></span><span class="t"> <span class="nam">embeddings_a</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">ArrayLike</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
411
+ <p class="run run2"><span class="n"><a id="t327" href="#t327">327</a></span><span class="t"> <span class="nam">embeddings_b</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">ArrayLike</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
412
+ <p class="run run2"><span class="n"><a id="t328" href="#t328">328</a></span><span class="t"> <span class="nam">metric</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"cosine"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
413
+ <p class="run run2"><span class="n"><a id="t329" href="#t329">329</a></span><span class="t"> <span class="nam">weights</span><span class="op">:</span> <span class="nam">ArrayLike</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
414
+ <p class="run run2"><span class="n"><a id="t330" href="#t330">330</a></span><span class="t"> <span class="nam">threshold_profile</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
415
+ <p class="run run2"><span class="n"><a id="t331" href="#t331">331</a></span><span class="t"> <span class="nam">explain</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">False</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
416
+ <p class="run run2"><span class="n"><a id="t332" href="#t332">332</a></span><span class="t"> <span class="nam">dimension_names</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
417
+ <p class="run run2"><span class="n"><a id="t333" href="#t333">333</a></span><span class="t"> <span class="nam">audit_trail</span><span class="op">:</span> <span class="nam">AuditTrail</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
418
+ <p class="run run2"><span class="n"><a id="t334" href="#t334">334</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">VerificationScore</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
419
+ <p class="pln"><span class="n"><a id="t335" href="#t335">335</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
420
+ <p class="pln"><span class="n"><a id="t336" href="#t336">336</a></span><span class="t"><span class="str"> Verify multiple embedding pairs efficiently (CMVK-004).</span>&nbsp;</span><span class="r"></span></p>
421
+ <p class="pln"><span class="n"><a id="t337" href="#t337">337</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
422
+ <p class="pln"><span class="n"><a id="t338" href="#t338">338</a></span><span class="t"><span class="str"> Processes all pairs with consistent settings and optional audit logging.</span>&nbsp;</span><span class="r"></span></p>
423
+ <p class="pln"><span class="n"><a id="t339" href="#t339">339</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
424
+ <p class="pln"><span class="n"><a id="t340" href="#t340">340</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
425
+ <p class="pln"><span class="n"><a id="t341" href="#t341">341</a></span><span class="t"><span class="str"> embeddings_a: Sequence of embedding vectors from source A</span>&nbsp;</span><span class="r"></span></p>
426
+ <p class="pln"><span class="n"><a id="t342" href="#t342">342</a></span><span class="t"><span class="str"> embeddings_b: Sequence of embedding vectors from source B</span>&nbsp;</span><span class="r"></span></p>
427
+ <p class="pln"><span class="n"><a id="t343" href="#t343">343</a></span><span class="t"><span class="str"> metric: Distance metric (applied to all pairs)</span>&nbsp;</span><span class="r"></span></p>
428
+ <p class="pln"><span class="n"><a id="t344" href="#t344">344</a></span><span class="t"><span class="str"> weights: Dimensional weights (applied to all pairs)</span>&nbsp;</span><span class="r"></span></p>
429
+ <p class="pln"><span class="n"><a id="t345" href="#t345">345</a></span><span class="t"><span class="str"> threshold_profile: Threshold profile name</span>&nbsp;</span><span class="r"></span></p>
430
+ <p class="pln"><span class="n"><a id="t346" href="#t346">346</a></span><span class="t"><span class="str"> explain: Whether to include explanations</span>&nbsp;</span><span class="r"></span></p>
431
+ <p class="pln"><span class="n"><a id="t347" href="#t347">347</a></span><span class="t"><span class="str"> dimension_names: Optional dimension names for explainability</span>&nbsp;</span><span class="r"></span></p>
432
+ <p class="pln"><span class="n"><a id="t348" href="#t348">348</a></span><span class="t"><span class="str"> audit_trail: Optional AuditTrail for logging</span>&nbsp;</span><span class="r"></span></p>
433
+ <p class="pln"><span class="n"><a id="t349" href="#t349">349</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
434
+ <p class="pln"><span class="n"><a id="t350" href="#t350">350</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
435
+ <p class="pln"><span class="n"><a id="t351" href="#t351">351</a></span><span class="t"><span class="str"> List of VerificationScore for each pair</span>&nbsp;</span><span class="r"></span></p>
436
+ <p class="pln"><span class="n"><a id="t352" href="#t352">352</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
437
+ <p class="pln"><span class="n"><a id="t353" href="#t353">353</a></span><span class="t"><span class="str"> Raises:</span>&nbsp;</span><span class="r"></span></p>
438
+ <p class="pln"><span class="n"><a id="t354" href="#t354">354</a></span><span class="t"><span class="str"> ValueError: If sequence lengths don't match</span>&nbsp;</span><span class="r"></span></p>
439
+ <p class="pln"><span class="n"><a id="t355" href="#t355">355</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
440
+ <p class="mis show_mis"><span class="n"><a id="t356" href="#t356">356</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">embeddings_a</span><span class="op">)</span> <span class="op">!=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">embeddings_b</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
441
+ <p class="mis show_mis"><span class="n"><a id="t357" href="#t357">357</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
442
+ <p class="mis mis2 show_mis"><span class="n"><a id="t358" href="#t358">358</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Length mismatch: embeddings_a has </span><span class="op">{</span><span class="nam">len</span><span class="op">(</span><span class="nam">embeddings_a</span><span class="op">)</span><span class="op">}</span><span class="fst"> items, </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
443
+ <p class="mis mis2 show_mis"><span class="n"><a id="t359" href="#t359">359</a></span><span class="t"> <span class="fst">f"</span><span class="fst">embeddings_b has </span><span class="op">{</span><span class="nam">len</span><span class="op">(</span><span class="nam">embeddings_b</span><span class="op">)</span><span class="op">}</span><span class="fst"> items</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
444
+ <p class="mis mis2 show_mis"><span class="n"><a id="t360" href="#t360">360</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
445
+ <p class="pln"><span class="n"><a id="t361" href="#t361">361</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
446
+ <p class="mis show_mis"><span class="n"><a id="t362" href="#t362">362</a></span><span class="t"> <span class="nam">results</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
447
+ <p class="mis show_mis"><span class="n"><a id="t363" href="#t363">363</a></span><span class="t"> <span class="key">for</span> <span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span> <span class="key">in</span> <span class="nam">zip</span><span class="op">(</span><span class="nam">embeddings_a</span><span class="op">,</span> <span class="nam">embeddings_b</span><span class="op">,</span> <span class="nam">strict</span><span class="op">=</span><span class="key">True</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
448
+ <p class="mis show_mis"><span class="n"><a id="t364" href="#t364">364</a></span><span class="t"> <span class="nam">score</span> <span class="op">=</span> <span class="nam">verify_embeddings</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
449
+ <p class="mis mis2 show_mis"><span class="n"><a id="t365" href="#t365">365</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
450
+ <p class="mis mis2 show_mis"><span class="n"><a id="t366" href="#t366">366</a></span><span class="t"> <span class="nam">vec_b</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
451
+ <p class="mis mis2 show_mis"><span class="n"><a id="t367" href="#t367">367</a></span><span class="t"> <span class="nam">metric</span><span class="op">=</span><span class="nam">metric</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
452
+ <p class="mis mis2 show_mis"><span class="n"><a id="t368" href="#t368">368</a></span><span class="t"> <span class="nam">weights</span><span class="op">=</span><span class="nam">weights</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
453
+ <p class="mis mis2 show_mis"><span class="n"><a id="t369" href="#t369">369</a></span><span class="t"> <span class="nam">threshold_profile</span><span class="op">=</span><span class="nam">threshold_profile</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
454
+ <p class="mis mis2 show_mis"><span class="n"><a id="t370" href="#t370">370</a></span><span class="t"> <span class="nam">explain</span><span class="op">=</span><span class="nam">explain</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
455
+ <p class="mis mis2 show_mis"><span class="n"><a id="t371" href="#t371">371</a></span><span class="t"> <span class="nam">dimension_names</span><span class="op">=</span><span class="nam">dimension_names</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
456
+ <p class="mis mis2 show_mis"><span class="n"><a id="t372" href="#t372">372</a></span><span class="t"> <span class="nam">audit_trail</span><span class="op">=</span><span class="nam">audit_trail</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
457
+ <p class="mis mis2 show_mis"><span class="n"><a id="t373" href="#t373">373</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
458
+ <p class="mis show_mis"><span class="n"><a id="t374" href="#t374">374</a></span><span class="t"> <span class="nam">results</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">score</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
459
+ <p class="pln"><span class="n"><a id="t375" href="#t375">375</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
460
+ <p class="mis show_mis"><span class="n"><a id="t376" href="#t376">376</a></span><span class="t"> <span class="key">return</span> <span class="nam">results</span>&nbsp;</span><span class="r"></span></p>
461
+ <p class="pln"><span class="n"><a id="t377" href="#t377">377</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
462
+ <p class="pln"><span class="n"><a id="t378" href="#t378">378</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
463
+ <p class="run"><span class="n"><a id="t379" href="#t379">379</a></span><span class="t"><span class="key">def</span> <span class="nam">aggregate_embedding_scores</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
464
+ <p class="run run2"><span class="n"><a id="t380" href="#t380">380</a></span><span class="t"> <span class="nam">scores</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">VerificationScore</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
465
+ <p class="run run2"><span class="n"><a id="t381" href="#t381">381</a></span><span class="t"> <span class="nam">threshold_profile</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
466
+ <p class="run run2"><span class="n"><a id="t382" href="#t382">382</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
467
+ <p class="pln"><span class="n"><a id="t383" href="#t383">383</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
468
+ <p class="pln"><span class="n"><a id="t384" href="#t384">384</a></span><span class="t"><span class="str"> Aggregate multiple embedding verification scores with profile context.</span>&nbsp;</span><span class="r"></span></p>
469
+ <p class="pln"><span class="n"><a id="t385" href="#t385">385</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
470
+ <p class="pln"><span class="n"><a id="t386" href="#t386">386</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
471
+ <p class="pln"><span class="n"><a id="t387" href="#t387">387</a></span><span class="t"><span class="str"> scores: Sequence of VerificationScore objects</span>&nbsp;</span><span class="r"></span></p>
472
+ <p class="pln"><span class="n"><a id="t388" href="#t388">388</a></span><span class="t"><span class="str"> threshold_profile: Optional profile for pass/fail classification</span>&nbsp;</span><span class="r"></span></p>
473
+ <p class="pln"><span class="n"><a id="t389" href="#t389">389</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
474
+ <p class="pln"><span class="n"><a id="t390" href="#t390">390</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
475
+ <p class="pln"><span class="n"><a id="t391" href="#t391">391</a></span><span class="t"><span class="str"> Dictionary with aggregate statistics and pass rates</span>&nbsp;</span><span class="r"></span></p>
476
+ <p class="pln"><span class="n"><a id="t392" href="#t392">392</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
477
+ <p class="mis show_mis"><span class="n"><a id="t393" href="#t393">393</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">scores</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
478
+ <p class="mis show_mis"><span class="n"><a id="t394" href="#t394">394</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span><span class="str">"count"</span><span class="op">:</span> <span class="num">0</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
479
+ <p class="pln"><span class="n"><a id="t395" href="#t395">395</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
480
+ <p class="mis show_mis"><span class="n"><a id="t396" href="#t396">396</a></span><span class="t"> <span class="nam">profile</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
481
+ <p class="mis show_mis"><span class="n"><a id="t397" href="#t397">397</a></span><span class="t"> <span class="key">if</span> <span class="nam">threshold_profile</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
482
+ <p class="mis show_mis"><span class="n"><a id="t398" href="#t398">398</a></span><span class="t"> <span class="key">from</span> <span class="op">.</span><span class="nam">profiles</span> <span class="key">import</span> <span class="nam">get_profile</span>&nbsp;</span><span class="r"></span></p>
483
+ <p class="pln"><span class="n"><a id="t399" href="#t399">399</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
484
+ <p class="mis show_mis"><span class="n"><a id="t400" href="#t400">400</a></span><span class="t"> <span class="nam">profile</span> <span class="op">=</span> <span class="nam">get_profile</span><span class="op">(</span><span class="nam">threshold_profile</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
485
+ <p class="pln"><span class="n"><a id="t401" href="#t401">401</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
486
+ <p class="mis show_mis"><span class="n"><a id="t402" href="#t402">402</a></span><span class="t"> <span class="nam">drift_values</span> <span class="op">=</span> <span class="op">[</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_score</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
487
+ <p class="mis show_mis"><span class="n"><a id="t403" href="#t403">403</a></span><span class="t"> <span class="nam">confidence_values</span> <span class="op">=</span> <span class="op">[</span><span class="nam">s</span><span class="op">.</span><span class="nam">confidence</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
488
+ <p class="pln"><span class="n"><a id="t404" href="#t404">404</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
489
+ <p class="pln"><span class="n"><a id="t405" href="#t405">405</a></span><span class="t"> <span class="com"># Calculate pass/fail if profile available</span>&nbsp;</span><span class="r"></span></p>
490
+ <p class="mis show_mis"><span class="n"><a id="t406" href="#t406">406</a></span><span class="t"> <span class="key">if</span> <span class="nam">profile</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
491
+ <p class="mis show_mis"><span class="n"><a id="t407" href="#t407">407</a></span><span class="t"> <span class="nam">passed_count</span> <span class="op">=</span> <span class="nam">sum</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
492
+ <p class="mis mis2 show_mis"><span class="n"><a id="t408" href="#t408">408</a></span><span class="t"> <span class="num">1</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span> <span class="key">if</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">is_within_threshold</span><span class="op">(</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_score</span><span class="op">,</span> <span class="nam">s</span><span class="op">.</span><span class="nam">confidence</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
493
+ <p class="mis mis2 show_mis"><span class="n"><a id="t409" href="#t409">409</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
494
+ <p class="mis show_mis"><span class="n"><a id="t410" href="#t410">410</a></span><span class="t"> <span class="nam">severity_counts</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
495
+ <p class="mis mis2 show_mis"><span class="n"><a id="t411" href="#t411">411</a></span><span class="t"> <span class="str">"pass"</span><span class="op">:</span> <span class="num">0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
496
+ <p class="mis mis2 show_mis"><span class="n"><a id="t412" href="#t412">412</a></span><span class="t"> <span class="str">"warning"</span><span class="op">:</span> <span class="num">0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
497
+ <p class="mis mis2 show_mis"><span class="n"><a id="t413" href="#t413">413</a></span><span class="t"> <span class="str">"critical"</span><span class="op">:</span> <span class="num">0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
498
+ <p class="mis mis2 show_mis"><span class="n"><a id="t414" href="#t414">414</a></span><span class="t"> <span class="str">"severe"</span><span class="op">:</span> <span class="num">0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
499
+ <p class="mis mis2 show_mis"><span class="n"><a id="t415" href="#t415">415</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
500
+ <p class="mis show_mis"><span class="n"><a id="t416" href="#t416">416</a></span><span class="t"> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
501
+ <p class="mis show_mis"><span class="n"><a id="t417" href="#t417">417</a></span><span class="t"> <span class="nam">severity</span> <span class="op">=</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">get_severity</span><span class="op">(</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_score</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
502
+ <p class="mis show_mis"><span class="n"><a id="t418" href="#t418">418</a></span><span class="t"> <span class="nam">severity_counts</span><span class="op">[</span><span class="nam">severity</span><span class="op">]</span> <span class="op">+=</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
503
+ <p class="pln"><span class="n"><a id="t419" href="#t419">419</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
504
+ <p class="mis show_mis"><span class="n"><a id="t420" href="#t420">420</a></span><span class="t"> <span class="nam">passed_count</span> <span class="op">=</span> <span class="nam">sum</span><span class="op">(</span><span class="num">1</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span> <span class="key">if</span> <span class="nam">s</span><span class="op">.</span><span class="nam">drift_score</span> <span class="op">&lt;=</span> <span class="num">0.3</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
505
+ <p class="mis show_mis"><span class="n"><a id="t421" href="#t421">421</a></span><span class="t"> <span class="nam">severity_counts</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
506
+ <p class="pln"><span class="n"><a id="t422" href="#t422">422</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
507
+ <p class="mis show_mis"><span class="n"><a id="t423" href="#t423">423</a></span><span class="t"> <span class="nam">result</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
508
+ <p class="mis mis2 show_mis"><span class="n"><a id="t424" href="#t424">424</a></span><span class="t"> <span class="str">"count"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">scores</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
509
+ <p class="mis mis2 show_mis"><span class="n"><a id="t425" href="#t425">425</a></span><span class="t"> <span class="str">"passed_count"</span><span class="op">:</span> <span class="nam">passed_count</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
510
+ <p class="mis mis2 show_mis"><span class="n"><a id="t426" href="#t426">426</a></span><span class="t"> <span class="str">"failed_count"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">scores</span><span class="op">)</span> <span class="op">-</span> <span class="nam">passed_count</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
511
+ <p class="mis mis2 show_mis"><span class="n"><a id="t427" href="#t427">427</a></span><span class="t"> <span class="str">"pass_rate"</span><span class="op">:</span> <span class="nam">passed_count</span> <span class="op">/</span> <span class="nam">len</span><span class="op">(</span><span class="nam">scores</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
512
+ <p class="mis mis2 show_mis"><span class="n"><a id="t428" href="#t428">428</a></span><span class="t"> <span class="str">"mean_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
513
+ <p class="mis mis2 show_mis"><span class="n"><a id="t429" href="#t429">429</a></span><span class="t"> <span class="str">"std_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">std</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
514
+ <p class="mis mis2 show_mis"><span class="n"><a id="t430" href="#t430">430</a></span><span class="t"> <span class="str">"min_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">min</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
515
+ <p class="mis mis2 show_mis"><span class="n"><a id="t431" href="#t431">431</a></span><span class="t"> <span class="str">"max_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">max</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
516
+ <p class="mis mis2 show_mis"><span class="n"><a id="t432" href="#t432">432</a></span><span class="t"> <span class="str">"median_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">median</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
517
+ <p class="mis mis2 show_mis"><span class="n"><a id="t433" href="#t433">433</a></span><span class="t"> <span class="str">"mean_confidence"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">confidence_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
518
+ <p class="mis mis2 show_mis"><span class="n"><a id="t434" href="#t434">434</a></span><span class="t"> <span class="str">"p95_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">percentile</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">,</span> <span class="num">95</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
519
+ <p class="mis mis2 show_mis"><span class="n"><a id="t435" href="#t435">435</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
520
+ <p class="pln"><span class="n"><a id="t436" href="#t436">436</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
521
+ <p class="mis show_mis"><span class="n"><a id="t437" href="#t437">437</a></span><span class="t"> <span class="key">if</span> <span class="nam">severity_counts</span> <span class="key">and</span> <span class="nam">profile</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
522
+ <p class="mis show_mis"><span class="n"><a id="t438" href="#t438">438</a></span><span class="t"> <span class="nam">result</span><span class="op">[</span><span class="str">"severity_distribution"</span><span class="op">]</span> <span class="op">=</span> <span class="nam">severity_counts</span>&nbsp;</span><span class="r"></span></p>
523
+ <p class="mis show_mis"><span class="n"><a id="t439" href="#t439">439</a></span><span class="t"> <span class="nam">result</span><span class="op">[</span><span class="str">"profile_used"</span><span class="op">]</span> <span class="op">=</span> <span class="nam">profile</span><span class="op">.</span><span class="nam">name</span>&nbsp;</span><span class="r"></span></p>
524
+ <p class="pln"><span class="n"><a id="t440" href="#t440">440</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
525
+ <p class="mis show_mis"><span class="n"><a id="t441" href="#t441">441</a></span><span class="t"> <span class="key">return</span> <span class="nam">result</span>&nbsp;</span><span class="r"></span></p>
526
+ <p class="pln"><span class="n"><a id="t442" href="#t442">442</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
527
+ <p class="pln"><span class="n"><a id="t443" href="#t443">443</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
528
+ <p class="pln"><span class="n"><a id="t444" href="#t444">444</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
529
+ <p class="pln"><span class="n"><a id="t445" href="#t445">445</a></span><span class="t"><span class="com"># Explainability Functions (CMVK-010)</span>&nbsp;</span><span class="r"></span></p>
530
+ <p class="pln"><span class="n"><a id="t446" href="#t446">446</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
531
+ <p class="pln"><span class="n"><a id="t447" href="#t447">447</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
532
+ <p class="pln"><span class="n"><a id="t448" href="#t448">448</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
533
+ <p class="run"><span class="n"><a id="t449" href="#t449">449</a></span><span class="t"><span class="key">def</span> <span class="nam">_build_drift_explanation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
534
+ <p class="run run2"><span class="n"><a id="t450" href="#t450">450</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
535
+ <p class="run run2"><span class="n"><a id="t451" href="#t451">451</a></span><span class="t"> <span class="nam">vec_b</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
536
+ <p class="run run2"><span class="n"><a id="t452" href="#t452">452</a></span><span class="t"> <span class="nam">metric_result</span><span class="op">:</span> <span class="nam">Any</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
537
+ <p class="run run2"><span class="n"><a id="t453" href="#t453">453</a></span><span class="t"> <span class="nam">weights</span><span class="op">:</span> <span class="nam">ArrayLike</span> <span class="op">|</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
538
+ <p class="run run2"><span class="n"><a id="t454" href="#t454">454</a></span><span class="t"> <span class="nam">dimension_names</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">|</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
539
+ <p class="run run2"><span class="n"><a id="t455" href="#t455">455</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">DriftExplanation</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
540
+ <p class="pln"><span class="n"><a id="t456" href="#t456">456</a></span><span class="t"> <span class="str">"""Build detailed drift explanation."""</span>&nbsp;</span><span class="r"></span></p>
541
+ <p class="mis show_mis"><span class="n"><a id="t457" href="#t457">457</a></span><span class="t"> <span class="nam">diff</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">abs</span><span class="op">(</span><span class="nam">vec_a</span> <span class="op">-</span> <span class="nam">vec_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
542
+ <p class="pln"><span class="n"><a id="t458" href="#t458">458</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
543
+ <p class="pln"><span class="n"><a id="t459" href="#t459">459</a></span><span class="t"> <span class="com"># Apply weights if provided</span>&nbsp;</span><span class="r"></span></p>
544
+ <p class="mis show_mis"><span class="n"><a id="t460" href="#t460">460</a></span><span class="t"> <span class="key">if</span> <span class="nam">weights</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
545
+ <p class="mis show_mis"><span class="n"><a id="t461" href="#t461">461</a></span><span class="t"> <span class="nam">weights_arr</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">asarray</span><span class="op">(</span><span class="nam">weights</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">float64</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
546
+ <p class="mis show_mis"><span class="n"><a id="t462" href="#t462">462</a></span><span class="t"> <span class="nam">weighted_diff</span> <span class="op">=</span> <span class="nam">diff</span> <span class="op">*</span> <span class="nam">weights_arr</span>&nbsp;</span><span class="r"></span></p>
547
+ <p class="pln"><span class="n"><a id="t463" href="#t463">463</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
548
+ <p class="mis show_mis"><span class="n"><a id="t464" href="#t464">464</a></span><span class="t"> <span class="nam">weighted_diff</span> <span class="op">=</span> <span class="nam">diff</span>&nbsp;</span><span class="r"></span></p>
549
+ <p class="pln"><span class="n"><a id="t465" href="#t465">465</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
550
+ <p class="pln"><span class="n"><a id="t466" href="#t466">466</a></span><span class="t"> <span class="com"># Calculate per-dimension contributions</span>&nbsp;</span><span class="r"></span></p>
551
+ <p class="mis show_mis"><span class="n"><a id="t467" href="#t467">467</a></span><span class="t"> <span class="nam">total_diff</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="nam">weighted_diff</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
552
+ <p class="mis show_mis"><span class="n"><a id="t468" href="#t468">468</a></span><span class="t"> <span class="nam">contributions</span> <span class="op">=</span> <span class="nam">weighted_diff</span> <span class="op">/</span> <span class="nam">total_diff</span> <span class="key">if</span> <span class="nam">total_diff</span> <span class="op">></span> <span class="num">0</span> <span class="key">else</span> <span class="nam">np</span><span class="op">.</span><span class="nam">zeros_like</span><span class="op">(</span><span class="nam">diff</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
553
+ <p class="pln"><span class="n"><a id="t469" href="#t469">469</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
554
+ <p class="pln"><span class="n"><a id="t470" href="#t470">470</a></span><span class="t"> <span class="com"># Map contributions to names or indices</span>&nbsp;</span><span class="r"></span></p>
555
+ <p class="pln"><span class="n"><a id="t471" href="#t471">471</a></span><span class="t"> <span class="nam">contrib_dict</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
556
+ <p class="pln"><span class="n"><a id="t472" href="#t472">472</a></span><span class="t"> <span class="nam">sorted_contribs</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">tuple</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
557
+ <p class="pln"><span class="n"><a id="t473" href="#t473">473</a></span><span class="t"> <span class="nam">primary_dim</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span>&nbsp;</span><span class="r"></span></p>
558
+ <p class="pln"><span class="n"><a id="t474" href="#t474">474</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
559
+ <p class="mis show_mis"><span class="n"><a id="t475" href="#t475">475</a></span><span class="t"> <span class="key">if</span> <span class="nam">dimension_names</span> <span class="key">and</span> <span class="nam">len</span><span class="op">(</span><span class="nam">dimension_names</span><span class="op">)</span> <span class="op">==</span> <span class="nam">len</span><span class="op">(</span><span class="nam">contributions</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
560
+ <p class="mis show_mis"><span class="n"><a id="t476" href="#t476">476</a></span><span class="t"> <span class="nam">contrib_dict</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
561
+ <p class="mis mis2 show_mis"><span class="n"><a id="t477" href="#t477">477</a></span><span class="t"> <span class="nam">name</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">c</span><span class="op">)</span> <span class="key">for</span> <span class="nam">name</span><span class="op">,</span> <span class="nam">c</span> <span class="key">in</span> <span class="nam">zip</span><span class="op">(</span><span class="nam">dimension_names</span><span class="op">,</span> <span class="nam">contributions</span><span class="op">,</span> <span class="nam">strict</span><span class="op">=</span><span class="key">False</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
562
+ <p class="mis mis2 show_mis"><span class="n"><a id="t478" href="#t478">478</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
563
+ <p class="mis show_mis"><span class="n"><a id="t479" href="#t479">479</a></span><span class="t"> <span class="nam">sorted_contribs</span> <span class="op">=</span> <span class="nam">sorted</span><span class="op">(</span><span class="nam">contrib_dict</span><span class="op">.</span><span class="nam">items</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">lambda</span> <span class="nam">x</span><span class="op">:</span> <span class="nam">x</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">reverse</span><span class="op">=</span><span class="key">True</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
564
+ <p class="mis show_mis"><span class="n"><a id="t480" href="#t480">480</a></span><span class="t"> <span class="nam">primary_dim</span> <span class="op">=</span> <span class="nam">sorted_contribs</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">[</span><span class="num">0</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
565
+ <p class="pln"><span class="n"><a id="t481" href="#t481">481</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
566
+ <p class="mis show_mis"><span class="n"><a id="t482" href="#t482">482</a></span><span class="t"> <span class="nam">contrib_dict</span> <span class="op">=</span> <span class="op">{</span><span class="nam">i</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">c</span><span class="op">)</span> <span class="key">for</span> <span class="nam">i</span><span class="op">,</span> <span class="nam">c</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">contributions</span><span class="op">)</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
567
+ <p class="mis show_mis"><span class="n"><a id="t483" href="#t483">483</a></span><span class="t"> <span class="nam">sorted_contribs</span> <span class="op">=</span> <span class="nam">sorted</span><span class="op">(</span><span class="nam">contrib_dict</span><span class="op">.</span><span class="nam">items</span><span class="op">(</span><span class="op">)</span><span class="op">,</span> <span class="nam">key</span><span class="op">=</span><span class="key">lambda</span> <span class="nam">x</span><span class="op">:</span> <span class="nam">x</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">,</span> <span class="nam">reverse</span><span class="op">=</span><span class="key">True</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
568
+ <p class="mis show_mis"><span class="n"><a id="t484" href="#t484">484</a></span><span class="t"> <span class="nam">primary_dim</span> <span class="op">=</span> <span class="nam">sorted_contribs</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">[</span><span class="num">0</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
569
+ <p class="pln"><span class="n"><a id="t485" href="#t485">485</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
570
+ <p class="pln"><span class="n"><a id="t486" href="#t486">486</a></span><span class="t"> <span class="com"># Top contributors (up to 5)</span>&nbsp;</span><span class="r"></span></p>
571
+ <p class="mis show_mis"><span class="n"><a id="t487" href="#t487">487</a></span><span class="t"> <span class="nam">top_contributors</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">tuple</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="nam">sorted_contribs</span><span class="op">[</span><span class="op">:</span><span class="num">5</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
572
+ <p class="pln"><span class="n"><a id="t488" href="#t488">488</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
573
+ <p class="pln"><span class="n"><a id="t489" href="#t489">489</a></span><span class="t"> <span class="com"># Generate interpretation</span>&nbsp;</span><span class="r"></span></p>
574
+ <p class="mis show_mis"><span class="n"><a id="t490" href="#t490">490</a></span><span class="t"> <span class="nam">interpretation</span> <span class="op">=</span> <span class="nam">_generate_interpretation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
575
+ <p class="mis mis2 show_mis"><span class="n"><a id="t491" href="#t491">491</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">,</span> <span class="nam">vec_b</span><span class="op">,</span> <span class="nam">primary_dim</span><span class="op">,</span> <span class="nam">top_contributors</span><span class="op">,</span> <span class="nam">dimension_names</span>&nbsp;</span><span class="r"></span></p>
576
+ <p class="mis mis2 show_mis"><span class="n"><a id="t492" href="#t492">492</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
577
+ <p class="pln"><span class="n"><a id="t493" href="#t493">493</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
578
+ <p class="mis show_mis"><span class="n"><a id="t494" href="#t494">494</a></span><span class="t"> <span class="key">return</span> <span class="nam">DriftExplanation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
579
+ <p class="mis mis2 show_mis"><span class="n"><a id="t495" href="#t495">495</a></span><span class="t"> <span class="nam">primary_drift_dimension</span><span class="op">=</span><span class="nam">primary_dim</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
580
+ <p class="mis mis2 show_mis"><span class="n"><a id="t496" href="#t496">496</a></span><span class="t"> <span class="nam">dimension_contributions</span><span class="op">=</span><span class="nam">contrib_dict</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
581
+ <p class="mis mis2 show_mis"><span class="n"><a id="t497" href="#t497">497</a></span><span class="t"> <span class="nam">top_contributors</span><span class="op">=</span><span class="nam">top_contributors</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
582
+ <p class="mis mis2 show_mis"><span class="n"><a id="t498" href="#t498">498</a></span><span class="t"> <span class="nam">metric_used</span><span class="op">=</span><span class="nam">metric_result</span><span class="op">.</span><span class="nam">metric</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
583
+ <p class="mis mis2 show_mis"><span class="n"><a id="t499" href="#t499">499</a></span><span class="t"> <span class="nam">interpretation</span><span class="op">=</span><span class="nam">interpretation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
584
+ <p class="mis mis2 show_mis"><span class="n"><a id="t500" href="#t500">500</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
585
+ <p class="pln"><span class="n"><a id="t501" href="#t501">501</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
586
+ <p class="pln"><span class="n"><a id="t502" href="#t502">502</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
587
+ <p class="run"><span class="n"><a id="t503" href="#t503">503</a></span><span class="t"><span class="key">def</span> <span class="nam">_generate_interpretation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
588
+ <p class="run run2"><span class="n"><a id="t504" href="#t504">504</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
589
+ <p class="run run2"><span class="n"><a id="t505" href="#t505">505</a></span><span class="t"> <span class="nam">vec_b</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
590
+ <p class="run run2"><span class="n"><a id="t506" href="#t506">506</a></span><span class="t"> <span class="nam">primary_dim</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
591
+ <p class="run run2"><span class="n"><a id="t507" href="#t507">507</a></span><span class="t"> <span class="nam">top_contributors</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">tuple</span><span class="op">[</span><span class="nam">str</span> <span class="op">|</span> <span class="nam">int</span><span class="op">,</span> <span class="nam">float</span><span class="op">]</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
592
+ <p class="run run2"><span class="n"><a id="t508" href="#t508">508</a></span><span class="t"> <span class="nam">dimension_names</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">|</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
593
+ <p class="run run2"><span class="n"><a id="t509" href="#t509">509</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
594
+ <p class="pln"><span class="n"><a id="t510" href="#t510">510</a></span><span class="t"> <span class="str">"""Generate human-readable interpretation of drift."""</span>&nbsp;</span><span class="r"></span></p>
595
+ <p class="pln"><span class="n"><a id="t511" href="#t511">511</a></span><span class="t"> <span class="com"># Get primary dimension index</span>&nbsp;</span><span class="r"></span></p>
596
+ <p class="mis show_mis"><span class="n"><a id="t512" href="#t512">512</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">primary_dim</span><span class="op">,</span> <span class="nam">str</span><span class="op">)</span> <span class="key">and</span> <span class="nam">dimension_names</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
597
+ <p class="mis show_mis"><span class="n"><a id="t513" href="#t513">513</a></span><span class="t"> <span class="nam">idx</span> <span class="op">=</span> <span class="nam">dimension_names</span><span class="op">.</span><span class="nam">index</span><span class="op">(</span><span class="nam">primary_dim</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
598
+ <p class="pln"><span class="n"><a id="t514" href="#t514">514</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
599
+ <p class="mis show_mis"><span class="n"><a id="t515" href="#t515">515</a></span><span class="t"> <span class="nam">idx</span> <span class="op">=</span> <span class="nam">primary_dim</span> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">primary_dim</span><span class="op">,</span> <span class="nam">int</span><span class="op">)</span> <span class="key">else</span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
600
+ <p class="pln"><span class="n"><a id="t516" href="#t516">516</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
601
+ <p class="mis show_mis"><span class="n"><a id="t517" href="#t517">517</a></span><span class="t"> <span class="nam">diff_value</span> <span class="op">=</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span> <span class="op">-</span> <span class="nam">vec_b</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
602
+ <p class="mis show_mis"><span class="n"><a id="t518" href="#t518">518</a></span><span class="t"> <span class="nam">pct_diff</span> <span class="op">=</span> <span class="op">(</span><span class="nam">diff_value</span> <span class="op">/</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span><span class="op">)</span><span class="op">)</span> <span class="op">*</span> <span class="num">100</span> <span class="key">if</span> <span class="nam">vec_a</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span> <span class="op">!=</span> <span class="num">0</span> <span class="key">else</span> <span class="nam">float</span><span class="op">(</span><span class="str">"inf"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
603
+ <p class="pln"><span class="n"><a id="t519" href="#t519">519</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
604
+ <p class="mis show_mis"><span class="n"><a id="t520" href="#t520">520</a></span><span class="t"> <span class="nam">dim_name</span> <span class="op">=</span> <span class="nam">primary_dim</span> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">primary_dim</span><span class="op">,</span> <span class="nam">str</span><span class="op">)</span> <span class="key">else</span> <span class="fst">f"</span><span class="fst">dimension </span><span class="op">{</span><span class="nam">primary_dim</span><span class="op">}</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
605
+ <p class="pln"><span class="n"><a id="t521" href="#t521">521</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
606
+ <p class="mis show_mis"><span class="n"><a id="t522" href="#t522">522</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">top_contributors</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span> <span class="key">and</span> <span class="nam">top_contributors</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">[</span><span class="num">1</span><span class="op">]</span> <span class="op">></span> <span class="num">0.5</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
607
+ <p class="mis show_mis"><span class="n"><a id="t523" href="#t523">523</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
608
+ <p class="mis mis2 show_mis"><span class="n"><a id="t524" href="#t524">524</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Drift primarily driven by </span><span class="op">{</span><span class="nam">dim_name</span><span class="op">}</span><span class="fst"> </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
609
+ <p class="mis mis2 show_mis"><span class="n"><a id="t525" href="#t525">525</a></span><span class="t"> <span class="fst">f"</span><span class="fst">(</span><span class="op">{</span><span class="nam">top_contributors</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">[</span><span class="num">1</span><span class="op">]</span><span class="op">*</span><span class="num">100</span><span class="op">:</span><span class="fst">.1f</span><span class="op">}</span><span class="fst">% of total drift). </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
610
+ <p class="mis mis2 show_mis"><span class="n"><a id="t526" href="#t526">526</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Value changed from </span><span class="op">{</span><span class="nam">vec_a</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span><span class="op">:</span><span class="fst">.4f</span><span class="op">}</span><span class="fst"> to </span><span class="op">{</span><span class="nam">vec_b</span><span class="op">[</span><span class="nam">idx</span><span class="op">]</span><span class="op">:</span><span class="fst">.4f</span><span class="op">}</span><span class="fst"> </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
611
+ <p class="mis mis2 show_mis"><span class="n"><a id="t527" href="#t527">527</a></span><span class="t"> <span class="fst">f"</span><span class="fst">(</span><span class="op">{</span><span class="nam">pct_diff</span><span class="op">:</span><span class="fst">.1f</span><span class="op">}</span><span class="fst">% difference).</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
612
+ <p class="mis mis2 show_mis"><span class="n"><a id="t528" href="#t528">528</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
613
+ <p class="mis show_mis"><span class="n"><a id="t529" href="#t529">529</a></span><span class="t"> <span class="key">elif</span> <span class="nam">len</span><span class="op">(</span><span class="nam">top_contributors</span><span class="op">)</span> <span class="op">></span> <span class="num">1</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
614
+ <p class="mis show_mis"><span class="n"><a id="t530" href="#t530">530</a></span><span class="t"> <span class="nam">top_names</span> <span class="op">=</span> <span class="op">[</span><span class="nam">str</span><span class="op">(</span><span class="nam">c</span><span class="op">[</span><span class="num">0</span><span class="op">]</span><span class="op">)</span> <span class="key">for</span> <span class="nam">c</span><span class="op">,</span> <span class="nam">_</span> <span class="key">in</span> <span class="nam">zip</span><span class="op">(</span><span class="nam">top_contributors</span><span class="op">[</span><span class="op">:</span><span class="num">3</span><span class="op">]</span><span class="op">,</span> <span class="nam">range</span><span class="op">(</span><span class="num">3</span><span class="op">)</span><span class="op">,</span> <span class="nam">strict</span><span class="op">=</span><span class="key">False</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
615
+ <p class="mis show_mis"><span class="n"><a id="t531" href="#t531">531</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
616
+ <p class="mis mis2 show_mis"><span class="n"><a id="t532" href="#t532">532</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Drift distributed across multiple dimensions. </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
617
+ <p class="mis mis2 show_mis"><span class="n"><a id="t533" href="#t533">533</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Top contributors: </span><span class="op">{</span><span class="str">', '</span><span class="op">.</span><span class="nam">join</span><span class="op">(</span><span class="nam">top_names</span><span class="op">)</span><span class="op">}</span><span class="fst">. </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
618
+ <p class="mis mis2 show_mis"><span class="n"><a id="t534" href="#t534">534</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Largest single change in </span><span class="op">{</span><span class="nam">dim_name</span><span class="op">}</span><span class="fst">.</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
619
+ <p class="mis mis2 show_mis"><span class="n"><a id="t535" href="#t535">535</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
620
+ <p class="pln"><span class="n"><a id="t536" href="#t536">536</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
621
+ <p class="mis show_mis"><span class="n"><a id="t537" href="#t537">537</a></span><span class="t"> <span class="key">return</span> <span class="fst">f"</span><span class="fst">Single dimension drift in </span><span class="op">{</span><span class="nam">dim_name</span><span class="op">}</span><span class="fst">.</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
622
+ <p class="pln"><span class="n"><a id="t538" href="#t538">538</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
623
+ <p class="pln"><span class="n"><a id="t539" href="#t539">539</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
624
+ <p class="run"><span class="n"><a id="t540" href="#t540">540</a></span><span class="t"><span class="key">def</span> <span class="nam">_calculate_embedding_confidence</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
625
+ <p class="run run2"><span class="n"><a id="t541" href="#t541">541</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
626
+ <p class="run run2"><span class="n"><a id="t542" href="#t542">542</a></span><span class="t"> <span class="nam">vec_b</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
627
+ <p class="run run2"><span class="n"><a id="t543" href="#t543">543</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="nam">float</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
628
+ <p class="pln"><span class="n"><a id="t544" href="#t544">544</a></span><span class="t"> <span class="str">"""Calculate confidence score for embedding verification."""</span>&nbsp;</span><span class="r"></span></p>
629
+ <p class="pln"><span class="n"><a id="t545" href="#t545">545</a></span><span class="t"> <span class="com"># Base confidence</span>&nbsp;</span><span class="r"></span></p>
630
+ <p class="mis show_mis"><span class="n"><a id="t546" href="#t546">546</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">=</span> <span class="num">0.9</span>&nbsp;</span><span class="r"></span></p>
631
+ <p class="pln"><span class="n"><a id="t547" href="#t547">547</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
632
+ <p class="pln"><span class="n"><a id="t548" href="#t548">548</a></span><span class="t"> <span class="com"># Reduce confidence for very small vectors (less reliable)</span>&nbsp;</span><span class="r"></span></p>
633
+ <p class="mis show_mis"><span class="n"><a id="t549" href="#t549">549</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">)</span> <span class="op">&lt;</span> <span class="num">10</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
634
+ <p class="mis show_mis"><span class="n"><a id="t550" href="#t550">550</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">*=</span> <span class="num">0.9</span>&nbsp;</span><span class="r"></span></p>
635
+ <p class="pln"><span class="n"><a id="t551" href="#t551">551</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
636
+ <p class="pln"><span class="n"><a id="t552" href="#t552">552</a></span><span class="t"> <span class="com"># Reduce confidence if vectors have very different magnitudes</span>&nbsp;</span><span class="r"></span></p>
637
+ <p class="mis show_mis"><span class="n"><a id="t553" href="#t553">553</a></span><span class="t"> <span class="nam">norm_a</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">linalg</span><span class="op">.</span><span class="nam">norm</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
638
+ <p class="mis show_mis"><span class="n"><a id="t554" href="#t554">554</a></span><span class="t"> <span class="nam">norm_b</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">linalg</span><span class="op">.</span><span class="nam">norm</span><span class="op">(</span><span class="nam">vec_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
639
+ <p class="mis show_mis"><span class="n"><a id="t555" href="#t555">555</a></span><span class="t"> <span class="key">if</span> <span class="nam">norm_a</span> <span class="op">></span> <span class="num">0</span> <span class="key">and</span> <span class="nam">norm_b</span> <span class="op">></span> <span class="num">0</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
640
+ <p class="mis show_mis"><span class="n"><a id="t556" href="#t556">556</a></span><span class="t"> <span class="nam">magnitude_ratio</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span><span class="nam">norm_a</span><span class="op">,</span> <span class="nam">norm_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max</span><span class="op">(</span><span class="nam">norm_a</span><span class="op">,</span> <span class="nam">norm_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
641
+ <p class="mis show_mis"><span class="n"><a id="t557" href="#t557">557</a></span><span class="t"> <span class="key">if</span> <span class="nam">magnitude_ratio</span> <span class="op">&lt;</span> <span class="num">0.5</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
642
+ <p class="mis show_mis"><span class="n"><a id="t558" href="#t558">558</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">*=</span> <span class="num">0.85</span>&nbsp;</span><span class="r"></span></p>
643
+ <p class="pln"><span class="n"><a id="t559" href="#t559">559</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
644
+ <p class="pln"><span class="n"><a id="t560" href="#t560">560</a></span><span class="t"> <span class="com"># Reduce confidence for near-zero vectors</span>&nbsp;</span><span class="r"></span></p>
645
+ <p class="mis show_mis"><span class="n"><a id="t561" href="#t561">561</a></span><span class="t"> <span class="key">if</span> <span class="nam">norm_a</span> <span class="op">&lt;</span> <span class="num">1e-6</span> <span class="key">or</span> <span class="nam">norm_b</span> <span class="op">&lt;</span> <span class="num">1e-6</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
646
+ <p class="mis show_mis"><span class="n"><a id="t562" href="#t562">562</a></span><span class="t"> <span class="nam">confidence</span> <span class="op">*=</span> <span class="num">0.7</span>&nbsp;</span><span class="r"></span></p>
647
+ <p class="pln"><span class="n"><a id="t563" href="#t563">563</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
648
+ <p class="mis show_mis"><span class="n"><a id="t564" href="#t564">564</a></span><span class="t"> <span class="key">return</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">confidence</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
649
+ <p class="pln"><span class="n"><a id="t565" href="#t565">565</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
650
+ <p class="pln"><span class="n"><a id="t566" href="#t566">566</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
651
+ <p class="run"><span class="n"><a id="t567" href="#t567">567</a></span><span class="t"><span class="key">def</span> <span class="nam">_log_to_audit</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
652
+ <p class="run run2"><span class="n"><a id="t568" href="#t568">568</a></span><span class="t"> <span class="nam">audit_trail</span><span class="op">:</span> <span class="nam">AuditTrail</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
653
+ <p class="run run2"><span class="n"><a id="t569" href="#t569">569</a></span><span class="t"> <span class="nam">vec_a</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
654
+ <p class="run run2"><span class="n"><a id="t570" href="#t570">570</a></span><span class="t"> <span class="nam">vec_b</span><span class="op">:</span> <span class="nam">np</span><span class="op">.</span><span class="nam">ndarray</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
655
+ <p class="run run2"><span class="n"><a id="t571" href="#t571">571</a></span><span class="t"> <span class="nam">result</span><span class="op">:</span> <span class="nam">VerificationScore</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
656
+ <p class="run run2"><span class="n"><a id="t572" href="#t572">572</a></span><span class="t"> <span class="nam">metric</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
657
+ <p class="run run2"><span class="n"><a id="t573" href="#t573">573</a></span><span class="t"> <span class="nam">profile_name</span><span class="op">:</span> <span class="nam">str</span> <span class="op">|</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
658
+ <p class="run run2"><span class="n"><a id="t574" href="#t574">574</a></span><span class="t"><span class="op">)</span> <span class="op">-></span> <span class="key">None</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
659
+ <p class="pln"><span class="n"><a id="t575" href="#t575">575</a></span><span class="t"> <span class="str">"""Log verification to audit trail."""</span>&nbsp;</span><span class="r"></span></p>
660
+ <p class="mis show_mis"><span class="n"><a id="t576" href="#t576">576</a></span><span class="t"> <span class="nam">passed</span> <span class="op">=</span> <span class="nam">result</span><span class="op">.</span><span class="nam">details</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"profile"</span><span class="op">,</span> <span class="op">{</span><span class="op">}</span><span class="op">)</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"passed"</span><span class="op">,</span> <span class="nam">result</span><span class="op">.</span><span class="nam">drift_score</span> <span class="op">&lt;=</span> <span class="num">0.3</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
661
+ <p class="pln"><span class="n"><a id="t577" href="#t577">577</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
662
+ <p class="mis show_mis"><span class="n"><a id="t578" href="#t578">578</a></span><span class="t"> <span class="nam">audit_trail</span><span class="op">.</span><span class="nam">log</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
663
+ <p class="mis mis2 show_mis"><span class="n"><a id="t579" href="#t579">579</a></span><span class="t"> <span class="nam">operation</span><span class="op">=</span><span class="str">"verify_embeddings"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
664
+ <p class="mis mis2 show_mis"><span class="n"><a id="t580" href="#t580">580</a></span><span class="t"> <span class="nam">inputs</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
665
+ <p class="mis mis2 show_mis"><span class="n"><a id="t581" href="#t581">581</a></span><span class="t"> <span class="str">"embedding_a_shape"</span><span class="op">:</span> <span class="nam">vec_a</span><span class="op">.</span><span class="nam">shape</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
666
+ <p class="mis mis2 show_mis"><span class="n"><a id="t582" href="#t582">582</a></span><span class="t"> <span class="str">"embedding_b_shape"</span><span class="op">:</span> <span class="nam">vec_b</span><span class="op">.</span><span class="nam">shape</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
667
+ <p class="mis mis2 show_mis"><span class="n"><a id="t583" href="#t583">583</a></span><span class="t"> <span class="str">"embedding_a_norm"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">linalg</span><span class="op">.</span><span class="nam">norm</span><span class="op">(</span><span class="nam">vec_a</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
668
+ <p class="mis mis2 show_mis"><span class="n"><a id="t584" href="#t584">584</a></span><span class="t"> <span class="str">"embedding_b_norm"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">linalg</span><span class="op">.</span><span class="nam">norm</span><span class="op">(</span><span class="nam">vec_b</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
669
+ <p class="mis mis2 show_mis"><span class="n"><a id="t585" href="#t585">585</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
670
+ <p class="mis mis2 show_mis"><span class="n"><a id="t586" href="#t586">586</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="nam">result</span><span class="op">.</span><span class="nam">drift_score</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
671
+ <p class="mis mis2 show_mis"><span class="n"><a id="t587" href="#t587">587</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="nam">result</span><span class="op">.</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
672
+ <p class="mis mis2 show_mis"><span class="n"><a id="t588" href="#t588">588</a></span><span class="t"> <span class="nam">metric_used</span><span class="op">=</span><span class="nam">metric</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
673
+ <p class="mis mis2 show_mis"><span class="n"><a id="t589" href="#t589">589</a></span><span class="t"> <span class="nam">profile_used</span><span class="op">=</span><span class="nam">profile_name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
674
+ <p class="mis mis2 show_mis"><span class="n"><a id="t590" href="#t590">590</a></span><span class="t"> <span class="nam">passed</span><span class="op">=</span><span class="nam">passed</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
675
+ <p class="mis mis2 show_mis"><span class="n"><a id="t591" href="#t591">591</a></span><span class="t"> <span class="nam">result_details</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
676
+ <p class="mis mis2 show_mis"><span class="n"><a id="t592" href="#t592">592</a></span><span class="t"> <span class="str">"drift_type"</span><span class="op">:</span> <span class="nam">result</span><span class="op">.</span><span class="nam">drift_type</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
677
+ <p class="mis mis2 show_mis"><span class="n"><a id="t593" href="#t593">593</a></span><span class="t"> <span class="str">"raw_distance"</span><span class="op">:</span> <span class="nam">result</span><span class="op">.</span><span class="nam">details</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"raw_distance"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
678
+ <p class="mis mis2 show_mis"><span class="n"><a id="t594" href="#t594">594</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
679
+ <p class="mis mis2 show_mis"><span class="n"><a id="t595" href="#t595">595</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
680
+ <p class="pln"><span class="n"><a id="t596" href="#t596">596</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
681
+ <p class="pln"><span class="n"><a id="t597" href="#t597">597</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
682
+ <p class="run"><span class="n"><a id="t598" href="#t598">598</a></span><span class="t"><span class="key">def</span> <span class="nam">verify_distributions</span><span class="op">(</span><span class="nam">dist_a</span><span class="op">:</span> <span class="nam">ArrayLike</span><span class="op">,</span> <span class="nam">dist_b</span><span class="op">:</span> <span class="nam">ArrayLike</span><span class="op">)</span> <span class="op">-></span> <span class="nam">VerificationScore</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
683
+ <p class="pln"><span class="n"><a id="t599" href="#t599">599</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
684
+ <p class="pln"><span class="n"><a id="t600" href="#t600">600</a></span><span class="t"><span class="str"> Calculate drift between two probability distributions.</span>&nbsp;</span><span class="r"></span></p>
685
+ <p class="pln"><span class="n"><a id="t601" href="#t601">601</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
686
+ <p class="pln"><span class="n"><a id="t602" href="#t602">602</a></span><span class="t"><span class="str"> Uses KL divergence and other statistical measures to compare distributions.</span>&nbsp;</span><span class="r"></span></p>
687
+ <p class="pln"><span class="n"><a id="t603" href="#t603">603</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
688
+ <p class="pln"><span class="n"><a id="t604" href="#t604">604</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
689
+ <p class="pln"><span class="n"><a id="t605" href="#t605">605</a></span><span class="t"><span class="str"> dist_a: First probability distribution</span>&nbsp;</span><span class="r"></span></p>
690
+ <p class="pln"><span class="n"><a id="t606" href="#t606">606</a></span><span class="t"><span class="str"> dist_b: Second probability distribution</span>&nbsp;</span><span class="r"></span></p>
691
+ <p class="pln"><span class="n"><a id="t607" href="#t607">607</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
692
+ <p class="pln"><span class="n"><a id="t608" href="#t608">608</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
693
+ <p class="pln"><span class="n"><a id="t609" href="#t609">609</a></span><span class="t"><span class="str"> VerificationScore with distribution-based drift score</span>&nbsp;</span><span class="r"></span></p>
694
+ <p class="pln"><span class="n"><a id="t610" href="#t610">610</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
695
+ <p class="mis show_mis"><span class="n"><a id="t611" href="#t611">611</a></span><span class="t"> <span class="nam">p</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">asarray</span><span class="op">(</span><span class="nam">dist_a</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">float64</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
696
+ <p class="mis show_mis"><span class="n"><a id="t612" href="#t612">612</a></span><span class="t"> <span class="nam">q</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">asarray</span><span class="op">(</span><span class="nam">dist_b</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">float64</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
697
+ <p class="pln"><span class="n"><a id="t613" href="#t613">613</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
698
+ <p class="pln"><span class="n"><a id="t614" href="#t614">614</a></span><span class="t"> <span class="com"># Normalize to valid probability distributions</span>&nbsp;</span><span class="r"></span></p>
699
+ <p class="mis show_mis"><span class="n"><a id="t615" href="#t615">615</a></span><span class="t"> <span class="nam">p</span> <span class="op">=</span> <span class="nam">p</span> <span class="op">/</span> <span class="op">(</span><span class="nam">p</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span> <span class="num">1e-10</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
700
+ <p class="mis show_mis"><span class="n"><a id="t616" href="#t616">616</a></span><span class="t"> <span class="nam">q</span> <span class="op">=</span> <span class="nam">q</span> <span class="op">/</span> <span class="op">(</span><span class="nam">q</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="op">)</span> <span class="op">+</span> <span class="num">1e-10</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
701
+ <p class="pln"><span class="n"><a id="t617" href="#t617">617</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
702
+ <p class="pln"><span class="n"><a id="t618" href="#t618">618</a></span><span class="t"> <span class="com"># Add small epsilon to avoid log(0)</span>&nbsp;</span><span class="r"></span></p>
703
+ <p class="mis show_mis"><span class="n"><a id="t619" href="#t619">619</a></span><span class="t"> <span class="nam">eps</span> <span class="op">=</span> <span class="num">1e-10</span>&nbsp;</span><span class="r"></span></p>
704
+ <p class="mis show_mis"><span class="n"><a id="t620" href="#t620">620</a></span><span class="t"> <span class="nam">p</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">eps</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
705
+ <p class="mis show_mis"><span class="n"><a id="t621" href="#t621">621</a></span><span class="t"> <span class="nam">q</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">q</span><span class="op">,</span> <span class="nam">eps</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
706
+ <p class="pln"><span class="n"><a id="t622" href="#t622">622</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
707
+ <p class="mis show_mis"><span class="n"><a id="t623" href="#t623">623</a></span><span class="t"> <span class="key">if</span> <span class="nam">HAS_SCIPY</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
708
+ <p class="pln"><span class="n"><a id="t624" href="#t624">624</a></span><span class="t"> <span class="com"># KL divergence</span>&nbsp;</span><span class="r"></span></p>
709
+ <p class="mis show_mis"><span class="n"><a id="t625" href="#t625">625</a></span><span class="t"> <span class="nam">kl_div</span> <span class="op">=</span> <span class="nam">stats</span><span class="op">.</span><span class="nam">entropy</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">q</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
710
+ <p class="pln"><span class="n"><a id="t626" href="#t626">626</a></span><span class="t"> <span class="com"># Jensen-Shannon divergence (symmetric, bounded [0, 1])</span>&nbsp;</span><span class="r"></span></p>
711
+ <p class="mis show_mis"><span class="n"><a id="t627" href="#t627">627</a></span><span class="t"> <span class="nam">m</span> <span class="op">=</span> <span class="num">0.5</span> <span class="op">*</span> <span class="op">(</span><span class="nam">p</span> <span class="op">+</span> <span class="nam">q</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
712
+ <p class="mis show_mis"><span class="n"><a id="t628" href="#t628">628</a></span><span class="t"> <span class="nam">js_div</span> <span class="op">=</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">stats</span><span class="op">.</span><span class="nam">entropy</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">m</span><span class="op">)</span> <span class="op">+</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">stats</span><span class="op">.</span><span class="nam">entropy</span><span class="op">(</span><span class="nam">q</span><span class="op">,</span> <span class="nam">m</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
713
+ <p class="pln"><span class="n"><a id="t629" href="#t629">629</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
714
+ <p class="pln"><span class="n"><a id="t630" href="#t630">630</a></span><span class="t"> <span class="com"># Fallback implementations</span>&nbsp;</span><span class="r"></span></p>
715
+ <p class="mis show_mis"><span class="n"><a id="t631" href="#t631">631</a></span><span class="t"> <span class="nam">kl_div</span> <span class="op">=</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="nam">p</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">log</span><span class="op">(</span><span class="nam">p</span> <span class="op">/</span> <span class="nam">q</span><span class="op">)</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
716
+ <p class="mis show_mis"><span class="n"><a id="t632" href="#t632">632</a></span><span class="t"> <span class="nam">m</span> <span class="op">=</span> <span class="num">0.5</span> <span class="op">*</span> <span class="op">(</span><span class="nam">p</span> <span class="op">+</span> <span class="nam">q</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
717
+ <p class="mis show_mis"><span class="n"><a id="t633" href="#t633">633</a></span><span class="t"> <span class="nam">js_div</span> <span class="op">=</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="nam">p</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">log</span><span class="op">(</span><span class="nam">p</span> <span class="op">/</span> <span class="nam">m</span><span class="op">)</span><span class="op">)</span> <span class="op">+</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="nam">q</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">log</span><span class="op">(</span><span class="nam">q</span> <span class="op">/</span> <span class="nam">m</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
718
+ <p class="pln"><span class="n"><a id="t634" href="#t634">634</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
719
+ <p class="pln"><span class="n"><a id="t635" href="#t635">635</a></span><span class="t"> <span class="com"># Total variation distance</span>&nbsp;</span><span class="r"></span></p>
720
+ <p class="mis show_mis"><span class="n"><a id="t636" href="#t636">636</a></span><span class="t"> <span class="nam">tv_dist</span> <span class="op">=</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">np</span><span class="op">.</span><span class="nam">sum</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">abs</span><span class="op">(</span><span class="nam">p</span> <span class="op">-</span> <span class="nam">q</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
721
+ <p class="pln"><span class="n"><a id="t637" href="#t637">637</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
722
+ <p class="pln"><span class="n"><a id="t638" href="#t638">638</a></span><span class="t"> <span class="com"># Combined drift (JS divergence is bounded [0, ln(2)])</span>&nbsp;</span><span class="r"></span></p>
723
+ <p class="mis show_mis"><span class="n"><a id="t639" href="#t639">639</a></span><span class="t"> <span class="nam">drift_score</span> <span class="op">=</span> <span class="nam">js_div</span> <span class="op">/</span> <span class="nam">np</span><span class="op">.</span><span class="nam">log</span><span class="op">(</span><span class="num">2</span><span class="op">)</span> <span class="com"># Normalize to [0, 1]</span>&nbsp;</span><span class="r"></span></p>
724
+ <p class="pln"><span class="n"><a id="t640" href="#t640">640</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
725
+ <p class="mis show_mis"><span class="n"><a id="t641" href="#t641">641</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
726
+ <p class="mis mis2 show_mis"><span class="n"><a id="t642" href="#t642">642</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">drift_score</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
727
+ <p class="mis mis2 show_mis"><span class="n"><a id="t643" href="#t643">643</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">0.9</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
728
+ <p class="mis mis2 show_mis"><span class="n"><a id="t644" href="#t644">644</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">NUMERICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
729
+ <p class="mis mis2 show_mis"><span class="n"><a id="t645" href="#t645">645</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
730
+ <p class="mis mis2 show_mis"><span class="n"><a id="t646" href="#t646">646</a></span><span class="t"> <span class="str">"kl_divergence"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">kl_div</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
731
+ <p class="mis mis2 show_mis"><span class="n"><a id="t647" href="#t647">647</a></span><span class="t"> <span class="str">"js_divergence"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">js_div</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
732
+ <p class="mis mis2 show_mis"><span class="n"><a id="t648" href="#t648">648</a></span><span class="t"> <span class="str">"total_variation"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">tv_dist</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
733
+ <p class="mis mis2 show_mis"><span class="n"><a id="t649" href="#t649">649</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
734
+ <p class="mis mis2 show_mis"><span class="n"><a id="t650" href="#t650">650</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
735
+ <p class="pln"><span class="n"><a id="t651" href="#t651">651</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
736
+ <p class="pln"><span class="n"><a id="t652" href="#t652">652</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
737
+ <p class="run"><span class="n"><a id="t653" href="#t653">653</a></span><span class="t"><span class="key">def</span> <span class="nam">verify_sequences</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">seq_b</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="nam">VerificationScore</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
738
+ <p class="pln"><span class="n"><a id="t654" href="#t654">654</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
739
+ <p class="pln"><span class="n"><a id="t655" href="#t655">655</a></span><span class="t"><span class="str"> Calculate drift between two sequences of tokens/items.</span>&nbsp;</span><span class="r"></span></p>
740
+ <p class="pln"><span class="n"><a id="t656" href="#t656">656</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
741
+ <p class="pln"><span class="n"><a id="t657" href="#t657">657</a></span><span class="t"><span class="str"> Uses edit distance and sequence alignment metrics.</span>&nbsp;</span><span class="r"></span></p>
742
+ <p class="pln"><span class="n"><a id="t658" href="#t658">658</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
743
+ <p class="pln"><span class="n"><a id="t659" href="#t659">659</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
744
+ <p class="pln"><span class="n"><a id="t660" href="#t660">660</a></span><span class="t"><span class="str"> seq_a: First sequence</span>&nbsp;</span><span class="r"></span></p>
745
+ <p class="pln"><span class="n"><a id="t661" href="#t661">661</a></span><span class="t"><span class="str"> seq_b: Second sequence</span>&nbsp;</span><span class="r"></span></p>
746
+ <p class="pln"><span class="n"><a id="t662" href="#t662">662</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
747
+ <p class="pln"><span class="n"><a id="t663" href="#t663">663</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
748
+ <p class="pln"><span class="n"><a id="t664" href="#t664">664</a></span><span class="t"><span class="str"> VerificationScore with sequence-based drift score</span>&nbsp;</span><span class="r"></span></p>
749
+ <p class="pln"><span class="n"><a id="t665" href="#t665">665</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
750
+ <p class="mis show_mis"><span class="n"><a id="t666" href="#t666">666</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">seq_a</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">seq_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
751
+ <p class="mis show_mis"><span class="n"><a id="t667" href="#t667">667</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
752
+ <p class="mis mis2 show_mis"><span class="n"><a id="t668" href="#t668">668</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="num">0.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
753
+ <p class="mis mis2 show_mis"><span class="n"><a id="t669" href="#t669">669</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
754
+ <p class="mis mis2 show_mis"><span class="n"><a id="t670" href="#t670">670</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">LEXICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
755
+ <p class="mis mis2 show_mis"><span class="n"><a id="t671" href="#t671">671</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span><span class="str">"reason"</span><span class="op">:</span> <span class="str">"both_empty"</span><span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
756
+ <p class="mis mis2 show_mis"><span class="n"><a id="t672" href="#t672">672</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
757
+ <p class="pln"><span class="n"><a id="t673" href="#t673">673</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
758
+ <p class="pln"><span class="n"><a id="t674" href="#t674">674</a></span><span class="t"> <span class="com"># Levenshtein distance</span>&nbsp;</span><span class="r"></span></p>
759
+ <p class="mis show_mis"><span class="n"><a id="t675" href="#t675">675</a></span><span class="t"> <span class="nam">edit_dist</span> <span class="op">=</span> <span class="nam">_levenshtein_distance</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">,</span> <span class="nam">seq_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
760
+ <p class="mis show_mis"><span class="n"><a id="t676" href="#t676">676</a></span><span class="t"> <span class="nam">max_len</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
761
+ <p class="mis show_mis"><span class="n"><a id="t677" href="#t677">677</a></span><span class="t"> <span class="nam">normalized_edit</span> <span class="op">=</span> <span class="nam">edit_dist</span> <span class="op">/</span> <span class="nam">max_len</span> <span class="key">if</span> <span class="nam">max_len</span> <span class="op">></span> <span class="num">0</span> <span class="key">else</span> <span class="num">0.0</span>&nbsp;</span><span class="r"></span></p>
762
+ <p class="pln"><span class="n"><a id="t678" href="#t678">678</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
763
+ <p class="pln"><span class="n"><a id="t679" href="#t679">679</a></span><span class="t"> <span class="com"># Jaccard similarity (set-based)</span>&nbsp;</span><span class="r"></span></p>
764
+ <p class="mis show_mis"><span class="n"><a id="t680" href="#t680">680</a></span><span class="t"> <span class="nam">set_a</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
765
+ <p class="mis show_mis"><span class="n"><a id="t681" href="#t681">681</a></span><span class="t"> <span class="nam">set_b</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
766
+ <p class="mis show_mis"><span class="n"><a id="t682" href="#t682">682</a></span><span class="t"> <span class="nam">intersection</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">set_a</span> <span class="op">&amp;</span> <span class="nam">set_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
767
+ <p class="mis show_mis"><span class="n"><a id="t683" href="#t683">683</a></span><span class="t"> <span class="nam">union</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">set_a</span> <span class="op">|</span> <span class="nam">set_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
768
+ <p class="mis show_mis"><span class="n"><a id="t684" href="#t684">684</a></span><span class="t"> <span class="nam">jaccard</span> <span class="op">=</span> <span class="nam">intersection</span> <span class="op">/</span> <span class="nam">union</span> <span class="key">if</span> <span class="nam">union</span> <span class="op">></span> <span class="num">0</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
769
+ <p class="mis show_mis"><span class="n"><a id="t685" href="#t685">685</a></span><span class="t"> <span class="nam">jaccard_drift</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">jaccard</span>&nbsp;</span><span class="r"></span></p>
770
+ <p class="pln"><span class="n"><a id="t686" href="#t686">686</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
771
+ <p class="pln"><span class="n"><a id="t687" href="#t687">687</a></span><span class="t"> <span class="com"># Order-aware similarity (longest common subsequence)</span>&nbsp;</span><span class="r"></span></p>
772
+ <p class="mis show_mis"><span class="n"><a id="t688" href="#t688">688</a></span><span class="t"> <span class="nam">lcs_len</span> <span class="op">=</span> <span class="nam">_lcs_length</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">,</span> <span class="nam">seq_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
773
+ <p class="mis show_mis"><span class="n"><a id="t689" href="#t689">689</a></span><span class="t"> <span class="nam">lcs_ratio</span> <span class="op">=</span> <span class="num">2</span> <span class="op">*</span> <span class="nam">lcs_len</span> <span class="op">/</span> <span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span> <span class="op">+</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span><span class="op">)</span> <span class="key">if</span> <span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span> <span class="op">+</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span><span class="op">)</span> <span class="op">></span> <span class="num">0</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
774
+ <p class="mis show_mis"><span class="n"><a id="t690" href="#t690">690</a></span><span class="t"> <span class="nam">lcs_drift</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">lcs_ratio</span>&nbsp;</span><span class="r"></span></p>
775
+ <p class="pln"><span class="n"><a id="t691" href="#t691">691</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
776
+ <p class="pln"><span class="n"><a id="t692" href="#t692">692</a></span><span class="t"> <span class="com"># Combined</span>&nbsp;</span><span class="r"></span></p>
777
+ <p class="mis show_mis"><span class="n"><a id="t693" href="#t693">693</a></span><span class="t"> <span class="nam">drift_score</span> <span class="op">=</span> <span class="num">0.4</span> <span class="op">*</span> <span class="nam">normalized_edit</span> <span class="op">+</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">jaccard_drift</span> <span class="op">+</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">lcs_drift</span>&nbsp;</span><span class="r"></span></p>
778
+ <p class="pln"><span class="n"><a id="t694" href="#t694">694</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
779
+ <p class="mis show_mis"><span class="n"><a id="t695" href="#t695">695</a></span><span class="t"> <span class="key">return</span> <span class="nam">VerificationScore</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
780
+ <p class="mis mis2 show_mis"><span class="n"><a id="t696" href="#t696">696</a></span><span class="t"> <span class="nam">drift_score</span><span class="op">=</span><span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">clip</span><span class="op">(</span><span class="nam">drift_score</span><span class="op">,</span> <span class="num">0.0</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
781
+ <p class="mis mis2 show_mis"><span class="n"><a id="t697" href="#t697">697</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">0.85</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
782
+ <p class="mis mis2 show_mis"><span class="n"><a id="t698" href="#t698">698</a></span><span class="t"> <span class="nam">drift_type</span><span class="op">=</span><span class="nam">DriftType</span><span class="op">.</span><span class="nam">STRUCTURAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
783
+ <p class="mis mis2 show_mis"><span class="n"><a id="t699" href="#t699">699</a></span><span class="t"> <span class="nam">details</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
784
+ <p class="mis mis2 show_mis"><span class="n"><a id="t700" href="#t700">700</a></span><span class="t"> <span class="str">"edit_distance"</span><span class="op">:</span> <span class="nam">edit_dist</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
785
+ <p class="mis mis2 show_mis"><span class="n"><a id="t701" href="#t701">701</a></span><span class="t"> <span class="str">"normalized_edit"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">normalized_edit</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
786
+ <p class="mis mis2 show_mis"><span class="n"><a id="t702" href="#t702">702</a></span><span class="t"> <span class="str">"jaccard_similarity"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">jaccard</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
787
+ <p class="mis mis2 show_mis"><span class="n"><a id="t703" href="#t703">703</a></span><span class="t"> <span class="str">"lcs_ratio"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">lcs_ratio</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
788
+ <p class="mis mis2 show_mis"><span class="n"><a id="t704" href="#t704">704</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
789
+ <p class="mis mis2 show_mis"><span class="n"><a id="t705" href="#t705">705</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
790
+ <p class="pln"><span class="n"><a id="t706" href="#t706">706</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
791
+ <p class="pln"><span class="n"><a id="t707" href="#t707">707</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
792
+ <p class="pln"><span class="n"><a id="t708" href="#t708">708</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
793
+ <p class="pln"><span class="n"><a id="t709" href="#t709">709</a></span><span class="t"><span class="com"># Internal pure functions</span>&nbsp;</span><span class="r"></span></p>
794
+ <p class="pln"><span class="n"><a id="t710" href="#t710">710</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
795
+ <p class="pln"><span class="n"><a id="t711" href="#t711">711</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
796
+ <p class="pln"><span class="n"><a id="t712" href="#t712">712</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
797
+ <p class="run"><span class="n"><a id="t713" href="#t713">713</a></span><span class="t"><span class="key">def</span> <span class="nam">_lexical_drift</span><span class="op">(</span><span class="nam">text_a</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">text_b</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
798
+ <p class="pln"><span class="n"><a id="t714" href="#t714">714</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
799
+ <p class="pln"><span class="n"><a id="t715" href="#t715">715</a></span><span class="t"><span class="str"> Calculate lexical drift between two texts.</span>&nbsp;</span><span class="r"></span></p>
800
+ <p class="pln"><span class="n"><a id="t716" href="#t716">716</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
801
+ <p class="pln"><span class="n"><a id="t717" href="#t717">717</a></span><span class="t"><span class="str"> Pure function - no side effects.</span>&nbsp;</span><span class="r"></span></p>
802
+ <p class="pln"><span class="n"><a id="t718" href="#t718">718</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
803
+ <p class="pln"><span class="n"><a id="t719" href="#t719">719</a></span><span class="t"> <span class="com"># Character-level comparison</span>&nbsp;</span><span class="r"></span></p>
804
+ <p class="mis show_mis"><span class="n"><a id="t720" href="#t720">720</a></span><span class="t"> <span class="nam">chars_a</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">text_a</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
805
+ <p class="mis show_mis"><span class="n"><a id="t721" href="#t721">721</a></span><span class="t"> <span class="nam">chars_b</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">text_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
806
+ <p class="mis show_mis"><span class="n"><a id="t722" href="#t722">722</a></span><span class="t"> <span class="nam">char_jaccard</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">chars_a</span> <span class="op">&amp;</span> <span class="nam">chars_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">len</span><span class="op">(</span><span class="nam">chars_a</span> <span class="op">|</span> <span class="nam">chars_b</span><span class="op">)</span> <span class="key">if</span> <span class="op">(</span><span class="nam">chars_a</span> <span class="op">|</span> <span class="nam">chars_b</span><span class="op">)</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
807
+ <p class="pln"><span class="n"><a id="t723" href="#t723">723</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
808
+ <p class="pln"><span class="n"><a id="t724" href="#t724">724</a></span><span class="t"> <span class="com"># Word-level comparison</span>&nbsp;</span><span class="r"></span></p>
809
+ <p class="mis show_mis"><span class="n"><a id="t725" href="#t725">725</a></span><span class="t"> <span class="nam">words_a</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">text_a</span><span class="op">.</span><span class="nam">split</span><span class="op">(</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
810
+ <p class="mis show_mis"><span class="n"><a id="t726" href="#t726">726</a></span><span class="t"> <span class="nam">words_b</span> <span class="op">=</span> <span class="nam">set</span><span class="op">(</span><span class="nam">text_b</span><span class="op">.</span><span class="nam">split</span><span class="op">(</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
811
+ <p class="mis show_mis"><span class="n"><a id="t727" href="#t727">727</a></span><span class="t"> <span class="nam">word_jaccard</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">words_a</span> <span class="op">&amp;</span> <span class="nam">words_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">len</span><span class="op">(</span><span class="nam">words_a</span> <span class="op">|</span> <span class="nam">words_b</span><span class="op">)</span> <span class="key">if</span> <span class="op">(</span><span class="nam">words_a</span> <span class="op">|</span> <span class="nam">words_b</span><span class="op">)</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
812
+ <p class="pln"><span class="n"><a id="t728" href="#t728">728</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
813
+ <p class="pln"><span class="n"><a id="t729" href="#t729">729</a></span><span class="t"> <span class="com"># Length ratio</span>&nbsp;</span><span class="r"></span></p>
814
+ <p class="mis show_mis"><span class="n"><a id="t730" href="#t730">730</a></span><span class="t"> <span class="nam">len_a</span><span class="op">,</span> <span class="nam">len_b</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">text_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
815
+ <p class="mis show_mis"><span class="n"><a id="t731" href="#t731">731</a></span><span class="t"> <span class="nam">length_ratio</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span><span class="nam">len_a</span><span class="op">,</span> <span class="nam">len_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max</span><span class="op">(</span><span class="nam">len_a</span><span class="op">,</span> <span class="nam">len_b</span><span class="op">)</span> <span class="key">if</span> <span class="nam">max</span><span class="op">(</span><span class="nam">len_a</span><span class="op">,</span> <span class="nam">len_b</span><span class="op">)</span> <span class="op">></span> <span class="num">0</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
816
+ <p class="pln"><span class="n"><a id="t732" href="#t732">732</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
817
+ <p class="pln"><span class="n"><a id="t733" href="#t733">733</a></span><span class="t"> <span class="com"># Combined score (lower similarity = higher drift)</span>&nbsp;</span><span class="r"></span></p>
818
+ <p class="mis show_mis"><span class="n"><a id="t734" href="#t734">734</a></span><span class="t"> <span class="nam">similarity</span> <span class="op">=</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">char_jaccard</span> <span class="op">+</span> <span class="num">0.5</span> <span class="op">*</span> <span class="nam">word_jaccard</span> <span class="op">+</span> <span class="num">0.2</span> <span class="op">*</span> <span class="nam">length_ratio</span>&nbsp;</span><span class="r"></span></p>
819
+ <p class="mis show_mis"><span class="n"><a id="t735" href="#t735">735</a></span><span class="t"> <span class="nam">drift</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">similarity</span>&nbsp;</span><span class="r"></span></p>
820
+ <p class="pln"><span class="n"><a id="t736" href="#t736">736</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
821
+ <p class="mis show_mis"><span class="n"><a id="t737" href="#t737">737</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
822
+ <p class="mis mis2 show_mis"><span class="n"><a id="t738" href="#t738">738</a></span><span class="t"> <span class="str">"score"</span><span class="op">:</span> <span class="nam">drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
823
+ <p class="mis mis2 show_mis"><span class="n"><a id="t739" href="#t739">739</a></span><span class="t"> <span class="str">"char_jaccard"</span><span class="op">:</span> <span class="nam">char_jaccard</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
824
+ <p class="mis mis2 show_mis"><span class="n"><a id="t740" href="#t740">740</a></span><span class="t"> <span class="str">"word_jaccard"</span><span class="op">:</span> <span class="nam">word_jaccard</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
825
+ <p class="mis mis2 show_mis"><span class="n"><a id="t741" href="#t741">741</a></span><span class="t"> <span class="str">"length_ratio"</span><span class="op">:</span> <span class="nam">length_ratio</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
826
+ <p class="mis mis2 show_mis"><span class="n"><a id="t742" href="#t742">742</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
827
+ <p class="pln"><span class="n"><a id="t743" href="#t743">743</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
828
+ <p class="pln"><span class="n"><a id="t744" href="#t744">744</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
829
+ <p class="run"><span class="n"><a id="t745" href="#t745">745</a></span><span class="t"><span class="key">def</span> <span class="nam">_structural_drift</span><span class="op">(</span><span class="nam">text_a</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">text_b</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
830
+ <p class="pln"><span class="n"><a id="t746" href="#t746">746</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
831
+ <p class="pln"><span class="n"><a id="t747" href="#t747">747</a></span><span class="t"><span class="str"> Calculate structural drift between two texts.</span>&nbsp;</span><span class="r"></span></p>
832
+ <p class="pln"><span class="n"><a id="t748" href="#t748">748</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
833
+ <p class="pln"><span class="n"><a id="t749" href="#t749">749</a></span><span class="t"><span class="str"> Analyzes structure like line count, indentation, code patterns.</span>&nbsp;</span><span class="r"></span></p>
834
+ <p class="pln"><span class="n"><a id="t750" href="#t750">750</a></span><span class="t"><span class="str"> Pure function - no side effects.</span>&nbsp;</span><span class="r"></span></p>
835
+ <p class="pln"><span class="n"><a id="t751" href="#t751">751</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
836
+ <p class="mis show_mis"><span class="n"><a id="t752" href="#t752">752</a></span><span class="t"> <span class="nam">lines_a</span> <span class="op">=</span> <span class="nam">text_a</span><span class="op">.</span><span class="nam">split</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
837
+ <p class="mis show_mis"><span class="n"><a id="t753" href="#t753">753</a></span><span class="t"> <span class="nam">lines_b</span> <span class="op">=</span> <span class="nam">text_b</span><span class="op">.</span><span class="nam">split</span><span class="op">(</span><span class="str">"\n"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
838
+ <p class="pln"><span class="n"><a id="t754" href="#t754">754</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
839
+ <p class="pln"><span class="n"><a id="t755" href="#t755">755</a></span><span class="t"> <span class="com"># Line count difference</span>&nbsp;</span><span class="r"></span></p>
840
+ <p class="mis show_mis"><span class="n"><a id="t756" href="#t756">756</a></span><span class="t"> <span class="nam">line_count_a</span><span class="op">,</span> <span class="nam">line_count_b</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">lines_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">lines_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
841
+ <p class="mis show_mis"><span class="n"><a id="t757" href="#t757">757</a></span><span class="t"> <span class="nam">line_ratio</span> <span class="op">=</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
842
+ <p class="mis mis2 show_mis"><span class="n"><a id="t758" href="#t758">758</a></span><span class="t"> <span class="nam">min</span><span class="op">(</span><span class="nam">line_count_a</span><span class="op">,</span> <span class="nam">line_count_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max</span><span class="op">(</span><span class="nam">line_count_a</span><span class="op">,</span> <span class="nam">line_count_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
843
+ <p class="mis mis2 show_mis"><span class="n"><a id="t759" href="#t759">759</a></span><span class="t"> <span class="key">if</span> <span class="nam">max</span><span class="op">(</span><span class="nam">line_count_a</span><span class="op">,</span> <span class="nam">line_count_b</span><span class="op">)</span> <span class="op">></span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
844
+ <p class="mis mis2 show_mis"><span class="n"><a id="t760" href="#t760">760</a></span><span class="t"> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
845
+ <p class="mis mis2 show_mis"><span class="n"><a id="t761" href="#t761">761</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
846
+ <p class="pln"><span class="n"><a id="t762" href="#t762">762</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
847
+ <p class="pln"><span class="n"><a id="t763" href="#t763">763</a></span><span class="t"> <span class="com"># Indentation pattern</span>&nbsp;</span><span class="r"></span></p>
848
+ <p class="mis show_mis"><span class="n"><a id="t764" href="#t764">764</a></span><span class="t"> <span class="nam">indent_a</span> <span class="op">=</span> <span class="op">[</span><span class="nam">len</span><span class="op">(</span><span class="nam">line</span><span class="op">)</span> <span class="op">-</span> <span class="nam">len</span><span class="op">(</span><span class="nam">line</span><span class="op">.</span><span class="nam">lstrip</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> <span class="key">for</span> <span class="nam">line</span> <span class="key">in</span> <span class="nam">lines_a</span> <span class="key">if</span> <span class="nam">line</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
849
+ <p class="mis show_mis"><span class="n"><a id="t765" href="#t765">765</a></span><span class="t"> <span class="nam">indent_b</span> <span class="op">=</span> <span class="op">[</span><span class="nam">len</span><span class="op">(</span><span class="nam">line</span><span class="op">)</span> <span class="op">-</span> <span class="nam">len</span><span class="op">(</span><span class="nam">line</span><span class="op">.</span><span class="nam">lstrip</span><span class="op">(</span><span class="op">)</span><span class="op">)</span> <span class="key">for</span> <span class="nam">line</span> <span class="key">in</span> <span class="nam">lines_b</span> <span class="key">if</span> <span class="nam">line</span><span class="op">.</span><span class="nam">strip</span><span class="op">(</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
850
+ <p class="pln"><span class="n"><a id="t766" href="#t766">766</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
851
+ <p class="mis show_mis"><span class="n"><a id="t767" href="#t767">767</a></span><span class="t"> <span class="key">if</span> <span class="nam">indent_a</span> <span class="key">and</span> <span class="nam">indent_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
852
+ <p class="mis show_mis"><span class="n"><a id="t768" href="#t768">768</a></span><span class="t"> <span class="nam">avg_indent_a</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">indent_a</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
853
+ <p class="mis show_mis"><span class="n"><a id="t769" href="#t769">769</a></span><span class="t"> <span class="nam">avg_indent_b</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">indent_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
854
+ <p class="mis show_mis"><span class="n"><a id="t770" href="#t770">770</a></span><span class="t"> <span class="nam">max_indent</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">avg_indent_a</span><span class="op">,</span> <span class="nam">avg_indent_b</span><span class="op">,</span> <span class="num">1</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
855
+ <p class="mis show_mis"><span class="n"><a id="t771" href="#t771">771</a></span><span class="t"> <span class="nam">indent_similarity</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">avg_indent_a</span> <span class="op">-</span> <span class="nam">avg_indent_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max_indent</span>&nbsp;</span><span class="r"></span></p>
856
+ <p class="pln"><span class="n"><a id="t772" href="#t772">772</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
857
+ <p class="mis show_mis"><span class="n"><a id="t773" href="#t773">773</a></span><span class="t"> <span class="nam">indent_similarity</span> <span class="op">=</span> <span class="num">1.0</span> <span class="key">if</span> <span class="op">(</span><span class="key">not</span> <span class="nam">indent_a</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">indent_b</span><span class="op">)</span> <span class="key">else</span> <span class="num">0.5</span>&nbsp;</span><span class="r"></span></p>
858
+ <p class="pln"><span class="n"><a id="t774" href="#t774">774</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
859
+ <p class="pln"><span class="n"><a id="t775" href="#t775">775</a></span><span class="t"> <span class="com"># Code pattern markers (for code comparison)</span>&nbsp;</span><span class="r"></span></p>
860
+ <p class="mis show_mis"><span class="n"><a id="t776" href="#t776">776</a></span><span class="t"> <span class="nam">patterns</span> <span class="op">=</span> <span class="op">[</span><span class="str">"def "</span><span class="op">,</span> <span class="str">"class "</span><span class="op">,</span> <span class="str">"import "</span><span class="op">,</span> <span class="str">"return "</span><span class="op">,</span> <span class="str">"if "</span><span class="op">,</span> <span class="str">"for "</span><span class="op">,</span> <span class="str">"while "</span><span class="op">,</span> <span class="str">"try:"</span><span class="op">,</span> <span class="str">"except"</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
861
+ <p class="mis show_mis"><span class="n"><a id="t777" href="#t777">777</a></span><span class="t"> <span class="nam">pattern_a</span> <span class="op">=</span> <span class="op">{</span><span class="nam">p</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">patterns</span> <span class="key">if</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">text_a</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
862
+ <p class="mis show_mis"><span class="n"><a id="t778" href="#t778">778</a></span><span class="t"> <span class="nam">pattern_b</span> <span class="op">=</span> <span class="op">{</span><span class="nam">p</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">patterns</span> <span class="key">if</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">text_b</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
863
+ <p class="mis show_mis"><span class="n"><a id="t779" href="#t779">779</a></span><span class="t"> <span class="nam">pattern_jaccard</span> <span class="op">=</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
864
+ <p class="mis mis2 show_mis"><span class="n"><a id="t780" href="#t780">780</a></span><span class="t"> <span class="nam">len</span><span class="op">(</span><span class="nam">pattern_a</span> <span class="op">&amp;</span> <span class="nam">pattern_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">len</span><span class="op">(</span><span class="nam">pattern_a</span> <span class="op">|</span> <span class="nam">pattern_b</span><span class="op">)</span> <span class="key">if</span> <span class="op">(</span><span class="nam">pattern_a</span> <span class="op">|</span> <span class="nam">pattern_b</span><span class="op">)</span> <span class="key">else</span> <span class="num">1.0</span>&nbsp;</span><span class="r"></span></p>
865
+ <p class="mis mis2 show_mis"><span class="n"><a id="t781" href="#t781">781</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
866
+ <p class="pln"><span class="n"><a id="t782" href="#t782">782</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
867
+ <p class="pln"><span class="n"><a id="t783" href="#t783">783</a></span><span class="t"> <span class="com"># Combined</span>&nbsp;</span><span class="r"></span></p>
868
+ <p class="mis show_mis"><span class="n"><a id="t784" href="#t784">784</a></span><span class="t"> <span class="nam">similarity</span> <span class="op">=</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">line_ratio</span> <span class="op">+</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">indent_similarity</span> <span class="op">+</span> <span class="num">0.4</span> <span class="op">*</span> <span class="nam">pattern_jaccard</span>&nbsp;</span><span class="r"></span></p>
869
+ <p class="mis show_mis"><span class="n"><a id="t785" href="#t785">785</a></span><span class="t"> <span class="nam">drift</span> <span class="op">=</span> <span class="num">1.0</span> <span class="op">-</span> <span class="nam">similarity</span>&nbsp;</span><span class="r"></span></p>
870
+ <p class="pln"><span class="n"><a id="t786" href="#t786">786</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
871
+ <p class="mis show_mis"><span class="n"><a id="t787" href="#t787">787</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
872
+ <p class="mis mis2 show_mis"><span class="n"><a id="t788" href="#t788">788</a></span><span class="t"> <span class="str">"score"</span><span class="op">:</span> <span class="nam">drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
873
+ <p class="mis mis2 show_mis"><span class="n"><a id="t789" href="#t789">789</a></span><span class="t"> <span class="str">"line_ratio"</span><span class="op">:</span> <span class="nam">line_ratio</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
874
+ <p class="mis mis2 show_mis"><span class="n"><a id="t790" href="#t790">790</a></span><span class="t"> <span class="str">"indent_similarity"</span><span class="op">:</span> <span class="nam">indent_similarity</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
875
+ <p class="mis mis2 show_mis"><span class="n"><a id="t791" href="#t791">791</a></span><span class="t"> <span class="str">"pattern_jaccard"</span><span class="op">:</span> <span class="nam">pattern_jaccard</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
876
+ <p class="mis mis2 show_mis"><span class="n"><a id="t792" href="#t792">792</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
877
+ <p class="pln"><span class="n"><a id="t793" href="#t793">793</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
878
+ <p class="pln"><span class="n"><a id="t794" href="#t794">794</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
879
+ <p class="run"><span class="n"><a id="t795" href="#t795">795</a></span><span class="t"><span class="key">def</span> <span class="nam">_numerical_drift</span><span class="op">(</span><span class="nam">text_a</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">text_b</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
880
+ <p class="pln"><span class="n"><a id="t796" href="#t796">796</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
881
+ <p class="pln"><span class="n"><a id="t797" href="#t797">797</a></span><span class="t"><span class="str"> Calculate numerical drift by extracting and comparing numbers.</span>&nbsp;</span><span class="r"></span></p>
882
+ <p class="pln"><span class="n"><a id="t798" href="#t798">798</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
883
+ <p class="pln"><span class="n"><a id="t799" href="#t799">799</a></span><span class="t"><span class="str"> Pure function - no side effects.</span>&nbsp;</span><span class="r"></span></p>
884
+ <p class="pln"><span class="n"><a id="t800" href="#t800">800</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
885
+ <p class="mis show_mis"><span class="n"><a id="t801" href="#t801">801</a></span><span class="t"> <span class="key">import</span> <span class="nam">re</span>&nbsp;</span><span class="r"></span></p>
886
+ <p class="pln"><span class="n"><a id="t802" href="#t802">802</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
887
+ <p class="pln"><span class="n"><a id="t803" href="#t803">803</a></span><span class="t"> <span class="com"># Extract numbers from both texts</span>&nbsp;</span><span class="r"></span></p>
888
+ <p class="mis show_mis"><span class="n"><a id="t804" href="#t804">804</a></span><span class="t"> <span class="nam">number_pattern</span> <span class="op">=</span> <span class="str">r"-?\d+\.?\d*"</span>&nbsp;</span><span class="r"></span></p>
889
+ <p class="mis show_mis"><span class="n"><a id="t805" href="#t805">805</a></span><span class="t"> <span class="nam">numbers_a</span> <span class="op">=</span> <span class="op">[</span><span class="nam">float</span><span class="op">(</span><span class="nam">n</span><span class="op">)</span> <span class="key">for</span> <span class="nam">n</span> <span class="key">in</span> <span class="nam">re</span><span class="op">.</span><span class="nam">findall</span><span class="op">(</span><span class="nam">number_pattern</span><span class="op">,</span> <span class="nam">text_a</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
890
+ <p class="mis show_mis"><span class="n"><a id="t806" href="#t806">806</a></span><span class="t"> <span class="nam">numbers_b</span> <span class="op">=</span> <span class="op">[</span><span class="nam">float</span><span class="op">(</span><span class="nam">n</span><span class="op">)</span> <span class="key">for</span> <span class="nam">n</span> <span class="key">in</span> <span class="nam">re</span><span class="op">.</span><span class="nam">findall</span><span class="op">(</span><span class="nam">number_pattern</span><span class="op">,</span> <span class="nam">text_b</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
891
+ <p class="pln"><span class="n"><a id="t807" href="#t807">807</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
892
+ <p class="mis show_mis"><span class="n"><a id="t808" href="#t808">808</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">numbers_a</span> <span class="key">and</span> <span class="key">not</span> <span class="nam">numbers_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
893
+ <p class="mis show_mis"><span class="n"><a id="t809" href="#t809">809</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span><span class="str">"score"</span><span class="op">:</span> <span class="num">0.0</span><span class="op">,</span> <span class="str">"reason"</span><span class="op">:</span> <span class="str">"no_numbers"</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
894
+ <p class="pln"><span class="n"><a id="t810" href="#t810">810</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
895
+ <p class="mis show_mis"><span class="n"><a id="t811" href="#t811">811</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">numbers_a</span> <span class="key">or</span> <span class="key">not</span> <span class="nam">numbers_b</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
896
+ <p class="mis show_mis"><span class="n"><a id="t812" href="#t812">812</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span><span class="str">"score"</span><span class="op">:</span> <span class="num">0.5</span><span class="op">,</span> <span class="str">"reason"</span><span class="op">:</span> <span class="str">"numbers_only_in_one"</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
897
+ <p class="pln"><span class="n"><a id="t813" href="#t813">813</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
898
+ <p class="pln"><span class="n"><a id="t814" href="#t814">814</a></span><span class="t"> <span class="com"># Compare statistics</span>&nbsp;</span><span class="r"></span></p>
899
+ <p class="mis show_mis"><span class="n"><a id="t815" href="#t815">815</a></span><span class="t"> <span class="nam">mean_a</span><span class="op">,</span> <span class="nam">mean_b</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">numbers_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">numbers_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
900
+ <p class="mis show_mis"><span class="n"><a id="t816" href="#t816">816</a></span><span class="t"> <span class="nam">std_a</span><span class="op">,</span> <span class="nam">std_b</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">std</span><span class="op">(</span><span class="nam">numbers_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">np</span><span class="op">.</span><span class="nam">std</span><span class="op">(</span><span class="nam">numbers_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
901
+ <p class="pln"><span class="n"><a id="t817" href="#t817">817</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
902
+ <p class="pln"><span class="n"><a id="t818" href="#t818">818</a></span><span class="t"> <span class="com"># Relative difference in means</span>&nbsp;</span><span class="r"></span></p>
903
+ <p class="mis show_mis"><span class="n"><a id="t819" href="#t819">819</a></span><span class="t"> <span class="nam">max_mean</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">abs</span><span class="op">(</span><span class="nam">mean_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">mean_b</span><span class="op">)</span><span class="op">,</span> <span class="num">1e-10</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
904
+ <p class="mis show_mis"><span class="n"><a id="t820" href="#t820">820</a></span><span class="t"> <span class="nam">mean_diff</span> <span class="op">=</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">mean_a</span> <span class="op">-</span> <span class="nam">mean_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max_mean</span>&nbsp;</span><span class="r"></span></p>
905
+ <p class="pln"><span class="n"><a id="t821" href="#t821">821</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
906
+ <p class="pln"><span class="n"><a id="t822" href="#t822">822</a></span><span class="t"> <span class="com"># Relative difference in stds</span>&nbsp;</span><span class="r"></span></p>
907
+ <p class="mis show_mis"><span class="n"><a id="t823" href="#t823">823</a></span><span class="t"> <span class="nam">max_std</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">std_a</span><span class="op">,</span> <span class="nam">std_b</span><span class="op">,</span> <span class="num">1e-10</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
908
+ <p class="mis show_mis"><span class="n"><a id="t824" href="#t824">824</a></span><span class="t"> <span class="nam">std_diff</span> <span class="op">=</span> <span class="nam">abs</span><span class="op">(</span><span class="nam">std_a</span> <span class="op">-</span> <span class="nam">std_b</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max_std</span> <span class="key">if</span> <span class="nam">max_std</span> <span class="op">></span> <span class="num">1e-10</span> <span class="key">else</span> <span class="num">0.0</span>&nbsp;</span><span class="r"></span></p>
909
+ <p class="pln"><span class="n"><a id="t825" href="#t825">825</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
910
+ <p class="pln"><span class="n"><a id="t826" href="#t826">826</a></span><span class="t"> <span class="com"># Count difference</span>&nbsp;</span><span class="r"></span></p>
911
+ <p class="mis show_mis"><span class="n"><a id="t827" href="#t827">827</a></span><span class="t"> <span class="nam">count_ratio</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">numbers_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">numbers_b</span><span class="op">)</span><span class="op">)</span> <span class="op">/</span> <span class="nam">max</span><span class="op">(</span><span class="nam">len</span><span class="op">(</span><span class="nam">numbers_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">numbers_b</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
912
+ <p class="pln"><span class="n"><a id="t828" href="#t828">828</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
913
+ <p class="pln"><span class="n"><a id="t829" href="#t829">829</a></span><span class="t"> <span class="com"># Combined</span>&nbsp;</span><span class="r"></span></p>
914
+ <p class="mis show_mis"><span class="n"><a id="t830" href="#t830">830</a></span><span class="t"> <span class="nam">drift</span> <span class="op">=</span> <span class="num">0.4</span> <span class="op">*</span> <span class="nam">min</span><span class="op">(</span><span class="nam">mean_diff</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span> <span class="op">+</span> <span class="num">0.3</span> <span class="op">*</span> <span class="nam">min</span><span class="op">(</span><span class="nam">std_diff</span><span class="op">,</span> <span class="num">1.0</span><span class="op">)</span> <span class="op">+</span> <span class="num">0.3</span> <span class="op">*</span> <span class="op">(</span><span class="num">1.0</span> <span class="op">-</span> <span class="nam">count_ratio</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
915
+ <p class="pln"><span class="n"><a id="t831" href="#t831">831</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
916
+ <p class="mis show_mis"><span class="n"><a id="t832" href="#t832">832</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
917
+ <p class="mis mis2 show_mis"><span class="n"><a id="t833" href="#t833">833</a></span><span class="t"> <span class="str">"score"</span><span class="op">:</span> <span class="nam">drift</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
918
+ <p class="mis mis2 show_mis"><span class="n"><a id="t834" href="#t834">834</a></span><span class="t"> <span class="str">"mean_a"</span><span class="op">:</span> <span class="nam">mean_a</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
919
+ <p class="mis mis2 show_mis"><span class="n"><a id="t835" href="#t835">835</a></span><span class="t"> <span class="str">"mean_b"</span><span class="op">:</span> <span class="nam">mean_b</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
920
+ <p class="mis mis2 show_mis"><span class="n"><a id="t836" href="#t836">836</a></span><span class="t"> <span class="str">"std_a"</span><span class="op">:</span> <span class="nam">std_a</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
921
+ <p class="mis mis2 show_mis"><span class="n"><a id="t837" href="#t837">837</a></span><span class="t"> <span class="str">"std_b"</span><span class="op">:</span> <span class="nam">std_b</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
922
+ <p class="mis mis2 show_mis"><span class="n"><a id="t838" href="#t838">838</a></span><span class="t"> <span class="str">"count_a"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">numbers_a</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
923
+ <p class="mis mis2 show_mis"><span class="n"><a id="t839" href="#t839">839</a></span><span class="t"> <span class="str">"count_b"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">numbers_b</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
924
+ <p class="mis mis2 show_mis"><span class="n"><a id="t840" href="#t840">840</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
925
+ <p class="pln"><span class="n"><a id="t841" href="#t841">841</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
926
+ <p class="pln"><span class="n"><a id="t842" href="#t842">842</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
927
+ <p class="run"><span class="n"><a id="t843" href="#t843">843</a></span><span class="t"><span class="key">def</span> <span class="nam">_levenshtein_distance</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">,</span> <span class="nam">seq_b</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
928
+ <p class="pln"><span class="n"><a id="t844" href="#t844">844</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
929
+ <p class="pln"><span class="n"><a id="t845" href="#t845">845</a></span><span class="t"><span class="str"> Calculate Levenshtein edit distance between two sequences.</span>&nbsp;</span><span class="r"></span></p>
930
+ <p class="pln"><span class="n"><a id="t846" href="#t846">846</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
931
+ <p class="pln"><span class="n"><a id="t847" href="#t847">847</a></span><span class="t"><span class="str"> Pure function using dynamic programming.</span>&nbsp;</span><span class="r"></span></p>
932
+ <p class="pln"><span class="n"><a id="t848" href="#t848">848</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
933
+ <p class="mis show_mis"><span class="n"><a id="t849" href="#t849">849</a></span><span class="t"> <span class="nam">m</span><span class="op">,</span> <span class="nam">n</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
934
+ <p class="pln"><span class="n"><a id="t850" href="#t850">850</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
935
+ <p class="mis show_mis"><span class="n"><a id="t851" href="#t851">851</a></span><span class="t"> <span class="key">if</span> <span class="nam">m</span> <span class="op">==</span> <span class="num">0</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
936
+ <p class="mis show_mis"><span class="n"><a id="t852" href="#t852">852</a></span><span class="t"> <span class="key">return</span> <span class="nam">n</span>&nbsp;</span><span class="r"></span></p>
937
+ <p class="mis show_mis"><span class="n"><a id="t853" href="#t853">853</a></span><span class="t"> <span class="key">if</span> <span class="nam">n</span> <span class="op">==</span> <span class="num">0</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
938
+ <p class="mis show_mis"><span class="n"><a id="t854" href="#t854">854</a></span><span class="t"> <span class="key">return</span> <span class="nam">m</span>&nbsp;</span><span class="r"></span></p>
939
+ <p class="pln"><span class="n"><a id="t855" href="#t855">855</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
940
+ <p class="pln"><span class="n"><a id="t856" href="#t856">856</a></span><span class="t"> <span class="com"># Use numpy for efficiency</span>&nbsp;</span><span class="r"></span></p>
941
+ <p class="mis show_mis"><span class="n"><a id="t857" href="#t857">857</a></span><span class="t"> <span class="nam">dp</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">zeros</span><span class="op">(</span><span class="op">(</span><span class="nam">m</span> <span class="op">+</span> <span class="num">1</span><span class="op">,</span> <span class="nam">n</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">int32</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
942
+ <p class="mis show_mis"><span class="n"><a id="t858" href="#t858">858</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="op">:</span><span class="op">,</span> <span class="num">0</span><span class="op">]</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">arange</span><span class="op">(</span><span class="nam">m</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
943
+ <p class="mis show_mis"><span class="n"><a id="t859" href="#t859">859</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="num">0</span><span class="op">,</span> <span class="op">:</span><span class="op">]</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">arange</span><span class="op">(</span><span class="nam">n</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
944
+ <p class="pln"><span class="n"><a id="t860" href="#t860">860</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
945
+ <p class="mis show_mis"><span class="n"><a id="t861" href="#t861">861</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">m</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
946
+ <p class="mis show_mis"><span class="n"><a id="t862" href="#t862">862</a></span><span class="t"> <span class="key">for</span> <span class="nam">j</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">n</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
947
+ <p class="mis show_mis"><span class="n"><a id="t863" href="#t863">863</a></span><span class="t"> <span class="nam">cost</span> <span class="op">=</span> <span class="num">0</span> <span class="key">if</span> <span class="nam">seq_a</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="op">==</span> <span class="nam">seq_b</span><span class="op">[</span><span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="key">else</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
948
+ <p class="mis show_mis"><span class="n"><a id="t864" href="#t864">864</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span><span class="op">,</span> <span class="nam">j</span><span class="op">]</span> <span class="op">=</span> <span class="nam">min</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
949
+ <p class="mis mis2 show_mis"><span class="n"><a id="t865" href="#t865">865</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">,</span> <span class="nam">j</span><span class="op">]</span> <span class="op">+</span> <span class="num">1</span><span class="op">,</span> <span class="com"># deletion</span>&nbsp;</span><span class="r"></span></p>
950
+ <p class="mis mis2 show_mis"><span class="n"><a id="t866" href="#t866">866</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span><span class="op">,</span> <span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="num">1</span><span class="op">,</span> <span class="com"># insertion</span>&nbsp;</span><span class="r"></span></p>
951
+ <p class="mis mis2 show_mis"><span class="n"><a id="t867" href="#t867">867</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">,</span> <span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="nam">cost</span><span class="op">,</span> <span class="com"># substitution</span>&nbsp;</span><span class="r"></span></p>
952
+ <p class="mis mis2 show_mis"><span class="n"><a id="t868" href="#t868">868</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
953
+ <p class="pln"><span class="n"><a id="t869" href="#t869">869</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
954
+ <p class="mis show_mis"><span class="n"><a id="t870" href="#t870">870</a></span><span class="t"> <span class="key">return</span> <span class="nam">int</span><span class="op">(</span><span class="nam">dp</span><span class="op">[</span><span class="nam">m</span><span class="op">,</span> <span class="nam">n</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
955
+ <p class="pln"><span class="n"><a id="t871" href="#t871">871</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
956
+ <p class="pln"><span class="n"><a id="t872" href="#t872">872</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
957
+ <p class="run"><span class="n"><a id="t873" href="#t873">873</a></span><span class="t"><span class="key">def</span> <span class="nam">_lcs_length</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">,</span> <span class="nam">seq_b</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
958
+ <p class="pln"><span class="n"><a id="t874" href="#t874">874</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
959
+ <p class="pln"><span class="n"><a id="t875" href="#t875">875</a></span><span class="t"><span class="str"> Calculate length of Longest Common Subsequence.</span>&nbsp;</span><span class="r"></span></p>
960
+ <p class="pln"><span class="n"><a id="t876" href="#t876">876</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
961
+ <p class="pln"><span class="n"><a id="t877" href="#t877">877</a></span><span class="t"><span class="str"> Pure function using dynamic programming.</span>&nbsp;</span><span class="r"></span></p>
962
+ <p class="pln"><span class="n"><a id="t878" href="#t878">878</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
963
+ <p class="mis show_mis"><span class="n"><a id="t879" href="#t879">879</a></span><span class="t"> <span class="nam">m</span><span class="op">,</span> <span class="nam">n</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_a</span><span class="op">)</span><span class="op">,</span> <span class="nam">len</span><span class="op">(</span><span class="nam">seq_b</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
964
+ <p class="pln"><span class="n"><a id="t880" href="#t880">880</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
965
+ <p class="mis show_mis"><span class="n"><a id="t881" href="#t881">881</a></span><span class="t"> <span class="key">if</span> <span class="nam">m</span> <span class="op">==</span> <span class="num">0</span> <span class="key">or</span> <span class="nam">n</span> <span class="op">==</span> <span class="num">0</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
966
+ <p class="mis show_mis"><span class="n"><a id="t882" href="#t882">882</a></span><span class="t"> <span class="key">return</span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
967
+ <p class="pln"><span class="n"><a id="t883" href="#t883">883</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
968
+ <p class="mis show_mis"><span class="n"><a id="t884" href="#t884">884</a></span><span class="t"> <span class="nam">dp</span> <span class="op">=</span> <span class="nam">np</span><span class="op">.</span><span class="nam">zeros</span><span class="op">(</span><span class="op">(</span><span class="nam">m</span> <span class="op">+</span> <span class="num">1</span><span class="op">,</span> <span class="nam">n</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">,</span> <span class="nam">dtype</span><span class="op">=</span><span class="nam">np</span><span class="op">.</span><span class="nam">int32</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
969
+ <p class="pln"><span class="n"><a id="t885" href="#t885">885</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
970
+ <p class="mis show_mis"><span class="n"><a id="t886" href="#t886">886</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">m</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
971
+ <p class="mis show_mis"><span class="n"><a id="t887" href="#t887">887</a></span><span class="t"> <span class="key">for</span> <span class="nam">j</span> <span class="key">in</span> <span class="nam">range</span><span class="op">(</span><span class="num">1</span><span class="op">,</span> <span class="nam">n</span> <span class="op">+</span> <span class="num">1</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
972
+ <p class="mis show_mis"><span class="n"><a id="t888" href="#t888">888</a></span><span class="t"> <span class="key">if</span> <span class="nam">seq_a</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="op">==</span> <span class="nam">seq_b</span><span class="op">[</span><span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
973
+ <p class="mis show_mis"><span class="n"><a id="t889" href="#t889">889</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span><span class="op">,</span> <span class="nam">j</span><span class="op">]</span> <span class="op">=</span> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">,</span> <span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span> <span class="op">+</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
974
+ <p class="pln"><span class="n"><a id="t890" href="#t890">890</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
975
+ <p class="mis show_mis"><span class="n"><a id="t891" href="#t891">891</a></span><span class="t"> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span><span class="op">,</span> <span class="nam">j</span><span class="op">]</span> <span class="op">=</span> <span class="nam">max</span><span class="op">(</span><span class="nam">dp</span><span class="op">[</span><span class="nam">i</span> <span class="op">-</span> <span class="num">1</span><span class="op">,</span> <span class="nam">j</span><span class="op">]</span><span class="op">,</span> <span class="nam">dp</span><span class="op">[</span><span class="nam">i</span><span class="op">,</span> <span class="nam">j</span> <span class="op">-</span> <span class="num">1</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
976
+ <p class="pln"><span class="n"><a id="t892" href="#t892">892</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
977
+ <p class="mis show_mis"><span class="n"><a id="t893" href="#t893">893</a></span><span class="t"> <span class="key">return</span> <span class="nam">int</span><span class="op">(</span><span class="nam">dp</span><span class="op">[</span><span class="nam">m</span><span class="op">,</span> <span class="nam">n</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
978
+ <p class="pln"><span class="n"><a id="t894" href="#t894">894</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
979
+ <p class="pln"><span class="n"><a id="t895" href="#t895">895</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
980
+ <p class="pln"><span class="n"><a id="t896" href="#t896">896</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
981
+ <p class="pln"><span class="n"><a id="t897" href="#t897">897</a></span><span class="t"><span class="com"># Batch verification functions</span>&nbsp;</span><span class="r"></span></p>
982
+ <p class="pln"><span class="n"><a id="t898" href="#t898">898</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
983
+ <p class="pln"><span class="n"><a id="t899" href="#t899">899</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
984
+ <p class="pln"><span class="n"><a id="t900" href="#t900">900</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
985
+ <p class="run"><span class="n"><a id="t901" href="#t901">901</a></span><span class="t"><span class="key">def</span> <span class="nam">verify_batch</span><span class="op">(</span><span class="nam">outputs_a</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">outputs_b</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">VerificationScore</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
986
+ <p class="pln"><span class="n"><a id="t902" href="#t902">902</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
987
+ <p class="pln"><span class="n"><a id="t903" href="#t903">903</a></span><span class="t"><span class="str"> Verify multiple output pairs.</span>&nbsp;</span><span class="r"></span></p>
988
+ <p class="pln"><span class="n"><a id="t904" href="#t904">904</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
989
+ <p class="pln"><span class="n"><a id="t905" href="#t905">905</a></span><span class="t"><span class="str"> Pure function that processes pairs in sequence.</span>&nbsp;</span><span class="r"></span></p>
990
+ <p class="pln"><span class="n"><a id="t906" href="#t906">906</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
991
+ <p class="pln"><span class="n"><a id="t907" href="#t907">907</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
992
+ <p class="pln"><span class="n"><a id="t908" href="#t908">908</a></span><span class="t"><span class="str"> outputs_a: Sequence of outputs from source A</span>&nbsp;</span><span class="r"></span></p>
993
+ <p class="pln"><span class="n"><a id="t909" href="#t909">909</a></span><span class="t"><span class="str"> outputs_b: Sequence of outputs from source B (same length as outputs_a)</span>&nbsp;</span><span class="r"></span></p>
994
+ <p class="pln"><span class="n"><a id="t910" href="#t910">910</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
995
+ <p class="pln"><span class="n"><a id="t911" href="#t911">911</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
996
+ <p class="pln"><span class="n"><a id="t912" href="#t912">912</a></span><span class="t"><span class="str"> List of VerificationScore for each pair</span>&nbsp;</span><span class="r"></span></p>
997
+ <p class="pln"><span class="n"><a id="t913" href="#t913">913</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
998
+ <p class="mis show_mis"><span class="n"><a id="t914" href="#t914">914</a></span><span class="t"> <span class="key">if</span> <span class="nam">len</span><span class="op">(</span><span class="nam">outputs_a</span><span class="op">)</span> <span class="op">!=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">outputs_b</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
999
+ <p class="mis show_mis"><span class="n"><a id="t915" href="#t915">915</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ValueError</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
1000
+ <p class="mis mis2 show_mis"><span class="n"><a id="t916" href="#t916">916</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Length mismatch: outputs_a has </span><span class="op">{</span><span class="nam">len</span><span class="op">(</span><span class="nam">outputs_a</span><span class="op">)</span><span class="op">}</span><span class="fst"> items, </span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
1001
+ <p class="mis mis2 show_mis"><span class="n"><a id="t917" href="#t917">917</a></span><span class="t"> <span class="fst">f"</span><span class="fst">outputs_b has </span><span class="op">{</span><span class="nam">len</span><span class="op">(</span><span class="nam">outputs_b</span><span class="op">)</span><span class="op">}</span><span class="fst"> items</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
1002
+ <p class="mis mis2 show_mis"><span class="n"><a id="t918" href="#t918">918</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
1003
+ <p class="pln"><span class="n"><a id="t919" href="#t919">919</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1004
+ <p class="mis show_mis"><span class="n"><a id="t920" href="#t920">920</a></span><span class="t"> <span class="key">return</span> <span class="op">[</span><span class="nam">verify</span><span class="op">(</span><span class="nam">a</span><span class="op">,</span> <span class="nam">b</span><span class="op">)</span> <span class="key">for</span> <span class="nam">a</span><span class="op">,</span> <span class="nam">b</span> <span class="key">in</span> <span class="nam">zip</span><span class="op">(</span><span class="nam">outputs_a</span><span class="op">,</span> <span class="nam">outputs_b</span><span class="op">,</span> <span class="nam">strict</span><span class="op">=</span><span class="key">False</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
1005
+ <p class="pln"><span class="n"><a id="t921" href="#t921">921</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1006
+ <p class="pln"><span class="n"><a id="t922" href="#t922">922</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1007
+ <p class="run"><span class="n"><a id="t923" href="#t923">923</a></span><span class="t"><span class="key">def</span> <span class="nam">aggregate_scores</span><span class="op">(</span><span class="nam">scores</span><span class="op">:</span> <span class="nam">Sequence</span><span class="op">[</span><span class="nam">VerificationScore</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
1008
+ <p class="pln"><span class="n"><a id="t924" href="#t924">924</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
1009
+ <p class="pln"><span class="n"><a id="t925" href="#t925">925</a></span><span class="t"><span class="str"> Aggregate multiple verification scores into summary statistics.</span>&nbsp;</span><span class="r"></span></p>
1010
+ <p class="pln"><span class="n"><a id="t926" href="#t926">926</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1011
+ <p class="pln"><span class="n"><a id="t927" href="#t927">927</a></span><span class="t"><span class="str"> Pure function.</span>&nbsp;</span><span class="r"></span></p>
1012
+ <p class="pln"><span class="n"><a id="t928" href="#t928">928</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1013
+ <p class="pln"><span class="n"><a id="t929" href="#t929">929</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
1014
+ <p class="pln"><span class="n"><a id="t930" href="#t930">930</a></span><span class="t"><span class="str"> scores: Sequence of VerificationScore objects</span>&nbsp;</span><span class="r"></span></p>
1015
+ <p class="pln"><span class="n"><a id="t931" href="#t931">931</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1016
+ <p class="pln"><span class="n"><a id="t932" href="#t932">932</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
1017
+ <p class="pln"><span class="n"><a id="t933" href="#t933">933</a></span><span class="t"><span class="str"> Dictionary with aggregate statistics</span>&nbsp;</span><span class="r"></span></p>
1018
+ <p class="pln"><span class="n"><a id="t934" href="#t934">934</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
1019
+ <p class="mis show_mis"><span class="n"><a id="t935" href="#t935">935</a></span><span class="t"> <span class="key">if</span> <span class="key">not</span> <span class="nam">scores</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
1020
+ <p class="mis show_mis"><span class="n"><a id="t936" href="#t936">936</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span><span class="str">"count"</span><span class="op">:</span> <span class="num">0</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
1021
+ <p class="pln"><span class="n"><a id="t937" href="#t937">937</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1022
+ <p class="mis show_mis"><span class="n"><a id="t938" href="#t938">938</a></span><span class="t"> <span class="nam">drift_values</span> <span class="op">=</span> <span class="op">[</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_score</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
1023
+ <p class="mis show_mis"><span class="n"><a id="t939" href="#t939">939</a></span><span class="t"> <span class="nam">confidence_values</span> <span class="op">=</span> <span class="op">[</span><span class="nam">s</span><span class="op">.</span><span class="nam">confidence</span> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
1024
+ <p class="pln"><span class="n"><a id="t940" href="#t940">940</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1025
+ <p class="mis show_mis"><span class="n"><a id="t941" href="#t941">941</a></span><span class="t"> <span class="nam">drift_types</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">int</span><span class="op">]</span> <span class="op">=</span> <span class="op">{</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
1026
+ <p class="mis show_mis"><span class="n"><a id="t942" href="#t942">942</a></span><span class="t"> <span class="key">for</span> <span class="nam">s</span> <span class="key">in</span> <span class="nam">scores</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
1027
+ <p class="mis show_mis"><span class="n"><a id="t943" href="#t943">943</a></span><span class="t"> <span class="nam">drift_types</span><span class="op">[</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_type</span><span class="op">.</span><span class="nam">value</span><span class="op">]</span> <span class="op">=</span> <span class="nam">drift_types</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">s</span><span class="op">.</span><span class="nam">drift_type</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span> <span class="num">0</span><span class="op">)</span> <span class="op">+</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
1028
+ <p class="pln"><span class="n"><a id="t944" href="#t944">944</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
1029
+ <p class="mis show_mis"><span class="n"><a id="t945" href="#t945">945</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
1030
+ <p class="mis mis2 show_mis"><span class="n"><a id="t946" href="#t946">946</a></span><span class="t"> <span class="str">"count"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">scores</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1031
+ <p class="mis mis2 show_mis"><span class="n"><a id="t947" href="#t947">947</a></span><span class="t"> <span class="str">"mean_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1032
+ <p class="mis mis2 show_mis"><span class="n"><a id="t948" href="#t948">948</a></span><span class="t"> <span class="str">"std_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">std</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1033
+ <p class="mis mis2 show_mis"><span class="n"><a id="t949" href="#t949">949</a></span><span class="t"> <span class="str">"min_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">min</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1034
+ <p class="mis mis2 show_mis"><span class="n"><a id="t950" href="#t950">950</a></span><span class="t"> <span class="str">"max_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">max</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1035
+ <p class="mis mis2 show_mis"><span class="n"><a id="t951" href="#t951">951</a></span><span class="t"> <span class="str">"median_drift"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">median</span><span class="op">(</span><span class="nam">drift_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1036
+ <p class="mis mis2 show_mis"><span class="n"><a id="t952" href="#t952">952</a></span><span class="t"> <span class="str">"mean_confidence"</span><span class="op">:</span> <span class="nam">float</span><span class="op">(</span><span class="nam">np</span><span class="op">.</span><span class="nam">mean</span><span class="op">(</span><span class="nam">confidence_values</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1037
+ <p class="mis mis2 show_mis"><span class="n"><a id="t953" href="#t953">953</a></span><span class="t"> <span class="str">"drift_type_distribution"</span><span class="op">:</span> <span class="nam">drift_types</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
1038
+ <p class="mis mis2 show_mis"><span class="n"><a id="t954" href="#t954">954</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
1039
+ </main>
1040
+ <footer>
1041
+ <div class="content">
1042
+ <p>
1043
+ <a class="nav" href="z_2c49bd2ed3e01e38_types_py.html">&#xab; prev</a> &nbsp; &nbsp;
1044
+ <a class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
1045
+ <a class="nav" href="index.html">&#xbb; next</a>
1046
+ &nbsp; &nbsp; &nbsp;
1047
+ <a class="nav" href="https://coverage.readthedocs.io/en/7.13.1">coverage.py v7.13.1</a>,
1048
+ created at 2026-02-02 21:04 -0800
1049
+ </p>
1050
+ </div>
1051
+ </footer>
1052
+ </body>
1053
+ </html>