# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

______________________________________________________________________

## [Unreleased]

### Added

- Unified persistent run history in SQLite:
  - new `src/tai/history_store.py` for host-scoped JSON run records
  - `--history-db` and `--history/--no-history` options on `tai run`
  - prior host history auto-loaded for analysis/follow-up prompts
  - analyzed runs auto-indexed into history DB
- External database targets for history and runbook options:
  - `--history-db` now supports SQLite path/URL and PostgreSQL DSN
  - `--runbooks`/`--store` now support remote ChromaDB URLs
- External DB authentication options:
  - history DB: `--history-db-user`, `--history-db-password`, `--env-file`
  - runbook store: `--runbooks-user`/`--runbooks-password` and `--store-user`/`--store-password`
  - dotenv credential keys: `TAI_HISTORY_DB_USER`, `TAI_HISTORY_DB_PASSWORD`, `TAI_RUNBOOK_STORE_USER`, `TAI_RUNBOOK_STORE_PASSWORD`
- Remote runbook/playbook source ingestion:
  - `tai runbooks sync --path` now supports `ssh://` directories
  - `tai runbooks sync --path` now supports HTTP/HTTPS webroots with Markdown links
  - `tai runbooks add` now supports `ssh://` and HTTP/HTTPS Markdown files
- `--output-file` option on `tai run` to persist final AI analysis output as Markdown
- `--output-format markdown|json` for `--output-file` exports
- JSON export schema now includes host-specific run metadata (`generated_at`, collection stats, token usage)
- New SQLite run history database (`--history-db`) now stores per-run JSON payloads and auto-loads prior host history for analysis context
- Planner enhancements for broader service detection:
  - generic service candidate extraction from free text
  - package presence probes in plans (`rpm -q` and `dpkg-query -W`)
- SSH read-only allowlist expanded to permit package presence commands (`rpm`, `dpkg-query`)
- History DB tests in `tests/test_history_store.py`
- CLI test coverage for analysis output file writing (`tests/test_cli.py`)
- CLI test coverage for JSON export and ANSI stripping in written output (`tests/test_cli.py`)

### Changed

- History reads/writes are now unified on SQLite DB in CLI workflows (`history`, interactive `/history`, analysis context injection).
- Documentation alignment updates in README and ROADMAP to reflect implemented history DB and package-presence capabilities.
- Package version metadata alignment: `src/tai/__init__.py` now matches project version `0.4.0`.

______________________________________________________________________

## [0.4.0] - 2026-05-06

### Added

- `runbooks/` corpus with service troubleshooting guides: `ssh`, `nginx`, `postgres`, `disk`, `kernel`, `docker`, `sssd`, `xorg`, `wayland`, `x2go`, `selinux`, `apparmor`
- Runbook knowledge store module `src/tai/runbook_store.py` (persistent ChromaDB-backed index and query)
- Chroma telemetry no-op client `src/tai/chroma_telemetry.py` to suppress noisy local telemetry errors
- `tai runbooks` command group with:
  - `sync` for indexing all Markdown runbooks
  - `list` for listing indexed metadata
  - `add` for indexing a single runbook file
- `--runbooks` option on `tai run` to enable Tier 2 runbook retrieval
- Initial analysis RAG path using retrieved diagnostic chunks (`build_analysis_message_with_chunks`)
- Follow-up RAG path updates with tighter `top_k` and runbook context injection
- AI runtime controls:
  - `--ai-timeout-seconds`
  - `--ai-max-tokens`
- Non-streaming AI completion path for improved local backend reliability
- Service/subsystem presence probes in collection plans:
  - unit-file checks
  - expected binary path checks
  - status/journal/config probes for recognized services including `sssd`
- Prompt instruction for "component absent or not installed" interpretation when presence signals are missing
- Runbook store unit tests in `tests/test_runbook_store.py`
- CLI tests updated for `tai run` subcommand and non-streaming completion mocks
- README refreshed with current CLI, architecture layout, RAG/runbook workflow, and usage examples
- `docs/ARCHITECTURE.md` with end-to-end flow, module responsibilities, safety boundaries, and fallback behavior

### Removed

- `.github/workflows/ci.yml` — GitHub Actions workflow removed; CI is now Gitea-only

### Decided

- Implementation language: **Python**
- Distribution strategy: single distributable binary via **Nuitka** (PyInstaller as fallback)
- SSH authentication: **keypair only** (ed25519/RSA); auto-accept new hosts; hard reject on host key change with MITM warning
- SSH bastion support: `--jump-host` flag using SSH native ProxyJump
- SSH config behavior: use `~/.ssh/config` by default; allow override via `--ignore-ssh-config`
- Interface: **interactive REPL** for v0.1; `textual`-based TUI (split-pane) for v0.2+
- RAG Tier 1 strategy: semantic diagnostic chunk retrieval with local embeddings
- RAG Tier 2 strategy: Markdown runbooks persisted in embedded ChromaDB