Skip to content

FixThis v1.3.0

Choose a tag to compare

View all tags
@beyondwin beyondwin released this 21 Jun 14:30
v1.3.0
e52286a

FixThis v1.3.0

FixThis v1.3.0 tightens the external Android app trust loop. The release makes
first-handoff failures easier to recover from, gives maintainers one matrix for
external setup plus runtime trust evidence, and adds a long-form handover guide
for people maintaining the Android, CLI, MCP, console, and release tooling
together.

Highlights

  • External App Trust Matrix v2. The external fixture matrix now separates
    setup-only checks from runtime-capable first-handoff trust checks. It reports
    pass, deferred, fail, fixture drift, or caveated pass, and it only accepts
    caveated trust when the handoff preserves warnings such as
    VISUAL_AREA_ONLY, POSSIBLE_VIEW_INTEROP, or SHARED_COMPONENT.
  • First-handoff recovery evidence. Agent-loop smoke reports now tell a
    maintainer exactly why the first external app handoff could not complete:
    failureCode, readiness, nextAction, verify, and fix are preserved
    for missing Android SDK, ADB, emulator, or app-launch prerequisites.
  • Release gate coverage for matrix v2. npm run release:gate now consumes
    the v2 external matrix as the external-trust-matrix-v2 claim, so release
    notes can be narrowed to evidence that actually passed or was explicitly
    deferred.
  • Maintainer handover guide. The new fullstack/tooling handover guide
    explains how the debug app runtime, desktop CLI/MCP process, browser console,
    local .fixthis/ workspace, and evidence scripts fit together.
  • Cleaner doc navigation. The docs index now points directly at the CLI
    exit-code reference, source-matching reference, and handover guide.

Compatibility

  • V1 scope is unchanged. FixThis remains debug-only, local/ADB-only, and
    Compose-only. This release does not add PyPI, Docker, or a new package
    channel.
  • Persisted MCP JSON: additive only. The existing compatibility fields
    items, screens, itemId, screenId, targetEvidence,
    targetReliability, and sourceCandidates are unchanged.
  • Source-index schema: current assets still use schema 1.3.
  • Bridge protocol: unchanged at 1.3.
  • Gradle plugin: io.github.beyondwin.fixthis.compose version 1.3.0.
  • CLI/MCP package: fixthis-cli-mcp-v1.3.0.tar.gz.
  • npm wrapper: @beyondwin/fixthis@1.3.0.

Agent install

From a Jetpack Compose Android app repository:

# macOS
brew install beyondwin/tools/fixthis

# npm
npm install -g @beyondwin/fixthis@1.3.0

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

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

Manual Gradle plugin form:

plugins {
    id("io.github.beyondwin.fixthis.compose") version "1.3.0"
}

Release evidence

The release commit should include passing or explicitly deferred evidence for
the External App Trust Matrix v2, first external-app handoff recovery, release
drift, and release gate sections in
docs/contributing/release-readiness.md.
Connected Android evidence remains local-only; if no unlocked emulator is
available, record the runtime commands as deferred rather than claiming
device-level proof.

See also

Assets 4
Loading