xithead 1.2.2 → 1.5.0
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/.actrc +14 -0
- package/.actrc.local.example +15 -0
- package/.changelog.md +2 -0
- package/.claude/agents/academic-anthropologist.md +125 -0
- package/.claude/agents/academic-geographer.md +127 -0
- package/.claude/agents/academic-historian.md +123 -0
- package/.claude/agents/academic-narratologist.md +118 -0
- package/.claude/agents/academic-psychologist.md +118 -0
- package/.claude/agents/academic-statistician.md +144 -0
- package/.claude/agents/accounts-payable-agent.md +205 -0
- package/.claude/agents/agentic-identity-trust.md +394 -0
- package/.claude/agents/agents-orchestrator.md +367 -0
- package/.claude/agents/automation-governance-architect.md +216 -0
- package/.claude/agents/blender-addon-engineer.md +243 -0
- package/.claude/agents/business-strategist.md +488 -0
- package/.claude/agents/change-management-consultant.md +497 -0
- package/.claude/agents/chief-financial-officer.md +388 -0
- package/.claude/agents/corporate-training-designer.md +192 -0
- package/.claude/agents/customer-service.md +398 -0
- package/.claude/agents/customer-success-manager.md +460 -0
- package/.claude/agents/data-consolidation-agent.md +60 -0
- package/.claude/agents/data-privacy-officer.md +412 -0
- package/.claude/agents/design-brand-guardian.md +322 -0
- package/.claude/agents/design-image-prompt-engineer.md +236 -0
- package/.claude/agents/design-inclusive-visuals-specialist.md +73 -0
- package/.claude/agents/design-persona-walkthrough.md +272 -0
- package/.claude/agents/design-ui-designer.md +386 -0
- package/.claude/agents/design-ui-finish-gate-reviewer.md +217 -0
- package/.claude/agents/design-ux-architect.md +482 -0
- package/.claude/agents/design-ux-researcher.md +329 -0
- package/.claude/agents/design-visual-storyteller.md +149 -0
- package/.claude/agents/design-whimsy-injector.md +460 -0
- package/.claude/agents/economy-designer.md +156 -0
- package/.claude/agents/engineering-ai-data-remediation-engineer.md +211 -0
- package/.claude/agents/engineering-ai-engineer.md +146 -0
- package/.claude/agents/engineering-api-platform-engineer.md +181 -0
- package/.claude/agents/engineering-ats-validator-architect.md +383 -0
- package/.claude/agents/engineering-autonomous-optimization-architect.md +121 -0
- package/.claude/agents/engineering-backend-architect.md +255 -0
- package/.claude/agents/engineering-china-network-engineer.md +252 -0
- package/.claude/agents/engineering-cms-developer.md +536 -0
- package/.claude/agents/engineering-code-reviewer.md +76 -0
- package/.claude/agents/engineering-codebase-onboarding-engineer.md +173 -0
- package/.claude/agents/engineering-data-engineer.md +349 -0
- package/.claude/agents/engineering-data-visualization-engineer.md +151 -0
- package/.claude/agents/engineering-database-optimizer.md +188 -0
- package/.claude/agents/engineering-database-reliability-engineer.md +201 -0
- package/.claude/agents/engineering-desktop-app-engineer.md +209 -0
- package/.claude/agents/engineering-developer-tooling-engineer.md +153 -0
- package/.claude/agents/engineering-devops-automator.md +385 -0
- package/.claude/agents/engineering-drupal-performance.md +347 -0
- package/.claude/agents/engineering-drupal-shopping-cart.md +360 -0
- package/.claude/agents/engineering-electrical-engineer.md +575 -0
- package/.claude/agents/engineering-email-intelligence-engineer.md +390 -0
- package/.claude/agents/engineering-embedded-firmware-engineer.md +196 -0
- package/.claude/agents/engineering-feishu-integration-developer.md +606 -0
- package/.claude/agents/engineering-filament-optimization-specialist.md +283 -0
- package/.claude/agents/engineering-finops-engineer.md +164 -0
- package/.claude/agents/engineering-frontend-developer.md +257 -0
- package/.claude/agents/engineering-gaussdb-expert.md +334 -0
- package/.claude/agents/engineering-git-workflow-master.md +98 -0
- package/.claude/agents/engineering-i18n-engineer.md +214 -0
- package/.claude/agents/engineering-identity-access-engineer.md +217 -0
- package/.claude/agents/engineering-incident-response-commander.md +444 -0
- package/.claude/agents/engineering-iot-fleet-engineer.md +148 -0
- package/.claude/agents/engineering-it-service-manager.md +561 -0
- package/.claude/agents/engineering-knowledge-graph-engineer.md +372 -0
- package/.claude/agents/engineering-llm-post-training-engineer.md +166 -0
- package/.claude/agents/engineering-minimal-change-engineer.md +207 -0
- package/.claude/agents/engineering-mobile-app-builder.md +493 -0
- package/.claude/agents/engineering-mobile-release-engineer.md +164 -0
- package/.claude/agents/engineering-multi-agent-systems-architect.md +600 -0
- package/.claude/agents/engineering-network-engineer.md +245 -0
- package/.claude/agents/engineering-orgscript-engineer.md +113 -0
- package/.claude/agents/engineering-payments-billing-engineer.md +228 -0
- package/.claude/agents/engineering-pdf-engine-architect.md +696 -0
- package/.claude/agents/engineering-platform-engineer.md +270 -0
- package/.claude/agents/engineering-privacy-engineer.md +152 -0
- package/.claude/agents/engineering-prompt-engineer.md +209 -0
- package/.claude/agents/engineering-rag-pipeline-engineer.md +450 -0
- package/.claude/agents/engineering-rapid-prototyper.md +466 -0
- package/.claude/agents/engineering-realtime-collaboration-engineer.md +200 -0
- package/.claude/agents/engineering-rust-refactoring-specialist.md +313 -0
- package/.claude/agents/engineering-search-relevance-engineer.md +237 -0
- package/.claude/agents/engineering-section-508-specialist.md +339 -0
- package/.claude/agents/engineering-senior-developer.md +176 -0
- package/.claude/agents/engineering-servicenow-developer-mentor.md +180 -0
- package/.claude/agents/engineering-software-architect.md +112 -0
- package/.claude/agents/engineering-solidity-smart-contract-engineer.md +522 -0
- package/.claude/agents/engineering-sre.md +90 -0
- package/.claude/agents/engineering-technical-writer.md +393 -0
- package/.claude/agents/engineering-universal-document-compiler.md +370 -0
- package/.claude/agents/engineering-uswds-developer.md +340 -0
- package/.claude/agents/engineering-video-streaming-engineer.md +151 -0
- package/.claude/agents/engineering-voice-ai-integration-engineer.md +584 -0
- package/.claude/agents/engineering-webassembly-engineer.md +153 -0
- package/.claude/agents/engineering-wechat-mini-program-developer.md +356 -0
- package/.claude/agents/engineering-wordpress-performance.md +346 -0
- package/.claude/agents/engineering-wordpress-shopping-cart.md +346 -0
- package/.claude/agents/esg-sustainability-officer.md +396 -0
- package/.claude/agents/finance-bookkeeper-controller.md +260 -0
- package/.claude/agents/finance-financial-analyst.md +234 -0
- package/.claude/agents/finance-fpa-analyst.md +263 -0
- package/.claude/agents/finance-investment-researcher.md +272 -0
- package/.claude/agents/finance-tax-strategist.md +239 -0
- package/.claude/agents/game-audio-engineer.md +264 -0
- package/.claude/agents/game-designer.md +167 -0
- package/.claude/agents/gis-3d-scene-developer.md +111 -0
- package/.claude/agents/gis-analyst.md +91 -0
- package/.claude/agents/gis-bim-specialist.md +108 -0
- package/.claude/agents/gis-cartography-designer.md +150 -0
- package/.claude/agents/gis-drone-reality-mapping.md +120 -0
- package/.claude/agents/gis-geoai-ml-engineer.md +105 -0
- package/.claude/agents/gis-geoprocessing-specialist.md +97 -0
- package/.claude/agents/gis-qa-engineer.md +133 -0
- package/.claude/agents/gis-solution-engineer.md +101 -0
- package/.claude/agents/gis-spatial-data-engineer.md +97 -0
- package/.claude/agents/gis-spatial-data-scientist.md +111 -0
- package/.claude/agents/gis-technical-consultant.md +86 -0
- package/.claude/agents/gis-web-gis-developer.md +108 -0
- package/.claude/agents/godot-gameplay-scripter.md +338 -0
- package/.claude/agents/godot-multiplayer-engineer.md +301 -0
- package/.claude/agents/godot-shader-developer.md +267 -0
- package/.claude/agents/government-digital-presales-consultant.md +363 -0
- package/.claude/agents/grant-writer.md +511 -0
- package/.claude/agents/healthcare-aging-parent-care-companion.md +414 -0
- package/.claude/agents/healthcare-clinical-evidence-agent.md +231 -0
- package/.claude/agents/healthcare-customer-service.md +389 -0
- package/.claude/agents/healthcare-innovation-strategist.md +433 -0
- package/.claude/agents/healthcare-marketing-compliance.md +395 -0
- package/.claude/agents/healthcare-sovereign-health-systems-agent.md +312 -0
- package/.claude/agents/hospitality-guest-services.md +603 -0
- package/.claude/agents/hr-onboarding.md +451 -0
- package/.claude/agents/identity-graph-operator.md +303 -0
- package/.claude/agents/language-translator.md +264 -0
- package/.claude/agents/legal-billing-time-tracking.md +569 -0
- package/.claude/agents/legal-client-intake.md +492 -0
- package/.claude/agents/legal-document-review.md +454 -0
- package/.claude/agents/level-designer.md +208 -0
- package/.claude/agents/loan-officer-assistant.md +555 -0
- package/.claude/agents/lsp-index-engineer.md +320 -0
- package/.claude/agents/ma-integration-manager.md +427 -0
- package/.claude/agents/macos-spatial-metal-engineer.md +337 -0
- package/.claude/agents/marketing-aeo-foundations.md +264 -0
- package/.claude/agents/marketing-agentic-search-optimizer.md +279 -0
- package/.claude/agents/marketing-ai-citation-strategist.md +172 -0
- package/.claude/agents/marketing-app-store-optimizer.md +321 -0
- package/.claude/agents/marketing-baidu-seo-specialist.md +226 -0
- package/.claude/agents/marketing-bilibili-content-strategist.md +199 -0
- package/.claude/agents/marketing-book-co-author.md +110 -0
- package/.claude/agents/marketing-carousel-growth-engine.md +204 -0
- package/.claude/agents/marketing-china-ecommerce-operator.md +283 -0
- package/.claude/agents/marketing-china-market-localization-strategist.md +283 -0
- package/.claude/agents/marketing-content-creator.md +54 -0
- package/.claude/agents/marketing-cross-border-ecommerce.md +259 -0
- package/.claude/agents/marketing-developer-community-builder.md +285 -0
- package/.claude/agents/marketing-douyin-strategist.md +149 -0
- package/.claude/agents/marketing-email-strategist.md +249 -0
- package/.claude/agents/marketing-global-podcast-strategist.md +206 -0
- package/.claude/agents/marketing-growth-hacker.md +54 -0
- package/.claude/agents/marketing-instagram-curator.md +113 -0
- package/.claude/agents/marketing-kuaishou-strategist.md +223 -0
- package/.claude/agents/marketing-linkedin-content-creator.md +214 -0
- package/.claude/agents/marketing-livestream-commerce-coach.md +305 -0
- package/.claude/agents/marketing-multi-platform-publisher.md +217 -0
- package/.claude/agents/marketing-podcast-strategist.md +277 -0
- package/.claude/agents/marketing-pr-communications-manager.md +473 -0
- package/.claude/agents/marketing-private-domain-operator.md +308 -0
- package/.claude/agents/marketing-reddit-community-builder.md +123 -0
- package/.claude/agents/marketing-seo-specialist.md +370 -0
- package/.claude/agents/marketing-short-video-editing-coach.md +412 -0
- package/.claude/agents/marketing-social-media-strategist.md +125 -0
- package/.claude/agents/marketing-tiktok-strategist.md +125 -0
- package/.claude/agents/marketing-twitter-engager.md +126 -0
- package/.claude/agents/marketing-video-optimization-specialist.md +119 -0
- package/.claude/agents/marketing-wechat-official-account.md +145 -0
- package/.claude/agents/marketing-weibo-strategist.md +240 -0
- package/.claude/agents/marketing-x-twitter-intelligence-analyst.md +161 -0
- package/.claude/agents/marketing-xiaohongshu-specialist.md +138 -0
- package/.claude/agents/marketing-zhihu-strategist.md +162 -0
- package/.claude/agents/medical-billing-coding-specialist.md +491 -0
- package/.claude/agents/narrative-designer.md +243 -0
- package/.claude/agents/operations-manager.md +399 -0
- package/.claude/agents/organizational-psychologist.md +391 -0
- package/.claude/agents/paid-media-auditor.md +71 -0
- package/.claude/agents/paid-media-creative-strategist.md +71 -0
- package/.claude/agents/paid-media-paid-social-strategist.md +71 -0
- package/.claude/agents/paid-media-ppc-strategist.md +71 -0
- package/.claude/agents/paid-media-programmatic-buyer.md +71 -0
- package/.claude/agents/paid-media-search-query-analyst.md +71 -0
- package/.claude/agents/paid-media-tracking-specialist.md +71 -0
- package/.claude/agents/personal-growth-mentor.md +159 -0
- package/.claude/agents/product-behavioral-nudge-engine.md +83 -0
- package/.claude/agents/product-dx-engineer.md +332 -0
- package/.claude/agents/product-feedback-synthesizer.md +119 -0
- package/.claude/agents/product-manager.md +469 -0
- package/.claude/agents/product-sprint-prioritizer.md +154 -0
- package/.claude/agents/product-trend-researcher.md +159 -0
- package/.claude/agents/project-management-experiment-tracker.md +198 -0
- package/.claude/agents/project-management-jira-workflow-steward.md +233 -0
- package/.claude/agents/project-management-meeting-notes-specialist.md +95 -0
- package/.claude/agents/project-management-project-shepherd.md +194 -0
- package/.claude/agents/project-management-studio-operations.md +200 -0
- package/.claude/agents/project-management-studio-producer.md +203 -0
- package/.claude/agents/project-manager-senior.md +135 -0
- package/.claude/agents/real-estate-buyer-seller.md +596 -0
- package/.claude/agents/recruitment-specialist.md +515 -0
- package/.claude/agents/report-distribution-agent.md +65 -0
- package/.claude/agents/research-synthesist.md +136 -0
- package/.claude/agents/resume-tailor.md +230 -0
- package/.claude/agents/retail-customer-returns.md +566 -0
- package/.claude/agents/roblox-avatar-creator.md +297 -0
- package/.claude/agents/roblox-experience-designer.md +306 -0
- package/.claude/agents/roblox-systems-scripter.md +332 -0
- package/.claude/agents/sales-account-strategist.md +227 -0
- package/.claude/agents/sales-coach.md +271 -0
- package/.claude/agents/sales-data-extraction-agent.md +67 -0
- package/.claude/agents/sales-deal-strategist.md +180 -0
- package/.claude/agents/sales-discovery-coach.md +225 -0
- package/.claude/agents/sales-engineer.md +182 -0
- package/.claude/agents/sales-offer-lead-gen-strategist.md +257 -0
- package/.claude/agents/sales-outbound-strategist.md +201 -0
- package/.claude/agents/sales-outreach.md +425 -0
- package/.claude/agents/sales-pipeline-analyst.md +267 -0
- package/.claude/agents/sales-proposal-strategist.md +217 -0
- package/.claude/agents/security-ai-generated-code-auditor.md +207 -0
- package/.claude/agents/security-appsec-engineer.md +536 -0
- package/.claude/agents/security-architect.md +307 -0
- package/.claude/agents/security-blockchain-security-auditor.md +482 -0
- package/.claude/agents/security-cloud-security-architect.md +576 -0
- package/.claude/agents/security-compliance-auditor.md +158 -0
- package/.claude/agents/security-incident-responder.md +450 -0
- package/.claude/agents/security-penetration-tester.md +399 -0
- package/.claude/agents/security-secrets-credential-engineer.md +189 -0
- package/.claude/agents/security-senior-secops.md +760 -0
- package/.claude/agents/security-threat-detection-engineer.md +553 -0
- package/.claude/agents/security-threat-intelligence-analyst.md +661 -0
- package/.claude/agents/specialized-chief-of-staff.md +279 -0
- package/.claude/agents/specialized-civil-engineer.md +356 -0
- package/.claude/agents/specialized-codebase-archaeologist.md +341 -0
- package/.claude/agents/specialized-cultural-intelligence-strategist.md +88 -0
- package/.claude/agents/specialized-developer-advocate.md +317 -0
- package/.claude/agents/specialized-document-generator.md +55 -0
- package/.claude/agents/specialized-fedramp-rmf-compliance.md +378 -0
- package/.claude/agents/specialized-focus-music-architect.md +175 -0
- package/.claude/agents/specialized-french-consulting-market.md +194 -0
- package/.claude/agents/specialized-korean-business-navigator.md +216 -0
- package/.claude/agents/specialized-master-plan-architect.md +157 -0
- package/.claude/agents/specialized-mcp-builder.md +260 -0
- package/.claude/agents/specialized-model-qa.md +528 -0
- package/.claude/agents/specialized-pricing-analyst.md +243 -0
- package/.claude/agents/specialized-salesforce-architect.md +182 -0
- package/.claude/agents/specialized-strategy-duel-agent.md +130 -0
- package/.claude/agents/specialized-workflow-architect.md +597 -0
- package/.claude/agents/study-abroad-advisor.md +282 -0
- package/.claude/agents/supply-chain-strategist.md +591 -0
- package/.claude/agents/support-analytics-reporter.md +387 -0
- package/.claude/agents/support-executive-summary-generator.md +212 -0
- package/.claude/agents/support-finance-tracker.md +480 -0
- package/.claude/agents/support-infrastructure-maintainer.md +628 -0
- package/.claude/agents/support-legal-compliance-checker.md +591 -0
- package/.claude/agents/support-support-responder.md +607 -0
- package/.claude/agents/technical-artist.md +233 -0
- package/.claude/agents/terminal-integration-specialist.md +70 -0
- package/.claude/agents/testing-accessibility-auditor.md +327 -0
- package/.claude/agents/testing-api-tester.md +334 -0
- package/.claude/agents/testing-evidence-collector.md +210 -0
- package/.claude/agents/testing-performance-benchmarker.md +283 -0
- package/.claude/agents/testing-reality-checker.md +249 -0
- package/.claude/agents/testing-test-automation-engineer.md +196 -0
- package/.claude/agents/testing-test-results-analyzer.md +330 -0
- package/.claude/agents/testing-tool-evaluator.md +416 -0
- package/.claude/agents/testing-workflow-optimizer.md +463 -0
- package/.claude/agents/unity-architect.md +271 -0
- package/.claude/agents/unity-editor-tool-developer.md +310 -0
- package/.claude/agents/unity-multiplayer-engineer.md +323 -0
- package/.claude/agents/unity-shader-graph-artist.md +269 -0
- package/.claude/agents/unreal-multiplayer-architect.md +364 -0
- package/.claude/agents/unreal-systems-engineer.md +322 -0
- package/.claude/agents/unreal-technical-artist.md +256 -0
- package/.claude/agents/unreal-world-builder.md +273 -0
- package/.claude/agents/visionos-spatial-engineer.md +54 -0
- package/.claude/agents/xr-cockpit-interaction-specialist.md +32 -0
- package/.claude/agents/xr-immersive-developer.md +32 -0
- package/.claude/agents/xr-interface-architect.md +32 -0
- package/.claude/agents/zk-steward.md +211 -0
- package/.claude-plugin/marketplace.json +30 -0
- package/.commitlintrc.json +26 -0
- package/.devcontainer/Dockerfile +24 -0
- package/.devcontainer/devcontainer.json +70 -0
- package/.devcontainer/docker-compose.memory.yml +42 -0
- package/.devcontainer/memory-stack/devcontainer.json +84 -0
- package/.devcontainer/post-create.sh +83 -0
- package/.dockerignore +23 -0
- package/.env.act.example +15 -0
- package/.env.example +171 -0
- package/.eslintrc.json +16 -0
- package/.git-blame-ignore-revs +10 -0
- package/.gitattributes +2 -0
- package/.gitguardian.yaml +50 -0
- package/.githooks/pre-commit +6 -0
- package/.pre-commit-config.yaml +30 -0
- package/.release-please-config-xithead.json +22 -0
- package/.release-please-config.json +44 -0
- package/.release-please-manifest-xithead.json +3 -0
- package/.release-please-manifest.json +3 -0
- package/CODE_OF_CONDUCT.md +133 -0
- package/CONTRIBUTING.md +133 -0
- package/Cargo.lock +5557 -0
- package/Cargo.toml +121 -0
- package/Dockerfile +38 -0
- package/Dockerfile.proxy +48 -0
- package/ENTERPRISE.md +5 -0
- package/FEATURES_ADVANCED.md +311 -0
- package/Headroom-2.gif +0 -0
- package/HeadroomDemo-Fast.gif +0 -0
- package/MANIFEST.in +4 -0
- package/MODERNIZATION_GUIDE.md +358 -0
- package/Makefile +140 -0
- package/NOTICE +43 -0
- package/NPM_TOKEN_SETUP.md +81 -0
- package/PR.md +170 -0
- package/PUBLISH.md +77 -0
- package/README.md +58 -137
- package/README_FRONTEND.md +196 -0
- package/REALIGNMENT/00-overview.md +53 -0
- package/REALIGNMENT/01-bug-list.md +421 -0
- package/REALIGNMENT/02-architecture.md +322 -0
- package/REALIGNMENT/03-phase-A-lockdown.md +420 -0
- package/REALIGNMENT/04-phase-B-live-zone.md +470 -0
- package/REALIGNMENT/05-phase-C-rust-proxy.md +329 -0
- package/REALIGNMENT/06-phase-D-bedrock-vertex.md +222 -0
- package/REALIGNMENT/07-phase-E-cache-stabilization.md +338 -0
- package/REALIGNMENT/08-phase-F-auth-mode.md +254 -0
- package/REALIGNMENT/09-phase-G-rtk-observability.md +194 -0
- package/REALIGNMENT/10-phase-H-python-retirement.md +214 -0
- package/REALIGNMENT/11-phase-I-test-infra.md +385 -0
- package/REALIGNMENT/12-decisions-needed.md +196 -0
- package/REALIGNMENT/INDEX.md +82 -0
- package/REFACTORING_CAMPAIGN.md +277 -0
- package/RESTRUCTURE_PLAN.md +100 -0
- package/RUST_DEV.md +361 -0
- package/SECURITY.md +65 -0
- package/SETUP_AUTO_PUBLISH.md +164 -0
- package/TESTING-copilot-subscription.md +153 -0
- package/app/api/config/route.ts +22 -0
- package/app/api/export/route.ts +83 -0
- package/app/api/models/route.ts +12 -0
- package/app/api/stats/route.ts +46 -0
- package/app/dashboard/page.tsx +445 -0
- package/app/globals.css +35 -0
- package/app/installation/page.tsx +293 -0
- package/app/layout.tsx +35 -0
- package/app/master-design-system.css +2076 -0
- package/app/master-design-system.source.css +8 -0
- package/app/page.tsx +187 -0
- package/app/rechtliches/agb/page.tsx +165 -0
- package/app/rechtliches/datenschutz/page.tsx +128 -0
- package/app/rechtliches/impressum/page.tsx +122 -0
- package/app/rechtliches/widerruf/page.tsx +185 -0
- package/bin/xithead.js +264 -0
- package/codecov.yml +34 -0
- package/components/layout/AppShell.tsx +25 -0
- package/components/layout/Footer.tsx +120 -0
- package/components/layout/Header.tsx +145 -0
- package/components/marketing/LegalHighlights.tsx +45 -0
- package/components/marketing/LegalPageShell.tsx +49 -0
- package/components/marketing/LegalPanel.tsx +41 -0
- package/components/marketing/index.ts +3 -0
- package/crates/headroom-core/Cargo.toml +165 -0
- package/crates/headroom-core/benches/auth_mode.rs +74 -0
- package/crates/headroom-core/benches/ccr_store.rs +224 -0
- package/crates/headroom-core/benches/tokenizer.rs +52 -0
- package/crates/headroom-core/config/pipeline.toml +151 -0
- package/crates/headroom-core/proptest-regressions/transforms/tag_protector.txt +9 -0
- package/crates/headroom-core/src/auth_mode.rs +250 -0
- package/crates/headroom-core/src/cache_control.rs +414 -0
- package/crates/headroom-core/src/ccr/backends/in_memory.rs +317 -0
- package/crates/headroom-core/src/ccr/backends/mod.rs +152 -0
- package/crates/headroom-core/src/ccr/backends/redis.rs +146 -0
- package/crates/headroom-core/src/ccr/backends/sqlite.rs +205 -0
- package/crates/headroom-core/src/ccr/mod.rs +119 -0
- package/crates/headroom-core/src/compression_policy.rs +505 -0
- package/crates/headroom-core/src/lib.rs +33 -0
- package/crates/headroom-core/src/relevance/base.rs +139 -0
- package/crates/headroom-core/src/relevance/bm25.rs +385 -0
- package/crates/headroom-core/src/relevance/embedding.rs +354 -0
- package/crates/headroom-core/src/relevance/hybrid.rs +364 -0
- package/crates/headroom-core/src/relevance/mod.rs +64 -0
- package/crates/headroom-core/src/signals/keyword_detector.rs +433 -0
- package/crates/headroom-core/src/signals/line_importance.rs +84 -0
- package/crates/headroom-core/src/signals/mod.rs +61 -0
- package/crates/headroom-core/src/signals/tiered.rs +141 -0
- package/crates/headroom-core/src/tokenizer/estimator.rs +152 -0
- package/crates/headroom-core/src/tokenizer/hf_impl.rs +314 -0
- package/crates/headroom-core/src/tokenizer/mod.rs +56 -0
- package/crates/headroom-core/src/tokenizer/registry.rs +342 -0
- package/crates/headroom-core/src/tokenizer/tiktoken_impl.rs +265 -0
- package/crates/headroom-core/src/transforms/adaptive_sizer.rs +610 -0
- package/crates/headroom-core/src/transforms/anchor_selector.rs +1189 -0
- package/crates/headroom-core/src/transforms/content_detector.rs +769 -0
- package/crates/headroom-core/src/transforms/detection.rs +222 -0
- package/crates/headroom-core/src/transforms/diff_compressor.rs +1685 -0
- package/crates/headroom-core/src/transforms/live_zone.rs +2967 -0
- package/crates/headroom-core/src/transforms/log_compressor.rs +1295 -0
- package/crates/headroom-core/src/transforms/magika_detector.rs +395 -0
- package/crates/headroom-core/src/transforms/mod.rs +64 -0
- package/crates/headroom-core/src/transforms/pipeline/config.rs +331 -0
- package/crates/headroom-core/src/transforms/pipeline/mod.rs +103 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_noise.rs +524 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/diff_offload.rs +279 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/json_offload.rs +400 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/log_offload.rs +284 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/mod.rs +34 -0
- package/crates/headroom-core/src/transforms/pipeline/offloads/search_offload.rs +331 -0
- package/crates/headroom-core/src/transforms/pipeline/orchestrator.rs +848 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/json_minifier.rs +175 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/log_template.rs +545 -0
- package/crates/headroom-core/src/transforms/pipeline/reformats/mod.rs +12 -0
- package/crates/headroom-core/src/transforms/pipeline/traits.rs +338 -0
- package/crates/headroom-core/src/transforms/recommendations.rs +329 -0
- package/crates/headroom-core/src/transforms/safety.rs +215 -0
- package/crates/headroom-core/src/transforms/search_compressor.rs +902 -0
- package/crates/headroom-core/src/transforms/smart_crusher/analyzer.rs +1262 -0
- package/crates/headroom-core/src/transforms/smart_crusher/anchors.rs +407 -0
- package/crates/headroom-core/src/transforms/smart_crusher/builder.rs +263 -0
- package/crates/headroom-core/src/transforms/smart_crusher/classifier.rs +214 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/classifier.rs +283 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/compactor.rs +733 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/formatter.rs +961 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/ir.rs +252 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/mod.rs +127 -0
- package/crates/headroom-core/src/transforms/smart_crusher/compaction/walker.rs +397 -0
- package/crates/headroom-core/src/transforms/smart_crusher/config.rs +173 -0
- package/crates/headroom-core/src/transforms/smart_crusher/constraints.rs +159 -0
- package/crates/headroom-core/src/transforms/smart_crusher/crusher.rs +1665 -0
- package/crates/headroom-core/src/transforms/smart_crusher/crushers.rs +865 -0
- package/crates/headroom-core/src/transforms/smart_crusher/error_keywords.rs +77 -0
- package/crates/headroom-core/src/transforms/smart_crusher/field_detect.rs +393 -0
- package/crates/headroom-core/src/transforms/smart_crusher/hashing.rs +72 -0
- package/crates/headroom-core/src/transforms/smart_crusher/mod.rs +81 -0
- package/crates/headroom-core/src/transforms/smart_crusher/observer.rs +66 -0
- package/crates/headroom-core/src/transforms/smart_crusher/orchestration.rs +459 -0
- package/crates/headroom-core/src/transforms/smart_crusher/outliers.rs +507 -0
- package/crates/headroom-core/src/transforms/smart_crusher/planning.rs +904 -0
- package/crates/headroom-core/src/transforms/smart_crusher/statistics.rs +510 -0
- package/crates/headroom-core/src/transforms/smart_crusher/stats_math.rs +287 -0
- package/crates/headroom-core/src/transforms/smart_crusher/traits.rs +203 -0
- package/crates/headroom-core/src/transforms/smart_crusher/types.rs +263 -0
- package/crates/headroom-core/src/transforms/tag_protector.rs +1272 -0
- package/crates/headroom-core/src/transforms/unidiff_detector.rs +232 -0
- package/crates/headroom-parity/Cargo.toml +26 -0
- package/crates/headroom-parity/examples/diff_fixture.rs +66 -0
- package/crates/headroom-parity/src/bin/parity_run.rs +78 -0
- package/crates/headroom-parity/src/lib.rs +613 -0
- package/crates/headroom-proxy/Cargo.toml +119 -0
- package/crates/headroom-proxy/data/model_prices_and_context_window.json +39767 -0
- package/crates/headroom-proxy/src/bedrock/auth_mode_layer.rs +192 -0
- package/crates/headroom-proxy/src/bedrock/envelope.rs +239 -0
- package/crates/headroom-proxy/src/bedrock/eventstream.rs +769 -0
- package/crates/headroom-proxy/src/bedrock/eventstream_to_sse.rs +459 -0
- package/crates/headroom-proxy/src/bedrock/invoke.rs +735 -0
- package/crates/headroom-proxy/src/bedrock/invoke_streaming.rs +1098 -0
- package/crates/headroom-proxy/src/bedrock/mod.rs +66 -0
- package/crates/headroom-proxy/src/bedrock/sigv4.rs +324 -0
- package/crates/headroom-proxy/src/bedrock/vendor.rs +82 -0
- package/crates/headroom-proxy/src/cache_stabilization/anthropic_cache_control.rs +698 -0
- package/crates/headroom-proxy/src/cache_stabilization/drift_detector.rs +683 -0
- package/crates/headroom-proxy/src/cache_stabilization/mod.rs +61 -0
- package/crates/headroom-proxy/src/cache_stabilization/openai_cache_key.rs +600 -0
- package/crates/headroom-proxy/src/cache_stabilization/tool_def_normalize.rs +514 -0
- package/crates/headroom-proxy/src/cache_stabilization/volatile_detector.rs +720 -0
- package/crates/headroom-proxy/src/compression/anthropic.rs +92 -0
- package/crates/headroom-proxy/src/compression/live_zone_anthropic.rs +1311 -0
- package/crates/headroom-proxy/src/compression/live_zone_openai.rs +660 -0
- package/crates/headroom-proxy/src/compression/live_zone_responses.rs +678 -0
- package/crates/headroom-proxy/src/compression/mod.rs +127 -0
- package/crates/headroom-proxy/src/compression/model_limits.rs +211 -0
- package/crates/headroom-proxy/src/config.rs +646 -0
- package/crates/headroom-proxy/src/error.rs +69 -0
- package/crates/headroom-proxy/src/handlers/chat_completions.rs +100 -0
- package/crates/headroom-proxy/src/handlers/conversations.rs +241 -0
- package/crates/headroom-proxy/src/handlers/mod.rs +13 -0
- package/crates/headroom-proxy/src/handlers/responses.rs +256 -0
- package/crates/headroom-proxy/src/headers.rs +288 -0
- package/crates/headroom-proxy/src/health.rs +41 -0
- package/crates/headroom-proxy/src/lib.rs +21 -0
- package/crates/headroom-proxy/src/main.rs +141 -0
- package/crates/headroom-proxy/src/observability/cache_hit_rate.rs +340 -0
- package/crates/headroom-proxy/src/observability/compression_ratio.rs +158 -0
- package/crates/headroom-proxy/src/observability/metric_names.rs +174 -0
- package/crates/headroom-proxy/src/observability/mod.rs +68 -0
- package/crates/headroom-proxy/src/observability/prometheus.rs +394 -0
- package/crates/headroom-proxy/src/observability/proxy_metrics.rs +368 -0
- package/crates/headroom-proxy/src/proxy.rs +1619 -0
- package/crates/headroom-proxy/src/responses_items.rs +565 -0
- package/crates/headroom-proxy/src/sse/anthropic.rs +415 -0
- package/crates/headroom-proxy/src/sse/framing.rs +366 -0
- package/crates/headroom-proxy/src/sse/mod.rs +40 -0
- package/crates/headroom-proxy/src/sse/openai_chat.rs +231 -0
- package/crates/headroom-proxy/src/sse/openai_responses.rs +458 -0
- package/crates/headroom-proxy/src/vertex/adc.rs +315 -0
- package/crates/headroom-proxy/src/vertex/envelope.rs +167 -0
- package/crates/headroom-proxy/src/vertex/mod.rs +277 -0
- package/crates/headroom-proxy/src/vertex/raw_predict.rs +490 -0
- package/crates/headroom-proxy/src/vertex/stream_raw_predict.rs +49 -0
- package/crates/headroom-proxy/src/websocket.rs +246 -0
- package/crates/headroom-py/Cargo.toml +37 -0
- package/crates/headroom-py/build.rs +77 -0
- package/crates/headroom-py/glibc_compat.c +170 -0
- package/crates/headroom-py/src/lib.rs +1655 -0
- package/deny.toml +32 -0
- package/design-system/base.css +127 -0
- package/design-system/components.css +1943 -0
- package/design-system/fonts.css +17 -0
- package/design-system/tailwind-preset.js +95 -0
- package/design-system/tokens.css +48 -0
- package/design-system/utilities.css +53 -0
- package/docker/differential-network-capture/Dockerfile.runner +14 -0
- package/docker/differential-network-capture/docker-compose.yml +142 -0
- package/docker/differential-network-capture/run-claude-lane.sh +24 -0
- package/docker/docker-compose.native.yml +44 -0
- package/docker-bake.hcl +88 -0
- package/docker-compose.yml +80 -0
- package/e2e/_lib/make_shim.ps1 +24 -0
- package/e2e/_lib/make_shim.sh +28 -0
- package/e2e/docker-native-install.sh +120 -0
- package/e2e/init/Dockerfile +79 -0
- package/e2e/wrap/Dockerfile +115 -0
- package/examples/07-context-compression.ipynb +279 -0
- package/examples/deployment/macos-launchagent/com.headroom.proxy.plist.template +65 -0
- package/examples/deployment/macos-launchagent/install.sh +227 -0
- package/examples/deployment/macos-launchagent/shell-integration.sh +74 -0
- package/examples/deployment/macos-launchagent/uninstall.sh +145 -0
- package/headroom-savings.png +0 -0
- package/headroom_learn.gif +0 -0
- package/lib/config/index.ts +12 -0
- package/lib/hooks/index.ts +4 -0
- package/lib/hooks/use-mounted.ts +13 -0
- package/lib/hooks/use-session.ts +34 -0
- package/lib/hooks/use-settings.ts +49 -0
- package/lib/utils/index.ts +1 -0
- package/lib/utils/settings.ts +162 -0
- package/lib/utils/utils.ts +6 -0
- package/llms.txt +67 -0
- package/middleware.ts +26 -0
- package/mkdocs.yml +136 -0
- package/next-env.d.ts +7 -0
- package/next.config.ts +12 -0
- package/npm/bin/xithead.js +2 -2
- package/npm/bin/xtream-head.js +366 -0
- package/npm/index.js +18 -91
- package/npm/package.json +55 -0
- package/package.json +47 -42
- package/plugins/headroom-agent-hooks/.claude-plugin/plugin.json +17 -0
- package/plugins/headroom-agent-hooks/hooks/hooks.json +29 -0
- package/plugins/headroom-oauth2/LICENSE +3 -0
- package/plugins/headroom-oauth2/SPEC.md +115 -0
- package/plugins/headroom-oauth2/pyproject.toml +48 -0
- package/plugins/hermes/headroom_retrieve/plugin.yaml +6 -0
- package/plugins/openclaw/hook-shim/HOOK.md +21 -0
- package/plugins/openclaw/hook-shim/handler.js +3 -0
- package/plugins/openclaw/openclaw.plugin.json +98 -0
- package/plugins/openclaw/package-lock.json +2692 -0
- package/plugins/openclaw/package.json +54 -0
- package/plugins/openclaw/prepare-dist.mjs +56 -0
- package/plugins/openclaw/src/convert.ts +418 -0
- package/plugins/openclaw/src/engine.ts +284 -0
- package/plugins/openclaw/src/gateway-config.ts +143 -0
- package/plugins/openclaw/src/index.ts +11 -0
- package/plugins/openclaw/src/plugin/index.ts +98 -0
- package/plugins/openclaw/src/proxy-manager.ts +477 -0
- package/plugins/openclaw/src/tools/headroom-retrieve.ts +76 -0
- package/plugins/openclaw/test/convert.test.ts +96 -0
- package/plugins/openclaw/test/engine-normalization.test.ts +21 -0
- package/plugins/openclaw/test/engine.test.ts +101 -0
- package/plugins/openclaw/test/gateway-config.test.ts +278 -0
- package/plugins/openclaw/test/plugin-runtime-routing.test.ts +141 -0
- package/plugins/openclaw/test/proxy-manager.test.ts +343 -0
- package/plugins/openclaw/tsup.config.ts +9 -0
- package/postcss.config.mjs +7 -0
- package/pyproject.toml +438 -0
- package/rust-toolchain.toml +16 -0
- package/sdk/typescript/examples/basic-compress.ts +64 -0
- package/sdk/typescript/examples/ccr-retrieve.ts +80 -0
- package/sdk/typescript/examples/hooks-custom-compression.ts +117 -0
- package/sdk/typescript/examples/middleware-composition.ts +59 -0
- package/sdk/typescript/examples/multi-provider.ts +53 -0
- package/sdk/typescript/examples/openai-anthropic-adapters.ts +73 -0
- package/sdk/typescript/examples/shared-context-multi-agent.ts +74 -0
- package/sdk/typescript/examples/simulation-dry-run.ts +80 -0
- package/sdk/typescript/examples/streaming-chat.ts +71 -0
- package/sdk/typescript/examples/structured-output.ts +99 -0
- package/sdk/typescript/examples/tool-calling-agent.ts +86 -0
- package/sdk/typescript/examples/with-headroom-vercel.ts +57 -0
- package/sdk/typescript/package-lock.json +3437 -0
- package/sdk/typescript/package.json +108 -0
- package/sdk/typescript/src/adapters/anthropic.ts +218 -0
- package/sdk/typescript/src/adapters/gemini.ts +83 -0
- package/sdk/typescript/src/adapters/openai.ts +77 -0
- package/sdk/typescript/src/adapters/vercel-ai.ts +131 -0
- package/sdk/typescript/src/client.ts +632 -0
- package/sdk/typescript/src/compress.ts +87 -0
- package/sdk/typescript/src/errors.ts +114 -0
- package/sdk/typescript/src/hooks.ts +113 -0
- package/sdk/typescript/src/index.ts +140 -0
- package/sdk/typescript/src/paths.ts +272 -0
- package/sdk/typescript/src/shared-context.ts +188 -0
- package/sdk/typescript/src/simulate.ts +52 -0
- package/sdk/typescript/src/types/config.ts +183 -0
- package/sdk/typescript/src/types/models.ts +314 -0
- package/sdk/typescript/src/types.ts +139 -0
- package/sdk/typescript/src/utils/case.ts +34 -0
- package/sdk/typescript/src/utils/format.ts +480 -0
- package/sdk/typescript/src/utils/stream.ts +50 -0
- package/sdk/typescript/test/adapters/anthropic.test.ts +217 -0
- package/sdk/typescript/test/adapters/gemini.test.ts +131 -0
- package/sdk/typescript/test/adapters/openai.test.ts +174 -0
- package/sdk/typescript/test/adapters/vercel-ai.test.ts +306 -0
- package/sdk/typescript/test/client-expanded.test.ts +333 -0
- package/sdk/typescript/test/client.test.ts +266 -0
- package/sdk/typescript/test/compress.test.ts +118 -0
- package/sdk/typescript/test/config.test.ts +275 -0
- package/sdk/typescript/test/errors.test.ts +169 -0
- package/sdk/typescript/test/format-integration.test.ts +252 -0
- package/sdk/typescript/test/hooks.test.ts +265 -0
- package/sdk/typescript/test/integration.test.ts +249 -0
- package/sdk/typescript/test/mdx-examples.test.ts +253 -0
- package/sdk/typescript/test/models.test.ts +318 -0
- package/sdk/typescript/test/parity.test.ts +337 -0
- package/sdk/typescript/test/paths.test.ts +447 -0
- package/sdk/typescript/test/shared-context.test.ts +245 -0
- package/sdk/typescript/test/simulate.test.ts +84 -0
- package/sdk/typescript/test/types.test.ts +244 -0
- package/sdk/typescript/test/utils/case.test.ts +129 -0
- package/sdk/typescript/test/utils/detect-format.test.ts +133 -0
- package/sdk/typescript/test/utils/format.test.ts +434 -0
- package/sdk/typescript/test/vercel-ai-e2e.test.ts +179 -0
- package/sdk/typescript/tsup.config.ts +17 -0
- package/tailwind.master.config.cjs +47 -0
- package/types/api.ts +12 -0
- package/types/config.ts +9 -0
- package/types/index.ts +2 -0
- package/uv.lock +6951 -0
- package/xithead.egg-info/PKG-INFO +22 -0
- package/xithead.egg-info/SOURCES.txt +16 -0
- package/xithead.egg-info/dependency_links.txt +1 -0
- package/xithead.egg-info/entry_points.txt +2 -0
- package/xithead.egg-info/requires.txt +10 -0
- package/xithead.egg-info/top_level.txt +2 -0
- package/xithead.ps1 +136 -0
- package/xithead.sh +129 -0
- package/xithead_dist/pyproject.toml +39 -0
- package/xithead_dist/xithead.egg-info/PKG-INFO +22 -0
- package/xithead_dist/xithead.egg-info/SOURCES.txt +16 -0
- package/xithead_dist/xithead.egg-info/dependency_links.txt +1 -0
- package/xithead_dist/xithead.egg-info/entry_points.txt +3 -0
- package/xithead_dist/xithead.egg-info/requires.txt +10 -0
- package/xithead_dist/xithead.egg-info/top_level.txt +2 -0
package/PR.md
ADDED
|
@@ -0,0 +1,170 @@
|
|
|
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
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
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.md
CHANGED
|
@@ -1,187 +1,108 @@
|
|
|
1
|
-
|
|
2
|
-
<img src="https://cdn.xtream-itsolutions.com/u/logo.png" alt="Xtream-ITSolutions UG" width="140" />
|
|
3
|
-
<br/><br/>
|
|
4
|
-
<h1>⚡ xithead</h1>
|
|
5
|
-
<p><strong>Claude Context Optimizer — bis zu 95% Token-Einsparung, automatisch</strong></p>
|
|
6
|
-
<p>
|
|
7
|
-
<a href="https://pypi.org/project/xithead/"><img src="https://img.shields.io/pypi/v/xithead?color=00e5ff&label=PyPI&style=flat-square" alt="PyPI" /></a>
|
|
8
|
-
<a href="https://www.npmjs.com/package/xithead"><img src="https://img.shields.io/npm/v/xithead?color=a855f7&label=npm&style=flat-square" alt="npm" /></a>
|
|
9
|
-
<a href="https://discord.gg/xtream-itsolutions"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" /></a>
|
|
10
|
-
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-10b981?style=flat-square" alt="Apache 2.0" /></a>
|
|
11
|
-
</p>
|
|
12
|
-
<p>
|
|
13
|
-
<a href="https://xtream-itsolutions.com">🌐 xtream-itsolutions.com</a> ·
|
|
14
|
-
<a href="https://discord.gg/xtream-itsolutions">💬 Discord</a> ·
|
|
15
|
-
<a href="https://github.com/xtream-itsolutions/xithead/issues">🐛 Bug melden</a>
|
|
16
|
-
</p>
|
|
17
|
-
</div>
|
|
1
|
+
# xtream-head
|
|
18
2
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
## Was ist xithead?
|
|
22
|
-
|
|
23
|
-
**xithead** ist ein lokaler Proxy von **[Xtream-ITSolutions UG](https://xtream-itsolutions.com)**, der sich zwischen Claude Code und die Anthropic API setzt. Er komprimiert Kontext aggressiv, cached Antworten und dedupliziert identische Requests — vollautomatisch, ohne Code-Änderungen.
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
Claude Code ──► xithead Proxy :8787 ──► Anthropic API
|
|
27
|
-
│ Cache-Control
|
|
28
|
-
│ Context-Trim
|
|
29
|
-
│ Request-Dedup
|
|
30
|
-
└ Live Dashboard
|
|
31
|
-
```
|
|
3
|
+
**Lokaler Claude Code Proxy** von [Xtream-ITSolutions UG](https://xtream-itsolutions.com) — setzt sich zwischen Claude Code und die Anthropic API, maximiert den Prompt Cache und reduziert Token-Kosten bis zu **88%**.
|
|
32
4
|
|
|
33
|
-
|
|
5
|
+
Dashboard läuft lokal auf `localhost:8787/dashboard` — deine Stats, deine Daten.
|
|
34
6
|
|
|
35
7
|
---
|
|
36
8
|
|
|
37
9
|
## Installation
|
|
38
10
|
|
|
39
|
-
###
|
|
40
|
-
|
|
41
|
-
```powershell
|
|
42
|
-
iex (irm https://raw.githubusercontent.com/xtream-itsolutions/xithead/main/headroom.ps1)
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Das Skript installiert automatisch (ohne Adminrechte):
|
|
46
|
-
- Python 3.12, Node.js, Git (via Winget falls nicht vorhanden)
|
|
47
|
-
- xithead Python-Paket + Proxy-Abhängigkeiten
|
|
48
|
-
- xithead npm CLI + Claude Code
|
|
49
|
-
- Claude Code konfigurieren (`~/.claude/settings.json`)
|
|
50
|
-
- PowerShell-Profil mit allen Hilfsbefehlen
|
|
11
|
+
### Option 1: Proxy (Python, empfohlen für Claude Code)
|
|
51
12
|
|
|
52
|
-
|
|
53
|
-
- Claude Login (Browser oder API-Key)
|
|
54
|
-
- GitHub Token (für Repo-Zugriff in Claude Code)
|
|
55
|
-
|
|
56
|
-
### npm (Windows / macOS / Linux)
|
|
13
|
+
Der Proxy ist das Python-Paket. Er startet auf `http://127.0.0.1:8787` und leitet Anfragen an `https://api.anthropic.com` weiter.
|
|
57
14
|
|
|
58
15
|
```bash
|
|
59
|
-
|
|
60
|
-
|
|
16
|
+
pip install "xtream-head[proxy]" # aus PyPI, sobald veröffentlicht
|
|
17
|
+
# oder aus dem Repo:
|
|
18
|
+
pip install -e ".[proxy]"
|
|
61
19
|
```
|
|
62
20
|
|
|
63
|
-
|
|
21
|
+
Proxy starten und Claude Code direkt darüber laufen lassen:
|
|
22
|
+
```bash
|
|
23
|
+
xithead wrap claude
|
|
24
|
+
```
|
|
64
25
|
|
|
26
|
+
Oder den Proxy separat starten und die Umgebungsvariable selbst setzen:
|
|
65
27
|
```bash
|
|
66
|
-
|
|
67
|
-
|
|
28
|
+
xithead proxy --port 8787
|
|
29
|
+
export ANTHROPIC_BASE_URL=http://127.0.0.1:8787 # Windows PowerShell: $env:ANTHROPIC_BASE_URL='http://127.0.0.1:8787'
|
|
30
|
+
claude
|
|
68
31
|
```
|
|
69
32
|
|
|
70
|
-
|
|
33
|
+
### Option 2: Dashboard (npm)
|
|
71
34
|
|
|
72
|
-
|
|
35
|
+
Das npm-Paket startet nur das Next.js-Dashboard. Es startet keinen Proxy.
|
|
73
36
|
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
xithead
|
|
77
|
-
xithead stats # Token-Einsparungen anzeigen
|
|
78
|
-
xithead update # Alles aktualisieren (npm + Python)
|
|
79
|
-
xithead help # Alle Befehle
|
|
37
|
+
```bash
|
|
38
|
+
npm install -g github:xtream-itsolutions/xithead
|
|
39
|
+
xithead # Dashboard auf http://localhost:8787/dashboard
|
|
80
40
|
```
|
|
81
41
|
|
|
82
|
-
|
|
42
|
+
> **Hinweis:** Beide Pakete stellen einen Befehl `xithead` bereit. Nicht beide gleichzeitig installieren, und beide Dienste nicht gleichzeitig auf Port 8787 starten.
|
|
43
|
+
|
|
44
|
+
### Option 3: Skript-Installation (Windows)
|
|
83
45
|
|
|
84
46
|
```powershell
|
|
85
|
-
|
|
86
|
-
xithead
|
|
87
|
-
xithead-update # Alles auf neuestem Stand halten
|
|
88
|
-
xithead-github # GitHub Token + MCP Server einrichten
|
|
89
|
-
xithead-doctor # System-Diagnose
|
|
90
|
-
xithead-help # Alle Befehle
|
|
47
|
+
iex (irm https://raw.githubusercontent.com/xtream-itsolutions/xithead/main/xithead.ps1)
|
|
48
|
+
xithead
|
|
91
49
|
```
|
|
92
50
|
|
|
93
|
-
|
|
51
|
+
### VS Code: Claude Code Extension über den Proxy betreiben
|
|
94
52
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
Das Live-Dashboard läuft automatisch auf `http://localhost:8787/dashboard`:
|
|
98
|
-
|
|
99
|
-
- **Echtzeit-Statistiken** — Token gespart, Kosten, Cache-Hit-Rate
|
|
100
|
-
- **Request-Verlauf** — Token-Verbrauch pro Request als Chart
|
|
101
|
-
- **Einstellungen** — Komprimierungsstärke, Cache-Optionen
|
|
102
|
-
- **Installation** — Quick-Start Guide direkt im Browser
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## Wie es funktioniert
|
|
107
|
-
|
|
108
|
-
| Feature | Beschreibung |
|
|
109
|
-
|---|---|
|
|
110
|
-
| **Cache Control** | Anthropic `cache_control` wird automatisch in jeden Request injiziert (bis zu 90% Einsparung bei Wiederholungen) |
|
|
111
|
-
| **Context Trimming** | Lange Konversations-Historien werden aggressiv komprimiert |
|
|
112
|
-
| **Request Deduplication** | Identische gleichzeitige Requests werden zusammengeführt |
|
|
113
|
-
| **429 Retry** | Automatisches Retry mit `Retry-After` Header bei Rate Limits |
|
|
114
|
-
| **SQLite Cache** | Persistenter Cache unter `~/.xithead/cache/` |
|
|
115
|
-
|
|
116
|
-
---
|
|
117
|
-
|
|
118
|
-
## Claude Code konfigurieren
|
|
119
|
-
|
|
120
|
-
xithead setzt `~/.claude/settings.json` automatisch während der Installation:
|
|
53
|
+
Die Extension liest dieselbe Claude-Code-Konfiguration wie die CLI. Die Umgebungsvariable deshalb in `~/.claude/settings.json` eintragen, nicht nur in der Shell:
|
|
121
54
|
|
|
122
55
|
```json
|
|
123
56
|
{
|
|
124
57
|
"env": {
|
|
125
|
-
"ANTHROPIC_BASE_URL": "http://
|
|
126
|
-
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000",
|
|
127
|
-
"XITHEAD_ENABLE_CACHE_CONTROL": "1",
|
|
128
|
-
"XITHEAD_ENABLE_DEDUP": "1",
|
|
129
|
-
"XITHEAD_ENABLE_CONTEXT_TRIM": "1",
|
|
130
|
-
"HEADROOM_STRENGTH": "aggressive"
|
|
58
|
+
"ANTHROPIC_BASE_URL": "http://127.0.0.1:8787"
|
|
131
59
|
}
|
|
132
60
|
}
|
|
133
61
|
```
|
|
134
62
|
|
|
135
|
-
|
|
63
|
+
Danach:
|
|
64
|
+
1. Proxy starten: `xithead proxy --port 8787`.
|
|
65
|
+
2. VS Code komplett neu starten, damit die Extension die Einstellung übernimmt.
|
|
66
|
+
3. Im Claude-Code-Panel eine Nachricht senden.
|
|
136
67
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
## GitHub Integration
|
|
140
|
-
|
|
141
|
-
Claude Code kann direkt mit GitHub arbeiten (Repos lesen, PRs erstellen, Issues verwalten):
|
|
68
|
+
Ist der Proxy nicht gestartet, schlagen Anfragen fehl. Dann den `env`-Eintrag entfernen, damit Claude Code wieder direkt mit der Anthropic-API spricht.
|
|
142
69
|
|
|
143
|
-
|
|
144
|
-
xithead-github # GitHub Token eingeben + MCP Server einrichten
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
Token erstellen unter: [github.com/settings/tokens/new](https://github.com/settings/tokens/new)
|
|
148
|
-
Benötigte Scopes: `repo`, `workflow`, `read:org`
|
|
70
|
+
Vollständige Anleitung für Windows, macOS und Linux: **[xtream-head.com/installation](https://xtream-head.com/installation)**
|
|
149
71
|
|
|
150
72
|
---
|
|
151
73
|
|
|
152
|
-
##
|
|
153
|
-
|
|
154
|
-
xithead prüft automatisch alle 6 Stunden auf neue Versionen:
|
|
155
|
-
- Neue npm-Version → stiller Hintergrund-Update
|
|
156
|
-
- Python-Paket → parallel aktualisiert
|
|
74
|
+
## Befehle
|
|
157
75
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
76
|
+
| Befehl | Funktion |
|
|
77
|
+
|--------|----------|
|
|
78
|
+
| `xtream-head` | Proxy + Claude Code starten |
|
|
79
|
+
| `xtream-head-dashboard` | Dashboard im Browser öffnen |
|
|
80
|
+
| `xtream-head-stats` | Einsparungen in der Konsole anzeigen |
|
|
81
|
+
| `xtream-head-update` | Alles aktualisieren |
|
|
82
|
+
| `xtream-head-doctor` | System-Diagnose |
|
|
83
|
+
| `headroom privacy doctor` | Datenschutz- und Deployment-Sicherheit prüfen |
|
|
163
84
|
|
|
164
85
|
---
|
|
165
86
|
|
|
166
|
-
##
|
|
87
|
+
## Was es macht
|
|
167
88
|
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
89
|
+
- **Cache-Control Normalisierung** — Verhindert HTTP 400 Fehler
|
|
90
|
+
- **Lossless Compression** — ANSI-Strip, Run-Collapse, Diff-Strip, Line-Truncation
|
|
91
|
+
- **Message Dedup** — Identische Nachrichten werden eliminiert
|
|
92
|
+
- **Context Trim** — Automatische Kürzung bei Token-Overflow
|
|
93
|
+
- **Lokales Dashboard** — Echtzeit-Stats auf `localhost:8787/dashboard`
|
|
94
|
+
- **Policy Engine** — Provider-, Modell- und Projektregeln für sichere Kompression
|
|
95
|
+
- **Replay-Fixtures** — anonymisierte Requests reproduzierbar analysieren
|
|
96
|
+
- **Quality Score** — Einsparung, Latenz, Struktur und Zuverlässigkeit gemeinsam bewerten
|
|
174
97
|
|
|
175
98
|
---
|
|
176
99
|
|
|
177
|
-
##
|
|
100
|
+
## Links
|
|
178
101
|
|
|
179
|
-
|
|
102
|
+
- Website: [xtream-head.com](https://xtream-head.com)
|
|
103
|
+
- Discord: [discord.gg/xtream-itsolutions](https://discord.gg/xtream-itsolutions)
|
|
104
|
+
- Unternehmen: [xtream-itsolutions.com](https://xtream-itsolutions.com)
|
|
180
105
|
|
|
181
106
|
---
|
|
182
107
|
|
|
183
|
-
|
|
184
|
-
<a href="https://discord.gg/xtream-itsolutions">💬 Discord</a> ·
|
|
185
|
-
<a href="https://xtream-itsolutions.com">🌐 xtream-itsolutions.com</a> ·
|
|
186
|
-
<a href="https://github.com/xtream-itsolutions/xithead">GitHub</a>
|
|
187
|
-
</div>
|
|
108
|
+
Apache 2.0 License · © 2026 Xtream-ITSolutions UG
|
|
@@ -0,0 +1,196 @@
|
|
|
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
|