fix: use percentage-based autocompact buffer with config toggle

- Change hardcoded 45k buffer to 22.5% of context window
- Scales correctly for enterprise windows (>200k)
- Add `display.autocompactBuffer` config option ('enabled' | 'disabled')
- Default 'enabled' preserves current behavior (buffered %)
- 'disabled' shows raw % for users with autocompact off

Fixes #48, #16
Related: #4, #30, #43, #49

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: jarrodwatts

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to Claude HUD will be documented in this file.
 
+## [Unreleased]
+
+### Changed
+- Context percentage now uses percentage-based buffer (22.5%) instead of hardcoded 45k tokens
+  - Scales correctly for enterprise context windows (>200k)
+- Add `display.autocompactBuffer` config option (`'enabled'` | `'disabled'`, default: `'enabled'`)
+  - `'enabled'`: Shows buffered % (matches `/context` when autocompact ON) - **default**
+  - `'disabled'`: Shows raw % (matches `/context` when autocompact OFF)
+
+### Credits
+- Ideas from PRs #30 (@r-firpo), #43 (@yansircc), #49 (@StephenJoshii) informed the final solution
+
+---
+
 ## [0.0.4] - 2026-01-07
 
 ### Added

dist/config.d.ts

@@ -1,4 +1,5 @@
 export type LayoutType = 'default' | 'separators';
+export type AutocompactBufferMode = 'enabled' | 'disabled';
 export interface HudConfig {
     layout: LayoutType;
     pathLevels: 1 | 2 | 3;
@@ -17,6 +18,7 @@ export interface HudConfig {
         showTools: boolean;
         showAgents: boolean;
         showTodos: boolean;
+        autocompactBuffer: AutocompactBufferMode;
     };
 }
 export declare const DEFAULT_CONFIG: HudConfig;

dist/config.d.ts.map

@@ -1,6 +1,10 @@
 /**
- * Autocompact buffer: reserved space that /context includes in its calculation.
- * This is fixed at 45k tokens (22.5% of 200k) - must be added to match /context output.
+ * Autocompact buffer percentage.
+ *
+ * NOTE: This value (22.5% = 45k/200k) is empirically derived from community
+ * observations of Claude Code's autocompact behavior. It is NOT officially
+ * documented by Anthropic and may change in future Claude Code versions.
+ * If users report mismatches, this value may need adjustment.
  */
-export declare const AUTOCOMPACT_BUFFER = 45000;
+export declare const AUTOCOMPACT_BUFFER_PERCENT = 0.225;
 //# sourceMappingURL=constants.d.ts.map