Skip to content

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

Python

Release the v0.0.302.6 line as v0.0.302.5

Rach Pradhan1334860a4824
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a175762d..443dcabd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,7 +10,7 @@ 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.0.302.6
+## v0.0.302.5
### Session and transport fixes
@@ -42,7 +42,7 @@ current is part of cutting a release.
- Prompt evolution and local learning can require pinned formal-check evidence before scoring, checkpoint restore, or promotion. Drifted inputs or missing evidence stop that optional path; ordinary learning keeps its prior defaults.
- Formal evidence remains separate from held-out task evaluation: a model check cannot make an incorrect candidate pass, and these finite models do not claim proof that the implementation matches them.
-## v0.0.302.5
+### Desktop, browser and routing
- Dry-run route checks preserve an explicitly qualified selection while checking whether it is available. This keeps the reported route aligned with the route the next request would use.
- The CLI no longer installs, invokes, or advertises the Kuri companion. `webfetch` uses the built-in HTTP client and returns bounded HTML or text instead of companion-generated Markdown.
@@ -52,6 +52,10 @@ current is part of cutting a release.
- Browser panes begin closed and do not reopen merely because the user switched chats. Returning to an unchanged chat does not replay the latest text animation. Resized chat dividers rebalance panes consistently.
- Pull-request claim review accepts observed local checks, follows bounded test-runner reachability, and reports when evidence exceeds its input limit instead of presenting it as an unsupported claim.
+### Updates
+
+- `graff update --beta` opts into beta builds explicitly: it picks the newest numeric release branch, verifies the pinned archive against its checksums, and activates on the next launch. `graff update` stays on the stable channel.
+
## v0.0.302.4
### Harness execution and recovery
diff --git a/docs/releases/v0.0.302.5.md b/docs/releases/v0.0.302.5.md
index c0551a9a..fb8db901 100644
--- a/docs/releases/v0.0.302.5.md
+++ b/docs/releases/v0.0.302.5.md
@@ -1,8 +1,44 @@
# Codegraff v0.0.302.5
-This release removes the Kuri companion from Codegraff's supported paths and
-keeps explicit route checks aligned with the next request. It also prepares the
-desktop transition without changing the browser built into the macOS app.
+This release makes WebSocket turns stream live and recover cleanly, lets ACP
+clients such as Harness drive sessions in the folder and worktree they choose,
+and accepts images from every OpenAI and Codex model. It also removes the Kuri
+companion from Codegraff's supported paths and keeps explicit route checks
+aligned with the next request.
+
+## Sessions and transport
+
+WebSocket turns show response text as it arrives instead of holding it until
+the turn completes, and the connection falls back to HTTPS automatically when
+the socket fails. The warm-up request is off by default and xAI turns resend
+their history rather than chaining, which avoided a stall after the first
+frame; `GRAFF_WS_PREWARM=1` and `GRAFF_XAI_WS_CHAIN=1` opt back in. Loading a
+saved ACP session keeps the model it was launched with, and ACP and `--json`
+input accept records larger than 64 KiB instead of ending the session.
+
+## Workspaces over ACP
+
+`session/new` and `session/load` use the folder the client asks for. The
+worktree a session runs in is reported as `_meta["graff/worktree"]` (name,
+path, branch, base, owning checkout, and whether graff generated it), or
+`null` in a main checkout, and a mid-session switch sends
+`session_info_update`. A relaunched `graff acp -w <name>` reopens its session
+from the repository root. `graff worktree` now exits 1 when it refuses or
+fails and 2 when it does nothing. ACP clients can also pass MCP servers when
+they create or load a session.
+
+## Image input
+
+Every OpenAI `gpt-*` model, and every model on the `openai` and `codex`
+providers, accepts images. ACP advertises `promptCapabilities.image` and
+passes standard `image` prompt blocks to the model; text-only models skip
+them.
+
+## Local learning evidence
+
+Prompt evolution and local learning can require pinned formal-check evidence
+before scoring, checkpoint restore, or promotion. Ordinary learning keeps its
+prior defaults.
## Browser and web fetching
@@ -27,6 +63,9 @@ route a subsequent request would use, including the selected credential path.
## Distribution
+`graff update --beta` opts into verified beta builds from the newest release
+branch; `graff update` stays on the stable channel.
+
The release includes versioned CLI archives and checksums. The macOS desktop
download is attached only after Developer ID signing, Apple notarization,
stapling, Gatekeeper assessment, and update-archive verification. The stable
diff --git a/src/cli.zig b/src/cli.zig
index 3dc830e0..67aeb180 100644
--- a/src/cli.zig
+++ b/src/cli.zig
@@ -24,9 +24,10 @@ pub const changelog_text =
\\What's new
\\──────────
\\0.0.302.5
- \\ • route checks preserve explicitly qualified selections
+ \\ • WebSocket turns stream live, with automatic HTTPS fallback
+ \\ • ACP sessions use the client's folder and report their worktree
+ \\ • openai/codex models and ACP image blocks accept images
\\ • the old browser companion is retired; webfetch uses built-in HTTP
- \\ • web-only browser access uses the paired Chrome extension
\\
\\Full release history: https://github.com/justrach/codegraff/releases
\\