iris-context/docs/dev/history.md

Shell history integration (integration/history.go)

The history module provides Ctrl+R search functionality by reading the user's persistent shell command history.

Features

• Zsh extended support: Parses : <timestamp>;<command> format common in Zsh.
• Lazy loading: Reads disk only when history search is invoked, preserving instant startup performance.
• Fuzzy search: Integrates with the fuzzy search engine for match scoring.
• Deduplication: Filters duplicate commands, displaying unique entries.

Data flow

1. User presses Ctrl+R.
2. root sets mode = "history".
3. SearchHistory("") is called.
4. If cache is empty:
   • Reads history file (~/.zsh_history or ~/.bash_history).
   • Strips metadata using delimiters.
   • Populates command memory cache.
5. Matches are scored and sorted by the search engine.
6. Suggestions are returned to overlay for rendering.