feat(compression): adaptive auto transcript compactor

README.md

@@ -166,6 +166,18 @@ For more detailed information, please refer to the following documents:
   `chafa` is available, PNG renders) for the documentation gallery. Use
   `--no-png` to skip the PNG step or `--output <dir>` to redirect the output.
 
+## Conversation Compression
+
+Owlen automatically compacts older turns once a chat crosses the configured
+token threshold. The behaviour is controlled by the `[chat]` section in
+`config.toml` (enabled by default via `chat.auto_compress = true`).
+
+- Launch the TUI with `--no-auto-compress` to opt out for a single run.
+- Inside the app, `:compress now` generates an on-demand summary, while
+  `:compress auto on|off` flips the automatic mode and persists the change.
+- Each compression pass emits a system summary that carries metadata about the
+  retained messages, strategy, and estimated token savings.
+
 ## Configuration
 
 OWLEN stores its configuration in the standard platform-specific config directory: