root-context-budget

Off by default: once a workspace turns it on, it reports a session's main thread whose context has grown past its level's size.

What it catches

A session's main thread whose context has grown past its level's size.

Why

Every call of a session re-sends its whole context, mostly as cache reads, so its cost grows with the square of its length, and a main thread that does its own reading pays for each result on every call after it. The size is the last usage the main transcript recorded, read after each call. At light it advises once at half the model's window, and says nothing for a model the table does not know; at standard it advises once at a fixed size, and at strict at a lower one, each lower when the account bills per token than on a subscription quota. The advice names magus job fork and a spawn. It never refuses: size tunes how often a session hears this, never whether its work is refused, which orchestrator-groundwork decides by the session's role. A tokens parameter replaces the level's sizes. It judges only the unleased main thread. A call whose output is a ref or one line is never judged by this rule, so a main thread past its budget can still build ./magus and file its work: the bootstrap build command, magus run or magus affected with -s or --silent, magus run go-build or go::go-build, magus job fork, exit, apply and wait, magus query output --identity, any magus command asked for -o name or -o template=, git commit, cherry-pick and branch, git status -s, and git log --oneline with a count (-n, --max-count or -N). A line that changes directory first is judged by the rest of it.

Default and override

By default this rule takes the decision off. A workspace sets it by name, in its root magusfile, to advise or off:

magus\guard.builtins({"root-context-budget": "advise"})

A loosening takes effect once it is committed; a tightening applies at once.

Seeing it

A verdict names its rule in brackets, which is how you got here:

advise [root-context-budget]: ...

magus describe rule root-context-budget prints the same entry at a terminal, and magus describe rules lists every rule this workspace enforces.

See also

• All rules - what this workspace enforces, deny first
• The guard - how a verdict is reached and wired
• Setting a built-in rule - how a workspace changes this default