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
package/PR.md
DELETED
|
@@ -1,170 +0,0 @@
|
|
|
1
|
-
## Description
|
|
2
|
-
|
|
3
|
-
Implement unified CI/CD release automation with semantic versioning across all three packages:
|
|
4
|
-
- **Python (xtream-head)** β pip package on PyPI
|
|
5
|
-
- **TypeScript SDK (xtream-head)** β npm package on npmjs.org
|
|
6
|
-
- **OpenClaw plugin (xtream-head-openclaw)** β npm package on npmjs.org and GitHub Package Registry
|
|
7
|
-
|
|
8
|
-
Currently the three packages are independently versioned (0.5.25 / 0.1.0 / 0.1.0). This PR introduces a single-source-of-truth version in `pyproject.toml` that propagates to all packages on every release, driven by conventional commit messages.
|
|
9
|
-
|
|
10
|
-
Fixes #(issue number)
|
|
11
|
-
|
|
12
|
-
## Type of Change
|
|
13
|
-
|
|
14
|
-
- [ ] Bug fix (non-breaking change that fixes an issue)
|
|
15
|
-
- [x] New feature (non-breaking change that adds functionality)
|
|
16
|
-
- [ ] Breaking change (fix or feature that would cause existing functionality to change)
|
|
17
|
-
- [x] Documentation update
|
|
18
|
-
- [ ] Performance improvement
|
|
19
|
-
- [x] Code refactoring (no functional changes)
|
|
20
|
-
|
|
21
|
-
## Changes Made
|
|
22
|
-
|
|
23
|
-
### New Files
|
|
24
|
-
|
|
25
|
-
**Scripts:**
|
|
26
|
-
- `scripts/version-sync.py` β Reads version from `pyproject.toml`, updates all 4 version files. Supports `--version X.Y.Z` and `--bump {major,minor,patch}`.
|
|
27
|
-
- `scripts/changelog-gen.py` β Parses conventional commits since last tag, groups by type, generates markdown changelog with breaking change detection.
|
|
28
|
-
- `scripts/verify-versions.py` β Pre-release sanity check that all 4 version files are in sync.
|
|
29
|
-
- `scripts/tests/test_version_sync.py` β 5 tests for version-sync.py
|
|
30
|
-
- `scripts/tests/test_changelog_gen.py` β 23 tests for changelog-gen.py
|
|
31
|
-
|
|
32
|
-
**Workflows:**
|
|
33
|
-
- `.github/workflows/release.yml` β Unified release pipeline: detect β build β publish-pypi β publish-npm β publish-github-packages β create-release
|
|
34
|
-
- `.commitlintrc.json` β Conventional commit enforcement via `@commitlint/config-conventional`
|
|
35
|
-
|
|
36
|
-
**Local Testing (act):**
|
|
37
|
-
- `.actrc` β Default `act` flags (Ubuntu runner, reuse, quiet)
|
|
38
|
-
- `.github/act/dry-run.json` β `act` event file for dry-run testing
|
|
39
|
-
- `.github/act/push-feat.json` β `act` event file for simulating a feat commit
|
|
40
|
-
- `.actrc.local.example` β Local override template for `act`
|
|
41
|
-
- `.env.act.example` β Secrets documentation template for `act` local testing
|
|
42
|
-
|
|
43
|
-
**Documentation:**
|
|
44
|
-
- `docs/content/docs/releases.mdx` β Full documentation for the release pipeline, testing guide, and configuration reference
|
|
45
|
-
|
|
46
|
-
### Modified Files
|
|
47
|
-
|
|
48
|
-
- `.github/workflows/ci.yml` β Added `commitlint` job to enforce conventional commits
|
|
49
|
-
- `.github/workflows/publish.yml` β Changed from `release` trigger to `workflow_dispatch` only (superseded by `release.yml`)
|
|
50
|
-
- `.github/workflows/release.yml` β **Rewritten** with canonical+commit-height algorithm (no more commit loop)
|
|
51
|
-
- `.gitignore` β Added `!scripts/version-sync.py`, `!scripts/changelog-gen.py`, `!scripts/verify-versions.py`, `!scripts/tests/`, `.env.act`, `.actrc.local`
|
|
52
|
-
|
|
53
|
-
## Testing
|
|
54
|
-
|
|
55
|
-
- [x] Unit tests pass (`pytest`)
|
|
56
|
-
- `scripts/tests/test_version_sync.py` β 5/5 passing
|
|
57
|
-
- `scripts/tests/test_changelog_gen.py` β 23/23 passing
|
|
58
|
-
- [x] Linting passes (`ruff check .`)
|
|
59
|
-
- [ ] Type checking passes (`mypy headroom`) β pre-existing issue in `headroom/cli/wrap.py:487` (unrelated)
|
|
60
|
-
- [x] New tests added for new functionality
|
|
61
|
-
- [x] Workflow tested with `act` (dry-run passes all jobs through build step β no infinite loop)
|
|
62
|
-
|
|
63
|
-
## Algorithm Validation
|
|
64
|
-
|
|
65
|
-
The canonical+commit-height algorithm was validated with test cases:
|
|
66
|
-
- Canonical `0.5.25`, no prior tag, `feat:` commit β git tag `v0.6.0.0`, npm `0.6.0` β
|
|
67
|
-
- Canonical `0.5.25`, tag `v0.5.25.2`, `fix:` commit β git tag `v0.5.25.3`, npm `0.5.26` β
|
|
68
|
-
- Canonical `0.5.25`, no prior tag, `fix:` commit β git tag `v0.5.25.0`, npm `0.5.25` β
|
|
69
|
-
- Manual override `1.2.3` β git tag `v1.2.3`, npm `1.2.3` β
|
|
70
|
-
|
|
71
|
-
## Test Output
|
|
72
|
-
|
|
73
|
-
```
|
|
74
|
-
scripts/tests/test_version_sync.py .....
|
|
75
|
-
scripts/tests/test_changelog_gen.py .......................
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
## Checklist
|
|
79
|
-
|
|
80
|
-
- [x] My code follows the project's style guidelines
|
|
81
|
-
- [x] I have performed a self-review of my code
|
|
82
|
-
- [x] I have commented my code, particularly in hard-to-understand areas
|
|
83
|
-
- [x] My changes generate no new warnings
|
|
84
|
-
- [x] I have added tests that prove my fix is effective or that my feature works
|
|
85
|
-
- [x] New and existing unit tests pass locally with my changes
|
|
86
|
-
- [x] I have made corresponding changes to the documentation
|
|
87
|
-
- [ ] I have updated the CHANGELOG.md if applicable
|
|
88
|
-
|
|
89
|
-
## Additional Notes
|
|
90
|
-
|
|
91
|
-
### Version Bump Logic
|
|
92
|
-
|
|
93
|
-
**Canonical + Commit Height Algorithm** β The workflow NEVER commits back to the repo. `pyproject.toml` is the canonical source of truth, updated manually before merging.
|
|
94
|
-
|
|
95
|
-
| Commit | Bump | Git Tag | npm Version |
|
|
96
|
-
|--------|------|---------|-------------|
|
|
97
|
-
| `fix:`, `ci:`, `chore:`, `perf:`, `refactor:` | patch | `v0.5.25.3` | `0.5.26` |
|
|
98
|
-
| `feat:` | minor | `v0.6.0.0` | `0.6.0` |
|
|
99
|
-
| `feat!:` or `feat:` + `BREAKING CHANGE` body | major | `v1.0.0.0` | `1.0.0` |
|
|
100
|
-
|
|
101
|
-
The git tag uses `v{canonical}.{height}` (e.g., `v0.5.25.3` = 3 commits since canonical `0.5.25`). npm versions use 3-part semver, bumped from canonical.
|
|
102
|
-
|
|
103
|
-
### Package Publishing Targets
|
|
104
|
-
|
|
105
|
-
| Package | Target | Status |
|
|
106
|
-
|---------|--------|--------|
|
|
107
|
-
| `xtream-head` (Python) | PyPI | β
via `pypa/gh-action-pypi-publish` |
|
|
108
|
-
| `xtream-head` (TypeScript SDK) | npmjs.org | β
via `npm publish` |
|
|
109
|
-
| `xtream-head-openclaw` | npmjs.org | β
via `npm publish` |
|
|
110
|
-
| `xtream-head-openclaw` | GitHub Package Registry | β
via `npm publish --registry npm.pkg.github.com` |
|
|
111
|
-
|
|
112
|
-
### Safety Gates
|
|
113
|
-
|
|
114
|
-
Each publish job requires both `dry_run != 'true'` **and** the corresponding skip variable not set:
|
|
115
|
-
|
|
116
|
-
| Variable | Effect |
|
|
117
|
-
|----------|--------|
|
|
118
|
-
| `PYPI_SKIP=true` | Skip PyPI publish |
|
|
119
|
-
| `NPM_SKIP=true` | Skip both npm publishes |
|
|
120
|
-
| `GH_PACKAGES_SKIP=true` | Skip GitHub Package Registry publish |
|
|
121
|
-
|
|
122
|
-
Set in: **GitHub repo β Settings β Variables β Actions Variables**.
|
|
123
|
-
|
|
124
|
-
### Workflow Triggers
|
|
125
|
-
|
|
126
|
-
- **Auto:** On push to `main` β analyzes latest commit, bumps version, builds, publishes, creates GitHub Release
|
|
127
|
-
- **Manual:** `workflow_dispatch` with optional `version` override and `dry_run` flag
|
|
128
|
-
- **Paths ignore:** Skips runs when only `docs/`, `.github/workflows/ci.yml`, `.github/workflows/publish.yml`, `scripts/`, `.commitlintrc.json`, `.actrc`, `.github/act/`, or `.env.act.example` change
|
|
129
|
-
|
|
130
|
-
### Local Testing
|
|
131
|
-
|
|
132
|
-
```bash
|
|
133
|
-
# Install act
|
|
134
|
-
winget install act
|
|
135
|
-
|
|
136
|
-
# Dry-run (no publishes)
|
|
137
|
-
act -W .github/workflows/release.yml -e .github/act/dry-run.json
|
|
138
|
-
|
|
139
|
-
# Test feat: commit (minor bump)
|
|
140
|
-
act -W .github/workflows/release.yml -e .github/act/push-feat.json
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
### Required GitHub Secrets
|
|
144
|
-
|
|
145
|
-
| Secret | Purpose |
|
|
146
|
-
|--------|---------|
|
|
147
|
-
| `NPM_TOKEN` | Publishing to npmjs.org |
|
|
148
|
-
| `GITHUB_TOKEN` | GitHub Package Registry (auto-provided by GitHub Actions) |
|
|
149
|
-
|
|
150
|
-
PyPI uses trusted publisher OIDC β no secret required, only the `pypi` GitHub Environment must be configured.
|
|
151
|
-
|
|
152
|
-
### First Release Note
|
|
153
|
-
|
|
154
|
-
The TypeScript packages are currently at `0.1.0` while Python is at `0.5.25`. The first release will align all three to the same version. Update `pyproject.toml` to the desired canonical version before merging, then use `workflow_dispatch` with a manual `version` input to set the target explicitly.
|
|
155
|
-
|
|
156
|
-
After each release, update `pyproject.toml` to match the published version to keep the canonical current and ensure unique git tags.
|
|
157
|
-
|
|
158
|
-
### Parameterized Configuration
|
|
159
|
-
|
|
160
|
-
All package names and registries are top-level `env` constants in `release.yml`:
|
|
161
|
-
|
|
162
|
-
```yaml
|
|
163
|
-
env:
|
|
164
|
-
PYPI_PACKAGE: xtream-head
|
|
165
|
-
PYPI_ENVIRONMENT: pypi
|
|
166
|
-
NPM_REGISTRY_URL: https://registry.npmjs.org
|
|
167
|
-
NPM_SDK_PACKAGE: xtream-head
|
|
168
|
-
NPM_OPENCLAW_PACKAGE: xtream-head-openclaw
|
|
169
|
-
GITHUB_PACKAGES_REGISTRY_URL: https://npm.pkg.github.com
|
|
170
|
-
```
|
package/PUBLISH.md
DELETED
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
# Publishing Guide
|
|
2
|
-
|
|
3
|
-
## npm Registry (npmjs.com)
|
|
4
|
-
|
|
5
|
-
### Prerequisites
|
|
6
|
-
- npm account at https://www.npmjs.com
|
|
7
|
-
- Logged in: `npm login`
|
|
8
|
-
|
|
9
|
-
### Publish Steps
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
# 1. Verify version in package.json is updated
|
|
13
|
-
npm version patch # or 'minor' / 'major'
|
|
14
|
-
|
|
15
|
-
# 2. Build and test
|
|
16
|
-
npm run build
|
|
17
|
-
npm test # if tests exist
|
|
18
|
-
|
|
19
|
-
# 3. Publish to npm
|
|
20
|
-
npm publish
|
|
21
|
-
|
|
22
|
-
# 4. Verify on https://www.npmjs.com/package/xithead
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### Current Version
|
|
26
|
-
- **Version**: 1.5.0
|
|
27
|
-
- **Package Name**: `xithead`
|
|
28
|
-
- **Registry**: https://registry.npmjs.org/
|
|
29
|
-
- **Access**: public
|
|
30
|
-
|
|
31
|
-
### Install via npm
|
|
32
|
-
```bash
|
|
33
|
-
npm install -g xithead
|
|
34
|
-
# or
|
|
35
|
-
npm install -g github:xtream-itsolutions/xithead
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
## GitHub Release
|
|
39
|
-
|
|
40
|
-
After publishing to npm, create a GitHub release:
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
git tag v1.5.0
|
|
44
|
-
git push origin v1.5.0
|
|
45
|
-
# Then create release on GitHub with changelog
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
## PyPI (Python Package Index)
|
|
49
|
-
|
|
50
|
-
Current setup:
|
|
51
|
-
- xithead is a **Node.js CLI** application, not a Python package
|
|
52
|
-
- PyPI is for Python packages only
|
|
53
|
-
- If Python wrapper is needed in future, create separate `xithead-py` package
|
|
54
|
-
|
|
55
|
-
For now:
|
|
56
|
-
- Distribution via npm (JavaScript)
|
|
57
|
-
- No PyPI package needed
|
|
58
|
-
|
|
59
|
-
## Troubleshooting
|
|
60
|
-
|
|
61
|
-
**Not authenticated to npm?**
|
|
62
|
-
```bash
|
|
63
|
-
npm login
|
|
64
|
-
# Enter credentials from npm account
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
**Package already exists?**
|
|
68
|
-
```bash
|
|
69
|
-
npm unpublish xithead@1.5.0 # Remove old version if needed
|
|
70
|
-
npm publish # Publish new version
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
**View published packages:**
|
|
74
|
-
```bash
|
|
75
|
-
npm view xithead versions # Show all versions
|
|
76
|
-
npm info xithead # Show package info
|
|
77
|
-
```
|
package/README_FRONTEND.md
DELETED
|
@@ -1,196 +0,0 @@
|
|
|
1
|
-
# XIT Head β Frontend
|
|
2
|
-
|
|
3
|
-
Modern Next.js-basiertes Frontend fΓΌr Claude Code Proxy mit professioneller Projektstruktur.
|
|
4
|
-
|
|
5
|
-
## π Projektstruktur
|
|
6
|
-
|
|
7
|
-
```
|
|
8
|
-
.
|
|
9
|
-
βββ app/ # Next.js App Router (Pages & Routes)
|
|
10
|
-
β βββ layout.tsx # Root Layout
|
|
11
|
-
β βββ page.tsx # Homepage
|
|
12
|
-
β βββ dashboard/ # Dashboard Routes
|
|
13
|
-
β βββ installation/ # Installation Guide
|
|
14
|
-
β βββ api/ # API Routes
|
|
15
|
-
β βββ rechtliches/ # Legal Pages
|
|
16
|
-
βββ components/ # React Components
|
|
17
|
-
β βββ layout/ # Layout Components (Header, Footer, AppShell)
|
|
18
|
-
β βββ dashboard/ # Dashboard-specific Components
|
|
19
|
-
β βββ pages/ # Page Components
|
|
20
|
-
β βββ shared/ # Reusable Components
|
|
21
|
-
β βββ marketing/ # Marketing Components
|
|
22
|
-
β βββ ui/ # UI Library Components
|
|
23
|
-
βββ lib/ # Utilities & Business Logic
|
|
24
|
-
β βββ config/ # Configuration
|
|
25
|
-
β βββ utils/ # Utility Functions
|
|
26
|
-
β βββ hooks/ # Custom React Hooks (exported to lib/hooks)
|
|
27
|
-
β βββ schemas/ # Zod/Validation Schemas
|
|
28
|
-
β βββ middleware/ # Middleware Utilities
|
|
29
|
-
β βββ api/ # API Client Helpers
|
|
30
|
-
β βββ __tests__/ # Unit Tests
|
|
31
|
-
βββ hooks/ # Custom React Hooks (aliased to lib/hooks)
|
|
32
|
-
βββ types/ # TypeScript Type Definitions
|
|
33
|
-
βββ public/ # Static Assets (images, icons, etc)
|
|
34
|
-
βββ scripts/ # Build & Utility Scripts
|
|
35
|
-
βββ design-system/ # Design Tokens & System
|
|
36
|
-
βββ __tests__/ # Integration Tests
|
|
37
|
-
βββ middleware.ts # Next.js Middleware
|
|
38
|
-
βββ next.config.ts # Next.js Configuration
|
|
39
|
-
βββ tailwind.config.ts # Tailwind CSS Configuration
|
|
40
|
-
βββ tsconfig.json # TypeScript Configuration
|
|
41
|
-
βββ package.json # NPM Configuration
|
|
42
|
-
βββ README.md # Documentation
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## π Quick Start
|
|
46
|
-
|
|
47
|
-
### Installation
|
|
48
|
-
```bash
|
|
49
|
-
npm install
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### Development
|
|
53
|
-
```bash
|
|
54
|
-
npm run dev
|
|
55
|
-
# App lΓ€uft auf http://localhost:3000
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### Build
|
|
59
|
-
```bash
|
|
60
|
-
npm run build
|
|
61
|
-
npm run start
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
### Testing
|
|
65
|
-
```bash
|
|
66
|
-
npm run test # Alle Tests laufen
|
|
67
|
-
npm run test:ui # Test UI ΓΆffnen
|
|
68
|
-
npm run test:coverage # Coverage Report
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
### Code Quality
|
|
72
|
-
```bash
|
|
73
|
-
npm run lint # ESLint
|
|
74
|
-
npm run type-check # TypeScript Check
|
|
75
|
-
npm run format # Code Formatierung
|
|
76
|
-
npm run verify # Alle Checks
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
## π¦ Scripts
|
|
80
|
-
|
|
81
|
-
| Script | Beschreibung |
|
|
82
|
-
|--------|-------------|
|
|
83
|
-
| `dev` | Starts dev server |
|
|
84
|
-
| `build` | Build fΓΌr production |
|
|
85
|
-
| `start` | Start production server |
|
|
86
|
-
| `lint` | ESLint check |
|
|
87
|
-
| `type-check` | TypeScript type checking |
|
|
88
|
-
| `format` | Prettier formatting |
|
|
89
|
-
| `test` | Vitest runner |
|
|
90
|
-
| `clean` | Delete build artifacts |
|
|
91
|
-
| `clean:cache` | Clear Next.js cache |
|
|
92
|
-
| `analyze` | Build bundle analysis |
|
|
93
|
-
|
|
94
|
-
## π¨ Design System
|
|
95
|
-
|
|
96
|
-
- **Color Scheme**: Schwarz/WeiΓ mit #BE3455 als Brand-Akzent
|
|
97
|
-
- **Framework**: Tailwind CSS v4
|
|
98
|
-
- **Icons**: Lucide React
|
|
99
|
-
- **Typography**: System Fonts mit Fallbacks
|
|
100
|
-
|
|
101
|
-
## π Path Aliases
|
|
102
|
-
|
|
103
|
-
```json
|
|
104
|
-
{
|
|
105
|
-
"@/*": "./*",
|
|
106
|
-
"@/app/*": "./app/*",
|
|
107
|
-
"@/components/*": "./components/*",
|
|
108
|
-
"@/lib/*": "./lib/*",
|
|
109
|
-
"@/types/*": "./types/*",
|
|
110
|
-
"@/hooks/*": "./lib/hooks/*",
|
|
111
|
-
"@/utils/*": "./lib/utils/*",
|
|
112
|
-
"@/schemas/*": "./lib/schemas/*"
|
|
113
|
-
}
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
## π Pages
|
|
117
|
-
|
|
118
|
-
- **Homepage**: `/`
|
|
119
|
-
- **Dashboard**: `/dashboard`
|
|
120
|
-
- **Dashboard Analytics**: `/dashboard/analytics`
|
|
121
|
-
- **Dashboard Settings**: `/dashboard/settings`
|
|
122
|
-
- **Installation**: `/installation`
|
|
123
|
-
- **Legal**: `/rechtliches/*`
|
|
124
|
-
|
|
125
|
-
## π§ Configuration
|
|
126
|
-
|
|
127
|
-
### Environment Variables
|
|
128
|
-
Kopiere `.env.example` zu `.env.local` und passe an:
|
|
129
|
-
|
|
130
|
-
```bash
|
|
131
|
-
cp .env.example .env.local
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
## π§ͺ Testing
|
|
135
|
-
|
|
136
|
-
Das Projekt nutzt **Vitest** fΓΌr Unit Tests:
|
|
137
|
-
|
|
138
|
-
```bash
|
|
139
|
-
npm run test # Run all tests
|
|
140
|
-
npm run test:ui # Open Vitest UI
|
|
141
|
-
npm run test:coverage # Generate coverage report
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
## π Dependencies
|
|
145
|
-
|
|
146
|
-
**Main Dependencies:**
|
|
147
|
-
- Next.js 15.3.4
|
|
148
|
-
- React 19.0.0
|
|
149
|
-
- Tailwind CSS 4
|
|
150
|
-
- Lucide React 0.454
|
|
151
|
-
- Recharts 2.15
|
|
152
|
-
|
|
153
|
-
**Dev Dependencies:**
|
|
154
|
-
- TypeScript 5
|
|
155
|
-
- ESLint + TypeScript Support
|
|
156
|
-
- Prettier
|
|
157
|
-
- Vitest
|
|
158
|
-
- PostCSS
|
|
159
|
-
|
|
160
|
-
## π Deployment
|
|
161
|
-
|
|
162
|
-
### Production Build
|
|
163
|
-
```bash
|
|
164
|
-
npm run build
|
|
165
|
-
npm run start
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
### Docker
|
|
169
|
-
```bash
|
|
170
|
-
docker build -t xtream-head .
|
|
171
|
-
docker run -p 3000:3000 xtream-head
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
## π Best Practices
|
|
175
|
-
|
|
176
|
-
1. **Components**: Nutze funktionale Komponenten mit Hooks
|
|
177
|
-
2. **Styling**: Tailwind CSS fΓΌr alle Styles
|
|
178
|
-
3. **Types**: Immer vollstΓ€ndige TypeScript Types
|
|
179
|
-
4. **Hooks**: Custom Hooks in `lib/hooks/`
|
|
180
|
-
5. **Utils**: Business Logic in `lib/utils/`
|
|
181
|
-
6. **Tests**: Unit Tests in `lib/__tests__/`
|
|
182
|
-
|
|
183
|
-
## π Security
|
|
184
|
-
|
|
185
|
-
- Alle API-Requests sind authentifiziert
|
|
186
|
-
- CORS-Headers sind konfiguriert
|
|
187
|
-
- CSP-Headers zur XSS-Prevention
|
|
188
|
-
- Sensitive Data ist environment-protected
|
|
189
|
-
|
|
190
|
-
## π Support
|
|
191
|
-
|
|
192
|
-
FΓΌr Issues und Fragen: https://github.com/Xtream-ITSolutions/xithead
|
|
193
|
-
|
|
194
|
-
## π Lizenz
|
|
195
|
-
|
|
196
|
-
Apache 2.0 β Siehe LICENSE datei
|
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# 00 β Overview & Wrong Mental Model
|
|
2
|
-
|
|
3
|
-
## Executive summary
|
|
4
|
-
|
|
5
|
-
Headroom is built on the wrong mental model: **"compression means choosing what to drop from conversation history."** The flagship `IntelligentContextManager` (ICM) tokenizes the entire `messages` array, scores each message for importance, and removes old messages until the budget is hit. It has been wired into the Rust proxy on `/v1/messages` with `frozen_message_count: 0` hardcoded β so every compression event drops messages from index 0, busting the Anthropic prompt cache for every customer that triggers it.
|
|
6
|
-
|
|
7
|
-
The correct mental model β confirmed by an authoritative engineering guide and ten parallel deep-audit subagents β is the opposite: **"passthrough is sacred; compress only the live zone, type-aware, hash-keyed, position-preserving, with side-channel metadata."** The cache hot zone (system prompt, tools, old turns, reasoning/thinking/redacted/compaction items) is **never** touched.
|
|
8
|
-
|
|
9
|
-
The audit found:
|
|
10
|
-
|
|
11
|
-
- **5 top-tier cache-killer bugs** all stemming from the wrong model
|
|
12
|
-
- **~10 K LOC of architectural over-build** (ICM + scoring + relevance + rolling-window + progressive-summarizer + tool-crusher + cache-aligner rewrite path + most of `crates/headroom-core/src/{context,scoring,relevance}/`)
|
|
13
|
-
- **Wire-format gaps** in the streaming SSE parser (missing `thinking_delta`, `signature_delta`, `citations_delta`; UTF-8-split corruption; single-`\n` SSE split bugs in fallback paths)
|
|
14
|
-
- **Bedrock/Vertex parity is fake** β a lossy LiteLLM Anthropic-to-OpenAI conversion drops `thinking`, `redacted_thinking`, `document`, `search_result`, `image`, `server_tool_use`, `mcp_tool_use` blocks
|
|
15
|
-
- **No tool-definition normalization** anywhere
|
|
16
|
-
- **No auth-mode awareness** β PAYG, OAuth, and subscription CLIs all get the same policy and the same fingerprint-leaking re-serialization
|
|
17
|
-
- **`X-Headroom-*` request headers leak upstream**, plus `anthropic-beta` mutation and `OpenAI-Beta` auto-injection β fingerprint-class subscription-revocation risks
|
|
18
|
-
- **CCR markers** are computed but never injected into the outgoing request body in the Rust path; the `ccr_retrieve` tool flips on/off per request β busts the tools array on every state change
|
|
19
|
-
|
|
20
|
-
## What changes
|
|
21
|
-
|
|
22
|
-
The realignment is structured in 9 phases, 40 PRs, ~13 weeks sequential or ~8 weeks with parallel work:
|
|
23
|
-
|
|
24
|
-
- **Phase A β Lockdown (1 week):** stop the cache bleeding immediately. Make `/v1/messages` compression a passthrough; stop mutating the system prompt; switch Python forwarders from `httpx ... json=body` (re-serializes) to `httpx ... content=raw_bytes`; honor customer-set `cache_control` markers in Rust; strip `x-headroom-*` from upstream-bound headers; pin `anthropic-beta` order and make it session-sticky; add a SHA-256 byte-faithful round-trip test.
|
|
25
|
-
- **Phase B β Live-zone engine (2 weeks):** delete ICM, scoring, relevance, rolling-window, progressive-summarizer, tool-crusher (~10 K LOC). Build a live-zone-only block dispatcher in Rust that runs SmartCrusher / LogCompressor / DiffCompressor / SearchCompressor / KompressCompressor on the latest user message content + latest tool_result + latest function_call_output + latest local_shell_call_output. Token-validate every compression with fallback. CCR hardens: persistent backend + always-on `ccr_retrieve` tool registration.
|
|
26
|
-
- **Phase C β Rust proxy paths (3 weeks):** byte-level SSE parser with full state machine; `/v1/chat/completions`, `/v1/responses` (HTTP and streaming) handlers; per-item-type passthrough preservation (V4A patches, `local_shell_call.action.command` argv, Codex `phase` field, MCP items, `compaction`).
|
|
27
|
-
- **Phase D β Bedrock/Vertex native (2 weeks):** delete the LiteLLM lossy converter; build native `/model/.../invoke` (AWS) and `/v1beta1/projects/.../publishers/anthropic/.../streamRawPredict` (GCP) routes with SigV4 + ADC signing. Cache fidelity restored on Bedrock/Vertex traffic.
|
|
28
|
-
- **Phase E β Phase 3 cache stabilization (1 week):** sort tool array deterministically; sort JSON Schema keys recursively; auto-place up to 4 `cache_control` breakpoints (Anthropic); auto-inject `prompt_cache_key` (OpenAI); volatile-content detector with customer warning (no rewrite); cache-bust drift telemetry.
|
|
29
|
-
- **Phase F β Auth-mode policy (1 week):** `classify_auth_mode(headers)` helper returning `payg | oauth | subscription`; per-mode compression policy gates; TOIN aggregation key extended to `(auth_mode, model_family, structure_hash)`; conditional `X-Forwarded-*` headers in Rust.
|
|
30
|
-
- **Phase G β RTK + observability (1 week):** extend wrap CLIs (cline, continue, goose, openhands); wire the dead `tokens_saved_rtk` field; per-invocation RTK Prometheus metrics.
|
|
31
|
-
- **Phase H β Python retirement (2 weeks):** delete `headroom/proxy/server.py`, all handlers, `responses_converter.py`, `memory_handler.py`, `memory_tool_adapter.py`, `batch.py`, `semantic_cache.py`, all of `headroom/transforms/*` Python (per Phase B); keep CLI wrappers, RTK installer, evals, learn, memory writers, tokenizers, TOIN.
|
|
32
|
-
- **Phase I β Test infra (continuous, parallel):** SHA-256 round-trip tests; SSE corner-case fixtures (UTF-8 split, ping, all delta types, `[DONE]`, mid-stream error); property tests (no-panic SSE parser, tokens-non-increasing compression); cache-hit-rate continuous metric; promote `ccr` / `log_compressor` / `cache_aligner` parity comparators from `Skipped` stubs to real; make `make test-parity` a per-PR gate.
|
|
33
|
-
|
|
34
|
-
## Top 5 wrong assumptions
|
|
35
|
-
|
|
36
|
-
1. **"Compression means choosing what to drop from history."** Implemented as ICM + DropByScoreStrategy + MessageScorer + relevance + scoring + rolling-window + progressive-summarizer. Fix: retire entirely; compress live-zone content only.
|
|
37
|
-
2. **"TOIN can influence per-request compression decisions."** `headroom/telemetry/toin.py:853-927` mutates pattern state during a call and returns hints that bias the same-input-bytes decision. Fix: strict observation-only; recommendations published between deploys.
|
|
38
|
-
3. **"CCR can mutate the cache hot zone (tools array, system prompt) on demand."** `headroom/ccr/tool_injection.py:302-328` only adds `ccr_retrieve` when content was compressed β tools list flips between requests. `cache_aligner.py:160-262` and `headroom/proxy/server.py:1051` rewrite the system prompt. Fix: register `ccr_retrieve` on every request; route memory injection to the live zone tail; delete the cache_aligner rewrite path.
|
|
39
|
-
4. **"Summarizing past turns is a strategy."** `intelligent_context.py:316-353` SUMMARIZE replaces messages with a single summary at the same position β head modification. Fix: delete; offer compaction only as an explicit customer-initiated action.
|
|
40
|
-
5. **"ToolCrusher operates on every tool message in history without a frozen check."** `headroom/transforms/tool_crusher.py:106` iterates all tool messages. Fix: delete; ContentRouter covers the use case correctly.
|
|
41
|
-
|
|
42
|
-
## What's preserved
|
|
43
|
-
|
|
44
|
-
Per your direction:
|
|
45
|
-
- **TOIN** (Tool Output Intelligence Network) β observation-only refactor; per-tenant key
|
|
46
|
-
- **CCR** (Compress-Cache-Retrieve) β persistent backend + always-on tool
|
|
47
|
-
- **Kompress-base** β plain-text Β§8.6 compressor; stays in Python now, Rust port via `ort` crate later
|
|
48
|
-
- **ContentRouter** β Python ~2150 LOC, the architecturally correct piece (NOTE: earlier project memory said 53 K lines β that was wrong by 25Γ; the file is fine)
|
|
49
|
-
- All per-type compressors: SmartCrusher (Rust 25 files), CodeCompressor, LogCompressor, SearchCompressor, DiffCompressor
|
|
50
|
-
|
|
51
|
-
## What's deleted
|
|
52
|
-
|
|
53
|
-
~25 K LOC across two languages. See [01-bug-list.md](./01-bug-list.md) Β§6 for the full retirement list with file:line evidence.
|