xithead 1.5.0 → 1.5.1
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/design-system/README.md +80 -0
- package/package.json +20 -1
- package/public/apple-touch-icon.png +0 -0
- package/public/logo-transparent.png +0 -0
- package/public/xithead.ps1 +937 -0
- package/scripts/README.md +77 -0
- package/scripts/audit_wheel_glibc_symbols.py +217 -0
- package/scripts/build-master-design-system.cjs +33 -0
- package/scripts/build_rust_extension.sh +58 -0
- package/scripts/changelog-gen.py +203 -0
- package/scripts/eval_output_shaper.py +235 -0
- package/scripts/export_kompress_v2_onnx.py +267 -0
- package/scripts/fixtures/anthropic_replay_body.json +133 -0
- package/scripts/fixtures/codex_response_create_frame.json +52 -0
- package/scripts/install-git-hooks.sh +104 -0
- package/scripts/install.ps1 +1809 -0
- package/scripts/install.sh +1673 -0
- package/scripts/pr-governance.py +297 -0
- package/scripts/record_fixtures.py +59 -0
- package/scripts/refresh_model_limits.sh +48 -0
- package/scripts/replay_codex_ws_load.py +445 -0
- package/scripts/repro_codex_replay.py +699 -0
- package/scripts/smoke_issue_327.py +233 -0
- package/scripts/sync-plugin-versions.py +116 -0
- package/scripts/tests/test_changelog_gen.py +302 -0
- package/scripts/tests/test_pr_governance.py +163 -0
- package/scripts/tests/test_pr_health_labels.py +94 -0
- package/scripts/tests/test_pr_health_workflow.py +14 -0
- package/scripts/tests/test_sync_plugin_versions.py +131 -0
- package/scripts/tests/test_version_sync.py +291 -0
- package/scripts/validate-workflows.sh +39 -0
- package/scripts/verify-versions.py +106 -0
- package/scripts/version-sync.py +207 -0
- package/tailwind.config.js +31 -0
- package/tsconfig.json +84 -0
- 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/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_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/codecov.yml +0 -34
- 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/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/llms.txt +0 -67
- package/mkdocs.yml +0 -136
- package/npm/bin/xithead.js +0 -366
- package/npm/bin/xtream-head.js +0 -366
- package/npm/index.d.ts +0 -57
- package/npm/index.js +0 -139
- package/npm/package.json +0 -55
- package/npm/postinstall.js +0 -43
- 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/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/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
|
@@ -1,338 +0,0 @@
|
|
|
1
|
-
//! Compression pipeline traits — `Reformat` and `Offload`.
|
|
2
|
-
//!
|
|
3
|
-
//! # Why two traits, both lossless w.r.t. information
|
|
4
|
-
//!
|
|
5
|
-
//! With CCR (Compress-Cache-Retrieve), no transform in this pipeline
|
|
6
|
-
//! destroys information. Bytes drop from the wire, but the original
|
|
7
|
-
//! payload is stashed in a [`CcrStore`] keyed by a hash; the LLM can
|
|
8
|
-
//! retrieve any dropped piece via a tool call. So calling transforms
|
|
9
|
-
//! "lossy" misnames the architecture — they all preserve information,
|
|
10
|
-
//! they just differ in *how* they shrink the wire output.
|
|
11
|
-
//!
|
|
12
|
-
//! Two distinct mechanisms, two traits:
|
|
13
|
-
//!
|
|
14
|
-
//! * [`ReformatTransform`] — pack denser without dropping anything.
|
|
15
|
-
//! Output bytes, when read, are semantically equivalent to the
|
|
16
|
-
//! input. Examples: `JsonMinifier` (whitespace), log RLE
|
|
17
|
-
//! deduplication, code-comment stripping, schema extraction.
|
|
18
|
-
//! **No CCR needed** — the LLM doesn't retrieve anything; the wire
|
|
19
|
-
//! output carries everything already.
|
|
20
|
-
//!
|
|
21
|
-
//! * [`OffloadTransform`] — drop bytes from the wire, stash the
|
|
22
|
-
//! original via a [`CcrStore`], emit a retrieval marker. Examples:
|
|
23
|
-
//! line-importance filtering, diff hunk sampling, search match
|
|
24
|
-
//! thinning. **CCR is required** — the trait method takes
|
|
25
|
-
//! `&dyn CcrStore`, and `OffloadOutput::cache_key` is `String`
|
|
26
|
-
//! (not `Option<String>`) so the contract is type-system-enforced.
|
|
27
|
-
//!
|
|
28
|
-
//! # Per-domain bloat estimation
|
|
29
|
-
//!
|
|
30
|
-
//! Different content shapes have different "bloat" signals — a
|
|
31
|
-
//! generic byte-redundancy heuristic (zlib, etc.) misses domain
|
|
32
|
-
//! semantics. So [`OffloadTransform`] carries an [`estimate_bloat`]
|
|
33
|
-
//! method that runs a CHEAP structural read and returns a 0.0–1.0
|
|
34
|
-
//! score representing how much THIS transform would benefit the
|
|
35
|
-
//! input. The orchestrator gates `apply` on `estimate_bloat`
|
|
36
|
-
//! clearing a configurable threshold, and runs estimates in parallel
|
|
37
|
-
//! with the reformat phase via `rayon::join`.
|
|
38
|
-
//!
|
|
39
|
-
//! [`estimate_bloat`]: OffloadTransform::estimate_bloat
|
|
40
|
-
|
|
41
|
-
use crate::ccr::CcrStore;
|
|
42
|
-
use crate::transforms::ContentType;
|
|
43
|
-
|
|
44
|
-
/// Errors a transform can return.
|
|
45
|
-
///
|
|
46
|
-
/// All three variants signal "skip this transform, continue the
|
|
47
|
-
/// pipeline" — the orchestrator never panics on a transform error.
|
|
48
|
-
/// `Internal` surfaces to logs at WARN; the others at TRACE.
|
|
49
|
-
#[derive(Debug, thiserror::Error)]
|
|
50
|
-
pub enum TransformError {
|
|
51
|
-
/// The transform couldn't parse the input. Caller skips it.
|
|
52
|
-
#[error("invalid input for {transform}: {message}")]
|
|
53
|
-
InvalidInput {
|
|
54
|
-
transform: &'static str,
|
|
55
|
-
message: String,
|
|
56
|
-
},
|
|
57
|
-
/// Ran cleanly, found nothing to do (empty input, content
|
|
58
|
-
/// already minimal). Caller skips silently.
|
|
59
|
-
#[error("{transform} skipped: {message}")]
|
|
60
|
-
Skipped {
|
|
61
|
-
transform: &'static str,
|
|
62
|
-
message: String,
|
|
63
|
-
},
|
|
64
|
-
/// Internal failure (serializer, store write error, logic bug).
|
|
65
|
-
/// Caller surfaces to WARN logs but continues.
|
|
66
|
-
#[error("{transform} internal error: {message}")]
|
|
67
|
-
Internal {
|
|
68
|
-
transform: &'static str,
|
|
69
|
-
message: String,
|
|
70
|
-
},
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
impl TransformError {
|
|
74
|
-
pub fn invalid_input(transform: &'static str, message: impl Into<String>) -> Self {
|
|
75
|
-
Self::InvalidInput {
|
|
76
|
-
transform,
|
|
77
|
-
message: message.into(),
|
|
78
|
-
}
|
|
79
|
-
}
|
|
80
|
-
pub fn skipped(transform: &'static str, message: impl Into<String>) -> Self {
|
|
81
|
-
Self::Skipped {
|
|
82
|
-
transform,
|
|
83
|
-
message: message.into(),
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
pub fn internal(transform: &'static str, message: impl Into<String>) -> Self {
|
|
87
|
-
Self::Internal {
|
|
88
|
-
transform,
|
|
89
|
-
message: message.into(),
|
|
90
|
-
}
|
|
91
|
-
}
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/// Result of a [`ReformatTransform`] — output bytes are semantically
|
|
95
|
-
/// equivalent to the input. No CCR handle, no tool call required.
|
|
96
|
-
#[derive(Debug, Clone)]
|
|
97
|
-
pub struct ReformatOutput {
|
|
98
|
-
pub output: String,
|
|
99
|
-
pub bytes_saved: usize,
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
impl ReformatOutput {
|
|
103
|
-
pub fn from_lengths(input_len: usize, output: String) -> Self {
|
|
104
|
-
Self {
|
|
105
|
-
bytes_saved: input_len.saturating_sub(output.len()),
|
|
106
|
-
output,
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
/// Result of an [`OffloadTransform`] — output bytes are a SUBSET of
|
|
112
|
-
/// the input, the original is in the supplied store, and `cache_key`
|
|
113
|
-
/// is the lookup handle. Required, not optional.
|
|
114
|
-
#[derive(Debug, Clone)]
|
|
115
|
-
pub struct OffloadOutput {
|
|
116
|
-
pub output: String,
|
|
117
|
-
pub bytes_saved: usize,
|
|
118
|
-
/// Cache key under which the original payload is stored.
|
|
119
|
-
/// Required by trait contract.
|
|
120
|
-
pub cache_key: String,
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
impl OffloadOutput {
|
|
124
|
-
pub fn from_lengths(input_len: usize, output: String, cache_key: String) -> Self {
|
|
125
|
-
Self {
|
|
126
|
-
bytes_saved: input_len.saturating_sub(output.len()),
|
|
127
|
-
output,
|
|
128
|
-
cache_key,
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
/// Per-call context the orchestrator passes to each transform.
|
|
134
|
-
#[derive(Debug, Default, Clone)]
|
|
135
|
-
pub struct CompressionContext {
|
|
136
|
-
/// User question for relevance scoring inside offload transforms.
|
|
137
|
-
pub query: String,
|
|
138
|
-
/// Token budget the orchestrator is targeting (None = no budget
|
|
139
|
-
/// signal; transforms apply their default aggressiveness).
|
|
140
|
-
pub token_budget: Option<usize>,
|
|
141
|
-
}
|
|
142
|
-
|
|
143
|
-
impl CompressionContext {
|
|
144
|
-
pub fn with_query(query: impl Into<String>) -> Self {
|
|
145
|
-
Self {
|
|
146
|
-
query: query.into(),
|
|
147
|
-
token_budget: None,
|
|
148
|
-
}
|
|
149
|
-
}
|
|
150
|
-
pub fn with_budget(token_budget: usize) -> Self {
|
|
151
|
-
Self {
|
|
152
|
-
query: String::new(),
|
|
153
|
-
token_budget: Some(token_budget),
|
|
154
|
-
}
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
/// A transform that packs the input denser without dropping
|
|
159
|
-
/// information. The orchestrator runs reformats first because they
|
|
160
|
-
/// don't need any CCR backing — surviving bytes round-trip
|
|
161
|
-
/// semantically.
|
|
162
|
-
pub trait ReformatTransform: Send + Sync {
|
|
163
|
-
/// Stable telemetry name (lowercase snake_case, no spaces).
|
|
164
|
-
/// Used as the strategy key in the per-strategy stats nest from
|
|
165
|
-
/// Phase 3e.0.
|
|
166
|
-
fn name(&self) -> &'static str;
|
|
167
|
-
|
|
168
|
-
/// Content types this transform accepts. Borrowed from `&self`
|
|
169
|
-
/// so impls can return either a `&'static` literal or a
|
|
170
|
-
/// runtime-configured slice.
|
|
171
|
-
fn applies_to(&self) -> &[ContentType];
|
|
172
|
-
|
|
173
|
-
/// Run the transform.
|
|
174
|
-
fn apply(&self, content: &str) -> Result<ReformatOutput, TransformError>;
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
/// A transform that drops bytes from the wire and stashes the
|
|
178
|
-
/// original via CCR. The trait carries a cheap, domain-specific
|
|
179
|
-
/// [`estimate_bloat`] method so the orchestrator can decide whether
|
|
180
|
-
/// running the full `apply` is worthwhile — the estimate is the
|
|
181
|
-
/// gating signal.
|
|
182
|
-
///
|
|
183
|
-
/// Trait contract:
|
|
184
|
-
/// 1. `estimate_bloat` returns a 0.0–1.0 score. It MUST be cheap
|
|
185
|
-
/// (structural-only, no full compression pass) and MUST be safe
|
|
186
|
-
/// to call on any input including the empty string.
|
|
187
|
-
/// 2. If the orchestrator calls `apply`, it has already gated on
|
|
188
|
-
/// `estimate_bloat ≥ threshold`. `apply` MUST emit a `cache_key`
|
|
189
|
-
/// on success — return `Err(Skipped)` if the implementation
|
|
190
|
-
/// decides post-hoc that the offload wasn't worth it.
|
|
191
|
-
/// 3. `apply` MUST stash the payload in `store` before returning,
|
|
192
|
-
/// and the returned `cache_key` MUST resolve in that store.
|
|
193
|
-
///
|
|
194
|
-
/// [`estimate_bloat`]: Self::estimate_bloat
|
|
195
|
-
pub trait OffloadTransform: Send + Sync {
|
|
196
|
-
/// Stable telemetry name (lowercase snake_case).
|
|
197
|
-
fn name(&self) -> &'static str;
|
|
198
|
-
|
|
199
|
-
/// Content types this transform accepts.
|
|
200
|
-
fn applies_to(&self) -> &[ContentType];
|
|
201
|
-
|
|
202
|
-
/// Cheap structural estimate of bloat in `content`, scoped to
|
|
203
|
-
/// THIS transform's domain. 0.0 = nothing here would benefit
|
|
204
|
-
/// from offload; 1.0 = entire input is offloadable. Runs in
|
|
205
|
-
/// parallel with the reformat phase via `rayon::join` — keep
|
|
206
|
-
/// it under O(n) on input length, no allocations beyond what's
|
|
207
|
-
/// needed for the structural read.
|
|
208
|
-
///
|
|
209
|
-
/// MUST be safe on empty input (returns 0.0 by convention).
|
|
210
|
-
fn estimate_bloat(&self, content: &str) -> f32;
|
|
211
|
-
|
|
212
|
-
/// Run the offload. The orchestrator only calls this when
|
|
213
|
-
/// `estimate_bloat(content) ≥ threshold`. On success, the
|
|
214
|
-
/// returned `cache_key` MUST resolve to the original payload
|
|
215
|
-
/// in `store`.
|
|
216
|
-
fn apply(
|
|
217
|
-
&self,
|
|
218
|
-
content: &str,
|
|
219
|
-
ctx: &CompressionContext,
|
|
220
|
-
store: &dyn CcrStore,
|
|
221
|
-
) -> Result<OffloadOutput, TransformError>;
|
|
222
|
-
|
|
223
|
-
/// Calibrated 0.0–1.0 quality score for telemetry. Future PR4
|
|
224
|
-
/// may use it to select between competing offload transforms.
|
|
225
|
-
fn confidence(&self) -> f32;
|
|
226
|
-
}
|
|
227
|
-
|
|
228
|
-
#[cfg(test)]
|
|
229
|
-
mod tests {
|
|
230
|
-
use super::*;
|
|
231
|
-
use crate::ccr::InMemoryCcrStore;
|
|
232
|
-
|
|
233
|
-
pub struct TestReformat;
|
|
234
|
-
impl ReformatTransform for TestReformat {
|
|
235
|
-
fn name(&self) -> &'static str {
|
|
236
|
-
"test_reformat"
|
|
237
|
-
}
|
|
238
|
-
fn applies_to(&self) -> &[ContentType] {
|
|
239
|
-
&[ContentType::PlainText]
|
|
240
|
-
}
|
|
241
|
-
fn apply(&self, content: &str) -> Result<ReformatOutput, TransformError> {
|
|
242
|
-
Ok(ReformatOutput::from_lengths(
|
|
243
|
-
content.len(),
|
|
244
|
-
content.to_string(),
|
|
245
|
-
))
|
|
246
|
-
}
|
|
247
|
-
}
|
|
248
|
-
|
|
249
|
-
pub struct TestOffload {
|
|
250
|
-
bloat: f32,
|
|
251
|
-
}
|
|
252
|
-
impl OffloadTransform for TestOffload {
|
|
253
|
-
fn name(&self) -> &'static str {
|
|
254
|
-
"test_offload"
|
|
255
|
-
}
|
|
256
|
-
fn applies_to(&self) -> &[ContentType] {
|
|
257
|
-
&[ContentType::PlainText]
|
|
258
|
-
}
|
|
259
|
-
fn estimate_bloat(&self, _content: &str) -> f32 {
|
|
260
|
-
self.bloat
|
|
261
|
-
}
|
|
262
|
-
fn apply(
|
|
263
|
-
&self,
|
|
264
|
-
content: &str,
|
|
265
|
-
_ctx: &CompressionContext,
|
|
266
|
-
store: &dyn CcrStore,
|
|
267
|
-
) -> Result<OffloadOutput, TransformError> {
|
|
268
|
-
let key = format!("test_key_{:024x}", content.len());
|
|
269
|
-
store.put(&key, content);
|
|
270
|
-
Ok(OffloadOutput::from_lengths(
|
|
271
|
-
content.len(),
|
|
272
|
-
content.to_string(),
|
|
273
|
-
key,
|
|
274
|
-
))
|
|
275
|
-
}
|
|
276
|
-
fn confidence(&self) -> f32 {
|
|
277
|
-
0.5
|
|
278
|
-
}
|
|
279
|
-
}
|
|
280
|
-
|
|
281
|
-
#[test]
|
|
282
|
-
fn reformat_output_clamps_negative_savings_to_zero() {
|
|
283
|
-
let r = ReformatOutput::from_lengths(10, "this is much longer than 10 bytes".into());
|
|
284
|
-
assert_eq!(r.bytes_saved, 0);
|
|
285
|
-
}
|
|
286
|
-
|
|
287
|
-
#[test]
|
|
288
|
-
fn offload_output_clamps_negative_savings_to_zero() {
|
|
289
|
-
let r = OffloadOutput::from_lengths(10, "this is much longer".into(), "k".into());
|
|
290
|
-
assert_eq!(r.bytes_saved, 0);
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
#[test]
|
|
294
|
-
fn transform_error_messages_round_trip() {
|
|
295
|
-
let e = TransformError::invalid_input("json_minifier", "bad token at line 3");
|
|
296
|
-
let msg = e.to_string();
|
|
297
|
-
assert!(msg.contains("json_minifier"));
|
|
298
|
-
assert!(msg.contains("bad token at line 3"));
|
|
299
|
-
}
|
|
300
|
-
|
|
301
|
-
#[test]
|
|
302
|
-
fn compression_context_constructors() {
|
|
303
|
-
let q = CompressionContext::with_query("find errors");
|
|
304
|
-
assert_eq!(q.query, "find errors");
|
|
305
|
-
assert_eq!(q.token_budget, None);
|
|
306
|
-
|
|
307
|
-
let b = CompressionContext::with_budget(2048);
|
|
308
|
-
assert!(b.query.is_empty());
|
|
309
|
-
assert_eq!(b.token_budget, Some(2048));
|
|
310
|
-
}
|
|
311
|
-
|
|
312
|
-
#[test]
|
|
313
|
-
fn reformat_trait_smoke() {
|
|
314
|
-
let t = TestReformat;
|
|
315
|
-
let r = t.apply("hello").expect("reformat passes through");
|
|
316
|
-
assert_eq!(r.output, "hello");
|
|
317
|
-
assert_eq!(r.bytes_saved, 0);
|
|
318
|
-
}
|
|
319
|
-
|
|
320
|
-
#[test]
|
|
321
|
-
fn offload_trait_writes_to_store_and_returns_required_cache_key() {
|
|
322
|
-
let store = InMemoryCcrStore::new();
|
|
323
|
-
let t = TestOffload { bloat: 0.9 };
|
|
324
|
-
let r = t
|
|
325
|
-
.apply("hello", &CompressionContext::default(), &store)
|
|
326
|
-
.expect("offload writes");
|
|
327
|
-
// Trait contract: cache_key is required and resolves in the store.
|
|
328
|
-
assert!(!r.cache_key.is_empty());
|
|
329
|
-
assert_eq!(store.get(&r.cache_key).as_deref(), Some("hello"));
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
#[test]
|
|
333
|
-
fn offload_estimate_bloat_is_safe_on_empty_input() {
|
|
334
|
-
let t = TestOffload { bloat: 0.0 };
|
|
335
|
-
// Should not panic.
|
|
336
|
-
let _score = t.estimate_bloat("");
|
|
337
|
-
}
|
|
338
|
-
}
|
|
@@ -1,329 +0,0 @@
|
|
|
1
|
-
//! Startup-time loader for `recommendations.toml` (PR-B5).
|
|
2
|
-
//!
|
|
3
|
-
//! # Why this module exists
|
|
4
|
-
//!
|
|
5
|
-
//! Pre-PR-B5, the live-zone dispatcher could call back into Python's
|
|
6
|
-
//! TOIN per request to get a [`CompressionHint`]. That coupling made
|
|
7
|
-
//! per-request output non-deterministic — same input could compress
|
|
8
|
-
//! differently across runs depending on TOIN's mutable state — which
|
|
9
|
-
//! broke prompt caching (P2-27, P5-56). PR-B5 retired the request-time
|
|
10
|
-
//! hint API; recommendations now flow through this loader at startup:
|
|
11
|
-
//!
|
|
12
|
-
//! 1. The Python `headroom.cli.toin_publish` CLI walks the on-disk TOIN
|
|
13
|
-
//! store and emits `recommendations.toml`.
|
|
14
|
-
//! 2. The deploy pipeline ships that TOML alongside the Rust binary.
|
|
15
|
-
//! 3. At startup, [`RecommendationStore::load_default`] reads the file
|
|
16
|
-
//! once and exposes the recommendations via a process-wide
|
|
17
|
-
//! [`OnceLock`].
|
|
18
|
-
//! 4. [`get`] / [`RecommendationStore::lookup`] return the row matching
|
|
19
|
-
//! `(auth_mode, model_family, structure_hash)`, or `None` when no
|
|
20
|
-
//! advice was published. The dispatcher (PR-B3's
|
|
21
|
-
//! `dispatch_compressor`) does **not** consume this surface yet —
|
|
22
|
-
//! PR-F3 is responsible for wiring it.
|
|
23
|
-
//!
|
|
24
|
-
//! # File schema
|
|
25
|
-
//!
|
|
26
|
-
//! ```toml
|
|
27
|
-
//! [[recommendation]]
|
|
28
|
-
//! auth_mode = "payg"
|
|
29
|
-
//! model_family = "claude-3-5"
|
|
30
|
-
//! structure_hash = "deadbeef..."
|
|
31
|
-
//! strategy_hint = "smart_crusher"
|
|
32
|
-
//! confidence = 0.87
|
|
33
|
-
//! observations = 142
|
|
34
|
-
//! ```
|
|
35
|
-
//!
|
|
36
|
-
//! # Failure modes (loud, never silent)
|
|
37
|
-
//!
|
|
38
|
-
//! Per project memory `feedback_no_silent_fallbacks.md`: a missing or
|
|
39
|
-
//! malformed file degrades to "no advice, use static defaults" — but
|
|
40
|
-
//! the load attempt always logs a structured `tracing::warn!` event.
|
|
41
|
-
//! Production deployments grep for `event=recommendations_load_failed`
|
|
42
|
-
//! to catch a broken publish pipeline.
|
|
43
|
-
|
|
44
|
-
use std::collections::HashMap;
|
|
45
|
-
use std::path::{Path, PathBuf};
|
|
46
|
-
use std::sync::OnceLock;
|
|
47
|
-
|
|
48
|
-
use serde::Deserialize;
|
|
49
|
-
|
|
50
|
-
/// Environment variable that overrides the default `recommendations.toml`
|
|
51
|
-
/// path. The Rust proxy reads it once at startup; runtime changes do
|
|
52
|
-
/// not propagate.
|
|
53
|
-
pub const RECOMMENDATIONS_PATH_ENV_VAR: &str = "HEADROOM_RECOMMENDATIONS_PATH";
|
|
54
|
-
|
|
55
|
-
/// Default file the proxy looks at when the env var is unset.
|
|
56
|
-
const DEFAULT_RECOMMENDATIONS_PATH: &str = "./recommendations.toml";
|
|
57
|
-
|
|
58
|
-
// AuthMode is the canonical enum from `super::live_zone` (PR-B3).
|
|
59
|
-
// Re-exported here so recommendations callers can import it via
|
|
60
|
-
// `transforms::recommendations::AuthMode` without crossing module
|
|
61
|
-
// boundaries; the underlying enum is shared with the live-zone
|
|
62
|
-
// dispatcher to avoid drift between the dispatcher's auth slice and
|
|
63
|
-
// the published recommendations'. PR-B5 originally introduced its
|
|
64
|
-
// own copy; merged into the live-zone enum during integration so
|
|
65
|
-
// there's only one source of truth.
|
|
66
|
-
pub use super::live_zone::AuthMode;
|
|
67
|
-
|
|
68
|
-
/// A single published recommendation row.
|
|
69
|
-
#[derive(Debug, Clone, Deserialize, PartialEq)]
|
|
70
|
-
pub struct Recommendation {
|
|
71
|
-
pub auth_mode: String,
|
|
72
|
-
pub model_family: String,
|
|
73
|
-
pub structure_hash: String,
|
|
74
|
-
pub strategy_hint: String,
|
|
75
|
-
pub confidence: f64,
|
|
76
|
-
pub observations: u64,
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
/// Top-level TOML envelope: `[[recommendation]]` array.
|
|
80
|
-
#[derive(Debug, Default, Deserialize)]
|
|
81
|
-
struct RecommendationFile {
|
|
82
|
-
#[serde(default)]
|
|
83
|
-
recommendation: Vec<Recommendation>,
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
/// In-memory recommendation index, keyed by
|
|
87
|
-
/// `(auth_mode, model_family, structure_hash)`.
|
|
88
|
-
///
|
|
89
|
-
/// The keys are owned `String`s rather than `&str` — the values come
|
|
90
|
-
/// from `toml::from_str`, which gives us `String`s anyway, and trying
|
|
91
|
-
/// to borrow into the original buffer would require self-referential
|
|
92
|
-
/// storage. Recommendation files are small (≪ 1 MB even at large
|
|
93
|
-
/// fleets), so the allocation cost is irrelevant compared to the
|
|
94
|
-
/// parsing cost we already paid.
|
|
95
|
-
#[derive(Debug, Default, Clone)]
|
|
96
|
-
pub struct RecommendationStore {
|
|
97
|
-
by_key: HashMap<(String, String, String), Recommendation>,
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
impl RecommendationStore {
|
|
101
|
-
/// Build an empty store. Used for tests and as the fallback when
|
|
102
|
-
/// no `recommendations.toml` is present.
|
|
103
|
-
pub fn empty() -> Self {
|
|
104
|
-
Self {
|
|
105
|
-
by_key: HashMap::new(),
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
/// Number of indexed rows.
|
|
110
|
-
pub fn len(&self) -> usize {
|
|
111
|
-
self.by_key.len()
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
/// Whether this store has zero recommendations.
|
|
115
|
-
pub fn is_empty(&self) -> bool {
|
|
116
|
-
self.by_key.is_empty()
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
/// Look up a recommendation by tenant slice + structure hash.
|
|
120
|
-
/// Returns `None` when no advice was published for that key.
|
|
121
|
-
pub fn lookup(
|
|
122
|
-
&self,
|
|
123
|
-
auth_mode: AuthMode,
|
|
124
|
-
model_family: &str,
|
|
125
|
-
structure_hash: &str,
|
|
126
|
-
) -> Option<&Recommendation> {
|
|
127
|
-
// HashMap::get on a tuple key requires `Borrow` on tuples,
|
|
128
|
-
// which Rust doesn't provide for mixed `&str`/`String` tuples.
|
|
129
|
-
// Allocate a short-lived owned key — recommendation lookups
|
|
130
|
-
// happen once per request at most, so this isn't hot.
|
|
131
|
-
let key = (
|
|
132
|
-
auth_mode.as_str().to_string(),
|
|
133
|
-
model_family.to_string(),
|
|
134
|
-
structure_hash.to_string(),
|
|
135
|
-
);
|
|
136
|
-
self.by_key.get(&key)
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
/// Parse a TOML string into a [`RecommendationStore`].
|
|
140
|
-
pub fn from_toml_str(s: &str) -> Result<Self, RecommendationsError> {
|
|
141
|
-
let parsed: RecommendationFile = toml::from_str(s).map_err(RecommendationsError::Parse)?;
|
|
142
|
-
let mut by_key = HashMap::with_capacity(parsed.recommendation.len());
|
|
143
|
-
for row in parsed.recommendation {
|
|
144
|
-
let key = (
|
|
145
|
-
row.auth_mode.clone(),
|
|
146
|
-
row.model_family.clone(),
|
|
147
|
-
row.structure_hash.clone(),
|
|
148
|
-
);
|
|
149
|
-
by_key.insert(key, row);
|
|
150
|
-
}
|
|
151
|
-
Ok(Self { by_key })
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
/// Read a TOML file from disk and parse it.
|
|
155
|
-
///
|
|
156
|
-
/// Missing files yield [`RecommendationsError::Missing`] —
|
|
157
|
-
/// callers usually downgrade that to "use defaults" without
|
|
158
|
-
/// panicking. Malformed files surface [`RecommendationsError::Parse`].
|
|
159
|
-
pub fn from_file(path: impl AsRef<Path>) -> Result<Self, RecommendationsError> {
|
|
160
|
-
let path = path.as_ref();
|
|
161
|
-
let text = std::fs::read_to_string(path).map_err(|e| {
|
|
162
|
-
if e.kind() == std::io::ErrorKind::NotFound {
|
|
163
|
-
RecommendationsError::Missing(path.to_path_buf())
|
|
164
|
-
} else {
|
|
165
|
-
RecommendationsError::Io {
|
|
166
|
-
path: path.to_path_buf(),
|
|
167
|
-
source: e,
|
|
168
|
-
}
|
|
169
|
-
}
|
|
170
|
-
})?;
|
|
171
|
-
Self::from_toml_str(&text)
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
/// Best-effort load: returns an empty store and logs structured
|
|
175
|
-
/// warnings when the file is missing or malformed. This is the
|
|
176
|
-
/// path the Rust proxy uses at startup — it's not fatal for the
|
|
177
|
-
/// publish pipeline to be down.
|
|
178
|
-
pub fn load_or_empty(path: impl AsRef<Path>) -> Self {
|
|
179
|
-
let path = path.as_ref();
|
|
180
|
-
match Self::from_file(path) {
|
|
181
|
-
Ok(store) => {
|
|
182
|
-
tracing::info!(
|
|
183
|
-
event = "recommendations_loaded",
|
|
184
|
-
path = %path.display(),
|
|
185
|
-
rows = store.len(),
|
|
186
|
-
"TOIN recommendations loaded",
|
|
187
|
-
);
|
|
188
|
-
store
|
|
189
|
-
}
|
|
190
|
-
Err(RecommendationsError::Missing(_)) => {
|
|
191
|
-
tracing::info!(
|
|
192
|
-
event = "recommendations_missing",
|
|
193
|
-
path = %path.display(),
|
|
194
|
-
"no recommendations.toml present; using static defaults",
|
|
195
|
-
);
|
|
196
|
-
Self::empty()
|
|
197
|
-
}
|
|
198
|
-
Err(err) => {
|
|
199
|
-
tracing::warn!(
|
|
200
|
-
event = "recommendations_load_failed",
|
|
201
|
-
path = %path.display(),
|
|
202
|
-
error = %err,
|
|
203
|
-
"TOIN recommendations failed to load — falling back to empty store",
|
|
204
|
-
);
|
|
205
|
-
Self::empty()
|
|
206
|
-
}
|
|
207
|
-
}
|
|
208
|
-
}
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
/// Process-wide store populated at first call to [`load_default`].
|
|
212
|
-
static GLOBAL: OnceLock<RecommendationStore> = OnceLock::new();
|
|
213
|
-
|
|
214
|
-
/// Compute the path the loader will read.
|
|
215
|
-
///
|
|
216
|
-
/// Honors `HEADROOM_RECOMMENDATIONS_PATH` for prod overrides; falls
|
|
217
|
-
/// back to [`DEFAULT_RECOMMENDATIONS_PATH`].
|
|
218
|
-
pub fn default_path() -> PathBuf {
|
|
219
|
-
std::env::var(RECOMMENDATIONS_PATH_ENV_VAR)
|
|
220
|
-
.map(PathBuf::from)
|
|
221
|
-
.unwrap_or_else(|_| PathBuf::from(DEFAULT_RECOMMENDATIONS_PATH))
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
/// Initialize and return the global [`RecommendationStore`].
|
|
225
|
-
///
|
|
226
|
-
/// On first call, reads the file at [`default_path`]; subsequent calls
|
|
227
|
-
/// return the cached store. Idempotent and thread-safe via [`OnceLock`].
|
|
228
|
-
pub fn load_default() -> &'static RecommendationStore {
|
|
229
|
-
GLOBAL.get_or_init(|| RecommendationStore::load_or_empty(default_path()))
|
|
230
|
-
}
|
|
231
|
-
|
|
232
|
-
/// Module-level convenience: look up a recommendation in the global
|
|
233
|
-
/// store. PR-F3 will wire this into `dispatch_compressor`. PR-B5 only
|
|
234
|
-
/// exposes the API surface.
|
|
235
|
-
pub fn get(
|
|
236
|
-
auth_mode: AuthMode,
|
|
237
|
-
model: &str,
|
|
238
|
-
structure_hash: &str,
|
|
239
|
-
) -> Option<&'static Recommendation> {
|
|
240
|
-
load_default().lookup(auth_mode, model, structure_hash)
|
|
241
|
-
}
|
|
242
|
-
|
|
243
|
-
/// Errors surfaced by the loader. Marked non-exhaustive so we can add
|
|
244
|
-
/// future variants without breaking callers.
|
|
245
|
-
#[derive(Debug, thiserror::Error)]
|
|
246
|
-
#[non_exhaustive]
|
|
247
|
-
pub enum RecommendationsError {
|
|
248
|
-
/// File doesn't exist on disk.
|
|
249
|
-
#[error("recommendations file not found: {0}")]
|
|
250
|
-
Missing(PathBuf),
|
|
251
|
-
/// Filesystem error other than NotFound.
|
|
252
|
-
#[error("recommendations IO error at {path}: {source}")]
|
|
253
|
-
Io {
|
|
254
|
-
path: PathBuf,
|
|
255
|
-
#[source]
|
|
256
|
-
source: std::io::Error,
|
|
257
|
-
},
|
|
258
|
-
/// TOML parse failure (typed wrapper for ergonomics).
|
|
259
|
-
#[error("recommendations TOML parse error: {0}")]
|
|
260
|
-
Parse(#[from] toml::de::Error),
|
|
261
|
-
}
|
|
262
|
-
|
|
263
|
-
#[cfg(test)]
|
|
264
|
-
mod tests {
|
|
265
|
-
use super::*;
|
|
266
|
-
|
|
267
|
-
fn sample_toml() -> &'static str {
|
|
268
|
-
r#"
|
|
269
|
-
[[recommendation]]
|
|
270
|
-
auth_mode = "payg"
|
|
271
|
-
model_family = "claude-3-5"
|
|
272
|
-
structure_hash = "deadbeef"
|
|
273
|
-
strategy_hint = "smart_crusher"
|
|
274
|
-
confidence = 0.87
|
|
275
|
-
observations = 142
|
|
276
|
-
|
|
277
|
-
[[recommendation]]
|
|
278
|
-
auth_mode = "oauth"
|
|
279
|
-
model_family = "gpt-4o"
|
|
280
|
-
structure_hash = "cafebabe"
|
|
281
|
-
strategy_hint = "log_compressor"
|
|
282
|
-
confidence = 0.42
|
|
283
|
-
observations = 60
|
|
284
|
-
"#
|
|
285
|
-
}
|
|
286
|
-
|
|
287
|
-
#[test]
|
|
288
|
-
fn from_toml_str_indexes_by_tuple_key() {
|
|
289
|
-
let store = RecommendationStore::from_toml_str(sample_toml()).expect("parses");
|
|
290
|
-
assert_eq!(store.len(), 2);
|
|
291
|
-
|
|
292
|
-
let r = store
|
|
293
|
-
.lookup(AuthMode::Payg, "claude-3-5", "deadbeef")
|
|
294
|
-
.expect("hit");
|
|
295
|
-
assert_eq!(r.strategy_hint, "smart_crusher");
|
|
296
|
-
assert!((r.confidence - 0.87).abs() < 1e-9);
|
|
297
|
-
assert_eq!(r.observations, 142);
|
|
298
|
-
}
|
|
299
|
-
|
|
300
|
-
#[test]
|
|
301
|
-
fn lookup_returns_none_for_missing_slice() {
|
|
302
|
-
let store = RecommendationStore::from_toml_str(sample_toml()).expect("parses");
|
|
303
|
-
assert!(store
|
|
304
|
-
.lookup(AuthMode::Unknown, "gpt-4o", "cafebabe")
|
|
305
|
-
.is_none());
|
|
306
|
-
}
|
|
307
|
-
|
|
308
|
-
#[test]
|
|
309
|
-
fn empty_store_lookup_is_none() {
|
|
310
|
-
let store = RecommendationStore::empty();
|
|
311
|
-
assert!(store.is_empty());
|
|
312
|
-
assert!(store.lookup(AuthMode::Payg, "claude-3-5", "any").is_none());
|
|
313
|
-
}
|
|
314
|
-
|
|
315
|
-
#[test]
|
|
316
|
-
fn malformed_toml_yields_parse_error() {
|
|
317
|
-
let bad = "this is not valid toml [[\n\n";
|
|
318
|
-
let err = RecommendationStore::from_toml_str(bad).unwrap_err();
|
|
319
|
-
assert!(matches!(err, RecommendationsError::Parse(_)));
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
#[test]
|
|
323
|
-
fn auth_mode_strings_match_python_publish_cli() {
|
|
324
|
-
assert_eq!(AuthMode::Payg.as_str(), "payg");
|
|
325
|
-
assert_eq!(AuthMode::OAuth.as_str(), "oauth");
|
|
326
|
-
assert_eq!(AuthMode::Subscription.as_str(), "subscription");
|
|
327
|
-
assert_eq!(AuthMode::Unknown.as_str(), "unknown");
|
|
328
|
-
}
|
|
329
|
-
}
|