graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
Python
Describe v0.0.302.4 release and interface preview
Rach Pradhan4607566ddad3
diff --git a/docs/releases/v0.0.302.4.md b/docs/releases/v0.0.302.4.mdnew file mode 100644index 00000000..e6183799--- /dev/null+++ b/docs/releases/v0.0.302.4.md@@ -0,0 +1,96 @@+# Codegraff v0.0.302.4++This release makes long-running work more dependable, improves request recovery+and model selection, and brings the terminal and desktop sessions closer to the+same behavior. It also expands the offline checks used before a release.++++## Work that continues after a turn++Independent read-only lookups can begin while a supported response is still+streaming. The harness joins them before the next request and delivers each+result once. Dependent tools keep their order, and edits validate every span+before changing a file. A failed or unfinished background check remains visible+as such; it cannot be presented as completed verification.++Background commands retain durable handles. When one finishes, its owning+session receives the exit status and output. A stale handle cannot accidentally+address a newer command. Worker resume also keeps the conversation's workspace+and settings. Saved sessions restore their history without rerunning old tools.++Tool previews now preserve useful complete diagnostic lines from their source+ranges. Directory scans disclose when a bounded result is partial. Streamed+tool calls keep their identities even when an index is reused, so an incomplete+call cannot absorb a later call's arguments.++## Networking, retries, and usage++Supported streaming requests, bounded buffered requests, and model-catalog+pages share an HTTP/2 transport where available. Connection reuse, deadlines,+cancellation, and response-size limits have local fixture coverage. HTTP/1.1+remains available through `GRAFF_HTTP2=0`.++Ambiguous send failures are handed to the request retry policy instead of+being silently replayed by the transport. A completed response is not retried+because its trailer is late. Errors that identify an unavailable model stop+retrying. Catalog redirects are bounded, and credentials remain scoped to their+original origin.++Usage displays distinguish reported tokens and cost from attempts whose usage+or charge was not reported. An incomplete total remains explicitly unknown;+it is not shown as zero or as a complete subtotal.++## Models and effort++Opening the model picker refreshes the available catalog with a bounded+request and a cached fallback. Saved or explicit selections keep their chosen+route when a refreshed catalog omits a model; changing routes remains an+explicit choice. `graff refresh` is a short form of `graff models refresh`.++Effort controls show the values supported by the active model. Models with an+on/off thinking control show **Off** and **On** instead of an artificial+intensity ladder. An unsupported explicit setting is rejected before a request,+and changing models visibly resets a saved setting that no longer applies.+The optional effort-selection tool can queue a supported setting for its owning+session; it does not approve actions or judge the answer.++## Desktop and ACP++ACP sessions expose their available effort choices on creation and load.+Clients can change the same state used by `/effort`, and agent-originated+changes update the client. A change requested during an active turn applies+after that turn. Tool approval belongs to the active request and client;+cancellation cannot grant approval.++The desktop restores composer focus when switching chats, supports transcript+selection and response copying, and keeps browser navigation errors accurate+when a new page replaces an aborted load. The send and stop controls retain+their compact shape; optional interface sounds remain off by default. Desktop+task workspaces use separate Git checkouts, with landing and archive checks+that protect dirty or active worktrees.++Notarized macOS distributions can omit optional platform-passkey configuration.+When a profile is supplied, its authorization is still validated before+signing. Signature, notarization, stapling, and Gatekeeper checks remain part+of the distribution path.++## Replacement interface preview++The image below previews a proposed replacement interface. **It is not the+desktop interface shipped in v0.0.302.4.** This release still ships the+Codegraff desktop interface described above.++++## Install and verification++The release page provides versioned CLI archives and checksums. The macOS+desktop download is the signed, notarized DMG attached to the same release;+the stable desktop update archive is checked against its manifest before the+release is published. Linux desktop packaging is included where supported.++Offline checks cover formatting, source limits, test reachability, generated+SDK consistency, terminal behavior, desktop regressions, and scripted harness+behavior. Local transport and ACP fixtures cover retries, cancellation, tool+ordering, and uncertain usage without live service calls.