# FixThis v0.6.1

FixThis v0.6.1 is a compatibility patch for external Android projects using
the published agent-first install path.

## Highlights

- **Android compileSdk compatibility restored.** The `0.6.1` sidekick AAR is
  built and release-gated with `minCompileSdk=34`, so apps compiling with
  Android 14 or 15 can consume FixThis without raising their project-wide
  `compileSdk` just for the debug sidekick.
- **Published versions are aligned.** CLI, Gradle plugin, sidekick, npm
  wrapper, MCP Registry metadata, and public install docs now all point at
  `0.6.1`.
- **Safer agent install.** `fixthis install-agent` preflights Gradle app-module
  matching before writing agent config, avoiding partial global Codex / Claude
  writes when a flavor-suffixed application id cannot be mapped.
- **Cleaner ADB device handling.** If one ready device is present alongside
  offline emulators, bridge requests scope to the ready device instead of
  failing with ADB's ambiguous-device error.
- **Release packaging guardrails.** Central Portal bundle creation validates
  sidekick AAR `minCompileSdk` against the shared catalog and now works with
  the documented relative output paths.

## Compatibility

- **Bridge protocol** is unchanged at `1.3`.
- **External Android apps** should apply the Gradle plugin
  `io.github.beyondwin.fixthis.compose` at version `0.6.1`.
- **Android compileSdk minimum** for the `0.6.1` sidekick artifact is `34`.
- **Persisted MCP JSON** is unchanged.

## Agent install

From a Jetpack Compose Android app repository:

```bash
# macOS
brew install beyondwin/tools/fixthis

# npm
npm install -g @beyondwin/fixthis

# macOS/Linux fallback without package managers
curl -fsSL https://raw.githubusercontent.com/beyondwin/FixThis/main/scripts/install-fixthis.sh \
  | bash -s -- --version v0.6.1

fixthis install-agent --project-dir . --target all
fixthis doctor --project-dir . --json
```

Manual Gradle plugin form:

```kotlin
plugins {
    id("io.github.beyondwin.fixthis.compose") version "0.6.1"
}
```

## Release evidence

The release-prep commit includes local Gradle, release version, Android
compatibility, and Central Portal bundle validation. Connected-emulator smoke
should be recorded separately if this tag's release issue needs device-level
evidence.

## See also

- [CHANGELOG.md](../../CHANGELOG.md) — full `[0.6.1]` entry.
- [docs/contributing/release-process.md](../contributing/release-process.md) —
  artifact and registry publication sequence.
- [docs/reference/compatibility.md](../reference/compatibility.md) —
  Android SDK compatibility contract.
