Class InputHistory

src/command_system/input_processing.py:796–848

Track user input history for navigation and recall.

class InputHistory:
    """Track user input history for navigation and recall."""

    def __init__(self, max_entries: int = 1000) -> None:
        self._entries: list[str] = []
        self._max_entries = max_entries
        self._cursor: int = -1

    def add(self, text: str) -> None:
        """Add an entry to history."""
        if not text.strip():
            return
        # Don't add duplicates of the last entry
        if self._entries and self._entries[-1] == text:
            return
        self._entries.append(text)
        if len(self._entries) > self._max_entries:
            self._entries.pop(0)
        self._cursor = len(self._entries)

    def previous(self) -> str | None:
        """Get previous history entry (up arrow)."""
        if not self._entries:
            return None
        self._cursor = max(0, self._cursor - 1)
        return self._entries[self._cursor]

    def next(self) -> str | None:
        """Get next history entry (down arrow)."""
        if not self._entries:
            return None
        self._cursor = min(len(self._entries), self._cursor + 1)
        if self._cursor >= len(self._entries):
            return ""  # Past the end = empty
        return self._entries[self._cursor]

    def search(self, prefix: str) -> list[str]:
        """Search history for entries starting with prefix."""
        prefix_lower = prefix.lower()
        return [e for e in reversed(self._entries) if e.lower().startswith(prefix_lower)]

    def clear(self) -> None:
        """Clear all history."""
        self._entries.clear()
        self._cursor = -1

    @property
    def entries(self) -> list[str]:
        return list(self._entries)

    @property
    def size(self) -> int:
        return len(self._entries)


# ---------------------------------------------------------------------------