Skip to content

AgentCache 0.4.0

Choose a tag to compare

View all tags
@cdibona cdibona released this 30 Jun 15:49
· 19 commits to main since this release
v0.4.0
2a3920c

AgentCache 0.4.0 — Measured adoption trial + explicit loop safety.

⚠️ Proof-of-Concept / Experimental Prototype
This is an early-stage project. The API, storage format, and semantics are subject to change. See README for the full caveat.

What's New

feat: One-shot MEASURED adoption trial

scripts/try_agentcache.py + scripts/try.sh — a curl-able wrapper for try-before-you-adopt.

The measured companion to the static assess_repo.py predictor. It mirrors your repo (local path or GitHub URL), stands up the real byte-counting proxy + git daemon + agentcache service on ephemeral ports (no Docker, no collision with a running harness), runs the real ExperimentRunner for one cold pass (seeds artifacts) + one warm pass (steady state), and reports:

  • Actual network bytes for naive / blobless / agentcache strategies
  • Warm % savings vs blobless
  • Break-even passes (how many warm clones to amortize the cold cost)
  • Honest suitability verdict — the same as used by the harness report: "agentcache worthwhile" / "blobless is enough" / "inconclusive — measure to be sure"

Cold-cost caveat: agentcache cold delivers full history; the blobless column is depth-1 shallow. See the README for interpretation.

feat(hook): Explicit, tested loop-prevention guard

Loop-prevention guarantee is now explicit and locked by tests — a self-trigger loop was already structurally impossible (cache artifacts written via in-process ref writes that never re-fire post-receive; hook acts only on refs/heads/; the Action's branches:[main] filter excludes refs/agent-cache/), but the guard is now config-correct, tested, and documented:

  • Early skip for any ref under the configured AGENTCACHE_REF_PREFIX
  • Documented loop-safety invariant
  • 5 regression tests (cache-namespace no-op, tags no-op, deletions no-op, real branches generate, mixed stdin generates one)

Quality & Testing

  • 183 tests pass (138 core + 45 new measured-trial integration)
  • CI green: all steps (checkout, install, generate, publish, artifacts upload)
  • Real repo measurement confirmed honest: reports "inconclusive" / "blobless is enough" correctly on previously-dangerous cases

Testing & Adoption Path

  1. Static prediction (cheap, conservative): python scripts/assess_repo.py /path/to/repo
  2. Measured trial (real proxy bytes): curl -fsSL https://raw.githubusercontent.com/cdibona/AgentCache/v0.4.0/scripts/try.sh | bash
  3. Deploy to production (full harness + GitHub Action) if verdict says "agentcache worthwhile" and you've confirmed the break-even math fits your cloning velocity.

Generated with Amplifier

Assets 2
Loading