Repository navigation
Reflex v0.18.0: human-last decisions
Reflex decides so you are asked only when it matters: Jev (System One) first, then System 2 (the claude CLI or an API backend), then you, for the always-human class, rule hits, a change freeze or the runaway guard.
Install: /plugin marketplace add ursuciprian/reflex then /plugin install reflex@reflex · or npx @ursuciprian/reflex@0.18.0 setup (run outside a Reflex checkout) · GitHub Action: uses: ursuciprian/reflex@v0.18.0
Changed
- Laya engine:
reflex setup --engine layainstallslaya[serve]==0.3.22(was 0.3.20). Measured head to head with 0.3.20 and Jev 1.13.0 on every golden set on 2026-09-30: every number is the same, and every answer is the same except four gate cases whose state holds a per-process path (at most 0.013 of probability, no decision changed). The checkpoints stay at revision55cf4c4, still the latest. The GUIDE's "Measured against Jev" table is rerun on the current golden sets (199 gate cases, 47 ladder commands) and adds the MCP set, where calibrated Laya matches Jev (0 MISS, 0 over-strict, on 6 cases that reach System 1). Laya stays off by default.
Added
- Human-last by default: when System 1 is unsure and a System 2 is found (the
claudeCLI, elseANTHROPIC_API_KEY),reflex setupturns it on in the supervised profile and with no profile too, so System 2 decides before a human is asked. The always-human class, rule outcomes, a change freeze and the runaway guard still reach a human, and what System 2 hands up is asked in the agent as before.config.json"judge": "off"(orreflex setup --judge off) opts out, and later setups keep it off. Ajudge.backendofnonesaved by an earlier supervised setup is not an opt-out: the next setup picks a System 2 when one is found. reflex statuslists the human-last rungs (rules, read-only and fast lane, the workspace allowlist, System 1, System 2, human), whether each is active and why, and what still reaches a human.- The keyless workspace allowlist (
workspace.mjs):mkdir -p,touch,sed -iwith ones///script on a tracked file (the GNU or the BSD form, following thesedon PATH), andcpormvof a tracked file to a path that does not exist yet pass without an engine, each as one simple command with plain relative paths only. No operator, expansion, redirect, glob, extra flag, dot segment (..,.git,.reflex,.github,.husky), symlink, nested repository or protected path. In enforce mode a checkpoint is taken first and the pass is refused without one, and never in production; anything else goes to the engine or the ladder unchanged.config.json"workspace": falseorREFLEX_WORKSPACE=offturns it off.node workspace.mjs --selfcheck(innpm test) runssetup/tool-gate/golden-workspace.json, which covers the ten bypasses the review of the first attempt (#78) confirmed. - MCP infrastructure preset: an unknown MCP tool on a server named for cloud, clusters, IaC, a database or a code host (
aws,awslabs,kubernetes,k8s,kubectl,terraform,tfc,gcp,gcloud,azure,postgres,mysql,mongodb,dynamodb,database,db,supabase,github,gitlab) or any server name containingprodasks keyless instead of being logged only; Jev still judges it with a key. The match reads the server name alone, word by word, so aupdate_databasetool on a notion server is not infra anddbtis notdb.config.json"mcp": {"infra": false}turns it off. npm run eval-compareruns the MCP golden set too (--suites mcp).
Fixed
- A checkpoint whose
git stash createfailed (an intent-to-add entry, a read-only.git) was recorded as HEAD, soreflex checkpoints restorecould not bring back uncommitted changes. It is now no checkpoint at all. - Engine jev with no API key (for example a curl install without
--keychain): in shadow mode every command the rules leave to the engine was logged as an ask with the rule "jev unavailable (Error: no API key for typesafe: ...)". Shadow enforces deterministic rules only, so an engine that gives no answer (a missing key, an unreachable host, a timeout, a malformed answer) now passes, and the trace records the reason. Enforce mode keeps the policy fallback, which asks. - A missing engine key is now reported as a configuration error, not an outage.
reflex statusandreflex doctorshow "Jev engine has no API key: every engine decision falls back; run reflex setup --keychain or set TYPESAFE_API_KEY", also when only the hooks' environment lacks the key. The Claude Code hook shows the warning once per session as a systemMessage, not once per command. reflex setupwith a saved engine jev and no key found (environment, Keychain or provider options) now picks the local engine and says so. With--engine jev,--providerorREFLEX_ENGINEit keeps jev and prints a loud warning that suggests--keychain.
Docs: https://ursuciprian.github.io/reflex/ · Changelog: https://github.com/ursuciprian/reflex/blob/main/CHANGELOG.md