Merge pull request #10 from claudioemmanuel/feat/context-engine

feat(context): aggressive token-engine — adaptive intensity, redundancy cache, summarize fallback

Author: claudioemmanuel

.github/workflows/ci.yml

@@ -15,3 +15,5 @@ jobs:
           cp target/release/squeez "$HOME/.claude/squeez/bin/squeez"
       - name: Run benchmarks
         run: bash bench/run.sh
+      - name: Run context-engine benchmarks
+        run: bash bench/run_context.sh

.gitignore

@@ -4,3 +4,8 @@
 .omc/
 docs/
 .worktrees/
+
+# Bench reports (regenerated on every run)
+bench/report.md
+bench/report_context.md
+

README.md

@@ -66,8 +66,40 @@ bypass = docker exec, psql, ssh
 # Session memory
 compact_threshold_tokens = 160000   # warn at 80% of context budget
 memory_retention_days = 30          # how long to keep session summaries
+
+# Context engine (PR1)
+adaptive_intensity = true           # auto-tighten compression as budget fills
+context_cache_enabled = true        # persist cross-call state in sessions/context.json
+redundancy_cache_enabled = true     # collapse identical recent outputs to a reference line
+summarize_threshold_lines = 500     # raw lines above this trigger summary fallback
 ```
 
+### Context engine
+
+When `adaptive_intensity = true` (default), squeez compresses every bash call
+at maximum aggression — limits ×0.3 across the board (Ultra mode):
+
+- `max_lines` × 0.3 (floor 20)
+- `dedup_min` × 0.5 (floor 2)
+- `git_diff_max_lines`, `docker_logs_max_lines`, `find_max_results` × 0.3
+- `summarize_threshold_lines` × 0.3 (floor 50)
+
+Set `adaptive_intensity = false` to fall back to **Lite** (no scaling, raw
+defaults). The active level is shown in the bash header:
+`# squeez [git] 841→323 tokens (-62%) 55ms [adaptive: Ultra]`.
+
+The `Lite` and `Full` enum variants remain for forward compatibility but are
+not selected automatically — they exist so future versions can introduce
+softer modes without breaking the public API.
+
+When the same compressed output appears within the last 8 calls (length-equality
+guarded), squeez replaces it with a single reference line:
+`[squeez: identical to <hash> at bash#<n> — re-run with --no-squeez]`.
+
+When raw output exceeds `summarize_threshold_lines`, squeez emits a dense
+≤40-line summary (top errors, top files, test summary, last 20 lines verbatim)
+instead of running the per-handler truncation pipeline.
+
 ## How it works
 
 ### Claude Code & Copilot CLI

bench/fixtures/context_crosscall_1.txt

@@ -0,0 +1,18 @@
+On branch develop
+Your branch is up to date with origin/develop.
+
+Changes not staged for commit:
+  (use git add to update what will be committed)
+  (use git restore to discard changes in working directory)
+        modified:   src/main.rs
+        modified:   src/lib.rs
+        modified:   src/config.rs
+        modified:   src/commands/wrap.rs
+        modified:   tests/test_intensity.rs
+        modified:   tests/test_redundancy.rs
+        modified:   tests/test_summarize.rs
+        modified:   tests/test_context_cache.rs
+        modified:   bench/run.sh
+        modified:   README.md
+
+no changes added to commit (use git add and/or git commit -a)

bench/fixtures/context_crosscall_2.txt

@@ -0,0 +1,18 @@
+On branch develop
+Your branch is up to date with origin/develop.
+
+Changes not staged for commit:
+  (use git add to update what will be committed)
+  (use git restore to discard changes in working directory)
+        modified:   src/main.rs
+        modified:   src/lib.rs
+        modified:   src/config.rs
+        modified:   src/commands/wrap.rs
+        modified:   tests/test_intensity.rs
+        modified:   tests/test_redundancy.rs
+        modified:   tests/test_summarize.rs
+        modified:   tests/test_context_cache.rs
+        modified:   bench/run.sh
+        modified:   README.md
+
+no changes added to commit (use git add and/or git commit -a)

bench/fixtures/context_crosscall_3.txt

@@ -0,0 +1,18 @@
+On branch develop
+Your branch is up to date with origin/develop.
+
+Changes not staged for commit:
+  (use git add to update what will be committed)
+  (use git restore to discard changes in working directory)
+        modified:   src/main.rs
+        modified:   src/lib.rs
+        modified:   src/config.rs
+        modified:   src/commands/wrap.rs
+        modified:   tests/test_intensity.rs
+        modified:   tests/test_redundancy.rs
+        modified:   tests/test_summarize.rs
+        modified:   tests/test_context_cache.rs
+        modified:   bench/run.sh
+        modified:   README.md
+
+no changes added to commit (use git add and/or git commit -a)