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.36

justrach2a6f7bedc49d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06c1bc40..a0f046cb 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.36
+
+### Workspaces
+
+- New task worktrees honor the tool-neutral `.agents/` setup. Each gitignored path `.agents/linked` lists becomes a symlink to the main checkout's copy, so a `.env` edited once is current in every worktree; tracked paths, `..`, globs and missing paths are skipped and nothing is moved or deleted. `.agents/prepare` runs from the new checkout when `.graff/workspace.toml` names no setup script. `graff worktree create` reports the linked count (#1633, ADR 0283).
+
## v0.302.35
### Hosted gateway
diff --git a/docs/releases/v0.302.36.md b/docs/releases/v0.302.36.md
new file mode 100644
index 00000000..0434c785
--- /dev/null
+++ b/docs/releases/v0.302.36.md
@@ -0,0 +1,34 @@
+# Codegraff v0.302.36
+
+New task worktrees set themselves up from the project's `.agents/` files.
+
+## `.agents/linked` and `.agents/prepare`
+
+Many projects keep their agent setup in the tool-neutral `.agents/` directory,
+next to `.agents/skills`. graff worktrees read only `.graff/workspace.toml`, so
+such a project got no setup, and the `.env` copied into a worktree went stale
+when the main checkout's copy changed.
+
+When graff mints a task worktree (`graff worktree create`, automatic isolation,
+or a workspace an ACP client asks for):
+
+- `.agents/linked` lists repository-relative paths, one per line. Each one that
+ is gitignored in the main checkout, exists there, and is missing from the new
+ worktree becomes a symlink to the main checkout's copy, so a `.env` edited
+ once is current everywhere. Tracked paths, `..`, globs and missing paths are
+ skipped, and nothing is moved or deleted. Windows links nothing.
+- `.agents/prepare` runs from the new checkout as its setup script when
+ `.graff/workspace.toml` names none. Keep it fast and safe to repeat.
+
+```
+# .agents/linked
+/.env
+secrets/
+```
+
+```sh
+#!/bin/sh
+# .agents/prepare
+set -eu
+pnpm install --frozen-lockfile
+```
diff --git a/scripts/eval/tier1-manifest.json b/scripts/eval/tier1-manifest.json
index 2dde2137..df4c9c63 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": 3252,
+ "test_count_baseline": 3253,
"test_count_slack": 25,
"required_invariants": [
{
diff --git a/src/cli.zig b/src/cli.zig
index cfa1eef6..0380f00c 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.36
+ \\ • new worktrees link .agents/linked files and run .agents/prepare
+ \\
\\0.302.35
\\ • gateway models are priced from the gateway itself; new models show their cost
\\ • graff models shows each gateway model's real rate