Skip to content

feat(reviewer): research provenance — footer, agy version, transcript archive - #172

Merged
asavs merged 4 commits into
mainfrom
feat/research-provenance
Jul 12, 2026
Merged

asavs merged 4 commits into
mainfrom
feat/research-provenance

Conversation

@asavs

@asavs asavs commented Jul 12, 2026

Copy link
Copy Markdown
Owner

Summary

Strengthens review and research provenance so posted reviews and research pairs are comparable across silent CLI upgrades and engine revisions.

  • Footer shape A: *{model} in [agy {cli_ver}](release) took {dur} via [goobreview {ref}](commit|release).*
    • Clean agy versions link to antigravity-cli release notes; messy probes stay plain text
    • Engine links goobreview release notes when HEAD is a v* tag tip, else the commit
    • Segments omit cleanly when CLI/engine are unavailable
  • agy CLI version probed once per tick (mtime-cached); recorded in footer, dry-run artifacts, research manifests, and the tick log
  • sync-worktree fetches refs/tags/v* so detached VM checkouts can resolve release tips
  • Capture the agy session transcript and session ID with each research pair #157 transcript archive: session id + gzip'd transcript_full.jsonl per research arm (before counterfactual overwrites sidecars), epistemic note in the manifest, size cap with truncation marker
  • Research fixture e2e: plants brain transcripts under a fixture HOME; asserts non-null session/archive + gunzip content; keeps FIXTURE_NO_TRANSCRIPT stdout_fallback path
  • Dev env: agent docs state GNU/Linux (Ubuntu/WSL) is required; fixture runner fails loud on MSYS/missing flock; optional scripts/dev-env-check.sh

Test plan

  • bash scripts/reviewer/tests/run-fixtures.sh under WSL Ubuntu — 617/617
  • CI Linux validation on this PR
  • (optional) dry-run against a real target and confirm footer wording + links

Closes #157

asavs added 4 commits July 12, 2026 13:56
Probe agy --version once per tick (mtime-cached) and record it in the
posted review footer, dry-run artifacts/launch.json, research manifests,
and the tick log. Model labels alone do not catch silent agy upgrades.

Footer shape:
  *{model} in [agy {cli_ver}]({agy_release_url}) took {dur} via [goobreview {ref}]({engine_url}).*

Clean agy versions link to antigravity-cli release notes; messy probes stay
plain text. When HEAD is exactly a v* release tag tip, the engine link points
at goobreview release notes instead of the raw commit. sync-worktree fetches
refs/tags/v* so detached VM checkouts can resolve that. The "in agy …" and
"via goobreview …" segments are omitted when unavailable.
Capture the brain session id and a gzipped transcript_full.jsonl next to
each research arm (#157), before the counterfactual run overwrites the
shared agy-runtime sidecars. Manifests record session_id and
transcript_archive paths plus a fixed epistemic note that transcript
thinking fields are model-paraphrased summaries, not verbatim reasoning.

Oversize transcripts are truncated at REVIEWER_MAX_TRANSCRIPT_BYTES
(default 10 MiB) with a sidecar marker. Missing transcripts remain
best-effort (stdout_fallback / agy_failed paths).
Plant brain-session transcripts in the research-loop fixture so #157 is covered under a full tick: distinct posted/CF session ids, gzip archives on disk, and gunzip content. Keep a FIXTURE_NO_TRANSCRIPT path that still succeeds with stdout_fallback and null session/archive fields.
Agent and contributor docs state that shell validation targets Ubuntu/WSL, not Git Bash. The fixture runner exits non-zero without flock or on MSYS instead of soft-skipping. scripts/dev-env-check.sh is an optional read-only probe for the GNU tools the daemon and suite need. Note GNU sort/sed at the provenance footer call sites.
@asavs
asavs merged commit 7ff9e26 into main Jul 12, 2026
1 check passed
@asavs
asavs deleted the feat/research-provenance branch July 12, 2026 21:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Capture the agy session transcript and session ID with each research pair

1 participant