# Changelog

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

## [Unreleased]

## [0.5.0] - 2026-05-16

Range: `app-v0.4.0` / `cli-v0.4.0` .. `app-v0.5.0` / `cli-v0.5.0`

### Added
- Add local `af app install` and `af app uninstall` for managing the official Autofish App over adb.
- Add a home page connection card for copying agent-ready `af config` commands and raw connection info from the Android app.
- Add deterministic `af connect usb` adb forwarding using the App's non-sensitive connection hint, plus local connection metadata in `af health`.

### Changed
- Refresh README onboarding with the current install/connect flow, app screenshots, and demo media.
- Expand `just` helper recipes for day-to-day build and CLI quality checks.

## [0.5.0-rc.1] - 2026-05-03

Range: `app-v0.4.0` / `cli-v0.4.0` .. `app-v0.5.0-rc.1` / `cli-v0.5.0-rc.1`

### Added
- Add local `af app install` and `af app uninstall` for managing the official Autofish App over adb.
- Add a home page connection card for copying agent-ready `af config` commands and raw connection info from the Android app.
- Add deterministic `af connect usb` adb forwarding using the App's non-sensitive connection hint, plus local connection metadata in `af health`.

## [0.4.0] - 2026-05-01

Range: `app-v0.3.0` / `cli-v0.3.0` .. `app-v0.4.0` / `cli-v0.4.0`

### Added
- Add local CLI config management: `af config list|get|set|unset`.
- Add config file support via `--config`, `AF_CONFIG`, and default path `~/.config/af/config.toml`.
- Add artifact persistence metadata table for large CLI outputs.
- Add `--case-sensitive` to `af verify text-contains`.
- Add `--for-session` to `af memory log` and `af memory stats`.

### Changed
- Default CLI output is now stable `text`/`key=value`; use `--output json` for structured output.
- Remote CLI defaults can now be resolved from config/env instead of parse-time-only flags.
- `observe screenshot`, `observe screen --full`, and large `observe page` screen payloads now save artifacts instead of inlining the full payload in command output.

### Fixed
- Distinguish unset config keys from unknown config keys in `af config get/list`.
- Preserve CLI-provided config sources in `af config list`.
- Redact `remote.token` in config command output.
- Store real SHA-256 artifact content hashes.
- Clarify packaged Autofish control skill examples so device commands keep the task session explicit.

### BREAKING
- CLI default output changed from one-line JSON to text.
- Scripts that depend on prior JSON output must add `--output json`.
- Replace `af memory log --session <session>` with `af memory log --for-session <session>`.
- Replace `af memory stats --session <session>` with `af memory stats --for-session <session>`.
- Replace `af verify text-contains --ignore-case=false` with `af verify text-contains --case-sensitive`.

## [0.3.0] - 2026-04-09

Range: `app-v0.2.1` (`9374656`) .. `app-v0.3.0`

### Added
- Add agent-driven knowledge notes (append-only): `af memory save`, `af memory search`, `af memory delete --id`.
- Add structured event log with failure cause and verify evidence: `af memory log`, `af memory stats`.
- Add automatic transition tracking: act → verify sequences are closed into transitions with success/verified/failure counters.
- Add automatic recovery tracking: recover commands are linked to preceding failures with success/failure counters.
- Add three-tier experience query (page → activity → app): `af memory experience`.
- Add session observation cache: `af memory context` shows cached page fingerprint.
- Add stable page fingerprint: human-readable string with activity, mode, webview flag, res_id anchors, class_name fallback. Replaces opaque FNV hash.
- Session cache updated by `observe top`, `observe screen`, `observe refs`, and `observe page` with quality-based overwrite rules.
- Add `af observe page`: stability-oriented observation that always returns base context fields (`topActivity`, `mode`, `hasWebView`, `nodeReliability`) in the response shape. `topActivity` may be `null` when the service cannot confirm a stable value during the request. Use `--field screen` and/or `--field refs` to include data slices (default: screen).
- Add server-side `GET /api/observe?include=top,screen,refs` endpoint for atomic, selective page observation.

### Changed
- Repurpose `AF_DB` from raw trace history storage to SQLite-backed tool memory storage.
- Rename CLI opt-out flag to `--no-memory` and keep `--no-trace` as a compatibility alias.
- Use CLI `--session` as the task grouping key for events and transitions.
- Memory no longer captures page context via extra HTTP calls; context is derived from commands the agent already runs.
- Make `af memory ...` a pure local command path. Remote options (`--url`, `--token`, `--timeout-ms`, `--proxy`) now belong to remote command groups instead of the global CLI root.
- Require `--token` during CLI argument parsing for protected remote command groups (`observe`, `act`, `verify`, `recover`). `health` no longer accepts `--token`.
- Notes are append-only; multiple notes with same `(app, topic)` coexist as historical chain (no more UPSERT overwrite).
- Transition closing is deferred: pre-context comes from act's cached state, post-context from the subsequent verify. Never closes at act time.

### Removed
- Remove `af memory next` (step recommendation engine). Replaced by `af memory experience` with three-tier matching.
- Remove `af memory inspect`. Replaced by `af memory experience`, `af memory log`, `af memory stats`.
- Remove `af memory get` (single-note lookup). Use `af memory search --topic <exact>` instead.
- Remove page-key FNV hash fingerprinting.
- Remove SQLite migration system (pre-release schema uses `CREATE TABLE IF NOT EXISTS`).

### BREAKING
- Replace `af memory next --goal ...` with `af memory experience --app ... --activity ...` for execution experience.
- Replace `af memory inspect` with `af memory experience` / `af memory log` / `af memory stats`.
- Replace `af memory delete --app ... --topic ...` with `af memory delete --id <note_id>`.
- Existing `af.db` v1 tables (`memory_steps`, `memory_verifications`, `memory_transitions`, `memory_recoveries`) are incompatible; delete `af.db` to recreate.
- Migration example: replace `af --no-trace ...` with `af --no-memory ...` in scripts.
- CLI shape change:
  - old: `af --url http://host:<PORT> memory log --session demo`
  - new: `af memory log --for-session demo`
- CLI shape change for explicit remote flags:
  - old: `af --url http://host:<PORT> observe page --field refs`
  - new: `af observe --url http://host:<PORT> page --field refs`
- Protected remote commands now require `--token` at parse time:
  - old: `af verify --url http://host:<PORT> text-contains --text Settings`
  - new: `af verify --url http://host:<PORT> --token <token> text-contains --text Settings`
- `health` no longer exposes `--token`:
  - old: `af health --url http://host:<PORT> --token <token>`
  - new: `af health --url http://host:<PORT>`

## [0.2.1] - 2026-04-01

Range: `app-v0.2.0` (`6201e4b`) .. `app-v0.2.1`

### Added
- On-demand refs diff in REST refs flow: introduce UI-change sequence tracking from accessibility events and skip full refs recompute when cache is still valid.
- Server-side ref alias replay mapping: persist `ref -> token` at observe time and resolve by token at act time.

### Changed
- `POST /api/nodes/tap` with `by=ref` now resolves ref aliases through server-side mapping instead of client-sent version checks.
- Ref replay resolution now uses exact token first, then identity-token fallback only when there is a unique candidate.
- CLI no longer sends `expected_ref_version` for `by=ref` and no longer sends `known_ref_version` for `/api/screen/refs`.
- Refs auto-refresh now runs only when ref panel is visible, reducing unnecessary background recomputation.
- Normalize CLI overlay internal request/options handling to satisfy strict Rust linting without changing command behavior.

### Fixed
- Add dedicated decision tests for refs rebuild gating to reduce regression risk.
- Add dedicated tests for ref alias mapping and stale/ambiguous fallback behavior.

### Build/CI/Release
- Add CLI Rust quality workflow for `cargo fmt --check`, `cargo clippy -- -D warnings`, and `cargo test` on pull requests and `main`.
- Add `just` shortcuts for CLI quality gates: `cli-check`, `cli-test`, `cli-fmt`, `cli-fmt-fix`, `cli-clippy`, `cli-lint`, and `cli-quality`.

## [0.2.0] - 2026-03-28

Range: `app-v0.1.1-rc.1` (`06bf830`) .. `app-v0.2.0` (`6201e4b`)

### Added
- Versioned refs replay and on-screen ref labels for safer ref-based actions (`8a6e4d5`).
- NPM meta package and platform package publish pipeline for CLI distribution (`626eb23`).

### Changed
- Rename app package to `com.memohai.autofish` (`d9328c4`).
- Rename CLI command from `amc` to `af`, with environment variable alignment (`ce72bd9`).
- Align docs and workflows with Autofish rename (`f145559`).

### Fixed
- Fix npm package scope alignment to `@memohjs` across loader/docs/workflow (`eea0eb6`).
- Fix npm Linux install path during RC progression (`0eee441`).
- Fix CLI package version issues (`92163e3`).
- Fix release archive naming to avoid duplicate prefix (`187015d`).

## [0.1.1-rc.1] - 2026-03-24

Range: project bootstrap (`547a61a`) .. `app-v0.1.1-rc.1` (`06bf830`)

### Added
- Initial architecture/design docs and agent guidelines (`547a61a`, `f38952a`).
- Android direct control path via Shizuku (`eb9a83b`).
- REST API server with separate port and bearer auth (`b29583f`).
- Android settings/log UI improvements and startup/log visibility work (`6cad620`).
- Deterministic executor support in CLI (`9d17003`).
- Migration to Rust-based CLI with broader control reliability improvements (`8f273d6`).
- CLI request API refactor and screen output improvements (`a38ef8e`).
- SQLite trace persistence for CLI command history (`ff78df0`).
- Observe/verify UX and guidance improvements (`f7659ac`).
- Overlay offset config and multi-color legend support (`1c81672`).
- Tuple-style swipe arguments and clearer action help (`125f267`).

### Changed
- Refactor CLI runtime/command shaping during early evolution (`77c29eb`).
- Hide legacy UI surfaces and unify service wording/runtime IP display (`3e4dc03`).
- Simplify architecture docs and refresh root/CLI readmes (`8125900`).

### Fixed
- Async server stop behavior and accessible full-row toggle in UI (`f956d6d`).
- Validate non-negative tap coordinates and align `node-exists` selector behavior (`6bd9f3a`).
- Prevent startup theme flicker and splash mismatch (`f3dea24`, `6f08d19`).

### Performance
- Optimize release profile for smaller CLI binary size (`482ca17`).

### Build/CI/Release
- Prefer official Gradle repos with mirror fallback (`77c6f89`).
- Split release workflows and update GitHub Actions compatibility (`1a0369a`, `c6cc16b`, `62cf6f7`, `6e7809e`).
- Add license and publish metadata updates (`25ad62b`, `ea3c18d`).
- Tag and release bump to `0.1.1-rc.1` (`06bf830`).