feat: parse decrypted Antigravity CLI trajectory sidecars (#552)

Adds support for `<uuid>.trajectory.json` sidecars next to the existing
AES-encrypted `<uuid>.pb` files under
`~/.gemini/antigravity-cli/{conversations,implicit}/`. The sidecars are
produced out-of-process by
[agy-reader](https://github.com/mjacobs/agy-reader), which holds the
decryption path and writes the resulting transcript as plain JSON;
agentsview's parser now detects the sidecar and uses it as the source of
truth for messages, tool calls, and tool results, falling back to the
existing `history.jsonl` + brain artifact path when no sidecar is
present. The sync engine treats the sidecar as part of the session for
change detection (combined mtime/size via `AntigravityCLIFileInfo`) and
forces message replacement on AgentAntigravityCLI sessions so trajectory
updates land cleanly. Per the trust-boundary table in `SECURITY.md`,
sidecars are treated as untrusted structured input under the "Imports
and new readers" row: the parser is defensive against unknown step
types, volatile fields are decoded through `json.RawMessage` accessors,
and reads are size-capped at 64 MB. No new outbound channel is
introduced; agy-reader is local-only. The legacy in-process
`ANTIGRAVITY_KEY` decrypt path is preserved as a fallback for users
without agy-reader installed; consolidating on the sidecar path is left
for a follow-up.

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Wes McKinney <wesmckinn+git@gmail.com>

Author: 3 people

README.md

@@ -213,11 +213,44 @@ agentsview auto-discovers sessions from all of these:
 | Warp               | `~/.warp/` (platform-dependent)                        |
 | Positron Assistant | `~/Library/Application Support/Positron/User/` (macOS) |
 | Antigravity        | `~/.gemini/antigravity/`                               |
-| Antigravity CLI    | `~/.gemini/antigravity-cli/` (summary mode)            |
+| Antigravity CLI    | `~/.gemini/antigravity-cli/` (see note below)          |
 
 Each directory can be overridden with an environment variable. See the
 [configuration docs](https://agentsview.io/configuration/) for details.
 
+### Antigravity CLI: high-resolution transcripts
+
+By default, agentsview indexes Antigravity CLI sessions in **summary mode**:
+your prompts from `history.jsonl` plus any plain-text artifacts under `brain/`
+(plans, walkthroughs, checkpoints). Assistant turns and tool calls live in
+AES-GCM-encrypted `.pb` files and are not visible in this mode.
+
+To unlock full transcripts, run
+[agy-reader](https://github.com/mjacobs/agy-reader) alongside agentsview.
+agy-reader talks to the local Antigravity daemon, decrypts each conversation,
+and writes a `<uuid>.trajectory.json` sidecar next to the encrypted `.pb` file.
+agentsview's file watcher detects the sidecar automatically and parses it in
+place of summary mode -- no agentsview restart needed.
+
+```bash
+go install github.com/mjacobs/agy-reader@latest
+
+# Generate sidecars for existing sessions...
+agy-reader --sync
+
+# ...or keep them fresh as you work.
+agy-reader --watch
+```
+
+agy-reader auto-discovers the Antigravity daemon URL by parsing
+`~/.gemini/antigravity-cli/cli.log`. If discovery fails (e.g. the log has
+rotated), the command prints platform-specific instructions for locating the
+port and exporting `ANTIGRAVITY_DAEMON_URL` manually.
+
+Sidecars stay on your machine. agentsview makes no outbound request to produce
+or read them, and treats sidecars as untrusted structured input -- see
+[SECURITY.md](SECURITY.md) for the trust model.
+
 ## PostgreSQL Sync
 
 Push session data to a shared PostgreSQL instance for team dashboards:

internal/config/config_test.go

@@ -51,6 +51,9 @@ func setupTestEnv(t *testing.T) string {
 
 func loadConfigFromFlags(t *testing.T, args ...string) (Config, error) {
 	t.Helper()
+	if os.Getenv("AGENTSVIEW_DATA_DIR") == "" {
+		t.Setenv("AGENTSVIEW_DATA_DIR", t.TempDir())
+	}
 	fs := flag.NewFlagSet("test", flag.ContinueOnError)
 	RegisterServeFlags(fs)
 	if err := fs.Parse(args); err != nil {
@@ -61,6 +64,9 @@ func loadConfigFromFlags(t *testing.T, args ...string) (Config, error) {
 
 func loadConfigFromPFlags(t *testing.T, args ...string) (Config, error) {
 	t.Helper()
+	if os.Getenv("AGENTSVIEW_DATA_DIR") == "" {
+		t.Setenv("AGENTSVIEW_DATA_DIR", t.TempDir())
+	}
 	fs := pflag.NewFlagSet("test", pflag.ContinueOnError)
 	RegisterServePFlags(fs)
 	if err := fs.Parse(args); err != nil {