Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python

Release v0.302.33

justrachd6b246b63ba6
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8b42ee9d..dd8b92bc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,12 @@ The release workflow uses a tag's section here as its release notes (a
hand-written `docs/releases/<tag>.md` wins if present), so keeping this file
current is part of cutting a release.
+## v0.302.33
+
+### Claude
+
+- On the Anthropic API, a new repo reads graff's tools and instructions from the prompt cache instead of rewriting them. The system prompt goes as two blocks with the same text, and the cache breakpoint now ends before the project instructions and layout. The first session in a repo the cache had not seen wrote 1.2k cache tokens instead of 10.1k on Claude Sonnet 5.5, about half the session's cost (ADR 0282).
+
## v0.302.32
### ACP
diff --git a/docs/releases/v0.302.33.md b/docs/releases/v0.302.33.md
new file mode 100644
index 00000000..98c491fe
--- /dev/null
+++ b/docs/releases/v0.302.33.md
@@ -0,0 +1,16 @@
+# Codegraff v0.302.33
+
+Claude sessions in a new repo start from the prompt cache.
+
+## A new repo reads the cache
+
+On the Anthropic API, graff caches its tools and instructions so later
+requests read them at a tenth of the price. The project layout sat at the end
+of that cached block, so a repo the cache had not seen yet missed all of it,
+and the first request wrote the whole ~10k-token prefix at 1.25x.
+
+The cache boundary now ends before the project instructions and layout. Every
+repo shares the tools and instructions, and only the repo's own part is
+written. Measured on Claude Sonnet 5.5, the first session in an unseen repo
+wrote 1.2k cache tokens instead of 10.1k and cost $0.017 instead of $0.033.
+The text graff sends is unchanged; only where the cache breakpoint sits moved.
diff --git a/scripts/eval/tier1-manifest.json b/scripts/eval/tier1-manifest.json
index ed66ba3a..f75c3f64 100644
--- a/scripts/eval/tier1-manifest.json
+++ b/scripts/eval/tier1-manifest.json
@@ -14,7 +14,7 @@
"src/main.zig",
"src/repl.zig"
],
- "test_count_baseline": 3245,
+ "test_count_baseline": 3247,
"test_count_slack": 25,
"required_invariants": [
{
diff --git a/src/cli.zig b/src/cli.zig
index 167cb86e..3ac86019 100644
--- a/src/cli.zig
+++ b/src/cli.zig
@@ -24,6 +24,9 @@ const update_target = @import("update_target.zig");
pub const changelog_text =
\\What's new
\\──────────
+ \\0.302.33
+ \\ • Claude: a new repo reads graff's tools and instructions from the prompt cache
+ \\
\\0.302.32
\\ • a yield_turn handoff shows once in ACP clients
\\ • graff login anthropic works from the desktop app, SSH and servers