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,338 +0,0 @@
|
|
|
1
|
-
# Phase E — Phase 3 Cache Stabilization
|
|
2
|
-
|
|
3
|
-
**Goal:** Add the cache-stabilization surface that today is **completely missing**: tool array deterministic sort, recursive JSON Schema key sort, auto `cache_control` placement (Anthropic), `prompt_cache_key` auto-injection (OpenAI), volatile-content detector with customer warning (no rewrite), cache-bust drift telemetry. These are guide §8.5, §9.11, §6.2, §4.17 implementations and the "Phase 3" of the guide's implementation checklist.
|
|
4
|
-
|
|
5
|
-
**Calendar:** 1 week.
|
|
6
|
-
|
|
7
|
-
**Shape:** 6 PRs. Mostly parallel; E3 + E4 should land paired (per-mode policy).
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## PR-E1 — Tool array deterministic sort (Rust)
|
|
12
|
-
|
|
13
|
-
**Branch:** `realign-E1-tool-array-sort`
|
|
14
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E1-tool-array-sort`
|
|
15
|
-
**Risk:** **LOW**
|
|
16
|
-
**LOC:** +200
|
|
17
|
-
|
|
18
|
-
### Scope
|
|
19
|
-
Eliminate P3-28. Sort `tools[]` alphabetically by name on the way out. Idempotent: re-sorting an already-sorted array is a no-op. Implementation matches Python's existing `_sort_tools_deterministically` (`headroom/proxy/handlers/anthropic.py:34-58`) — same sort key, same output bytes (modulo serialization).
|
|
20
|
-
|
|
21
|
-
### Files
|
|
22
|
-
|
|
23
|
-
**Add:**
|
|
24
|
-
- `crates/headroom-proxy/src/compression/tool_def_normalize.rs`:
|
|
25
|
-
```rust
|
|
26
|
-
pub fn sort_tools_deterministically(tools: &mut Vec<&RawValue>) -> Result<()> {
|
|
27
|
-
// Sort key: tool["name"] string, fallback to MD5(serialized) for unnamed tools.
|
|
28
|
-
tools.sort_by_key(|t| {
|
|
29
|
-
let parsed: serde_json::Value = serde_json::from_str(t.get()).unwrap_or_default();
|
|
30
|
-
parsed.get("name").and_then(|v| v.as_str()).unwrap_or("").to_string()
|
|
31
|
-
});
|
|
32
|
-
Ok(())
|
|
33
|
-
}
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
**Modify:**
|
|
37
|
-
- `crates/headroom-proxy/src/compression/live_zone_anthropic.rs` — call `sort_tools_deterministically` on the request body's `tools` array before forwarding (only on PAYG; gated by Phase F PR-F2).
|
|
38
|
-
- `crates/headroom-proxy/src/compression/live_zone_openai.rs` — same.
|
|
39
|
-
- `crates/headroom-proxy/src/compression/live_zone_responses.rs` — same.
|
|
40
|
-
|
|
41
|
-
**Tests added:**
|
|
42
|
-
- `crates/headroom-proxy/tests/integration_tool_sort.rs::sort_alphabetic_by_name`
|
|
43
|
-
- `crates/headroom-proxy/tests/integration_tool_sort.rs::idempotent_resort_no_change`
|
|
44
|
-
- `crates/headroom-proxy/tests/integration_tool_sort.rs::byte_stable_across_runs`
|
|
45
|
-
|
|
46
|
-
### Acceptance criteria
|
|
47
|
-
|
|
48
|
-
- Tests pass.
|
|
49
|
-
- Output `tools[]` byte-equal between Rust and Python sort implementations.
|
|
50
|
-
|
|
51
|
-
### Blocked by
|
|
52
|
-
|
|
53
|
-
PR-B2.
|
|
54
|
-
|
|
55
|
-
### Blocks
|
|
56
|
-
|
|
57
|
-
PR-E2.
|
|
58
|
-
|
|
59
|
-
### Rollback
|
|
60
|
-
|
|
61
|
-
`git revert`. Rust path matches client's tool order (subject to the cache-bust risk).
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
65
|
-
## PR-E2 — Recursive JSON Schema key sort
|
|
66
|
-
|
|
67
|
-
**Branch:** `realign-E2-schema-key-sort`
|
|
68
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E2-schema-key-sort`
|
|
69
|
-
**Risk:** **MEDIUM** (recursive sort over tool schemas; risk of breaking schema semantics if there's an `if`/`then`/`else` or `oneOf` ordering invariant — there isn't, but verify)
|
|
70
|
-
**LOC:** +300
|
|
71
|
-
|
|
72
|
-
### Scope
|
|
73
|
-
Eliminate P3-29. Recursively sort JSON Schema object keys in every tool's `input_schema`. This includes nested `properties`, `definitions`, `oneOf`, `anyOf`, `allOf`, `if/then/else`, `additionalProperties`, etc.
|
|
74
|
-
|
|
75
|
-
### Files
|
|
76
|
-
|
|
77
|
-
**Modify:**
|
|
78
|
-
- `crates/headroom-proxy/src/compression/tool_def_normalize.rs` — add `sort_schema_keys_recursive`. Walks every Object node; replaces with `IndexMap` rebuilt in alphabetic key order. Preserves Array order (JSON Schema arrays are ordered: `prefixItems`, `oneOf` alternatives, etc.).
|
|
79
|
-
|
|
80
|
-
**Tests added:**
|
|
81
|
-
- `crates/headroom-proxy/tests/integration_schema_sort.rs::flat_schema_keys_sorted`
|
|
82
|
-
- `crates/headroom-proxy/tests/integration_schema_sort.rs::nested_properties_sorted`
|
|
83
|
-
- `crates/headroom-proxy/tests/integration_schema_sort.rs::oneof_array_order_preserved`
|
|
84
|
-
- `crates/headroom-proxy/tests/integration_schema_sort.rs::definitions_keys_sorted`
|
|
85
|
-
- `crates/headroom-proxy/tests/integration_schema_sort.rs::idempotent_resort`
|
|
86
|
-
|
|
87
|
-
### Acceptance criteria
|
|
88
|
-
|
|
89
|
-
- Tests pass.
|
|
90
|
-
- Snapshot test on a real production tool schema (e.g., Claude Code's `Read` tool) — pin the sorted bytes.
|
|
91
|
-
|
|
92
|
-
### Blocked by
|
|
93
|
-
|
|
94
|
-
PR-E1.
|
|
95
|
-
|
|
96
|
-
### Blocks
|
|
97
|
-
|
|
98
|
-
PR-E5.
|
|
99
|
-
|
|
100
|
-
### Rollback
|
|
101
|
-
|
|
102
|
-
`git revert`. Schema keys reflect customer ordering.
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## PR-E3 — Auto `cache_control` breakpoint placement (Anthropic)
|
|
107
|
-
|
|
108
|
-
**Branch:** `realign-E3-cache-control-auto-place`
|
|
109
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E3-cache-control-auto-place`
|
|
110
|
-
**Risk:** **MEDIUM-HIGH** (auto-adds bytes to client request — only on PAYG)
|
|
111
|
-
**LOC:** +400
|
|
112
|
-
|
|
113
|
-
### Scope
|
|
114
|
-
Eliminate P3-31. When PAYG mode is detected (Phase F PR-F1) and the customer has not set any `cache_control` markers, auto-place up to 4 ephemeral markers at:
|
|
115
|
-
1. End of system prompt (1 marker)
|
|
116
|
-
2. End of `tools[]` (1 marker)
|
|
117
|
-
3. After the last stable conversation history boundary (1 marker; configurable threshold for "stable")
|
|
118
|
-
4. Before the latest user message (1 marker)
|
|
119
|
-
|
|
120
|
-
OAuth and subscription modes: never auto-place (could void scope).
|
|
121
|
-
|
|
122
|
-
### Files
|
|
123
|
-
|
|
124
|
-
**Add:**
|
|
125
|
-
- `crates/headroom-proxy/src/compression/cache_control.rs` — `pub fn auto_place_breakpoints(body: &mut serde_json::Value, auth_mode: AuthMode)`. Walks the structure; appends `cache_control: {type: "ephemeral"}` to the trailing block of system, tools, history, and current user message.
|
|
126
|
-
|
|
127
|
-
**Modify:**
|
|
128
|
-
- `crates/headroom-proxy/src/compression/live_zone_anthropic.rs` — call `auto_place_breakpoints` on PAYG only.
|
|
129
|
-
|
|
130
|
-
**Tests added:**
|
|
131
|
-
- `crates/headroom-proxy/tests/integration_cache_control_auto.rs::payg_auto_places_4_markers`
|
|
132
|
-
- `crates/headroom-proxy/tests/integration_cache_control_auto.rs::oauth_no_auto_placement`
|
|
133
|
-
- `crates/headroom-proxy/tests/integration_cache_control_auto.rs::subscription_no_auto_placement`
|
|
134
|
-
- `crates/headroom-proxy/tests/integration_cache_control_auto.rs::customer_set_markers_respected_no_addition`
|
|
135
|
-
- `crates/headroom-proxy/tests/integration_cache_control_auto.rs::ttl_ordering_correct_1h_before_5m`
|
|
136
|
-
|
|
137
|
-
### Acceptance criteria
|
|
138
|
-
|
|
139
|
-
- Tests pass.
|
|
140
|
-
- Customer requests with existing markers are unmodified.
|
|
141
|
-
- A representative PAYG request gets 4 markers in the right positions.
|
|
142
|
-
|
|
143
|
-
### Blocked by
|
|
144
|
-
|
|
145
|
-
PR-A4, PR-F1, PR-F2.
|
|
146
|
-
|
|
147
|
-
### Blocks
|
|
148
|
-
|
|
149
|
-
None.
|
|
150
|
-
|
|
151
|
-
### Rollback
|
|
152
|
-
|
|
153
|
-
`git revert`. Customers without their own `cache_control` markers don't get auto-placement; cache benefit smaller but correct.
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## PR-E4 — `prompt_cache_key` auto-injection (OpenAI)
|
|
158
|
-
|
|
159
|
-
**Branch:** `realign-E4-prompt-cache-key-inject`
|
|
160
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E4-prompt-cache-key-inject`
|
|
161
|
-
**Risk:** **MEDIUM**
|
|
162
|
-
**LOC:** +250
|
|
163
|
-
|
|
164
|
-
### Scope
|
|
165
|
-
Eliminate P3-30. For OpenAI Chat Completions and Responses requests on PAYG mode where the customer has not set `prompt_cache_key`, auto-inject one derived from a stable session hash. OAuth/subscription modes: never inject (the CLI may already populate this and Headroom must preserve byte-for-byte).
|
|
166
|
-
|
|
167
|
-
### Files
|
|
168
|
-
|
|
169
|
-
**Modify:**
|
|
170
|
-
- `crates/headroom-proxy/src/compression/live_zone_openai.rs` — add `inject_prompt_cache_key` step.
|
|
171
|
-
- `crates/headroom-proxy/src/compression/live_zone_responses.rs` — same.
|
|
172
|
-
|
|
173
|
-
**Add:**
|
|
174
|
-
- `crates/headroom-proxy/src/session.rs` — `pub fn derive_prompt_cache_key(session_id: &str, model: &str) -> String` — returns `{session_id}_{model_family}` (deterministic per session+model).
|
|
175
|
-
|
|
176
|
-
**Tests added:**
|
|
177
|
-
- `crates/headroom-proxy/tests/integration_prompt_cache_key.rs::payg_auto_injects_when_absent`
|
|
178
|
-
- `crates/headroom-proxy/tests/integration_prompt_cache_key.rs::customer_value_preserved`
|
|
179
|
-
- `crates/headroom-proxy/tests/integration_prompt_cache_key.rs::oauth_no_injection`
|
|
180
|
-
- `crates/headroom-proxy/tests/integration_prompt_cache_key.rs::subscription_no_injection`
|
|
181
|
-
- `crates/headroom-proxy/tests/integration_prompt_cache_key.rs::same_session_same_key_deterministic`
|
|
182
|
-
|
|
183
|
-
### Acceptance criteria
|
|
184
|
-
|
|
185
|
-
- Tests pass.
|
|
186
|
-
|
|
187
|
-
### Blocked by
|
|
188
|
-
|
|
189
|
-
PR-F1, PR-F2.
|
|
190
|
-
|
|
191
|
-
### Blocks
|
|
192
|
-
|
|
193
|
-
None.
|
|
194
|
-
|
|
195
|
-
### Rollback
|
|
196
|
-
|
|
197
|
-
`git revert`. OpenAI cache routing less sticky on PAYG; functional.
|
|
198
|
-
|
|
199
|
-
---
|
|
200
|
-
|
|
201
|
-
## PR-E5 — Volatile-content detector with customer warning (no rewrite)
|
|
202
|
-
|
|
203
|
-
**Branch:** `realign-E5-volatile-detector`
|
|
204
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E5-volatile-detector`
|
|
205
|
-
**Risk:** **LOW**
|
|
206
|
-
**LOC:** +400
|
|
207
|
-
|
|
208
|
-
### Scope
|
|
209
|
-
Eliminate P3-32. Detect dynamic content in the early prompt (timestamps, UUIDs, JWT tokens, build hashes, randomized IDs) and surface to the customer via a log line and a Prometheus metric. **Do not rewrite.** This is what Python's `cache_aligner.py` was *trying* to do correctly (the rewrite path is gone in Phase A PR-A2).
|
|
210
|
-
|
|
211
|
-
### Files
|
|
212
|
-
|
|
213
|
-
**Add:**
|
|
214
|
-
- `crates/headroom-core/src/transforms/volatile_detector.rs`:
|
|
215
|
-
```rust
|
|
216
|
-
pub struct VolatileDetector { /* compiled regex set */ }
|
|
217
|
-
|
|
218
|
-
impl VolatileDetector {
|
|
219
|
-
pub fn scan(&self, content: &str) -> Vec<VolatileFinding>;
|
|
220
|
-
}
|
|
221
|
-
|
|
222
|
-
pub struct VolatileFinding {
|
|
223
|
-
pub kind: VolatileKind, // Timestamp | Uuid | Jwt | BuildHash | ...
|
|
224
|
-
pub byte_offset: usize,
|
|
225
|
-
pub matched: String,
|
|
226
|
-
pub recommendation: String, // "Move to metadata"
|
|
227
|
-
}
|
|
228
|
-
```
|
|
229
|
-
Patterns:
|
|
230
|
-
- ISO 8601 timestamp regex
|
|
231
|
-
- UUID v4 regex
|
|
232
|
-
- JWT shape (`eyJ...`)
|
|
233
|
-
- Long hex strings >=32 chars (build hashes)
|
|
234
|
-
- Unix epoch timestamps within an order of magnitude of `now`
|
|
235
|
-
|
|
236
|
-
**Modify:**
|
|
237
|
-
- `crates/headroom-proxy/src/compression/live_zone_anthropic.rs` — run scanner on system prompt; if findings, log warning and increment metric.
|
|
238
|
-
- `crates/headroom-proxy/src/compression/live_zone_openai.rs` — same on `instructions` field.
|
|
239
|
-
- `crates/headroom-proxy/src/compression/live_zone_responses.rs` — same.
|
|
240
|
-
|
|
241
|
-
**Tests added:**
|
|
242
|
-
- `crates/headroom-core/tests/volatile_detector.rs::detects_iso_8601_timestamp`
|
|
243
|
-
- `crates/headroom-core/tests/volatile_detector.rs::detects_uuid_v4`
|
|
244
|
-
- `crates/headroom-core/tests/volatile_detector.rs::detects_jwt_shape`
|
|
245
|
-
- `crates/headroom-core/tests/volatile_detector.rs::detects_build_hash`
|
|
246
|
-
- `crates/headroom-core/tests/volatile_detector.rs::no_false_positives_on_normal_prose`
|
|
247
|
-
- `crates/headroom-proxy/tests/integration_volatile.rs::warning_logged_on_volatile_system_prompt`
|
|
248
|
-
- `crates/headroom-proxy/tests/integration_volatile.rs::system_prompt_bytes_unchanged`
|
|
249
|
-
|
|
250
|
-
### Acceptance criteria
|
|
251
|
-
|
|
252
|
-
- Tests pass.
|
|
253
|
-
- Detector runs in <1ms on a 4KB system prompt (don't slow the request path).
|
|
254
|
-
|
|
255
|
-
### Blocked by
|
|
256
|
-
|
|
257
|
-
PR-E2.
|
|
258
|
-
|
|
259
|
-
### Blocks
|
|
260
|
-
|
|
261
|
-
None.
|
|
262
|
-
|
|
263
|
-
### Rollback
|
|
264
|
-
|
|
265
|
-
`git revert`. Detector loses; no functional regression.
|
|
266
|
-
|
|
267
|
-
---
|
|
268
|
-
|
|
269
|
-
## PR-E6 — Cache-bust drift detector telemetry
|
|
270
|
-
|
|
271
|
-
**Branch:** `realign-E6-cache-bust-detector`
|
|
272
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-E6-cache-bust-detector`
|
|
273
|
-
**Risk:** **LOW**
|
|
274
|
-
**LOC:** +500
|
|
275
|
-
|
|
276
|
-
### Scope
|
|
277
|
-
Eliminate P3-35. Hash the prefix (system + tools + first N stable messages) of every request. Track per-session prefix hashes. When the prefix hash changes between turns, increment a counter and log a `prefix_drift` event with which subsystem mutated (likely none after Phase A — but if it happens, we want to know).
|
|
278
|
-
|
|
279
|
-
### Files
|
|
280
|
-
|
|
281
|
-
**Add:**
|
|
282
|
-
- `crates/headroom-proxy/src/observability/prefix_drift.rs`:
|
|
283
|
-
```rust
|
|
284
|
-
pub struct PrefixDriftDetector {
|
|
285
|
-
// Keyed by session_id; stores last-seen prefix hash + timestamp.
|
|
286
|
-
cache: Cache<SessionId, (PrefixHash, Instant)>,
|
|
287
|
-
}
|
|
288
|
-
|
|
289
|
-
impl PrefixDriftDetector {
|
|
290
|
-
pub fn check(&self, session_id: &str, body: &serde_json::Value) -> DriftCheck;
|
|
291
|
-
}
|
|
292
|
-
|
|
293
|
-
pub enum DriftCheck {
|
|
294
|
-
FirstSeen,
|
|
295
|
-
Stable,
|
|
296
|
-
Drifted { previous_hash: PrefixHash, new_hash: PrefixHash, age: Duration },
|
|
297
|
-
}
|
|
298
|
-
```
|
|
299
|
-
|
|
300
|
-
**Modify:**
|
|
301
|
-
- `crates/headroom-proxy/src/observability/prometheus.rs` — add `prefix_drift_detected_total{provider, model}` counter.
|
|
302
|
-
|
|
303
|
-
**Tests added:**
|
|
304
|
-
- `crates/headroom-proxy/tests/integration_prefix_drift.rs::stable_prefix_no_drift`
|
|
305
|
-
- `crates/headroom-proxy/tests/integration_prefix_drift.rs::system_change_detected_as_drift`
|
|
306
|
-
- `crates/headroom-proxy/tests/integration_prefix_drift.rs::tools_reorder_detected`
|
|
307
|
-
|
|
308
|
-
### Acceptance criteria
|
|
309
|
-
|
|
310
|
-
- Tests pass.
|
|
311
|
-
- A canary request that mutates the system prompt mid-session triggers the counter.
|
|
312
|
-
|
|
313
|
-
### Blocked by
|
|
314
|
-
|
|
315
|
-
PR-B2.
|
|
316
|
-
|
|
317
|
-
### Blocks
|
|
318
|
-
|
|
319
|
-
None.
|
|
320
|
-
|
|
321
|
-
### Rollback
|
|
322
|
-
|
|
323
|
-
`git revert`. Loses observability; no functional regression.
|
|
324
|
-
|
|
325
|
-
---
|
|
326
|
-
|
|
327
|
-
## Phase E acceptance summary
|
|
328
|
-
|
|
329
|
-
After all 6 PRs land:
|
|
330
|
-
|
|
331
|
-
- ✅ Tools alphabetically sorted (deterministic, idempotent)
|
|
332
|
-
- ✅ JSON Schema keys recursively sorted
|
|
333
|
-
- ✅ `cache_control` auto-placement on PAYG (4 markers)
|
|
334
|
-
- ✅ `prompt_cache_key` auto-injection on PAYG (OpenAI)
|
|
335
|
-
- ✅ Volatile-content detector + customer warning (no rewrite)
|
|
336
|
-
- ✅ Cache-bust drift telemetry per session
|
|
337
|
-
|
|
338
|
-
**Phase E retires P3-28 through P3-32, P3-35.**
|
|
@@ -1,254 +0,0 @@
|
|
|
1
|
-
# Phase F — Auth-Mode Policy Gates
|
|
2
|
-
|
|
3
|
-
**Goal:** Make auth mode a first-class policy axis. Detect (PAYG / OAuth / subscription) at request entry; gate compression behavior, header injection, and TOIN aggregation per mode. Stealth mode for subscription CLIs.
|
|
4
|
-
|
|
5
|
-
**Calendar:** 1 week.
|
|
6
|
-
|
|
7
|
-
**Shape:** 4 PRs. F1 first; F2 + F3 + F4 parallel after.
|
|
8
|
-
|
|
9
|
-
Reference: `~/.claude/projects/-Users-tchopra-claude-projects-headroom/memory/project_auth_mode_compression_nuances.md`.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## PR-F1 — `classify_auth_mode` helper
|
|
14
|
-
|
|
15
|
-
**Branch:** `realign-F1-classify-auth-mode`
|
|
16
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-F1-classify-auth-mode`
|
|
17
|
-
**Risk:** **LOW**
|
|
18
|
-
**LOC:** +500
|
|
19
|
-
|
|
20
|
-
### Scope
|
|
21
|
-
Single helper called at request entry returning `AuthMode = Payg | OAuth | Subscription`. Pure-function classification from headers (Authorization shape, OpenAI-Beta, anthropic-beta) and User-Agent prefix.
|
|
22
|
-
|
|
23
|
-
### Files
|
|
24
|
-
|
|
25
|
-
**Add:**
|
|
26
|
-
- `crates/headroom-core/src/auth_mode.rs`:
|
|
27
|
-
```rust
|
|
28
|
-
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
|
29
|
-
pub enum AuthMode { Payg, OAuth, Subscription }
|
|
30
|
-
|
|
31
|
-
pub fn classify(headers: &http::HeaderMap) -> AuthMode {
|
|
32
|
-
let ua = headers.get("user-agent").and_then(|h| h.to_str().ok()).unwrap_or("").to_lowercase();
|
|
33
|
-
const SUBSCRIPTION_UA_PREFIXES: &[&str] = &[
|
|
34
|
-
"claude-cli/", "claude-code/", "codex-cli/", "cursor/",
|
|
35
|
-
"claude-vscode/", "github-copilot/", "anthropic-cli/", "antigravity/",
|
|
36
|
-
];
|
|
37
|
-
if SUBSCRIPTION_UA_PREFIXES.iter().any(|p| ua.contains(p)) {
|
|
38
|
-
return AuthMode::Subscription;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
let auth = headers.get("authorization").and_then(|h| h.to_str().ok()).unwrap_or("");
|
|
42
|
-
if auth.starts_with("Bearer ") {
|
|
43
|
-
let token = &auth[7..];
|
|
44
|
-
if token.starts_with("sk-ant-api") || token.starts_with("sk-") {
|
|
45
|
-
return AuthMode::Payg;
|
|
46
|
-
}
|
|
47
|
-
if token.starts_with("sk-ant-oat-") || token.split('.').count() >= 3 {
|
|
48
|
-
// sk-ant-oat-* (Claude Pro OAuth) or JWT (Codex/Cursor OAuth)
|
|
49
|
-
return AuthMode::OAuth;
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
// Bedrock / Vertex (no Authorization header from client; signed downstream)
|
|
54
|
-
if !auth.is_empty() == false
|
|
55
|
-
&& headers.get("x-api-key").is_none()
|
|
56
|
-
&& headers.get("x-goog-api-key").is_none()
|
|
57
|
-
{
|
|
58
|
-
return AuthMode::OAuth;
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
// x-api-key present (Anthropic API key style)
|
|
62
|
-
if headers.contains_key("x-api-key") {
|
|
63
|
-
return AuthMode::Payg;
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
AuthMode::Payg // default
|
|
67
|
-
}
|
|
68
|
-
```
|
|
69
|
-
|
|
70
|
-
**Add (Python):**
|
|
71
|
-
- `headroom/proxy/auth_mode.py` — Python port of the same logic. Used in Python paths until Phase H deletes them.
|
|
72
|
-
|
|
73
|
-
**Modify:**
|
|
74
|
-
- `crates/headroom-core/src/lib.rs` — `pub mod auth_mode;`.
|
|
75
|
-
- `crates/headroom-proxy/src/proxy.rs` — call `classify` at request entry; store in request extensions for downstream handlers.
|
|
76
|
-
- `headroom/proxy/handlers/anthropic.py` — call Python `classify_auth_mode(headers)` at request entry.
|
|
77
|
-
- `headroom/proxy/handlers/openai.py` — same.
|
|
78
|
-
|
|
79
|
-
**Tests added:**
|
|
80
|
-
- `crates/headroom-core/tests/auth_mode.rs::api_key_classified_payg`
|
|
81
|
-
- `crates/headroom-core/tests/auth_mode.rs::oauth_jwt_classified_oauth`
|
|
82
|
-
- `crates/headroom-core/tests/auth_mode.rs::oauth_sk_ant_oat_classified_oauth`
|
|
83
|
-
- `crates/headroom-core/tests/auth_mode.rs::claude_code_ua_classified_subscription`
|
|
84
|
-
- `crates/headroom-core/tests/auth_mode.rs::cursor_ua_classified_subscription`
|
|
85
|
-
- `crates/headroom-core/tests/auth_mode.rs::no_auth_no_user_agent_default_payg`
|
|
86
|
-
- `crates/headroom-core/tests/auth_mode.rs::bedrock_no_auth_classified_oauth`
|
|
87
|
-
- Python equivalents in `tests/test_auth_mode.py`.
|
|
88
|
-
|
|
89
|
-
### Acceptance criteria
|
|
90
|
-
|
|
91
|
-
- Tests pass.
|
|
92
|
-
- Detection runs in <10us per call.
|
|
93
|
-
- Documented in `docs/auth-modes.md` with the detection rules and how to extend.
|
|
94
|
-
|
|
95
|
-
### Blocked by
|
|
96
|
-
|
|
97
|
-
None.
|
|
98
|
-
|
|
99
|
-
### Blocks
|
|
100
|
-
|
|
101
|
-
PR-F2, PR-F3, PR-F4.
|
|
102
|
-
|
|
103
|
-
### Rollback
|
|
104
|
-
|
|
105
|
-
`git revert`. All requests treated as PAYG (current behavior).
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
## PR-F2 — Per-mode compression policy gates
|
|
110
|
-
|
|
111
|
-
**Branch:** `realign-F2-per-mode-policy`
|
|
112
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-F2-per-mode-policy`
|
|
113
|
-
**Risk:** **MEDIUM-HIGH** (changes compression behavior per request)
|
|
114
|
-
**LOC:** +600
|
|
115
|
-
|
|
116
|
-
### Scope
|
|
117
|
-
Wire `AuthMode` into every compression decision per the policy matrix in `02-architecture.md §2.4`. PAYG = aggressive (current default). OAuth = passthrough-prefer (no auto-`cache_control`, no auto-`prompt_cache_key`, no lossy compressors). Subscription = stealth (everything OAuth does + preserve `accept-encoding`, never strip; never inject `X-Headroom-*`; never mutate User-Agent).
|
|
118
|
-
|
|
119
|
-
### Files
|
|
120
|
-
|
|
121
|
-
**Modify:**
|
|
122
|
-
- `crates/headroom-proxy/src/compression/live_zone_anthropic.rs` — gate `auto_place_breakpoints` on `auth_mode == Payg`.
|
|
123
|
-
- `crates/headroom-proxy/src/compression/live_zone_openai.rs` — gate `inject_prompt_cache_key` on `auth_mode == Payg`.
|
|
124
|
-
- `crates/headroom-proxy/src/compression/live_zone.rs` — gate lossy compressors (Kompress text) on `auth_mode == Payg`. OAuth and Subscription get lossless-only compression.
|
|
125
|
-
- `crates/headroom-proxy/src/headers.rs:103-117` — `add_x_forwarded_headers` becomes `add_x_forwarded_headers_if(auth_mode)`. Skip on Subscription.
|
|
126
|
-
- `crates/headroom-proxy/src/proxy.rs` — `accept-encoding` strip becomes conditional on `auth_mode != Subscription`.
|
|
127
|
-
- `headroom/proxy/handlers/anthropic.py` — gate Python compression decisions identically.
|
|
128
|
-
- `headroom/proxy/handlers/openai.py` — same.
|
|
129
|
-
|
|
130
|
-
**Tests added:**
|
|
131
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::payg_aggressive_compression`
|
|
132
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::oauth_no_auto_cache_control`
|
|
133
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::oauth_no_auto_prompt_cache_key`
|
|
134
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::oauth_lossless_only`
|
|
135
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::subscription_no_x_forwarded`
|
|
136
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::subscription_preserves_accept_encoding`
|
|
137
|
-
- `crates/headroom-proxy/tests/integration_authmode_policy.rs::subscription_lossless_only`
|
|
138
|
-
|
|
139
|
-
### Acceptance criteria
|
|
140
|
-
|
|
141
|
-
- Tests pass.
|
|
142
|
-
- Manual smoke test: a real Claude Code session through the proxy produces no `X-Forwarded-*` upstream and preserves `accept-encoding`.
|
|
143
|
-
|
|
144
|
-
### Blocked by
|
|
145
|
-
|
|
146
|
-
PR-F1, PR-E3, PR-E4.
|
|
147
|
-
|
|
148
|
-
### Blocks
|
|
149
|
-
|
|
150
|
-
None.
|
|
151
|
-
|
|
152
|
-
### Rollback
|
|
153
|
-
|
|
154
|
-
`git revert`. All requests treated as PAYG. No functional regression for PAYG users; OAuth/Subscription users may see scope-rejection or revocation increase.
|
|
155
|
-
|
|
156
|
-
---
|
|
157
|
-
|
|
158
|
-
## PR-F3 — TOIN per-tenant aggregation key
|
|
159
|
-
|
|
160
|
-
**Branch:** `realign-F3-toin-per-tenant`
|
|
161
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-F3-toin-per-tenant`
|
|
162
|
-
**Risk:** **MEDIUM**
|
|
163
|
-
**LOC:** -200 / +400
|
|
164
|
-
|
|
165
|
-
### Scope
|
|
166
|
-
Eliminate P5-56. Extend TOIN's aggregation key from `structure_hash` to `(auth_mode, model_family, structure_hash)`. Storage key prefix updated; in-memory dicts re-keyed. Existing observations from before this PR are preserved under a `legacy/` prefix and deprecated over the next 30 days.
|
|
167
|
-
|
|
168
|
-
### Files
|
|
169
|
-
|
|
170
|
-
**Modify:**
|
|
171
|
-
- `headroom/telemetry/toin.py:103` — `Pattern` adds `auth_mode: str = "unknown"`, `model_family: str = "unknown"`. (Already covered by Phase B PR-B5; this PR ensures the wiring lands.)
|
|
172
|
-
- `headroom/telemetry/toin.py:477, 496, 727, 729, 1248, 1256` — change aggregation key to tuple.
|
|
173
|
-
- `headroom/telemetry/toin.py` — migration helper that walks the legacy `structure_hash`-only store and copies entries under `("unknown", "unknown", structure_hash)` for graceful degrade.
|
|
174
|
-
- `headroom/telemetry/toin.py` — bumping aggregation key invalidates earlier recommendations; re-publish via the deploy CLI.
|
|
175
|
-
- `headroom/subscription/tracker.py:166` — replace `_current_token: str` (raw OAuth bearer storage) with `_current_token_id: str` (a one-way hash + last-4 chars for debugging). Polling code adapts to use the actual `Authorization` header per request rather than the stored copy.
|
|
176
|
-
|
|
177
|
-
**Tests added:**
|
|
178
|
-
- `tests/test_toin_per_tenant.py::test_aggregation_key_includes_auth_mode_model`
|
|
179
|
-
- `tests/test_toin_per_tenant.py::test_legacy_observations_preserved_under_unknown`
|
|
180
|
-
- `tests/test_toin_per_tenant.py::test_publish_per_auth_mode_writes_separate_recommendations`
|
|
181
|
-
- `tests/test_subscription_tracker_token_hardening.py::test_raw_token_not_stored_in_memory`
|
|
182
|
-
|
|
183
|
-
### Acceptance criteria
|
|
184
|
-
|
|
185
|
-
- Tests pass.
|
|
186
|
-
- Recommendations file becomes structured `recommendations.toml` with sections per `(auth_mode, model_family)`.
|
|
187
|
-
- The subscription tracker token-leak risk closed.
|
|
188
|
-
|
|
189
|
-
### Blocked by
|
|
190
|
-
|
|
191
|
-
PR-B5, PR-F1.
|
|
192
|
-
|
|
193
|
-
### Blocks
|
|
194
|
-
|
|
195
|
-
None.
|
|
196
|
-
|
|
197
|
-
### Rollback
|
|
198
|
-
|
|
199
|
-
`git revert`. TOIN reverts to global aggregation. No functional break.
|
|
200
|
-
|
|
201
|
-
---
|
|
202
|
-
|
|
203
|
-
## PR-F4 — `X-Forwarded-*` conditional in Rust path
|
|
204
|
-
|
|
205
|
-
**Branch:** `realign-F4-x-forwarded-conditional`
|
|
206
|
-
**Worktree:** `~/claude-projects/headroom-worktrees/realign-F4-x-forwarded-conditional`
|
|
207
|
-
**Risk:** **LOW**
|
|
208
|
-
**LOC:** +100
|
|
209
|
-
|
|
210
|
-
### Scope
|
|
211
|
-
Eliminate P5-53. The Rust proxy currently always adds `X-Forwarded-For`, `X-Forwarded-Proto`, `X-Forwarded-Host`, `X-Request-Id` to upstream-bound requests. Make this conditional: PAYG → add; OAuth → add; Subscription → skip (fingerprint risk).
|
|
212
|
-
|
|
213
|
-
### Files
|
|
214
|
-
|
|
215
|
-
**Modify:**
|
|
216
|
-
- `crates/headroom-proxy/src/headers.rs:103-117` — `add_x_forwarded_headers` takes an `AuthMode` parameter; no-ops on Subscription.
|
|
217
|
-
|
|
218
|
-
**Tests added:**
|
|
219
|
-
- `crates/headroom-proxy/tests/integration_x_forwarded_authmode.rs::payg_adds_xfwd`
|
|
220
|
-
- `crates/headroom-proxy/tests/integration_x_forwarded_authmode.rs::oauth_adds_xfwd`
|
|
221
|
-
- `crates/headroom-proxy/tests/integration_x_forwarded_authmode.rs::subscription_no_xfwd`
|
|
222
|
-
|
|
223
|
-
### Acceptance criteria
|
|
224
|
-
|
|
225
|
-
- Tests pass.
|
|
226
|
-
|
|
227
|
-
### Blocked by
|
|
228
|
-
|
|
229
|
-
PR-F1.
|
|
230
|
-
|
|
231
|
-
### Blocks
|
|
232
|
-
|
|
233
|
-
None.
|
|
234
|
-
|
|
235
|
-
### Rollback
|
|
236
|
-
|
|
237
|
-
`git revert`. Headers always added. Mild fingerprint regression for Subscription users.
|
|
238
|
-
|
|
239
|
-
---
|
|
240
|
-
|
|
241
|
-
## Phase F acceptance summary
|
|
242
|
-
|
|
243
|
-
After all 4 PRs land:
|
|
244
|
-
|
|
245
|
-
- ✅ `classify_auth_mode` helper detects PAYG / OAuth / Subscription
|
|
246
|
-
- ✅ Per-mode compression policy gates (auto-cache_control, prompt_cache_key, lossy compressors)
|
|
247
|
-
- ✅ TOIN aggregation key per `(auth_mode, model_family, structure_hash)`
|
|
248
|
-
- ✅ Subscription tracker doesn't store raw OAuth bearer
|
|
249
|
-
- ✅ `X-Forwarded-*` skipped on Subscription mode
|
|
250
|
-
- ✅ `accept-encoding` preserved on Subscription mode
|
|
251
|
-
|
|
252
|
-
**Phase F retires P5-52, P5-53, P5-54, P5-55, P5-56.**
|
|
253
|
-
|
|
254
|
-
After Phase F, fingerprint risk for Subscription CLI users is dramatically reduced.
|