Repository navigation
v0.12.0 “Gleipnir”: capabilities the realm grants, a fleet you read at a glance, and gates that hold the code's shape
Gleipnir is the binding the dwarves made: thin as a ribbon, and nothing
breaks it. In this release a seat holds only the powers its realm grants. It
also brings a terminal console that shows who must act and what each run is
doing, and a set of gates that hold the code to its architecture. It includes
the changes merged since
v0.11.0.
This release breaks recipes that write capability flags into a driver
command. Read Upgrade and compatibility
before you install it over a working setup.
What changed
-
Capabilities are the realm's to grant (decision 0065, slice one).
- Typed tools. A seat declares its tools as data (
tools.allow,
tools.deny,tools.sandbox), and the engine lowers them to each
harness's own flags. Every capability is off until the realm's map
(realms.v6) grants it. - Native powers. A harness power with no measured way to turn it off
refuses the seat; it is never silently on. - The final launch check. It re-reads the exact command handed to a
harness. - Bound to the bundle. Charters and policy are read once and bound to
the bundle's identity. - Recorded and reported. The run manifest (
run-manifest.v11) records
the realm, its grants and each seat's controls. Every prompt states what
the seat holds, andbrokkr doctorassesses the whole plan through the
launch's own final validation.
- Typed tools. A seat declares its tools as data (
-
A fleet you read at a glance.
brokkr tuilists runs by who must act:
needs you, then running, recent and older.- Each row carries a title, the ruling and its highest residual. A run
that folds to running but has been silent past every shipped deadline
shows as stale, and a quarantined run says what it needs. - On a wide terminal, the fleet opens on the first run that needs you,
in three columns:- the runs;
- a run dashboard (
d), which draws the run's live graph; - a live or findings column (
f), with the running seat's latest events
or the last review's findings.
- Keys.
cexpands a commission. A running row opens in place with →,
lor Space, and folds with ← orh.
- Each row carries a title, the ruling and its highest residual. A run
-
One run, one view. On a terminal,
brokkr run,brokkr resumeand
brokkr watch --run <id>open the same run view asbrokkr tuiand
Enter: graph, seats and trail, live.qcloses the view and the run keeps driving.- Ctrl+C stops the run as SIGINT always has.
- Off a terminal, every verb prints exactly what it printed before.
--no-viewkeeps the old output on a terminal too.
-
A timed-out attempt ends its whole process tree. This covers detached
descendants, the harness and its tools, before the report returns, so a
retry can no longer overlap a seat that is still writing. An end that
cannot be proven isindeterminate.
#483 -
Journal and engine.
- Contention. A peer's journal lock delays a working seat's
checkpoints and never ends its attempt.
#466 - Locked session trees. A hands session tree is locked for its owner's
life, and a dead owner's tree is reaped at the next start.
#469 - The hot path. Appends and engine turns pay only for what changed.
#458,
#459 - One admission. Run, resume and rerun admit through one runtime use
case. #495
- Contention. A peer's journal lock delays a working seat's
-
Operator surfaces.
- The CLI reference is rendered from the parser itself, every
documented command parses, and every exit code comes from one enum.
#490 - Operator commands are one typed verb with typed refusals and one
fence, and the views offer only the commands the fold would accept.
#446,
#456 - Spend. Every surface reports every attempt's spend.
#391 - Journals. Reading verbs open the journal read-only, and every journal
verb opens the map's journal.
#384,
#389 - Quarantine. A corrupt run is quarantined on every surface instead of
taking the fleet down.
#386 - Masking. A bound secret's value is masked wherever a transcript is
read. #390
- The CLI reference is rendered from the parser itself, every
-
Seats and secrets.
-
Policy.
-
Roster.
sonnetis Claude Sonnet 5.5.solis GPT-6.1 Sol, capped at
high effort, and Astra is kept only as a chief's last fallback. DeepSeek's
Flash is pinned by its current name.
#482,
#498,
#400 -
The code is held to its architecture (decision 0071). These gates run
on every pull request, and the required ones run again on the merge
queue's own commit.
#454- Ratchets on function size, nesting, parameters, suppressions, CRAP,
file size, duplication, public API and unused dependencies, against
committed baselines. - Static gates: pure core and view crates, no
unsafe, one-way
layering, and known dependency sources. - Exact coverage, with its escapes closed.
- Mutation testing of brokkr-core's diff.
- Deterministic budgets for speed, memory, crate count, prompt bytes
and binary size. The binary budget is a 30 MB ceiling. - Non-Rust lints, with every tool pinned.
#401,
#405,
#407,
#409,
#410,
#411,
#416,
#417,
#420,
#422,
#425,
#426,
#512 - Ratchets on function size, nesting, parameters, suppressions, CRAP,
-
Decisions are a ledger of what is in force.
#488
Accepted, not yet in this build
- Decision 0064: a run says how it ended. Runs still end
completedor
stopped. - Decision 0065, slices two and three. Slice one is in this build.
- Decision 0067: the plan is the schedule.
- Decision 0068: the dispatcher. Its first slice, the durable queue, is
in review (#430).
Built here but still proposed, and so not yet the operator's ruling:
- decision 0066 (a denial is something the launch proves);
- decision 0070 (every journal verb opens the map's journal);
- decision 0076 (the fleet lists who must act first).
Known issues
- A sandboxed script can park
indeterminate. A boxed exec attempt on a
loaded host can park as indeterminate because a sandbox descendant was
still exiting at the kill. Retry it.
#504 - Seats can receive cross-session messages. On a host running other
interactive Claude Code sessions, a seat is reachable by those sessions'
cross-session messages: an input channel outside the journal.
#505 - Some quarantined runs never leave "needs you". A run whose journal does
not fold has no operator command that closes it.
#511 - The terminal can be left in raw mode. If an external SIGTERM, SIGHUP or
SIGQUIT arrives while a driven run view is open, runreset. Ctrl+C itself
is handled. - Two commands cost more instructions. Each crossed the CPU budget's 2%
step in this cycle, measured against its pull request's base:
brokkr inspect(+2.1%, #509) andbrokkr --version(+2.8%, #510). - The status page and security model predate 0065. They do not yet
describe its tools semantics. Read decision 0065 for what a seat holds.
#366
Upgrade and compatibility
Capability flags in a driver command are refused at compile. A recipe or
agent that writes any of these into an inline driver command must declare
them as data instead:
- a tool list:
--allowedTools,--tools,--disallowedTools; --permission-mode;- an MCP, settings or config load:
--mcp-config,--strict-mcp-config,
--settings, Codex-c; - a sandbox class: Codex
--sandboxor-s; - an extra directory:
--add-dir; - a session selector.
The refusal names the argument. Declare tools.allow, tools.deny or
tools.sandbox on the seat or its agent, and grant the capability in the
realm's map (forge.realms/v6, capabilities). brokkr doctor shows what
each seat ends up holding.
Finish or conclude runs started before this release with 0.11. A pinned
resume of such a run refuses as unrecorded, because its manifest records
none of the capabilities this release requires.
Also retired in this cycle:
- The pre-rename names. The
FORGE_*environment overrides and the
{forge}argv token no longer configure anything. Set theBROKKR_*
names, and write{brokkr}.
#457 binding_grantin an adapter is refused. Declareegressinstead.python3andpytestleave the shipped allow-lists.intake-sddleaves the agent library.
New contracts. realms.v6, run-manifest.v11, tool-dialect.v1 and
effect-cleanup.v1 sit beside their earlier versions; no earlier frozen bytes
changed. The version bump changes compiled manifest identities. The binary
remains brokkr, with Rust 1.88 as the minimum build version.
Verifying a download. Check it against SHA256SUMS, and its build
provenance with gh attestation verify <asset> -R feedback-loop-ai/brokkr.