Skip to content

PlanBefore v0.5.0

Choose a tag to compare

@kevincoder91 kevincoder91 released this 22 Sep 03:50

Highlights

  • Tasks now work with Codex's default sandbox. Your local developer agent
    no longer needs to write to .git. The Node prepares the requirement's
    branch before the first task and, when a task finishes as done, creates
    one new commit with exactly the files that task changed, verifies it against
    Git and reports its hash. The agent only edits files and runs checks, so
    executor.sandbox: workspace-write is enough for the whole flow: branch,
    task, commit, checkpoint, next task and fix packs.
  • Your existing work stays yours. Uncommitted changes, staged changes,
    untracked files and planning documents that existed before a task are never
    included in its commit and are left exactly as they were.
  • Fails safe instead of guessing. If the Node cannot isolate a task's
    changes safely (a file you were already editing that the task also touched,
    a change the agent did not report, or the branch, HEAD or index changed by
    someone else during the task), it does not commit: the run ends with
    git_finalize_failed and the changes stay in place for you to review.
    Cancelled, timed-out, blocked or failed runs never commit.
  • The Node never pushes, merges, opens pull requests, resets, cleans, amends
    or squashes, and it never rolls anything back. The MCP Git tools remain
    read-only; there is still no tool for Git changes, shell commands or
    arbitrary file writes. Accepting a task is still up to you.

Fixes

  • A commit touching files in subdirectories is now verified correctly.
  • A cancellation that arrives while a task is finishing no longer lets that
    task commit; cancelling while the Node is already committing is rejected.
  • A commit left behind by a Node crash is reported as drift instead of being
    silently built upon.

Upgrade notes

Run the install command again, then restart the Node:
pbnode stop && pbnode serve --background.

If you set executor.sandbox: danger-full-access only so that tasks could
create branches and commit, you can switch back to the default
workspace-write (or remove the setting) and restart the Node.
danger-full-access is still accepted, but no longer required.


Install

macOS / Linux:

curl -fsSL https://planbefore.kvnlabs.xyz/install.sh | REPOFLOW_VERSION=v0.5.0 sh

Windows (PowerShell):

$env:REPOFLOW_VERSION = 'v0.5.0'; irm https://planbefore.kvnlabs.xyz/install.ps1 | iex

Both installers verify the SHA-256 of the download against checksums.txt.
Manual installation, requirements (git, rg) and first steps:
https://planbefore.kvnlabs.xyz/install

The binaries are not code-signed yet; macOS and Windows may show a warning
for files downloaded with a browser. See the installation guide.