Skip to content

Track: adopt agentic-qe 3.12.3 (atomic RVF export + self-heal) and remove the corrupt-lock guard #30

Description

@pacphi

What we're waiting on

Upstream agentic-qe PR #564 (release v3.12.3) fixes the RVF corruption we filed as #563: non-atomic brain.rvf export → truncated store + permanent FsyncFailed, silently dropping aqe off ruvector.

Status at time of filing (2026-07-17): PR #564 is open / not merged; agentic-qe@3.12.3 is not published (latest on npm is 3.12.2). Nothing to do until it ships.

What 3.12.3 changes for us

  • Exports become atomic (tmp + rename) — the corruption stops happening.
  • Genuinely-unusable stores self-heal on the next run, non-destructively (quarantine-aside, not delete), gated on the lock's owner pid.
  • The kit's own corrupt-lock detector is unsound and becomes redundant: FLVR is the normal lock magic (store magic is SFVR), a 162-byte store is a valid empty store — measured against @ruvector/rvf-node 0.1.8 and confirmed across every lock on the dev machine. See PR fix(rvf): version-gate + pid-guard the corrupt-lock detector (retires on aqe 3.12.3) #31 (fix/rvf-corrupt-lock-detector-version-gated).

Already shipped (PR #31, merged/pending)

  • aqeSelfHealsRvf() gate: the corrupt-lock scan auto-retires once installed aqe ≥ 3.12.3 — so the moment we ak sync up to it, the kit stops second-guessing aqe. No code change strictly required at release time; it flips on version detection.
  • Interim safety on < 3.12.3: the legacy scan is now pid-guarded (only a stale/dead-owner lock can trip it — never a live peer's store).

Acceptance criteria (do these when 3.12.3 lands)

  • npm view agentic-qe@3.12.3 version returns 3.12.3 (published)
  • PR #564 shows merged
  • ak sync bumps the machine to aqe 3.12.3; confirm ak status no longer shows an aqe … stale/oversized RVF row on a previously-flagged project
  • Confirm aqe self-heal fires (its [RVF] Quarantined unusable store … / Removed stale lock … log on a real broken store), i.e. the kit's guard is genuinely dead weight
  • Then delete the now-dead corrupt-lock branch + aqeSelfHealsRvf gate from src/lib/rvf.mjs (keep only the oversized backstop), and simplify the aqe status/heal wording
  • Update memory note aqe-brain-rvf-fsync-issue

How we'll get notified

Watching for the release rather than polling by hand — see the follow-up in this thread (scheduled npm/GitHub-release check). Manual check any time:

npm view agentic-qe@3.12.3 version   # empty until published
gh pr view 564 --repo proffesor-for-testing/agentic-qe --json state,merged

Refs: aqe #563 (root cause), aqe #564 (fix), kit PR #31 (interim guard + gate).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions