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
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# scripts/
|
|
2
|
+
|
|
3
|
+
Utility scripts bundled with the Headroom repo. Most are one-off operator
|
|
4
|
+
tools; a few are runnable as part of development workflows.
|
|
5
|
+
|
|
6
|
+
## Reproducing the reconnect storm
|
|
7
|
+
|
|
8
|
+
`repro_codex_replay.py` reproduces the multi-agent Codex reconnect/retry storm
|
|
9
|
+
against a local Xtream Head proxy (default `http://127.0.0.1:8787`), as described
|
|
10
|
+
in `wiki/plans/2026-04-17-codex-proxy-runtime-analysis.md` under "Latest
|
|
11
|
+
Correction". Use it to:
|
|
12
|
+
|
|
13
|
+
- Regression-check that `/livez` stays responsive under a cold-start storm.
|
|
14
|
+
- Empirically tune the Unit 4 pre-upstream semaphore default
|
|
15
|
+
(`HEADROOM_ANTHROPIC_PRE_UPSTREAM_CONCURRENCY`).
|
|
16
|
+
- Exercise the Codex WS lifecycle + Anthropic HTTP path simultaneously
|
|
17
|
+
without needing to replay captured production traffic.
|
|
18
|
+
|
|
19
|
+
### Run
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# Default: 8 WS + 4 HTTP clients, 30s storm, p99 /livez must stay <= 500ms.
|
|
23
|
+
python scripts/repro_codex_replay.py
|
|
24
|
+
|
|
25
|
+
# Tighter budget, shorter run:
|
|
26
|
+
python scripts/repro_codex_replay.py \
|
|
27
|
+
--url http://127.0.0.1:8787 \
|
|
28
|
+
--ws-clients 16 \
|
|
29
|
+
--anthropic-clients 8 \
|
|
30
|
+
--duration 60 \
|
|
31
|
+
--livez-threshold-ms 100
|
|
32
|
+
|
|
33
|
+
# Dump the full summary as JSON for downstream tooling:
|
|
34
|
+
python scripts/repro_codex_replay.py --json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Exit code:
|
|
38
|
+
|
|
39
|
+
- `0` — warmup succeeded (or was skipped), storm ran for the requested
|
|
40
|
+
duration, and `/livez` p99 stayed under `--livez-threshold-ms`.
|
|
41
|
+
- `1` — soft assertion failed, proxy unreachable, or unhandled exception.
|
|
42
|
+
Proxy-unreachable is detected and reported within ~5 seconds.
|
|
43
|
+
|
|
44
|
+
### Fixtures
|
|
45
|
+
|
|
46
|
+
The script loads two hand-crafted, fully synthetic JSON fixtures:
|
|
47
|
+
|
|
48
|
+
- `scripts/fixtures/anthropic_replay_body.json` — shape of a large agent
|
|
49
|
+
reconnect replay `/v1/messages?beta=true` POST body.
|
|
50
|
+
- `scripts/fixtures/codex_response_create_frame.json` — first Codex WS frame
|
|
51
|
+
with the `{"type": "response.create", "response": {...}}` envelope.
|
|
52
|
+
|
|
53
|
+
Override via `--ws-frame-fixture` / `--anthropic-body-fixture` if you have
|
|
54
|
+
captured traffic to replay instead.
|
|
55
|
+
|
|
56
|
+
### Interpretation
|
|
57
|
+
|
|
58
|
+
- `/livez p99` under threshold means the event loop is not starved during the
|
|
59
|
+
storm. If it rises with the semaphore unbounded
|
|
60
|
+
(`HEADROOM_ANTHROPIC_PRE_UPSTREAM_CONCURRENCY=10000`) and drops back under
|
|
61
|
+
the default, Unit 4's backpressure is working.
|
|
62
|
+
- `Codex WS: opened` should equal `--ws-clients`. `response.completed`
|
|
63
|
+
typically stays low when upstream auth isn't configured locally — the goal
|
|
64
|
+
is handshake + relay wiring, not real upstream traffic.
|
|
65
|
+
- `Anthropic HTTP: ok_2xx + non_2xx + timed_out + errors` should roughly equal
|
|
66
|
+
`attempted`. Sustained non-zero `timed_out` during the storm is the failure
|
|
67
|
+
signal the plan targets.
|
|
68
|
+
|
|
69
|
+
A smoke test at `tests/test_scripts/test_repro_codex_replay_smoke.py`
|
|
70
|
+
exercises the script against a mock FastAPI server on every PR.
|
|
71
|
+
|
|
72
|
+
## Install scripts
|
|
73
|
+
|
|
74
|
+
- `install.sh` — POSIX installer.
|
|
75
|
+
- `install.ps1` — Windows PowerShell installer.
|
|
76
|
+
|
|
77
|
+
These are generated by the release pipeline; edit with care.
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Audit a manylinux Python wheel for glibc symbol references that exceed
|
|
3
|
+
the wheel's declared manylinux ABI floor.
|
|
4
|
+
|
|
5
|
+
This catches the bug class from issue #355: a wheel tagged
|
|
6
|
+
`manylinux_2_28_x86_64` whose `_core.so` references `__isoc23_strtoll`
|
|
7
|
+
(introduced in glibc 2.38) — the link succeeds because the manylinux
|
|
8
|
+
build host has 2.38+, but every end user with glibc < 2.38 sees an
|
|
9
|
+
`ImportError: undefined symbol` at `import headroom._core`.
|
|
10
|
+
|
|
11
|
+
How it works
|
|
12
|
+
------------
|
|
13
|
+
|
|
14
|
+
1. Parse the wheel filename to extract the manylinux tag
|
|
15
|
+
(`manylinux_2_28` → glibc floor 2.28).
|
|
16
|
+
2. Run `objdump -T` (or `nm -D`) on every `.so` inside the wheel.
|
|
17
|
+
3. For every `UND` symbol, check whether it's allowed at the glibc
|
|
18
|
+
floor. Allowed:
|
|
19
|
+
- Symbols with a `GLIBC_x.y` version tag where `x.y <= floor`.
|
|
20
|
+
- Symbols defined by us locally (i.e. NOT marked `UND`).
|
|
21
|
+
4. Reject any `UND` symbol that's:
|
|
22
|
+
- Tagged with a GLIBC version > floor.
|
|
23
|
+
- Or in the `__isoc23_*` family (no version tag, but introduced
|
|
24
|
+
in glibc 2.38 — special-cased).
|
|
25
|
+
- Or in any other known "introduced after floor" symbol list
|
|
26
|
+
(extensible).
|
|
27
|
+
|
|
28
|
+
Exit 0 = wheel is portable. Exit 1 = wheel will break on some users.
|
|
29
|
+
|
|
30
|
+
Usage
|
|
31
|
+
-----
|
|
32
|
+
|
|
33
|
+
scripts/audit_wheel_glibc_symbols.py path/to/headroom_ai-*.whl
|
|
34
|
+
|
|
35
|
+
Run on Linux only — `objdump` from binutils is the audit tool. macOS's
|
|
36
|
+
default `objdump` is llvm-objdump, also works on ELF.
|
|
37
|
+
"""
|
|
38
|
+
|
|
39
|
+
from __future__ import annotations
|
|
40
|
+
|
|
41
|
+
import argparse
|
|
42
|
+
import re
|
|
43
|
+
import shutil
|
|
44
|
+
import subprocess
|
|
45
|
+
import sys
|
|
46
|
+
import tempfile
|
|
47
|
+
import zipfile
|
|
48
|
+
from pathlib import Path
|
|
49
|
+
|
|
50
|
+
# Symbols introduced after specific glibc versions, beyond what
|
|
51
|
+
# `auditwheel` already checks (auditwheel relies on the GLIBC_x.y
|
|
52
|
+
# version tag baked into versioned symbols; the entries below are
|
|
53
|
+
# either tagless or family-tagged, neither of which auditwheel
|
|
54
|
+
# catches). Add here as new bug classes surface.
|
|
55
|
+
#
|
|
56
|
+
# Each entry is `(symbol_name_prefix, min_glibc_version_introduced, justification_url)`.
|
|
57
|
+
# `startswith(prefix)` is used to match — for a single symbol use the
|
|
58
|
+
# full name as the prefix (no other symbol starts with it).
|
|
59
|
+
POST_FLOOR_SYMBOLS = [
|
|
60
|
+
# C23 strtol family. Issue #355.
|
|
61
|
+
(
|
|
62
|
+
"__isoc23_",
|
|
63
|
+
(2, 38),
|
|
64
|
+
"https://sourceware.org/glibc/wiki/Release/2.38",
|
|
65
|
+
),
|
|
66
|
+
# Single-threaded fast-path flag read by libstdc++ (gcc 11+).
|
|
67
|
+
# Caught by the X1 smoke gate on PR #396 (X2 dry-run) on the
|
|
68
|
+
# manylinux_2_28 floor entry — the audit had let the wheel
|
|
69
|
+
# through because it didn't know about this symbol.
|
|
70
|
+
(
|
|
71
|
+
"__libc_single_threaded",
|
|
72
|
+
(2, 32),
|
|
73
|
+
"https://sourceware.org/glibc/wiki/Release/2.32",
|
|
74
|
+
),
|
|
75
|
+
]
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def parse_manylinux_floor(wheel_filename: str) -> tuple[int, int] | None:
|
|
79
|
+
"""Extract glibc floor from a manylinux wheel filename.
|
|
80
|
+
|
|
81
|
+
`headroom_ai-0.20.26-cp312-cp312-manylinux_2_28_x86_64.whl` → (2, 28).
|
|
82
|
+
Returns None for non-manylinux wheels (macOS, Windows, sdist).
|
|
83
|
+
"""
|
|
84
|
+
m = re.search(r"manylinux_(\d+)_(\d+)_", wheel_filename)
|
|
85
|
+
if m:
|
|
86
|
+
return (int(m.group(1)), int(m.group(2)))
|
|
87
|
+
# `manylinux2014_x86_64` is the legacy alias for manylinux_2_17.
|
|
88
|
+
if "manylinux2014_" in wheel_filename:
|
|
89
|
+
return (2, 17)
|
|
90
|
+
if "manylinux1_" in wheel_filename:
|
|
91
|
+
return (2, 5)
|
|
92
|
+
return None
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def list_undef_symbols(so_path: Path) -> list[tuple[str, str]]:
|
|
96
|
+
"""Return [(symbol_name, glibc_version_or_empty), ...] for every
|
|
97
|
+
UND (undefined) dynamic symbol in `so_path`.
|
|
98
|
+
"""
|
|
99
|
+
objdump = shutil.which("objdump") or shutil.which("llvm-objdump")
|
|
100
|
+
if not objdump:
|
|
101
|
+
raise RuntimeError(
|
|
102
|
+
"neither `objdump` nor `llvm-objdump` is on PATH; "
|
|
103
|
+
"install binutils (Linux) or LLVM (macOS) to run this audit"
|
|
104
|
+
)
|
|
105
|
+
out = subprocess.run(
|
|
106
|
+
[objdump, "-T", str(so_path)],
|
|
107
|
+
check=True,
|
|
108
|
+
capture_output=True,
|
|
109
|
+
text=True,
|
|
110
|
+
).stdout
|
|
111
|
+
found = []
|
|
112
|
+
for line in out.splitlines():
|
|
113
|
+
# `objdump -T` lines: `address SECTION ... NAME` where SECTION
|
|
114
|
+
# contains `*UND*` for undefined references and a versioned
|
|
115
|
+
# symbol name like `__isoc23_strtoll@GLIBC_2.38` or unversioned.
|
|
116
|
+
if "*UND*" not in line:
|
|
117
|
+
continue
|
|
118
|
+
# The last whitespace-separated token is the (versioned) symbol.
|
|
119
|
+
token = line.split()[-1]
|
|
120
|
+
if "@" in token:
|
|
121
|
+
name, _, ver = token.partition("@")
|
|
122
|
+
# `@@` indicates the default version; strip the second `@`.
|
|
123
|
+
ver = ver.lstrip("@")
|
|
124
|
+
else:
|
|
125
|
+
name, ver = token, ""
|
|
126
|
+
found.append((name, ver))
|
|
127
|
+
return found
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
def glibc_version_from_token(ver: str) -> tuple[int, int] | None:
|
|
131
|
+
"""`GLIBC_2.28` → (2, 28). Returns None for non-GLIBC tokens."""
|
|
132
|
+
m = re.match(r"^GLIBC_(\d+)\.(\d+)", ver)
|
|
133
|
+
if m:
|
|
134
|
+
return (int(m.group(1)), int(m.group(2)))
|
|
135
|
+
return None
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
def audit_so(so_path: Path, floor: tuple[int, int]) -> list[str]:
|
|
139
|
+
"""Return a list of human-readable violation strings."""
|
|
140
|
+
violations: list[str] = []
|
|
141
|
+
for name, ver in list_undef_symbols(so_path):
|
|
142
|
+
v = glibc_version_from_token(ver)
|
|
143
|
+
if v is not None and v > floor:
|
|
144
|
+
violations.append(
|
|
145
|
+
f" {name}@{ver} requires glibc {v[0]}.{v[1]} > floor {floor[0]}.{floor[1]}"
|
|
146
|
+
)
|
|
147
|
+
continue
|
|
148
|
+
# Versionless symbols: cross-check the post-floor list.
|
|
149
|
+
for prefix, introduced, url in POST_FLOOR_SYMBOLS:
|
|
150
|
+
if name.startswith(prefix) and introduced > floor:
|
|
151
|
+
violations.append(
|
|
152
|
+
f" {name} (no version tag, introduced in glibc "
|
|
153
|
+
f"{introduced[0]}.{introduced[1]} > floor "
|
|
154
|
+
f"{floor[0]}.{floor[1]} — see {url})"
|
|
155
|
+
)
|
|
156
|
+
break
|
|
157
|
+
return violations
|
|
158
|
+
|
|
159
|
+
|
|
160
|
+
def main() -> int:
|
|
161
|
+
parser = argparse.ArgumentParser(description=__doc__)
|
|
162
|
+
parser.add_argument("wheel", type=Path, help="path to the .whl to audit")
|
|
163
|
+
args = parser.parse_args()
|
|
164
|
+
|
|
165
|
+
wheel: Path = args.wheel
|
|
166
|
+
if not wheel.exists():
|
|
167
|
+
print(f"ERROR: wheel not found: {wheel}", file=sys.stderr)
|
|
168
|
+
return 1
|
|
169
|
+
|
|
170
|
+
floor = parse_manylinux_floor(wheel.name)
|
|
171
|
+
if floor is None:
|
|
172
|
+
print(
|
|
173
|
+
f"OK: {wheel.name} is not a manylinux wheel; nothing to audit "
|
|
174
|
+
"(macOS / Windows / sdist run on a different runtime ABI)."
|
|
175
|
+
)
|
|
176
|
+
return 0
|
|
177
|
+
|
|
178
|
+
print(f"Auditing {wheel.name} (glibc floor: {floor[0]}.{floor[1]})")
|
|
179
|
+
with tempfile.TemporaryDirectory() as td:
|
|
180
|
+
td_path = Path(td)
|
|
181
|
+
with zipfile.ZipFile(wheel) as zf:
|
|
182
|
+
so_members = [m for m in zf.namelist() if m.endswith(".so")]
|
|
183
|
+
if not so_members:
|
|
184
|
+
print(
|
|
185
|
+
f"WARN: {wheel.name} contains no .so files; "
|
|
186
|
+
"nothing to audit (pure-Python wheel?)"
|
|
187
|
+
)
|
|
188
|
+
return 0
|
|
189
|
+
zf.extractall(td_path, members=so_members)
|
|
190
|
+
|
|
191
|
+
all_violations: list[tuple[str, list[str]]] = []
|
|
192
|
+
for so_rel in so_members:
|
|
193
|
+
so_path = td_path / so_rel
|
|
194
|
+
violations = audit_so(so_path, floor)
|
|
195
|
+
if violations:
|
|
196
|
+
all_violations.append((so_rel, violations))
|
|
197
|
+
|
|
198
|
+
if not all_violations:
|
|
199
|
+
print(f"OK: all .so files in {wheel.name} are within glibc {floor[0]}.{floor[1]}.")
|
|
200
|
+
return 0
|
|
201
|
+
|
|
202
|
+
print(f"\nFAIL: {wheel.name} references symbols above its glibc floor:")
|
|
203
|
+
for so_name, viols in all_violations:
|
|
204
|
+
print(f"\n {so_name}:")
|
|
205
|
+
for v in viols:
|
|
206
|
+
print(f" {v}")
|
|
207
|
+
print(
|
|
208
|
+
"\nThis wheel will fail to import on end-user systems with the "
|
|
209
|
+
"older glibc. Fix the build (or add a compat shim) before "
|
|
210
|
+
"publishing to PyPI. See issue #355 for the canonical example "
|
|
211
|
+
"and `crates/headroom-py/glibc_compat.c` for the shim pattern."
|
|
212
|
+
)
|
|
213
|
+
return 1
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
if __name__ == "__main__":
|
|
217
|
+
sys.exit(main())
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
const fs = require('node:fs/promises');
|
|
2
|
+
const path = require('node:path');
|
|
3
|
+
const postcss = require('postcss');
|
|
4
|
+
const atImport = require('postcss-import');
|
|
5
|
+
const tailwindcss = require('tailwindcss-v3');
|
|
6
|
+
const autoprefixer = require('autoprefixer');
|
|
7
|
+
|
|
8
|
+
const root = path.resolve(__dirname, '..');
|
|
9
|
+
|
|
10
|
+
async function build() {
|
|
11
|
+
const sourcePath = path.join(root, 'app', 'master-design-system.source.css');
|
|
12
|
+
const configPath = path.join(root, 'tailwind.master.config.cjs');
|
|
13
|
+
const config = require(configPath);
|
|
14
|
+
|
|
15
|
+
const result = await postcss([
|
|
16
|
+
atImport(),
|
|
17
|
+
tailwindcss(config),
|
|
18
|
+
autoprefixer(),
|
|
19
|
+
]).process(await fs.readFile(sourcePath, 'utf8'), {
|
|
20
|
+
from: sourcePath,
|
|
21
|
+
to: path.join(root, 'app', 'master-design-system.css'),
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
await fs.writeFile(path.join(root, 'app', 'master-design-system.css'), result.css);
|
|
25
|
+
if (result.warnings().length) {
|
|
26
|
+
console.warn(result.warnings().map((warning) => warning.toString()).join('\n'));
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
build().catch((error) => {
|
|
31
|
+
console.error(error);
|
|
32
|
+
process.exitCode = 1;
|
|
33
|
+
});
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Build + install the Rust extension (headroom._core) into the active venv.
|
|
3
|
+
#
|
|
4
|
+
# With single-wheel architecture (post-#355), `pip install -e .` invokes
|
|
5
|
+
# maturin (declared in pyproject.toml's `[build-system]`) which builds the
|
|
6
|
+
# Rust extension and installs it into site-packages alongside the Python
|
|
7
|
+
# source. Earlier versions of this script symlinked the .so into the
|
|
8
|
+
# in-tree `headroom/` directory because the dual-package layout left the
|
|
9
|
+
# .so in `crates/headroom-py/python/headroom/`. That dance is no longer
|
|
10
|
+
# needed — maturin places the .so directly in the editable install's
|
|
11
|
+
# overlay and Python's import system finds it.
|
|
12
|
+
#
|
|
13
|
+
# Idempotent. Safe to run repeatedly.
|
|
14
|
+
|
|
15
|
+
set -euo pipefail
|
|
16
|
+
|
|
17
|
+
cd "$(dirname "$0")/.."
|
|
18
|
+
|
|
19
|
+
log() {
|
|
20
|
+
printf '[build_rust_extension] %s\n' "$*" >&2
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
fail() {
|
|
24
|
+
printf '[build_rust_extension] error: %s\n' "$*" >&2
|
|
25
|
+
exit 1
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
# Pre-flight: a venv should be active. The install would otherwise write
|
|
29
|
+
# into the system Python.
|
|
30
|
+
if [[ -z "${VIRTUAL_ENV:-}" ]]; then
|
|
31
|
+
log "warning: VIRTUAL_ENV is unset; pip will install into the system Python."
|
|
32
|
+
log " If that is not what you want, abort and 'source .venv/bin/activate' first."
|
|
33
|
+
fi
|
|
34
|
+
|
|
35
|
+
if ! command -v cargo >/dev/null 2>&1; then
|
|
36
|
+
fail "cargo not found on PATH. Install Rust toolchain (rustup) first."
|
|
37
|
+
fi
|
|
38
|
+
|
|
39
|
+
# Build + install in one shot. The `[build-system] build-backend = "maturin"`
|
|
40
|
+
# in pyproject.toml means pip drives maturin under the hood. The resulting
|
|
41
|
+
# wheel contains both the Python source and the compiled `headroom/_core.so`,
|
|
42
|
+
# and pip installs them into the editable overlay together.
|
|
43
|
+
log "pip install -e . (drives maturin via build-backend)"
|
|
44
|
+
python -m pip install -e . || fail "pip install -e . failed (see output above)"
|
|
45
|
+
|
|
46
|
+
# End-to-end verification — same shape as Phase A0's startup smoke check.
|
|
47
|
+
log "verifying \`from headroom._core import DiffCompressor, SmartCrusher\`"
|
|
48
|
+
python -c '
|
|
49
|
+
import sys
|
|
50
|
+
try:
|
|
51
|
+
from headroom._core import DiffCompressor, SmartCrusher
|
|
52
|
+
except Exception as exc:
|
|
53
|
+
print(f"verify FAILED: {type(exc).__name__}: {exc}", file=sys.stderr)
|
|
54
|
+
sys.exit(1)
|
|
55
|
+
print(f"verify OK: DiffCompressor={DiffCompressor!r}, SmartCrusher={SmartCrusher!r}")
|
|
56
|
+
' || fail "import verification failed (see above)"
|
|
57
|
+
|
|
58
|
+
log "headroom._core build + install + verify: OK"
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Generate changelog from conventional commits."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
import argparse
|
|
7
|
+
import re
|
|
8
|
+
import subprocess
|
|
9
|
+
from datetime import date
|
|
10
|
+
from pathlib import Path
|
|
11
|
+
from typing import NamedTuple
|
|
12
|
+
|
|
13
|
+
ROOT = Path(__file__).parent.parent
|
|
14
|
+
|
|
15
|
+
COMMIT_PATTERN = re.compile(
|
|
16
|
+
r"^(feat|fix|ci|chore|perf|refactor|docs|style|test)(\(.+\))?(!)?:\s*(.+)$"
|
|
17
|
+
)
|
|
18
|
+
BREAKING_CHANGE_PATTERN = re.compile(r"^BREAKING CHANGE:\s*(.+)$", re.MULTILINE)
|
|
19
|
+
COMMIT_ENTRY_PATTERN = re.compile(r"^(.+?)(?:\n(.+))?\|(\w+)$", re.MULTILINE)
|
|
20
|
+
FIELD_SEP = "\x1f"
|
|
21
|
+
RECORD_SEP = "\x1e"
|
|
22
|
+
GIT_LOG_FORMAT = "%s%x1f%b%x1f%h%x1e"
|
|
23
|
+
|
|
24
|
+
TYPE_LABELS: dict[str, str] = {
|
|
25
|
+
"feat": "Features",
|
|
26
|
+
"fix": "Bug Fixes",
|
|
27
|
+
"ci": "CI/CD",
|
|
28
|
+
"chore": "Chores",
|
|
29
|
+
"perf": "Performance",
|
|
30
|
+
"refactor": "Refactors",
|
|
31
|
+
"docs": "Documentation",
|
|
32
|
+
"style": "Styles",
|
|
33
|
+
"test": "Tests",
|
|
34
|
+
"other": "Other Changes",
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
class ParsedCommit(NamedTuple):
|
|
39
|
+
type: str
|
|
40
|
+
scope: str | None
|
|
41
|
+
breaking: bool
|
|
42
|
+
message: str
|
|
43
|
+
hash: str
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def iter_commit_entries(log_output: str) -> list[tuple[str, str, str]]:
|
|
47
|
+
"""Split raw git log output into (subject, body, hash) tuples."""
|
|
48
|
+
|
|
49
|
+
if not log_output.strip():
|
|
50
|
+
return []
|
|
51
|
+
|
|
52
|
+
if RECORD_SEP in log_output and FIELD_SEP in log_output:
|
|
53
|
+
entries: list[tuple[str, str, str]] = []
|
|
54
|
+
for raw_entry in log_output.split(RECORD_SEP):
|
|
55
|
+
if not raw_entry:
|
|
56
|
+
continue
|
|
57
|
+
if FIELD_SEP not in raw_entry:
|
|
58
|
+
continue
|
|
59
|
+
subject, body_and_hash = raw_entry.split(FIELD_SEP, 1)
|
|
60
|
+
if FIELD_SEP not in body_and_hash:
|
|
61
|
+
continue
|
|
62
|
+
body, commit_hash = body_and_hash.rsplit(FIELD_SEP, 1)
|
|
63
|
+
entries.append((subject.strip(), body.strip(), commit_hash.strip()))
|
|
64
|
+
return entries
|
|
65
|
+
|
|
66
|
+
return [
|
|
67
|
+
(
|
|
68
|
+
match.group(1).strip(),
|
|
69
|
+
(match.group(2) or "").strip(),
|
|
70
|
+
match.group(3).strip(),
|
|
71
|
+
)
|
|
72
|
+
for match in COMMIT_ENTRY_PATTERN.finditer(log_output)
|
|
73
|
+
]
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
def get_merge_summary(subject: str, body: str) -> str:
|
|
77
|
+
"""Return the first meaningful summary line for a merge commit."""
|
|
78
|
+
|
|
79
|
+
if not subject.startswith("Merge "):
|
|
80
|
+
return ""
|
|
81
|
+
|
|
82
|
+
for line in body.splitlines():
|
|
83
|
+
stripped = line.strip()
|
|
84
|
+
if stripped:
|
|
85
|
+
return stripped
|
|
86
|
+
return ""
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
def parse_commits(log_output: str) -> list[ParsedCommit]:
|
|
90
|
+
"""Parse git log output into structured commits."""
|
|
91
|
+
|
|
92
|
+
commits: list[ParsedCommit] = []
|
|
93
|
+
|
|
94
|
+
for subject, body, commit_hash in iter_commit_entries(log_output):
|
|
95
|
+
is_breaking = bool(BREAKING_CHANGE_PATTERN.search(body))
|
|
96
|
+
merge_summary = get_merge_summary(subject, body)
|
|
97
|
+
candidates = [subject]
|
|
98
|
+
if merge_summary:
|
|
99
|
+
candidates.insert(0, merge_summary)
|
|
100
|
+
|
|
101
|
+
for candidate in candidates:
|
|
102
|
+
commit_match = COMMIT_PATTERN.match(candidate)
|
|
103
|
+
if not commit_match:
|
|
104
|
+
continue
|
|
105
|
+
|
|
106
|
+
scope = commit_match.group(2)
|
|
107
|
+
if scope:
|
|
108
|
+
scope = scope[1:-1]
|
|
109
|
+
commits.append(
|
|
110
|
+
ParsedCommit(
|
|
111
|
+
type=commit_match.group(1),
|
|
112
|
+
scope=scope,
|
|
113
|
+
breaking=is_breaking or bool(commit_match.group(3)),
|
|
114
|
+
message=commit_match.group(4),
|
|
115
|
+
hash=commit_hash,
|
|
116
|
+
)
|
|
117
|
+
)
|
|
118
|
+
break
|
|
119
|
+
else:
|
|
120
|
+
fallback_message = merge_summary or subject
|
|
121
|
+
if not fallback_message or fallback_message.startswith("Merge "):
|
|
122
|
+
continue
|
|
123
|
+
commits.append(
|
|
124
|
+
ParsedCommit(
|
|
125
|
+
type="other",
|
|
126
|
+
scope=None,
|
|
127
|
+
breaking=is_breaking,
|
|
128
|
+
message=fallback_message,
|
|
129
|
+
hash=commit_hash,
|
|
130
|
+
)
|
|
131
|
+
)
|
|
132
|
+
|
|
133
|
+
return commits
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
def generate_changelog(version: str, commits: list[ParsedCommit]) -> str:
|
|
137
|
+
"""Generate markdown changelog from parsed commits."""
|
|
138
|
+
today = date.today().isoformat()
|
|
139
|
+
lines = [f"## [{version}] - {today}", ""]
|
|
140
|
+
|
|
141
|
+
# Collect breaking changes
|
|
142
|
+
breaking_commits = [c for c in commits if c.breaking]
|
|
143
|
+
if breaking_commits:
|
|
144
|
+
lines.append("### Breaking Changes")
|
|
145
|
+
for commit in breaking_commits:
|
|
146
|
+
if commit.scope:
|
|
147
|
+
lines.append(f"- **{commit.scope}**: {commit.message} ({commit.hash})")
|
|
148
|
+
else:
|
|
149
|
+
lines.append(f"- {commit.message} ({commit.hash})")
|
|
150
|
+
lines.append("")
|
|
151
|
+
|
|
152
|
+
# Group by type
|
|
153
|
+
by_type: dict[str, list[ParsedCommit]] = {}
|
|
154
|
+
for commit in commits:
|
|
155
|
+
by_type.setdefault(commit.type, []).append(commit)
|
|
156
|
+
|
|
157
|
+
for commit_type, label in TYPE_LABELS.items():
|
|
158
|
+
type_commits = by_type.get(commit_type, [])
|
|
159
|
+
if not type_commits:
|
|
160
|
+
continue
|
|
161
|
+
lines.append(f"### {label}")
|
|
162
|
+
for commit in type_commits:
|
|
163
|
+
if commit.scope:
|
|
164
|
+
lines.append(f"- **{commit.scope}**: {commit.message} ({commit.hash})")
|
|
165
|
+
else:
|
|
166
|
+
lines.append(f"- {commit.message} ({commit.hash})")
|
|
167
|
+
lines.append("")
|
|
168
|
+
|
|
169
|
+
return "\n".join(lines) + "\n"
|
|
170
|
+
|
|
171
|
+
|
|
172
|
+
def run_git_log(since: str | None, cwd: Path) -> str:
|
|
173
|
+
"""Run git log command and return output."""
|
|
174
|
+
cmd = ["git", "log", "--first-parent", f"--pretty=format:{GIT_LOG_FORMAT}"]
|
|
175
|
+
if since:
|
|
176
|
+
cmd.append(f"{since}..HEAD")
|
|
177
|
+
else:
|
|
178
|
+
cmd.append("HEAD")
|
|
179
|
+
result = subprocess.run(cmd, cwd=cwd, capture_output=True, text=True)
|
|
180
|
+
return result.stdout
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
def main() -> None:
|
|
184
|
+
parser = argparse.ArgumentParser(description="Generate changelog from conventional commits")
|
|
185
|
+
parser.add_argument("--version", required=True, help="Version number (e.g., 0.6.0)")
|
|
186
|
+
parser.add_argument("--since", help="Starting tag (exclusive)")
|
|
187
|
+
parser.add_argument("--dry-run", action="store_true", help="Print to stdout instead of writing")
|
|
188
|
+
args = parser.parse_args()
|
|
189
|
+
|
|
190
|
+
log_output = run_git_log(args.since, ROOT)
|
|
191
|
+
commits = parse_commits(log_output)
|
|
192
|
+
changelog = generate_changelog(args.version, commits)
|
|
193
|
+
|
|
194
|
+
if args.dry_run:
|
|
195
|
+
print(changelog)
|
|
196
|
+
else:
|
|
197
|
+
output_path = ROOT / ".changelog.md"
|
|
198
|
+
output_path.write_text(changelog, encoding="utf-8")
|
|
199
|
+
print(f"Changelog written to {output_path}")
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
if __name__ == "__main__":
|
|
203
|
+
main()
|