Skip to content

Replace the README with the approved overview - #407

Merged
tylerreckart merged 5 commits into
mainfrom
cursor/readme-draft-2ba9
Oct 15, 2026
Merged

tylerreckart merged 5 commits into
mainfrom
cursor/readme-draft-2ba9

Conversation

@tylerreckart

@tylerreckart tylerreckart commented Oct 15, 2026 •

Copy link
Copy Markdown
Owner

Summary

Replaces README.md with the user-approved draft. Wording is unchanged except three factual corrections against the router that #403 ships:

  • A low-confidence bge score is still the route for that turn. Background Luna (openai/gpt-6-luna) runs only when ARBITER_ROUTER=luna.
  • A missing model, a failed download, or ARBITER_EMBED_NO_FETCH uses the keyword heuristic and does not start Luna.
  • The routing diagram and the ARBITER_EMBED_NO_FETCH row say the same thing.

Left as written, because they already match the blocker PRs: arbiter --version, docs/stability.md, ARBITER_ROUTER=bge|luna|heuristic (default bge), the Luna model id openai/gpt-6-luna, and the model cache under ~/.cache/arbiter/models/. The draft does not name the default chat model, so it does not mention ~openai/gpt-sol-latest.

Every relative link in the file resolves on this branch, including docs/stability.md, the docs pages, CONTRIBUTING.md, SECURITY.md, LICENSE, and the icon and trailer assets. The in-page #safety-model anchor matches the Safety model heading. All three mermaid flowcharts parse.

Base

The branch is stacked on cursor/stability-contract-2ba9 (#404), not cut from main alone. docs/stability.md does not exist on main, and the README links to it. This PR targets main so CI runs. Until #404 merges, the diff also contains that branch. After it merges, only the README commit remains. Merge #404 first.

Test plan

Open in Web Open in Cursor 

cursoragent and others added 2 commits October 15, 2026 13:17
docs/stability.md is the freeze for CLI flags, agent files, the ~/.arbiter layout, and documented environment variables. Agent files gain an optional version (default 1). The tenant database records schema version 1 in PRAGMA user_version and migrates through that hook. ~/.arbiter is mode 0700 and tenants.db is mode 0600. go run asks for confirmation; go build and go test do not. ROADMAP.md is removed.

Co-authored-by: Tyler Reckart <tylerreckart@users.noreply.github.com>
Correct the default router: a low-confidence embed still routes, Luna runs
only for ARBITER_ROUTER=luna, and a missing model uses the heuristic.

Co-authored-by: Tyler Reckart <tylerreckart@users.noreply.github.com>
@cursor
cursor Bot changed the base branch from cursor/stability-contract-2ba9 to main October 15, 2026 13:42
cursoragent and others added 3 commits October 15, 2026 13:43
Co-authored-by: Tyler Reckart <tylerreckart@users.noreply.github.com>
Co-authored-by: Tyler Reckart <tylerreckart@users.noreply.github.com>
@tylerreckart
tylerreckart marked this pull request as ready for review October 15, 2026 15:06
@tylerreckart
tylerreckart merged commit e6a925b into main Oct 15, 2026
5 checks passed
@tylerreckart
tylerreckart deleted the cursor/readme-draft-2ba9 branch October 15, 2026 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants