xithead 1.5.0 → 1.5.2
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.
- package/bin/xithead.js +486 -226
- package/{npm/index.js → index.js} +2 -2
- package/package.json +46 -46
- package/.actrc +0 -14
- package/.actrc.local.example +0 -15
- package/.changelog.md +0 -2
- package/.claude/agents/academic-anthropologist.md +0 -125
- package/.claude/agents/academic-geographer.md +0 -127
- package/.claude/agents/academic-historian.md +0 -123
- package/.claude/agents/academic-narratologist.md +0 -118
- package/.claude/agents/academic-psychologist.md +0 -118
- package/.claude/agents/academic-statistician.md +0 -144
- package/.claude/agents/accounts-payable-agent.md +0 -205
- package/.claude/agents/agentic-identity-trust.md +0 -394
- package/.claude/agents/agents-orchestrator.md +0 -367
- package/.claude/agents/automation-governance-architect.md +0 -216
- package/.claude/agents/blender-addon-engineer.md +0 -243
- package/.claude/agents/business-strategist.md +0 -488
- package/.claude/agents/change-management-consultant.md +0 -497
- package/.claude/agents/chief-financial-officer.md +0 -388
- package/.claude/agents/corporate-training-designer.md +0 -192
- package/.claude/agents/customer-service.md +0 -398
- package/.claude/agents/customer-success-manager.md +0 -460
- package/.claude/agents/data-consolidation-agent.md +0 -60
- package/.claude/agents/data-privacy-officer.md +0 -412
- package/.claude/agents/design-brand-guardian.md +0 -322
- package/.claude/agents/design-image-prompt-engineer.md +0 -236
- package/.claude/agents/design-inclusive-visuals-specialist.md +0 -73
- package/.claude/agents/design-persona-walkthrough.md +0 -272
- package/.claude/agents/design-ui-designer.md +0 -386
- package/.claude/agents/design-ui-finish-gate-reviewer.md +0 -217
- package/.claude/agents/design-ux-architect.md +0 -482
- package/.claude/agents/design-ux-researcher.md +0 -329
- package/.claude/agents/design-visual-storyteller.md +0 -149
- package/.claude/agents/design-whimsy-injector.md +0 -460
- package/.claude/agents/economy-designer.md +0 -156
- package/.claude/agents/engineering-ai-data-remediation-engineer.md +0 -211
- package/.claude/agents/engineering-ai-engineer.md +0 -146
- package/.claude/agents/engineering-api-platform-engineer.md +0 -181
- package/.claude/agents/engineering-ats-validator-architect.md +0 -383
- package/.claude/agents/engineering-autonomous-optimization-architect.md +0 -121
- package/.claude/agents/engineering-backend-architect.md +0 -255
- package/.claude/agents/engineering-china-network-engineer.md +0 -252
- package/.claude/agents/engineering-cms-developer.md +0 -536
- package/.claude/agents/engineering-code-reviewer.md +0 -76
- package/.claude/agents/engineering-codebase-onboarding-engineer.md +0 -173
- package/.claude/agents/engineering-data-engineer.md +0 -349
- package/.claude/agents/engineering-data-visualization-engineer.md +0 -151
- package/.claude/agents/engineering-database-optimizer.md +0 -188
- package/.claude/agents/engineering-database-reliability-engineer.md +0 -201
- package/.claude/agents/engineering-desktop-app-engineer.md +0 -209
- package/.claude/agents/engineering-developer-tooling-engineer.md +0 -153
- package/.claude/agents/engineering-devops-automator.md +0 -385
- package/.claude/agents/engineering-drupal-performance.md +0 -347
- package/.claude/agents/engineering-drupal-shopping-cart.md +0 -360
- package/.claude/agents/engineering-electrical-engineer.md +0 -575
- package/.claude/agents/engineering-email-intelligence-engineer.md +0 -390
- package/.claude/agents/engineering-embedded-firmware-engineer.md +0 -196
- package/.claude/agents/engineering-feishu-integration-developer.md +0 -606
- package/.claude/agents/engineering-filament-optimization-specialist.md +0 -283
- package/.claude/agents/engineering-finops-engineer.md +0 -164
- package/.claude/agents/engineering-frontend-developer.md +0 -257
- package/.claude/agents/engineering-gaussdb-expert.md +0 -334
- package/.claude/agents/engineering-git-workflow-master.md +0 -98
- package/.claude/agents/engineering-i18n-engineer.md +0 -214
- package/.claude/agents/engineering-identity-access-engineer.md +0 -217
- package/.claude/agents/engineering-incident-response-commander.md +0 -444
- package/.claude/agents/engineering-iot-fleet-engineer.md +0 -148
- package/.claude/agents/engineering-it-service-manager.md +0 -561
- package/.claude/agents/engineering-knowledge-graph-engineer.md +0 -372
- package/.claude/agents/engineering-llm-post-training-engineer.md +0 -166
- package/.claude/agents/engineering-minimal-change-engineer.md +0 -207
- package/.claude/agents/engineering-mobile-app-builder.md +0 -493
- package/.claude/agents/engineering-mobile-release-engineer.md +0 -164
- package/.claude/agents/engineering-multi-agent-systems-architect.md +0 -600
- package/.claude/agents/engineering-network-engineer.md +0 -245
- package/.claude/agents/engineering-orgscript-engineer.md +0 -113
- package/.claude/agents/engineering-payments-billing-engineer.md +0 -228
- package/.claude/agents/engineering-pdf-engine-architect.md +0 -696
- package/.claude/agents/engineering-platform-engineer.md +0 -270
- package/.claude/agents/engineering-privacy-engineer.md +0 -152
- package/.claude/agents/engineering-prompt-engineer.md +0 -209
- package/.claude/agents/engineering-rag-pipeline-engineer.md +0 -450
- package/.claude/agents/engineering-rapid-prototyper.md +0 -466
- package/.claude/agents/engineering-realtime-collaboration-engineer.md +0 -200
- package/.claude/agents/engineering-rust-refactoring-specialist.md +0 -313
- package/.claude/agents/engineering-search-relevance-engineer.md +0 -237
- package/.claude/agents/engineering-section-508-specialist.md +0 -339
- package/.claude/agents/engineering-senior-developer.md +0 -176
- package/.claude/agents/engineering-servicenow-developer-mentor.md +0 -180
- package/.claude/agents/engineering-software-architect.md +0 -112
- package/.claude/agents/engineering-solidity-smart-contract-engineer.md +0 -522
- package/.claude/agents/engineering-sre.md +0 -90
- package/.claude/agents/engineering-technical-writer.md +0 -393
- package/.claude/agents/engineering-universal-document-compiler.md +0 -370
- package/.claude/agents/engineering-uswds-developer.md +0 -340
- package/.claude/agents/engineering-video-streaming-engineer.md +0 -151
- package/.claude/agents/engineering-voice-ai-integration-engineer.md +0 -584
- package/.claude/agents/engineering-webassembly-engineer.md +0 -153
- package/.claude/agents/engineering-wechat-mini-program-developer.md +0 -356
- package/.claude/agents/engineering-wordpress-performance.md +0 -346
- package/.claude/agents/engineering-wordpress-shopping-cart.md +0 -346
- package/.claude/agents/esg-sustainability-officer.md +0 -396
- package/.claude/agents/finance-bookkeeper-controller.md +0 -260
- package/.claude/agents/finance-financial-analyst.md +0 -234
- package/.claude/agents/finance-fpa-analyst.md +0 -263
- package/.claude/agents/finance-investment-researcher.md +0 -272
- package/.claude/agents/finance-tax-strategist.md +0 -239
- package/.claude/agents/game-audio-engineer.md +0 -264
- package/.claude/agents/game-designer.md +0 -167
- package/.claude/agents/gis-3d-scene-developer.md +0 -111
- package/.claude/agents/gis-analyst.md +0 -91
- package/.claude/agents/gis-bim-specialist.md +0 -108
- package/.claude/agents/gis-cartography-designer.md +0 -150
- package/.claude/agents/gis-drone-reality-mapping.md +0 -120
- package/.claude/agents/gis-geoai-ml-engineer.md +0 -105
- package/.claude/agents/gis-geoprocessing-specialist.md +0 -97
- package/.claude/agents/gis-qa-engineer.md +0 -133
- package/.claude/agents/gis-solution-engineer.md +0 -101
- package/.claude/agents/gis-spatial-data-engineer.md +0 -97
- package/.claude/agents/gis-spatial-data-scientist.md +0 -111
- package/.claude/agents/gis-technical-consultant.md +0 -86
- package/.claude/agents/gis-web-gis-developer.md +0 -108
- package/.claude/agents/godot-gameplay-scripter.md +0 -338
- package/.claude/agents/godot-multiplayer-engineer.md +0 -301
- package/.claude/agents/godot-shader-developer.md +0 -267
- package/.claude/agents/government-digital-presales-consultant.md +0 -363
- package/.claude/agents/grant-writer.md +0 -511
- package/.claude/agents/healthcare-aging-parent-care-companion.md +0 -414
- package/.claude/agents/healthcare-clinical-evidence-agent.md +0 -231
- package/.claude/agents/healthcare-customer-service.md +0 -389
- package/.claude/agents/healthcare-innovation-strategist.md +0 -433
- package/.claude/agents/healthcare-marketing-compliance.md +0 -395
- package/.claude/agents/healthcare-sovereign-health-systems-agent.md +0 -312
- package/.claude/agents/hospitality-guest-services.md +0 -603
- package/.claude/agents/hr-onboarding.md +0 -451
- package/.claude/agents/identity-graph-operator.md +0 -303
- package/.claude/agents/language-translator.md +0 -264
- package/.claude/agents/legal-billing-time-tracking.md +0 -569
- package/.claude/agents/legal-client-intake.md +0 -492
- package/.claude/agents/legal-document-review.md +0 -454
- package/.claude/agents/level-designer.md +0 -208
- package/.claude/agents/loan-officer-assistant.md +0 -555
- package/.claude/agents/lsp-index-engineer.md +0 -320
- package/.claude/agents/ma-integration-manager.md +0 -427
- package/.claude/agents/macos-spatial-metal-engineer.md +0 -337
- package/.claude/agents/marketing-aeo-foundations.md +0 -264
- package/.claude/agents/marketing-agentic-search-optimizer.md +0 -279
- package/.claude/agents/marketing-ai-citation-strategist.md +0 -172
- package/.claude/agents/marketing-app-store-optimizer.md +0 -321
- package/.claude/agents/marketing-baidu-seo-specialist.md +0 -226
- package/.claude/agents/marketing-bilibili-content-strategist.md +0 -199
- package/.claude/agents/marketing-book-co-author.md +0 -110
- package/.claude/agents/marketing-carousel-growth-engine.md +0 -204
- package/.claude/agents/marketing-china-ecommerce-operator.md +0 -283
- package/.claude/agents/marketing-china-market-localization-strategist.md +0 -283
- package/.claude/agents/marketing-content-creator.md +0 -54
- package/.claude/agents/marketing-cross-border-ecommerce.md +0 -259
- package/.claude/agents/marketing-developer-community-builder.md +0 -285
- package/.claude/agents/marketing-douyin-strategist.md +0 -149
- package/.claude/agents/marketing-email-strategist.md +0 -249
- package/.claude/agents/marketing-global-podcast-strategist.md +0 -206
- package/.claude/agents/marketing-growth-hacker.md +0 -54
- package/.claude/agents/marketing-instagram-curator.md +0 -113
- package/.claude/agents/marketing-kuaishou-strategist.md +0 -223
- package/.claude/agents/marketing-linkedin-content-creator.md +0 -214
- package/.claude/agents/marketing-livestream-commerce-coach.md +0 -305
- package/.claude/agents/marketing-multi-platform-publisher.md +0 -217
- package/.claude/agents/marketing-podcast-strategist.md +0 -277
- package/.claude/agents/marketing-pr-communications-manager.md +0 -473
- package/.claude/agents/marketing-private-domain-operator.md +0 -308
- package/.claude/agents/marketing-reddit-community-builder.md +0 -123
- package/.claude/agents/marketing-seo-specialist.md +0 -370
- package/.claude/agents/marketing-short-video-editing-coach.md +0 -412
- package/.claude/agents/marketing-social-media-strategist.md +0 -125
- package/.claude/agents/marketing-tiktok-strategist.md +0 -125
- package/.claude/agents/marketing-twitter-engager.md +0 -126
- package/.claude/agents/marketing-video-optimization-specialist.md +0 -119
- package/.claude/agents/marketing-wechat-official-account.md +0 -145
- package/.claude/agents/marketing-weibo-strategist.md +0 -240
- package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +0 -161
- package/.claude/agents/marketing-xiaohongshu-specialist.md +0 -138
- package/.claude/agents/marketing-zhihu-strategist.md +0 -162
- package/.claude/agents/medical-billing-coding-specialist.md +0 -491
- package/.claude/agents/narrative-designer.md +0 -243
- package/.claude/agents/operations-manager.md +0 -399
- package/.claude/agents/organizational-psychologist.md +0 -391
- package/.claude/agents/paid-media-auditor.md +0 -71
- package/.claude/agents/paid-media-creative-strategist.md +0 -71
- package/.claude/agents/paid-media-paid-social-strategist.md +0 -71
- package/.claude/agents/paid-media-ppc-strategist.md +0 -71
- package/.claude/agents/paid-media-programmatic-buyer.md +0 -71
- package/.claude/agents/paid-media-search-query-analyst.md +0 -71
- package/.claude/agents/paid-media-tracking-specialist.md +0 -71
- package/.claude/agents/personal-growth-mentor.md +0 -159
- package/.claude/agents/product-behavioral-nudge-engine.md +0 -83
- package/.claude/agents/product-dx-engineer.md +0 -332
- package/.claude/agents/product-feedback-synthesizer.md +0 -119
- package/.claude/agents/product-manager.md +0 -469
- package/.claude/agents/product-sprint-prioritizer.md +0 -154
- package/.claude/agents/product-trend-researcher.md +0 -159
- package/.claude/agents/project-management-experiment-tracker.md +0 -198
- package/.claude/agents/project-management-jira-workflow-steward.md +0 -233
- package/.claude/agents/project-management-meeting-notes-specialist.md +0 -95
- package/.claude/agents/project-management-project-shepherd.md +0 -194
- package/.claude/agents/project-management-studio-operations.md +0 -200
- package/.claude/agents/project-management-studio-producer.md +0 -203
- package/.claude/agents/project-manager-senior.md +0 -135
- package/.claude/agents/real-estate-buyer-seller.md +0 -596
- package/.claude/agents/recruitment-specialist.md +0 -515
- package/.claude/agents/report-distribution-agent.md +0 -65
- package/.claude/agents/research-synthesist.md +0 -136
- package/.claude/agents/resume-tailor.md +0 -230
- package/.claude/agents/retail-customer-returns.md +0 -566
- package/.claude/agents/roblox-avatar-creator.md +0 -297
- package/.claude/agents/roblox-experience-designer.md +0 -306
- package/.claude/agents/roblox-systems-scripter.md +0 -332
- package/.claude/agents/sales-account-strategist.md +0 -227
- package/.claude/agents/sales-coach.md +0 -271
- package/.claude/agents/sales-data-extraction-agent.md +0 -67
- package/.claude/agents/sales-deal-strategist.md +0 -180
- package/.claude/agents/sales-discovery-coach.md +0 -225
- package/.claude/agents/sales-engineer.md +0 -182
- package/.claude/agents/sales-offer-lead-gen-strategist.md +0 -257
- package/.claude/agents/sales-outbound-strategist.md +0 -201
- package/.claude/agents/sales-outreach.md +0 -425
- package/.claude/agents/sales-pipeline-analyst.md +0 -267
- package/.claude/agents/sales-proposal-strategist.md +0 -217
- package/.claude/agents/security-ai-generated-code-auditor.md +0 -207
- package/.claude/agents/security-appsec-engineer.md +0 -536
- package/.claude/agents/security-architect.md +0 -307
- package/.claude/agents/security-blockchain-security-auditor.md +0 -482
- package/.claude/agents/security-cloud-security-architect.md +0 -576
- package/.claude/agents/security-compliance-auditor.md +0 -158
- package/.claude/agents/security-incident-responder.md +0 -450
- package/.claude/agents/security-penetration-tester.md +0 -399
- package/.claude/agents/security-secrets-credential-engineer.md +0 -189
- package/.claude/agents/security-senior-secops.md +0 -760
- package/.claude/agents/security-threat-detection-engineer.md +0 -553
- package/.claude/agents/security-threat-intelligence-analyst.md +0 -661
- package/.claude/agents/specialized-chief-of-staff.md +0 -279
- package/.claude/agents/specialized-civil-engineer.md +0 -356
- package/.claude/agents/specialized-codebase-archaeologist.md +0 -341
- package/.claude/agents/specialized-cultural-intelligence-strategist.md +0 -88
- package/.claude/agents/specialized-developer-advocate.md +0 -317
- package/.claude/agents/specialized-document-generator.md +0 -55
- package/.claude/agents/specialized-fedramp-rmf-compliance.md +0 -378
- package/.claude/agents/specialized-focus-music-architect.md +0 -175
- package/.claude/agents/specialized-french-consulting-market.md +0 -194
- package/.claude/agents/specialized-korean-business-navigator.md +0 -216
- package/.claude/agents/specialized-master-plan-architect.md +0 -157
- package/.claude/agents/specialized-mcp-builder.md +0 -260
- package/.claude/agents/specialized-model-qa.md +0 -528
- package/.claude/agents/specialized-pricing-analyst.md +0 -243
- package/.claude/agents/specialized-salesforce-architect.md +0 -182
- package/.claude/agents/specialized-strategy-duel-agent.md +0 -130
- package/.claude/agents/specialized-workflow-architect.md +0 -597
- package/.claude/agents/study-abroad-advisor.md +0 -282
- package/.claude/agents/supply-chain-strategist.md +0 -591
- package/.claude/agents/support-analytics-reporter.md +0 -387
- package/.claude/agents/support-executive-summary-generator.md +0 -212
- package/.claude/agents/support-finance-tracker.md +0 -480
- package/.claude/agents/support-infrastructure-maintainer.md +0 -628
- package/.claude/agents/support-legal-compliance-checker.md +0 -591
- package/.claude/agents/support-support-responder.md +0 -607
- package/.claude/agents/technical-artist.md +0 -233
- package/.claude/agents/terminal-integration-specialist.md +0 -70
- package/.claude/agents/testing-accessibility-auditor.md +0 -327
- package/.claude/agents/testing-api-tester.md +0 -334
- package/.claude/agents/testing-evidence-collector.md +0 -210
- package/.claude/agents/testing-performance-benchmarker.md +0 -283
- package/.claude/agents/testing-reality-checker.md +0 -249
- package/.claude/agents/testing-test-automation-engineer.md +0 -196
- package/.claude/agents/testing-test-results-analyzer.md +0 -330
- package/.claude/agents/testing-tool-evaluator.md +0 -416
- package/.claude/agents/testing-workflow-optimizer.md +0 -463
- package/.claude/agents/unity-architect.md +0 -271
- package/.claude/agents/unity-editor-tool-developer.md +0 -310
- package/.claude/agents/unity-multiplayer-engineer.md +0 -323
- package/.claude/agents/unity-shader-graph-artist.md +0 -269
- package/.claude/agents/unreal-multiplayer-architect.md +0 -364
- package/.claude/agents/unreal-systems-engineer.md +0 -322
- package/.claude/agents/unreal-technical-artist.md +0 -256
- package/.claude/agents/unreal-world-builder.md +0 -273
- package/.claude/agents/visionos-spatial-engineer.md +0 -54
- package/.claude/agents/xr-cockpit-interaction-specialist.md +0 -32
- package/.claude/agents/xr-immersive-developer.md +0 -32
- package/.claude/agents/xr-interface-architect.md +0 -32
- package/.claude/agents/zk-steward.md +0 -211
- package/.claude-plugin/marketplace.json +0 -30
- package/.commitlintrc.json +0 -26
- package/.devcontainer/Dockerfile +0 -24
- package/.devcontainer/devcontainer.json +0 -70
- package/.devcontainer/docker-compose.memory.yml +0 -42
- package/.devcontainer/memory-stack/devcontainer.json +0 -84
- package/.devcontainer/post-create.sh +0 -83
- package/.dockerignore +0 -23
- package/.env.act.example +0 -15
- package/.env.example +0 -171
- package/.eslintrc.json +0 -16
- package/.git-blame-ignore-revs +0 -10
- package/.gitattributes +0 -2
- package/.gitguardian.yaml +0 -50
- package/.githooks/pre-commit +0 -6
- package/.pre-commit-config.yaml +0 -30
- package/.release-please-config-xithead.json +0 -22
- package/.release-please-config.json +0 -44
- package/.release-please-manifest-xithead.json +0 -3
- package/.release-please-manifest.json +0 -3
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -133
- package/Cargo.lock +0 -5557
- package/Cargo.toml +0 -121
- package/Dockerfile +0 -38
- package/Dockerfile.proxy +0 -48
- package/ENTERPRISE.md +0 -5
- package/FEATURES_ADVANCED.md +0 -311
- package/Headroom-2.gif +0 -0
- package/HeadroomDemo-Fast.gif +0 -0
- package/LICENSE +0 -190
- package/MANIFEST.in +0 -4
- package/MODERNIZATION_GUIDE.md +0 -358
- package/Makefile +0 -140
- package/NOTICE +0 -43
- package/NPM_TOKEN_SETUP.md +0 -81
- package/PR.md +0 -170
- package/PUBLISH.md +0 -77
- package/README.md +0 -108
- package/README_FRONTEND.md +0 -196
- package/REALIGNMENT/00-overview.md +0 -53
- package/REALIGNMENT/01-bug-list.md +0 -421
- package/REALIGNMENT/02-architecture.md +0 -322
- package/REALIGNMENT/03-phase-A-lockdown.md +0 -420
- package/REALIGNMENT/04-phase-B-live-zone.md +0 -470
- package/REALIGNMENT/05-phase-C-rust-proxy.md +0 -329
- package/REALIGNMENT/06-phase-D-bedrock-vertex.md +0 -222
- package/REALIGNMENT/07-phase-E-cache-stabilization.md +0 -338
- package/REALIGNMENT/08-phase-F-auth-mode.md +0 -254
- package/REALIGNMENT/09-phase-G-rtk-observability.md +0 -194
- package/REALIGNMENT/10-phase-H-python-retirement.md +0 -214
- package/REALIGNMENT/11-phase-I-test-infra.md +0 -385
- package/REALIGNMENT/12-decisions-needed.md +0 -196
- package/REALIGNMENT/INDEX.md +0 -82
- package/REFACTORING_CAMPAIGN.md +0 -277
- package/RESTRUCTURE_PLAN.md +0 -100
- package/RUST_DEV.md +0 -361
- package/SECURITY.md +0 -65
- package/SETUP_AUTO_PUBLISH.md +0 -164
- package/TESTING-copilot-subscription.md +0 -153
- package/app/api/config/route.ts +0 -22
- package/app/api/export/route.ts +0 -83
- package/app/api/models/route.ts +0 -12
- package/app/api/stats/route.ts +0 -46
- package/app/dashboard/page.tsx +0 -445
- package/app/globals.css +0 -35
- package/app/installation/page.tsx +0 -293
- package/app/layout.tsx +0 -35
- package/app/master-design-system.css +0 -2076
- package/app/master-design-system.source.css +0 -8
- package/app/page.tsx +0 -187
- package/app/rechtliches/agb/page.tsx +0 -165
- package/app/rechtliches/datenschutz/page.tsx +0 -128
- package/app/rechtliches/impressum/page.tsx +0 -122
- package/app/rechtliches/widerruf/page.tsx +0 -185
- package/codecov.yml +0 -34
- package/components/layout/AppShell.tsx +0 -25
- package/components/layout/Footer.tsx +0 -120
- package/components/layout/Header.tsx +0 -145
- package/components/marketing/LegalHighlights.tsx +0 -45
- package/components/marketing/LegalPageShell.tsx +0 -49
- package/components/marketing/LegalPanel.tsx +0 -41
- package/components/marketing/index.ts +0 -3
- package/crates/headroom-core/Cargo.toml +0 -165
- package/crates/headroom-core/benches/auth_mode.rs +0 -74
- package/crates/headroom-core/benches/ccr_store.rs +0 -224
- package/crates/headroom-core/benches/tokenizer.rs +0 -52
- package/crates/headroom-core/config/pipeline.toml +0 -151
- package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +0 -9
- package/crates/headroom-core/src/auth_mode.rs +0 -250
- package/crates/headroom-core/src/cache_control.rs +0 -414
- package/crates/headroom-core/src/ccr/backends/in_memory.rs +0 -317
- package/crates/headroom-core/src/ccr/backends/mod.rs +0 -152
- package/crates/headroom-core/src/ccr/backends/redis.rs +0 -146
- package/crates/headroom-core/src/ccr/backends/sqlite.rs +0 -205
- package/crates/headroom-core/src/ccr/mod.rs +0 -119
- package/crates/headroom-core/src/compression_policy.rs +0 -505
- package/crates/headroom-core/src/lib.rs +0 -33
- package/crates/headroom-core/src/relevance/base.rs +0 -139
- package/crates/headroom-core/src/relevance/bm25.rs +0 -385
- package/crates/headroom-core/src/relevance/embedding.rs +0 -354
- package/crates/headroom-core/src/relevance/hybrid.rs +0 -364
- package/crates/headroom-core/src/relevance/mod.rs +0 -64
- package/crates/headroom-core/src/signals/keyword_detector.rs +0 -433
- package/crates/headroom-core/src/signals/line_importance.rs +0 -84
- package/crates/headroom-core/src/signals/mod.rs +0 -61
- package/crates/headroom-core/src/signals/tiered.rs +0 -141
- package/crates/headroom-core/src/tokenizer/estimator.rs +0 -152
- package/crates/headroom-core/src/tokenizer/hf_impl.rs +0 -314
- package/crates/headroom-core/src/tokenizer/mod.rs +0 -56
- package/crates/headroom-core/src/tokenizer/registry.rs +0 -342
- package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +0 -265
- package/crates/headroom-core/src/transforms/adaptive_sizer.rs +0 -610
- package/crates/headroom-core/src/transforms/anchor_selector.rs +0 -1189
- package/crates/headroom-core/src/transforms/content_detector.rs +0 -769
- package/crates/headroom-core/src/transforms/detection.rs +0 -222
- package/crates/headroom-core/src/transforms/diff_compressor.rs +0 -1685
- package/crates/headroom-core/src/transforms/live_zone.rs +0 -2967
- package/crates/headroom-core/src/transforms/log_compressor.rs +0 -1295
- package/crates/headroom-core/src/transforms/magika_detector.rs +0 -395
- package/crates/headroom-core/src/transforms/mod.rs +0 -64
- package/crates/headroom-core/src/transforms/pipeline/config.rs +0 -331
- package/crates/headroom-core/src/transforms/pipeline/mod.rs +0 -103
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +0 -524
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +0 -279
- package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +0 -400
- package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +0 -284
- package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +0 -34
- package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +0 -331
- package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +0 -848
- package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +0 -175
- package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +0 -545
- package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +0 -12
- package/crates/headroom-core/src/transforms/pipeline/traits.rs +0 -338
- package/crates/headroom-core/src/transforms/recommendations.rs +0 -329
- package/crates/headroom-core/src/transforms/safety.rs +0 -215
- package/crates/headroom-core/src/transforms/search_compressor.rs +0 -902
- package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +0 -1262
- package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +0 -407
- package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +0 -263
- package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +0 -214
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +0 -283
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +0 -733
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +0 -961
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +0 -252
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +0 -127
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +0 -397
- package/crates/headroom-core/src/transforms/smart_crusher/config.rs +0 -173
- package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +0 -159
- package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +0 -1665
- package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +0 -865
- package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +0 -77
- package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +0 -393
- package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +0 -72
- package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +0 -81
- package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +0 -66
- package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +0 -459
- package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +0 -507
- package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +0 -904
- package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +0 -510
- package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +0 -287
- package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +0 -203
- package/crates/headroom-core/src/transforms/smart_crusher/types.rs +0 -263
- package/crates/headroom-core/src/transforms/tag_protector.rs +0 -1272
- package/crates/headroom-core/src/transforms/unidiff_detector.rs +0 -232
- package/crates/headroom-parity/Cargo.toml +0 -26
- package/crates/headroom-parity/examples/diff_fixture.rs +0 -66
- package/crates/headroom-parity/src/bin/parity_run.rs +0 -78
- package/crates/headroom-parity/src/lib.rs +0 -613
- package/crates/headroom-proxy/Cargo.toml +0 -119
- package/crates/headroom-proxy/data/model_prices_and_context_window.json +0 -39767
- package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +0 -192
- package/crates/headroom-proxy/src/bedrock/envelope.rs +0 -239
- package/crates/headroom-proxy/src/bedrock/eventstream.rs +0 -769
- package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +0 -459
- package/crates/headroom-proxy/src/bedrock/invoke.rs +0 -735
- package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +0 -1098
- package/crates/headroom-proxy/src/bedrock/mod.rs +0 -66
- package/crates/headroom-proxy/src/bedrock/sigv4.rs +0 -324
- package/crates/headroom-proxy/src/bedrock/vendor.rs +0 -82
- package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +0 -698
- package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +0 -683
- package/crates/headroom-proxy/src/cache_stabilization/mod.rs +0 -61
- package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +0 -600
- package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +0 -514
- package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +0 -720
- package/crates/headroom-proxy/src/compression/anthropic.rs +0 -92
- package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +0 -1311
- package/crates/headroom-proxy/src/compression/live_zone_openai.rs +0 -660
- package/crates/headroom-proxy/src/compression/live_zone_responses.rs +0 -678
- package/crates/headroom-proxy/src/compression/mod.rs +0 -127
- package/crates/headroom-proxy/src/compression/model_limits.rs +0 -211
- package/crates/headroom-proxy/src/config.rs +0 -646
- package/crates/headroom-proxy/src/error.rs +0 -69
- package/crates/headroom-proxy/src/handlers/chat_completions.rs +0 -100
- package/crates/headroom-proxy/src/handlers/conversations.rs +0 -241
- package/crates/headroom-proxy/src/handlers/mod.rs +0 -13
- package/crates/headroom-proxy/src/handlers/responses.rs +0 -256
- package/crates/headroom-proxy/src/headers.rs +0 -288
- package/crates/headroom-proxy/src/health.rs +0 -41
- package/crates/headroom-proxy/src/lib.rs +0 -21
- package/crates/headroom-proxy/src/main.rs +0 -141
- package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +0 -340
- package/crates/headroom-proxy/src/observability/compression_ratio.rs +0 -158
- package/crates/headroom-proxy/src/observability/metric_names.rs +0 -174
- package/crates/headroom-proxy/src/observability/mod.rs +0 -68
- package/crates/headroom-proxy/src/observability/prometheus.rs +0 -394
- package/crates/headroom-proxy/src/observability/proxy_metrics.rs +0 -368
- package/crates/headroom-proxy/src/proxy.rs +0 -1619
- package/crates/headroom-proxy/src/responses_items.rs +0 -565
- package/crates/headroom-proxy/src/sse/anthropic.rs +0 -415
- package/crates/headroom-proxy/src/sse/framing.rs +0 -366
- package/crates/headroom-proxy/src/sse/mod.rs +0 -40
- package/crates/headroom-proxy/src/sse/openai_chat.rs +0 -231
- package/crates/headroom-proxy/src/sse/openai_responses.rs +0 -458
- package/crates/headroom-proxy/src/vertex/adc.rs +0 -315
- package/crates/headroom-proxy/src/vertex/envelope.rs +0 -167
- package/crates/headroom-proxy/src/vertex/mod.rs +0 -277
- package/crates/headroom-proxy/src/vertex/raw_predict.rs +0 -490
- package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +0 -49
- package/crates/headroom-proxy/src/websocket.rs +0 -246
- package/crates/headroom-py/Cargo.toml +0 -37
- package/crates/headroom-py/build.rs +0 -77
- package/crates/headroom-py/glibc_compat.c +0 -170
- package/crates/headroom-py/src/lib.rs +0 -1655
- package/deny.toml +0 -32
- package/design-system/base.css +0 -127
- package/design-system/components.css +0 -1943
- package/design-system/fonts.css +0 -17
- package/design-system/tailwind-preset.js +0 -95
- package/design-system/tokens.css +0 -48
- package/design-system/utilities.css +0 -53
- package/docker/differential-network-capture/Dockerfile.runner +0 -14
- package/docker/differential-network-capture/docker-compose.yml +0 -142
- package/docker/differential-network-capture/run-claude-lane.sh +0 -24
- package/docker/docker-compose.native.yml +0 -44
- package/docker-bake.hcl +0 -88
- package/docker-compose.yml +0 -80
- package/e2e/_lib/make_shim.ps1 +0 -24
- package/e2e/_lib/make_shim.sh +0 -28
- package/e2e/docker-native-install.sh +0 -120
- package/e2e/init/Dockerfile +0 -79
- package/e2e/wrap/Dockerfile +0 -115
- package/examples/07-context-compression.ipynb +0 -279
- package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +0 -65
- package/examples/deployment/macos-launchagent/install.sh +0 -227
- package/examples/deployment/macos-launchagent/shell-integration.sh +0 -74
- package/examples/deployment/macos-launchagent/uninstall.sh +0 -145
- package/headroom-savings.png +0 -0
- package/headroom_learn.gif +0 -0
- package/lib/config/index.ts +0 -12
- package/lib/hooks/index.ts +0 -4
- package/lib/hooks/use-mounted.ts +0 -13
- package/lib/hooks/use-session.ts +0 -34
- package/lib/hooks/use-settings.ts +0 -49
- package/lib/utils/index.ts +0 -1
- package/lib/utils/settings.ts +0 -162
- package/lib/utils/utils.ts +0 -6
- package/llms.txt +0 -67
- package/middleware.ts +0 -26
- package/mkdocs.yml +0 -136
- package/next-env.d.ts +0 -7
- package/next.config.ts +0 -12
- package/npm/bin/xithead.js +0 -366
- package/npm/bin/xtream-head.js +0 -366
- package/npm/package.json +0 -55
- package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +0 -17
- package/plugins/headroom-agent-hooks/hooks/hooks.json +0 -29
- package/plugins/headroom-oauth2/LICENSE +0 -3
- package/plugins/headroom-oauth2/SPEC.md +0 -115
- package/plugins/headroom-oauth2/pyproject.toml +0 -48
- package/plugins/hermes/headroom_retrieve/plugin.yaml +0 -6
- package/plugins/openclaw/hook-shim/HOOK.md +0 -21
- package/plugins/openclaw/hook-shim/handler.js +0 -3
- package/plugins/openclaw/openclaw.plugin.json +0 -98
- package/plugins/openclaw/package-lock.json +0 -2692
- package/plugins/openclaw/package.json +0 -54
- package/plugins/openclaw/prepare-dist.mjs +0 -56
- package/plugins/openclaw/src/convert.ts +0 -418
- package/plugins/openclaw/src/engine.ts +0 -284
- package/plugins/openclaw/src/gateway-config.ts +0 -143
- package/plugins/openclaw/src/index.ts +0 -11
- package/plugins/openclaw/src/plugin/index.ts +0 -98
- package/plugins/openclaw/src/proxy-manager.ts +0 -477
- package/plugins/openclaw/src/tools/headroom-retrieve.ts +0 -76
- package/plugins/openclaw/test/convert.test.ts +0 -96
- package/plugins/openclaw/test/engine-normalization.test.ts +0 -21
- package/plugins/openclaw/test/engine.test.ts +0 -101
- package/plugins/openclaw/test/gateway-config.test.ts +0 -278
- package/plugins/openclaw/test/plugin-runtime-routing.test.ts +0 -141
- package/plugins/openclaw/test/proxy-manager.test.ts +0 -343
- package/plugins/openclaw/tsup.config.ts +0 -9
- package/postcss.config.mjs +0 -7
- package/pyproject.toml +0 -438
- package/rust-toolchain.toml +0 -16
- package/sdk/typescript/examples/basic-compress.ts +0 -64
- package/sdk/typescript/examples/ccr-retrieve.ts +0 -80
- package/sdk/typescript/examples/hooks-custom-compression.ts +0 -117
- package/sdk/typescript/examples/middleware-composition.ts +0 -59
- package/sdk/typescript/examples/multi-provider.ts +0 -53
- package/sdk/typescript/examples/openai-anthropic-adapters.ts +0 -73
- package/sdk/typescript/examples/shared-context-multi-agent.ts +0 -74
- package/sdk/typescript/examples/simulation-dry-run.ts +0 -80
- package/sdk/typescript/examples/streaming-chat.ts +0 -71
- package/sdk/typescript/examples/structured-output.ts +0 -99
- package/sdk/typescript/examples/tool-calling-agent.ts +0 -86
- package/sdk/typescript/examples/with-headroom-vercel.ts +0 -57
- package/sdk/typescript/package-lock.json +0 -3437
- package/sdk/typescript/package.json +0 -108
- package/sdk/typescript/src/adapters/anthropic.ts +0 -218
- package/sdk/typescript/src/adapters/gemini.ts +0 -83
- package/sdk/typescript/src/adapters/openai.ts +0 -77
- package/sdk/typescript/src/adapters/vercel-ai.ts +0 -131
- package/sdk/typescript/src/client.ts +0 -632
- package/sdk/typescript/src/compress.ts +0 -87
- package/sdk/typescript/src/errors.ts +0 -114
- package/sdk/typescript/src/hooks.ts +0 -113
- package/sdk/typescript/src/index.ts +0 -140
- package/sdk/typescript/src/paths.ts +0 -272
- package/sdk/typescript/src/shared-context.ts +0 -188
- package/sdk/typescript/src/simulate.ts +0 -52
- package/sdk/typescript/src/types/config.ts +0 -183
- package/sdk/typescript/src/types/models.ts +0 -314
- package/sdk/typescript/src/types.ts +0 -139
- package/sdk/typescript/src/utils/case.ts +0 -34
- package/sdk/typescript/src/utils/format.ts +0 -480
- package/sdk/typescript/src/utils/stream.ts +0 -50
- package/sdk/typescript/test/adapters/anthropic.test.ts +0 -217
- package/sdk/typescript/test/adapters/gemini.test.ts +0 -131
- package/sdk/typescript/test/adapters/openai.test.ts +0 -174
- package/sdk/typescript/test/adapters/vercel-ai.test.ts +0 -306
- package/sdk/typescript/test/client-expanded.test.ts +0 -333
- package/sdk/typescript/test/client.test.ts +0 -266
- package/sdk/typescript/test/compress.test.ts +0 -118
- package/sdk/typescript/test/config.test.ts +0 -275
- package/sdk/typescript/test/errors.test.ts +0 -169
- package/sdk/typescript/test/format-integration.test.ts +0 -252
- package/sdk/typescript/test/hooks.test.ts +0 -265
- package/sdk/typescript/test/integration.test.ts +0 -249
- package/sdk/typescript/test/mdx-examples.test.ts +0 -253
- package/sdk/typescript/test/models.test.ts +0 -318
- package/sdk/typescript/test/parity.test.ts +0 -337
- package/sdk/typescript/test/paths.test.ts +0 -447
- package/sdk/typescript/test/shared-context.test.ts +0 -245
- package/sdk/typescript/test/simulate.test.ts +0 -84
- package/sdk/typescript/test/types.test.ts +0 -244
- package/sdk/typescript/test/utils/case.test.ts +0 -129
- package/sdk/typescript/test/utils/detect-format.test.ts +0 -133
- package/sdk/typescript/test/utils/format.test.ts +0 -434
- package/sdk/typescript/test/vercel-ai-e2e.test.ts +0 -179
- package/sdk/typescript/tsup.config.ts +0 -17
- package/tailwind.master.config.cjs +0 -47
- package/types/api.ts +0 -12
- package/types/config.ts +0 -9
- package/types/index.ts +0 -2
- package/uv.lock +0 -6951
- package/xithead.egg-info/PKG-INFO +0 -22
- package/xithead.egg-info/SOURCES.txt +0 -16
- package/xithead.egg-info/dependency_links.txt +0 -1
- package/xithead.egg-info/entry_points.txt +0 -2
- package/xithead.egg-info/requires.txt +0 -10
- package/xithead.egg-info/top_level.txt +0 -2
- package/xithead.ps1 +0 -136
- package/xithead.sh +0 -129
- package/xithead_dist/pyproject.toml +0 -39
- package/xithead_dist/xithead.egg-info/PKG-INFO +0 -22
- package/xithead_dist/xithead.egg-info/SOURCES.txt +0 -16
- package/xithead_dist/xithead.egg-info/dependency_links.txt +0 -1
- package/xithead_dist/xithead.egg-info/entry_points.txt +0 -3
- package/xithead_dist/xithead.egg-info/requires.txt +0 -10
- package/xithead_dist/xithead.egg-info/top_level.txt +0 -2
- /package/{npm/index.d.ts → index.d.ts} +0 -0
- /package/{npm/postinstall.js → postinstall.js} +0 -0
|
@@ -1,287 +0,0 @@
|
|
|
1
|
-
//! Numeric statistics helpers — port of Python's `statistics` module
|
|
2
|
-
//! semantics used by `SmartAnalyzer`.
|
|
3
|
-
//!
|
|
4
|
-
//! Python's `statistics` module uses **sample** variance/stdev (n-1
|
|
5
|
-
//! denominator), not population (n denominator). Mismatching the
|
|
6
|
-
//! denominator silently shifts every variance-based decision (change
|
|
7
|
-
//! points, anomaly thresholds, crushability cases). These helpers
|
|
8
|
-
//! mirror Python's defaults.
|
|
9
|
-
|
|
10
|
-
/// Arithmetic mean. Returns `None` on empty input — Python's
|
|
11
|
-
/// `statistics.mean([])` raises `StatisticsError`; we model that as
|
|
12
|
-
/// "no value to return", and callers must handle it.
|
|
13
|
-
///
|
|
14
|
-
/// Also returns `None` if the result is non-finite (Inf/NaN). Python's
|
|
15
|
-
/// numeric-stats path in `_analyze_field` is wrapped in
|
|
16
|
-
/// `try/except (OverflowError, ValueError)` and resets all stats to
|
|
17
|
-
/// `None` on failure; mirroring that here keeps parity on extreme floats.
|
|
18
|
-
pub fn mean(values: &[f64]) -> Option<f64> {
|
|
19
|
-
if values.is_empty() {
|
|
20
|
-
return None;
|
|
21
|
-
}
|
|
22
|
-
let sum: f64 = values.iter().sum();
|
|
23
|
-
let m = sum / values.len() as f64;
|
|
24
|
-
if m.is_finite() {
|
|
25
|
-
Some(m)
|
|
26
|
-
} else {
|
|
27
|
-
None
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
/// Sample variance with `n-1` denominator (Python `statistics.variance`).
|
|
32
|
-
/// Requires at least 2 values; returns `None` for fewer (mirrors
|
|
33
|
-
/// Python which raises `StatisticsError` for n < 2). Also returns `None`
|
|
34
|
-
/// on non-finite results — see `mean` for rationale.
|
|
35
|
-
pub fn sample_variance(values: &[f64]) -> Option<f64> {
|
|
36
|
-
if values.len() < 2 {
|
|
37
|
-
return None;
|
|
38
|
-
}
|
|
39
|
-
let m = mean(values)?;
|
|
40
|
-
let sum_sq_diff: f64 = values.iter().map(|v| (v - m).powi(2)).sum();
|
|
41
|
-
let var = sum_sq_diff / (values.len() - 1) as f64;
|
|
42
|
-
if var.is_finite() {
|
|
43
|
-
Some(var)
|
|
44
|
-
} else {
|
|
45
|
-
None
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
/// Sample standard deviation — sqrt of `sample_variance`. Same n>=2
|
|
50
|
-
/// requirement as the variance helper. `None` propagates from
|
|
51
|
-
/// `sample_variance`, including on non-finite inputs.
|
|
52
|
-
pub fn sample_stdev(values: &[f64]) -> Option<f64> {
|
|
53
|
-
sample_variance(values).map(f64::sqrt)
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
/// Median (Python `statistics.median`). Returns the middle element for
|
|
57
|
-
/// odd-count input, mean of two middles for even-count. Returns `None`
|
|
58
|
-
/// on empty input — Python raises `StatisticsError`.
|
|
59
|
-
///
|
|
60
|
-
/// Caller must pre-filter NaN/Inf if undesired (Python's median with
|
|
61
|
-
/// NaN gives indeterminate ordering; we sort with `total_cmp` to keep
|
|
62
|
-
/// behavior deterministic).
|
|
63
|
-
pub fn median(values: &[f64]) -> Option<f64> {
|
|
64
|
-
if values.is_empty() {
|
|
65
|
-
return None;
|
|
66
|
-
}
|
|
67
|
-
let mut sorted: Vec<f64> = values.to_vec();
|
|
68
|
-
sorted.sort_by(f64::total_cmp);
|
|
69
|
-
let n = sorted.len();
|
|
70
|
-
if n % 2 == 0 {
|
|
71
|
-
// Mean of the two middle elements.
|
|
72
|
-
let lo = sorted[n / 2 - 1];
|
|
73
|
-
let hi = sorted[n / 2];
|
|
74
|
-
Some((lo + hi) / 2.0)
|
|
75
|
-
} else {
|
|
76
|
-
Some(sorted[n / 2])
|
|
77
|
-
}
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
/// Approximation of Python's `f"{x:.4g}"` general-purpose float format.
|
|
81
|
-
///
|
|
82
|
-
/// Rules:
|
|
83
|
-
/// - 4 significant digits.
|
|
84
|
-
/// - Scientific notation when `exponent < -4` OR `exponent >= 4`.
|
|
85
|
-
/// - Trailing zeros stripped (and the `.` if all decimals removed).
|
|
86
|
-
/// - Scientific exponent padded to at least 2 digits with explicit sign
|
|
87
|
-
/// (`1.234e+04`, `1e-05`).
|
|
88
|
-
///
|
|
89
|
-
/// Used for crusher strategy debug strings. Strategy strings are
|
|
90
|
-
/// fixture-locked at the parity stage; if Rust's float formatting drifts
|
|
91
|
-
/// from CPython on some edge case, we'll catch it then. Documented
|
|
92
|
-
/// edge cases:
|
|
93
|
-
///
|
|
94
|
-
/// - **Banker's rounding (round half-to-even)**: Python uses banker's;
|
|
95
|
-
/// Rust's `format!("{:.*}", ...)` also rounds-half-to-even (per the
|
|
96
|
-
/// "round-to-nearest-even" IEEE 754 default). Should match.
|
|
97
|
-
/// - **NaN/Inf**: Python prints `nan`, `inf`, `-inf`. We mirror.
|
|
98
|
-
pub fn format_g(x: f64) -> String {
|
|
99
|
-
if x.is_nan() {
|
|
100
|
-
return "nan".to_string();
|
|
101
|
-
}
|
|
102
|
-
if x.is_infinite() {
|
|
103
|
-
return if x > 0.0 {
|
|
104
|
-
"inf".to_string()
|
|
105
|
-
} else {
|
|
106
|
-
"-inf".to_string()
|
|
107
|
-
};
|
|
108
|
-
}
|
|
109
|
-
if x == 0.0 {
|
|
110
|
-
return "0".to_string();
|
|
111
|
-
}
|
|
112
|
-
|
|
113
|
-
let abs = x.abs();
|
|
114
|
-
let exp = abs.log10().floor() as i32;
|
|
115
|
-
|
|
116
|
-
if !(-4..4).contains(&exp) {
|
|
117
|
-
// Scientific. Python uses 4 sig figs → 3 digits after decimal in mantissa.
|
|
118
|
-
let s = format!("{:.3e}", x);
|
|
119
|
-
normalize_scientific_exp(&s)
|
|
120
|
-
} else {
|
|
121
|
-
let digits_after = (3 - exp).max(0) as usize;
|
|
122
|
-
let s = format!("{:.*}", digits_after, x);
|
|
123
|
-
if s.contains('.') {
|
|
124
|
-
// Trim trailing zeros and a dangling decimal point.
|
|
125
|
-
s.trim_end_matches('0').trim_end_matches('.').to_string()
|
|
126
|
-
} else {
|
|
127
|
-
s
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
fn normalize_scientific_exp(s: &str) -> String {
|
|
133
|
-
let Some(epos) = s.find('e') else {
|
|
134
|
-
return s.to_string();
|
|
135
|
-
};
|
|
136
|
-
let (mantissa, rest) = s.split_at(epos);
|
|
137
|
-
let exp_part = &rest[1..];
|
|
138
|
-
let exp_num: i32 = exp_part.parse().unwrap_or(0);
|
|
139
|
-
let mantissa_clean = if mantissa.contains('.') {
|
|
140
|
-
mantissa
|
|
141
|
-
.trim_end_matches('0')
|
|
142
|
-
.trim_end_matches('.')
|
|
143
|
-
.to_string()
|
|
144
|
-
} else {
|
|
145
|
-
mantissa.to_string()
|
|
146
|
-
};
|
|
147
|
-
let sign = if exp_num >= 0 { "+" } else { "-" };
|
|
148
|
-
format!("{}e{}{:02}", mantissa_clean, sign, exp_num.abs())
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
#[cfg(test)]
|
|
152
|
-
mod tests {
|
|
153
|
-
use super::*;
|
|
154
|
-
|
|
155
|
-
fn approx_eq(a: f64, b: f64) -> bool {
|
|
156
|
-
(a - b).abs() < 1e-9
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
#[test]
|
|
160
|
-
fn mean_empty_is_none() {
|
|
161
|
-
assert_eq!(mean(&[]), None);
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
#[test]
|
|
165
|
-
fn mean_single() {
|
|
166
|
-
assert!(approx_eq(mean(&[5.0]).unwrap(), 5.0));
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
#[test]
|
|
170
|
-
fn mean_basic() {
|
|
171
|
-
// Python: statistics.mean([1, 2, 3, 4, 5]) == 3.0
|
|
172
|
-
assert!(approx_eq(mean(&[1.0, 2.0, 3.0, 4.0, 5.0]).unwrap(), 3.0));
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
#[test]
|
|
176
|
-
fn sample_variance_too_few_values_is_none() {
|
|
177
|
-
// Python: statistics.variance([5]) raises; we return None.
|
|
178
|
-
assert_eq!(sample_variance(&[]), None);
|
|
179
|
-
assert_eq!(sample_variance(&[5.0]), None);
|
|
180
|
-
}
|
|
181
|
-
|
|
182
|
-
#[test]
|
|
183
|
-
fn sample_variance_uses_n_minus_1_denominator() {
|
|
184
|
-
// Python: statistics.variance([1, 2, 3, 4, 5]) == 2.5
|
|
185
|
-
// (Population variance with n in denominator would give 2.0.)
|
|
186
|
-
let v = sample_variance(&[1.0, 2.0, 3.0, 4.0, 5.0]).unwrap();
|
|
187
|
-
assert!(approx_eq(v, 2.5), "got {v}, expected 2.5");
|
|
188
|
-
}
|
|
189
|
-
|
|
190
|
-
#[test]
|
|
191
|
-
fn sample_stdev_basic() {
|
|
192
|
-
// Python: statistics.stdev([1, 2, 3, 4, 5]) == sqrt(2.5)
|
|
193
|
-
let s = sample_stdev(&[1.0, 2.0, 3.0, 4.0, 5.0]).unwrap();
|
|
194
|
-
assert!(approx_eq(s, 2.5_f64.sqrt()), "got {s}");
|
|
195
|
-
}
|
|
196
|
-
|
|
197
|
-
#[test]
|
|
198
|
-
fn sample_variance_constant_values_is_zero() {
|
|
199
|
-
// All-identical values: variance = 0.
|
|
200
|
-
let v = sample_variance(&[7.0, 7.0, 7.0]).unwrap();
|
|
201
|
-
assert!(approx_eq(v, 0.0));
|
|
202
|
-
}
|
|
203
|
-
|
|
204
|
-
#[test]
|
|
205
|
-
fn mean_non_finite_overflow_returns_none() {
|
|
206
|
-
// Python parity: extreme inputs that overflow during sum cause
|
|
207
|
-
// `statistics.mean` to raise OverflowError, which `_analyze_field`
|
|
208
|
-
// treats as "no stats". We mirror by returning None.
|
|
209
|
-
let huge = f64::MAX / 2.0;
|
|
210
|
-
let nums = vec![huge, huge, huge, huge];
|
|
211
|
-
// Sum overflows to +Inf, mean = Inf — non-finite, must be None.
|
|
212
|
-
assert_eq!(mean(&nums), None);
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
#[test]
|
|
216
|
-
fn sample_variance_non_finite_returns_none() {
|
|
217
|
-
// Squared-diff sum overflows. Mirrors Python's OverflowError path.
|
|
218
|
-
let huge = 1e200;
|
|
219
|
-
let v = sample_variance(&[huge, -huge]);
|
|
220
|
-
// (1e200 - 0)² + (-1e200 - 0)² overflows → variance is Inf → None.
|
|
221
|
-
assert_eq!(v, None);
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
#[test]
|
|
225
|
-
fn sample_stdev_non_finite_returns_none() {
|
|
226
|
-
let huge = 1e200;
|
|
227
|
-
assert_eq!(sample_stdev(&[huge, -huge]), None);
|
|
228
|
-
}
|
|
229
|
-
|
|
230
|
-
#[test]
|
|
231
|
-
fn median_empty_is_none() {
|
|
232
|
-
assert_eq!(median(&[]), None);
|
|
233
|
-
}
|
|
234
|
-
|
|
235
|
-
#[test]
|
|
236
|
-
fn median_odd_count() {
|
|
237
|
-
assert_eq!(median(&[3.0, 1.0, 2.0]), Some(2.0));
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
#[test]
|
|
241
|
-
fn median_even_count_mean_of_middles() {
|
|
242
|
-
// Python: statistics.median([1, 2, 3, 4]) == 2.5
|
|
243
|
-
assert_eq!(median(&[4.0, 1.0, 2.0, 3.0]), Some(2.5));
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
#[test]
|
|
247
|
-
fn median_single_element() {
|
|
248
|
-
assert_eq!(median(&[42.0]), Some(42.0));
|
|
249
|
-
}
|
|
250
|
-
|
|
251
|
-
// ---------- format_g ----------
|
|
252
|
-
|
|
253
|
-
#[test]
|
|
254
|
-
fn format_g_zero_and_special() {
|
|
255
|
-
assert_eq!(format_g(0.0), "0");
|
|
256
|
-
assert_eq!(format_g(-0.0), "0");
|
|
257
|
-
assert_eq!(format_g(f64::NAN), "nan");
|
|
258
|
-
assert_eq!(format_g(f64::INFINITY), "inf");
|
|
259
|
-
assert_eq!(format_g(f64::NEG_INFINITY), "-inf");
|
|
260
|
-
}
|
|
261
|
-
|
|
262
|
-
#[test]
|
|
263
|
-
fn format_g_fixed_range() {
|
|
264
|
-
// Python: f"{1.5:.4g}" = "1.5"
|
|
265
|
-
assert_eq!(format_g(1.5), "1.5");
|
|
266
|
-
// Python: f"{1.0:.4g}" = "1"
|
|
267
|
-
assert_eq!(format_g(1.0), "1");
|
|
268
|
-
// Python: f"{1234.0:.4g}" = "1234"
|
|
269
|
-
assert_eq!(format_g(1234.0), "1234");
|
|
270
|
-
// Python: f"{0.123456:.4g}" = "0.1235"
|
|
271
|
-
assert_eq!(format_g(0.123456), "0.1235");
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
#[test]
|
|
275
|
-
fn format_g_scientific_range() {
|
|
276
|
-
// Python: f"{12345.678:.4g}" = "1.235e+04"
|
|
277
|
-
assert_eq!(format_g(12345.678), "1.235e+04");
|
|
278
|
-
// Python: f"{0.00001234:.4g}" = "1.234e-05"
|
|
279
|
-
assert_eq!(format_g(0.00001234), "1.234e-05");
|
|
280
|
-
}
|
|
281
|
-
|
|
282
|
-
#[test]
|
|
283
|
-
fn format_g_negative() {
|
|
284
|
-
assert_eq!(format_g(-1.5), "-1.5");
|
|
285
|
-
assert_eq!(format_g(-12345.678), "-1.235e+04");
|
|
286
|
-
}
|
|
287
|
-
}
|
|
@@ -1,203 +0,0 @@
|
|
|
1
|
-
//! Public extension surface for `SmartCrusher` (Stage 3c.2 PR 1).
|
|
2
|
-
//!
|
|
3
|
-
//! Three traits — `Scorer`, `Constraint`, `Observer` — capture every
|
|
4
|
-
//! decision a `SmartCrusher` makes that downstream consumers might
|
|
5
|
-
//! want to override:
|
|
6
|
-
//!
|
|
7
|
-
//! - **`Scorer`** (already public via `crate::relevance::RelevanceScorer`):
|
|
8
|
-
//! how relevant is item *i* to query *q*? OSS default `HybridScorer`
|
|
9
|
-
//! (BM25 + fastembed). Enterprise can plug in a per-tenant Loop-trained
|
|
10
|
-
//! scorer.
|
|
11
|
-
//! - **`Constraint`** (this module): which indices must be kept
|
|
12
|
-
//! regardless of score? OSS defaults preserve errors and structural
|
|
13
|
-
//! outliers. Enterprise can add `BusinessRuleConstraint`,
|
|
14
|
-
//! `RegulatoryConstraint`, etc.
|
|
15
|
-
//! - **`Observer`** (this module): emit a structured event after each
|
|
16
|
-
//! `crush()` so telemetry, audit logs, and continuous-eval pipelines
|
|
17
|
-
//! can hook in. OSS default writes to the `tracing` crate.
|
|
18
|
-
//!
|
|
19
|
-
//! # Why three, not eight
|
|
20
|
-
//!
|
|
21
|
-
//! The 5-stage pipeline (classify → compact → score → allocate →
|
|
22
|
-
//! format) has more stage boundaries, but only three of them carry
|
|
23
|
-
//! *differentiated value* to Enterprise customers — Loop scorer,
|
|
24
|
-
//! business rules, audit telemetry. The other stages stay as concrete
|
|
25
|
-
//! Rust types; if an Enterprise customer ever needs to plug into a
|
|
26
|
-
//! different stage we can promote it to a trait at that point. We're
|
|
27
|
-
//! not designing for hypothetical futures — we're naming the seams
|
|
28
|
-
//! that real customers will pay for today.
|
|
29
|
-
//!
|
|
30
|
-
//! # Composition
|
|
31
|
-
//!
|
|
32
|
-
//! Use [`SmartCrusherBuilder`](super::builder::SmartCrusherBuilder) to
|
|
33
|
-
//! compose a custom `SmartCrusher`. The default OSS composition is
|
|
34
|
-
//! reachable via `SmartCrusher::new(config)` and stays byte-equivalent
|
|
35
|
-
//! to pre-PR1 behavior — all 17 parity fixtures pass.
|
|
36
|
-
|
|
37
|
-
use serde_json::Value;
|
|
38
|
-
|
|
39
|
-
// ── Constraint ────────────────────────────────────────────────────────────
|
|
40
|
-
|
|
41
|
-
/// A hard preservation constraint: indices the allocator must keep
|
|
42
|
-
/// regardless of saliency score or token budget.
|
|
43
|
-
///
|
|
44
|
-
/// Constraints stack — the must-keep set is the union of every
|
|
45
|
-
/// constraint's `must_keep` output. OSS ships [`KeepErrorsConstraint`]
|
|
46
|
-
/// and [`KeepStructuralOutliersConstraint`] (wrappers around the
|
|
47
|
-
/// existing detection functions); Enterprise crates can add
|
|
48
|
-
/// `BusinessRuleConstraint("amount > 10000")`,
|
|
49
|
-
/// `RegulatoryConstraint::HIPAA`, and so on.
|
|
50
|
-
///
|
|
51
|
-
/// # Contract
|
|
52
|
-
///
|
|
53
|
-
/// - **`must_keep` returns indices into `items`.** Out-of-bounds
|
|
54
|
-
/// indices are silently dropped by the allocator; constraints
|
|
55
|
-
/// should not return them.
|
|
56
|
-
/// - **Idempotent in the small.** Calling `must_keep` twice with the
|
|
57
|
-
/// same `items` returns the same set; constraints do not own
|
|
58
|
-
/// mutable state that drifts between calls within one
|
|
59
|
-
/// `SmartCrusher::crush` invocation. (Caching across crushes is
|
|
60
|
-
/// fine — see `LoopScorer` style stateful enrichers.)
|
|
61
|
-
/// - **Cheap is free.** Constraints run on every dict-array crush.
|
|
62
|
-
/// A constraint that does I/O or heavy regex per-item can dominate
|
|
63
|
-
/// the crusher's cost. Aim for O(n) on items with small constants.
|
|
64
|
-
///
|
|
65
|
-
/// # Why `item_strings: Option<&[String]>`?
|
|
66
|
-
///
|
|
67
|
-
/// Many constraints search the JSON serialization for keywords (the
|
|
68
|
-
/// existing `detect_error_items_for_preservation` does this). The
|
|
69
|
-
/// caller may already have computed `item_strings` for adaptive
|
|
70
|
-
/// sizing; passing them through avoids redundant `serde_json::to_string`
|
|
71
|
-
/// calls. Constraints that don't need the strings simply ignore the
|
|
72
|
-
/// argument.
|
|
73
|
-
pub trait Constraint: Send + Sync {
|
|
74
|
-
/// Stable identifier — appears in `CrushEvent` strategy strings,
|
|
75
|
-
/// audit logs, and config-validation diagnostics. Use snake_case
|
|
76
|
-
/// (`"keep_errors"`, `"business_rule"`).
|
|
77
|
-
fn name(&self) -> &str;
|
|
78
|
-
|
|
79
|
-
/// Indices of items the allocator MUST keep.
|
|
80
|
-
fn must_keep(&self, items: &[Value], item_strings: Option<&[String]>) -> Vec<usize>;
|
|
81
|
-
}
|
|
82
|
-
|
|
83
|
-
// ── Observer ──────────────────────────────────────────────────────────────
|
|
84
|
-
|
|
85
|
-
/// Telemetry event emitted at the end of each `SmartCrusher::crush`
|
|
86
|
-
/// call. Observers (multiple, stacked) consume these for `tracing`,
|
|
87
|
-
/// audit logs, Loop training data, real-time dashboards.
|
|
88
|
-
#[derive(Debug, Clone)]
|
|
89
|
-
pub struct CrushEvent {
|
|
90
|
-
/// Strategy debug string returned by the crusher
|
|
91
|
-
/// (e.g. `"smart_sample(30->15)"`, `"passthrough"`,
|
|
92
|
-
/// `"top_n(50->15)"`).
|
|
93
|
-
pub strategy: String,
|
|
94
|
-
/// Length in bytes of the input content (whatever was passed to
|
|
95
|
-
/// `crush()`).
|
|
96
|
-
pub input_bytes: usize,
|
|
97
|
-
/// Length in bytes of the compressed output.
|
|
98
|
-
pub output_bytes: usize,
|
|
99
|
-
/// Wall-clock duration of the `crush()` call.
|
|
100
|
-
pub elapsed_ns: u64,
|
|
101
|
-
/// Whether the output differs from the input.
|
|
102
|
-
pub was_modified: bool,
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
/// Decision-stream hook. Called after each top-level `SmartCrusher::crush`
|
|
106
|
-
/// returns; observers run synchronously on the crusher's thread.
|
|
107
|
-
///
|
|
108
|
-
/// # Contract
|
|
109
|
-
///
|
|
110
|
-
/// - **Cheap is free.** Like constraints, observers run on every
|
|
111
|
-
/// crush. `tracing::debug!` is essentially free when the subscriber
|
|
112
|
-
/// filters the level out; remote network calls are not.
|
|
113
|
-
/// - **Don't panic.** A panicking observer aborts the calling thread.
|
|
114
|
-
/// If your observer does I/O, catch and log errors yourself.
|
|
115
|
-
/// - **Order matters.** Observers fire in the order they were added
|
|
116
|
-
/// to the builder. Most callers should not depend on the order
|
|
117
|
-
/// (telemetry is naturally idempotent), but if you have an
|
|
118
|
-
/// audit-then-publish chain, add them in that order.
|
|
119
|
-
pub trait Observer: Send + Sync {
|
|
120
|
-
/// Stable identifier — useful for filtering in the rare cases
|
|
121
|
-
/// where an observer wants to disable itself when another is
|
|
122
|
-
/// already configured. Default: the type name.
|
|
123
|
-
fn name(&self) -> &str {
|
|
124
|
-
std::any::type_name::<Self>()
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
/// Called once per `SmartCrusher::crush` invocation, after the
|
|
128
|
-
/// result is computed and before it is returned to the caller.
|
|
129
|
-
fn on_event(&self, event: &CrushEvent);
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
// ── Re-exports for convenience ────────────────────────────────────────────
|
|
133
|
-
|
|
134
|
-
// Scorer is in the relevance crate, not here; re-export so callers
|
|
135
|
-
// can get all three traits from one path.
|
|
136
|
-
pub use crate::relevance::RelevanceScorer as Scorer;
|
|
137
|
-
|
|
138
|
-
#[cfg(test)]
|
|
139
|
-
mod tests {
|
|
140
|
-
use super::*;
|
|
141
|
-
use serde_json::json;
|
|
142
|
-
use std::sync::atomic::{AtomicUsize, Ordering};
|
|
143
|
-
use std::sync::Arc;
|
|
144
|
-
|
|
145
|
-
/// A tiny constraint that always keeps index 0 (if any items).
|
|
146
|
-
/// Pins the trait shape and the additive behavior of constraint
|
|
147
|
-
/// stacking.
|
|
148
|
-
struct AlwaysKeepFirst;
|
|
149
|
-
impl Constraint for AlwaysKeepFirst {
|
|
150
|
-
fn name(&self) -> &str {
|
|
151
|
-
"always_keep_first"
|
|
152
|
-
}
|
|
153
|
-
fn must_keep(&self, items: &[Value], _: Option<&[String]>) -> Vec<usize> {
|
|
154
|
-
if items.is_empty() {
|
|
155
|
-
Vec::new()
|
|
156
|
-
} else {
|
|
157
|
-
vec![0]
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
#[test]
|
|
163
|
-
fn constraint_returns_indices_in_bounds() {
|
|
164
|
-
let items = vec![json!({"a": 1}), json!({"a": 2})];
|
|
165
|
-
let c = AlwaysKeepFirst;
|
|
166
|
-
let kept = c.must_keep(&items, None);
|
|
167
|
-
assert_eq!(kept, vec![0]);
|
|
168
|
-
assert_eq!(c.name(), "always_keep_first");
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
#[test]
|
|
172
|
-
fn constraint_handles_empty_input() {
|
|
173
|
-
let kept = AlwaysKeepFirst.must_keep(&[], None);
|
|
174
|
-
assert!(kept.is_empty());
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
/// Counts events to verify the observer trait fires correctly
|
|
178
|
-
/// when wired into a SmartCrusher (integration test in
|
|
179
|
-
/// `crusher.rs::tests`).
|
|
180
|
-
#[derive(Default)]
|
|
181
|
-
struct CountingObserver {
|
|
182
|
-
count: Arc<AtomicUsize>,
|
|
183
|
-
}
|
|
184
|
-
impl Observer for CountingObserver {
|
|
185
|
-
fn on_event(&self, _: &CrushEvent) {
|
|
186
|
-
self.count.fetch_add(1, Ordering::SeqCst);
|
|
187
|
-
}
|
|
188
|
-
}
|
|
189
|
-
|
|
190
|
-
#[test]
|
|
191
|
-
fn observer_event_carries_strategy_and_sizes() {
|
|
192
|
-
let observer = CountingObserver::default();
|
|
193
|
-
let event = CrushEvent {
|
|
194
|
-
strategy: "smart_sample(30->15)".to_string(),
|
|
195
|
-
input_bytes: 1000,
|
|
196
|
-
output_bytes: 500,
|
|
197
|
-
elapsed_ns: 12_345,
|
|
198
|
-
was_modified: true,
|
|
199
|
-
};
|
|
200
|
-
observer.on_event(&event);
|
|
201
|
-
assert_eq!(observer.count.load(Ordering::SeqCst), 1);
|
|
202
|
-
}
|
|
203
|
-
}
|