COMPATIBILITY.md

Compatibility

agy-reader is verified against the Antigravity CLI (agy) local session format recorded below. This file is generated by the agy-format-audit skill and is replaced wholesale on a qualified passing audit (audit_format.sh --record). Do not hand-edit.

• agy version: 1.2.13
• Verified on: 2026-09-29
• agy-reader commit: 9a228af (clean working tree)
• Schema: user_version=1, 7 tables, indices: idx_steps_status,idx_steps_step_type
• Schema fingerprint: sha256:1ca98426f561fe73223c8620a238405030fdb3014444d970e1300a6009f72f43
• Sidecar shape fingerprint: sha256:3acca61c897bdec898292c1646090faf1913781f0a4d11ca389bc043ba4ec92a
• Sidecar corpus scope: explicit-version-scoped — deterministic digest over the trajectory JSON's key-structure (see internal/shapefp); catches daemon RPC-response reshaping the schema fingerprint cannot see. Corpus-dependent: by default this is the sidecar paired with the newest DB; set AGY_SIDECAR_CORPUS to a stable curated corpus generated by the version under audit. A partial-<version>-scoped label means the corpus was not asserted to be fully re-serialized by that version, so its union may mask a path the version removed; the version in the label makes the next audit report not comparable instead of a falsely reassuring UNCHANGED. Re-sync every sidecar and re-run with --corpus-swept to earn the comparable explicit-version-scoped label.
• IDE surface: the Antigravity IDE (~/.gemini/antigravity) writes the same conversation .db schema, verified byte-identical against this fingerprint at Antigravity 2.2.1 (2026-07-02); only trajectory_meta.source differs (IDE=1, CLI=17). Spot-check the IDE copy read-only with ANTIGRAVITY_CLI_ROOT=$HOME/.gemini/antigravity audit_format.sh — never --record from an IDE root.