Configuration

Every tunable has one default, in lib/defaults.env, with a comment saying what it does. Four layers decide the value, highest first:

  1. An environment variable, MAINTAINER_<KEY>, for one invocation: MAINTAINER_VERIFY_MEMORY=8g maintainer-merge verify ...
  2. A suite's own declaration, for the VERIFY_* resource keys only. A file in profiles/<name>/verify.d/ may define suite_memory, suite_cpus, suite_pids or suite_tmpfs, because the suite knows what its build needs. The sysknife rust suite declares suite_memory (6g) and suite_jobs (4) side by side: each cargo job is a rustc holding about a gigabyte while it links, so the two move together.
  3. The key in a profile's profile.env, to change it for that profile.
  4. lib/defaults.env.

A profile does not need to declare any of these. maintainer-doctor, run.sh, maintainer-merge, maintainer, maintainer-mcp and the backends all read the same file, so a number is changed in one place.

keydefaultwhat it bounds
VERIFY_MEMORY2gcontainer memory for a verify run (fetch, clean and mutated)
VERIFY_CPUS2CPUs for the clean and mutated runs
VERIFY_PIDS512process limit inside a verify container
VERIFY_TMPFS256msize of the /tmp tmpfs inside a verify container
VERIFY_TIMEOUT1800seconds one clean or mutated container may run
PREFETCH_TIMEOUT900seconds the networked dependency fetch may run
MCP_VERIFY_SLACK300seconds added to the MCP verify deadline, which is 2 x VERIFY_TIMEOUT + PREFETCH_TIMEOUT + slack
LOCK_WAIT3600seconds a run waits for the shared lock. Keep it below the unit's TimeoutStartSec (10800): the wait spends that budget, and the test suite fails if it reaches it
RETENTION_DAYS90days maintainer gc keeps logs and drafts. runs/ and index.md are never pruned
REPORT_MIN_LINES3non-empty lines a run report needs below its heading before finish indexes it; lib/preamble-core.md asks a quiet run for exactly this many
CLAIM_STALE_DAYS7days of silence after which maintainer claims marks a claim stale
STALE_HOLD_DAYS9days of silence after which maintainer stale names a hold
FIXUP_QUIET_DAYS10days an author must be silent after a review before maintainer stalled lists the pull request and maintainer-repo fixup may act on it
FIXUP_NOTICE_DAYS5days between the heads-up comment and the fixup push. Covers the slowest comment reply seen on sysknife (4.0 days)
FIXUP_MAX_LINES20most lines, added plus deleted, a fixup patch may change. Five times the 4 lines each past test-count edit changed
GH_LIST_LIMIT1000rows requested from a gh list that must be complete. A listing exactly this long is refused, because gh cuts silently at the limit
CONTRIBUTOR_WINDOW300merged pull requests read to find past contributors. A recency window, so filling it is not an error
GH_TRIES3attempts run.sh makes to reach GitHub before recording an exit-75 failure
GH_BACKOFF20seconds between those attempts
RED_GRACE_HOURS6hours main may stay red before maintainer-doctor fails
DOCTOR_RUN_LIMIT40workflow runs maintainer-doctor reads to decide whether main is red
DENY_WALL_MIN_RULES100fewest rules a rendered deny wall may hold before the doctor calls it stale
LEASE_TTL_SECONDS3600seconds a maintainer lease take holds a pull request when --ttl is not given. An unrenewed lease frees itself after this long
DOCTOR_LEASE_HOURS12hours since a lease was last renewed before maintainer-doctor warns that it was forgotten
OPENCODE_MODELgroq/openai/gpt-oss-120bmodel the opencode backend uses when the profile names a Claude model
DEPS_AUTOMERGEminorwhich green Dependabot bumps maintainer deps sends to verify: none, patch (every member semver-patch) or minor (patch or minor). A Docker digest bump that keeps its image and tag has no semver class and passes at patch and minor. A semver-major member always goes to a person
DEPS_UNKNOWN_READS3reads maintainer deps makes of a merge state GitHub answers UNKNOWN, before it reports it
DEPS_UNKNOWN_WAIT5seconds between those reads
UPDATE_READBACK_READS6reads maintainer-merge update makes of the pull request after asking GitHub to update the branch, waiting for the head to move and the merge state to leave BEHIND and UNKNOWN. It reports the update only on a read that shows it
UPDATE_READBACK_WAIT5seconds between those reads
CLASSIFY_TIMEOUT60seconds verify-deps gives the dependency classifier before refusing

Adding a key: put it in lib/defaults.env with a comment, add a row here, and read it through $KEY in bash (after maintainer_load_defaults) or _tunable("KEY") in bin/maintainer. Never write the number at the call site.

One profile key has no default and is not in that file: FIXUP_COUNT_CMD, a command that prints the profile's test count, run in the scratch clone by maintainer-repo fixup so that a test-count item is derived and never typed. It must count statically (grep -c, find | wc -l), because it runs over a contributor's tree: a command that builds or runs their tests runs their code. With it unset, a test-count item is refused.

Environment variables that are not defaults

Every name below is read by the code. A test fails when the code reads a MAINTAINER_* name this page does not list.

You set these, for one invocation or in your shell:

variablewhat it does
MAINTAINER_PROFILEwhich deployed profile a command acts on. Required when more than one is deployed
MAINTAINER_FORCE1 skips the cadence gate in run.sh for one run. It is unset before the agent starts
MAINTAINER_POSTon or off, overriding the profile's POST for one run
MAINTAINER_NOTIFYoff silences desktop notifications
MAINTAINER_ALERT_CMDa shell command run.sh runs on every failure alert, after the failure marker and the desktop popup, for ntfy, mail or a webhook. The message arrives as $1; it also sees MAINTAINER_ALERT_TASK and MAINTAINER_ALERT_LOG. Its own failure is logged and never fatal
MAINTAINER_UNINSTALL_YES1 lets install.sh --uninstall proceed while timers are enabled
MAINTAINER_CARGO_JOBScargo's job count in the sysknife rust suite. Overrides the suite's suite_jobs
MAINTAINER_SHELL_IMAGEthe image the sysknife shell suite runs in. The test suite points it at a registry image
MAINTAINER_RECEIPT_KEYpath of the receipt signing key. Default: ~/.local/share/maintainer/receipt.key
MAINTAINER_IMAGE_RESOLVERthe script verify-deps asks what an image tag resolves to. Default: scripts/resolve_image_digest.py
MAINTAINER_PYPI_VERIFIERthe script verify-deps asks whether every pinned pip hash is a file the release publishes. Default: scripts/verify_pypi_release.py
MAINTAINER_PYPI_URLthe JSON API that script asks. Default: https://pypi.org/pypi. The test suite points it at a file:// tree
MAINTAINER_PIP_FILES_VERIFIERthe script verify-deps reads a requirements file with, whole, at the merge base and the head. Default: scripts/verify_pip_files.py
MAINTAINER_CLASSIFY_TIMEOUTseconds verify-deps gives the dependency classifier before refusing. Default: CLASSIFY_TIMEOUT in lib/defaults.env
MAINTAINER_FAILURE_SHAPESpath of the failure-classification table. Default: lib/failure-shapes.json
MAINTAINER_SETTINGSthe permission file the backend uses (the claude settings or the opencode config), replacing the profile's own. run.sh sets it itself to swap in the rehearsal wall
MAINTAINER_THINKINGthinking-token budget for the claude backend when the profile sets no THINKING_<task>
MAINTAINER_CHILD_ENVread by the Rust maintainer-doctor (and the other Rust programs as they arrive): a space-separated list of extra variable names it passes to the programs it starts, on top of its fixed allowlist (HOME, USER, TMPDIR, XDG_*, the gh and git settings and the proxy variables). The bash programs pass the whole environment and ignore it. The wrapper that rust/scripts/assemble-tree.sh writes for a test tree names every variable the caller exported in it, so the suites' stubs see what they see under the bash programs
MAINTAINER_DOCTOR_MISSING_LOGa test hook of the Rust maintainer-doctor: a file it appends the name of every program it could not find to, one per line, the record bash's command_not_found_handle gives the characterization harness
MAINTAINER_CURSOR_DIRdirectory of the cursor backend's configuration
MAINTAINER_BACKENDoverrides BACKEND in a profile that reads it (the shipped ones do)
MAINTAINER_PROSE_STYLEraw turns the prose discipline off, for debugging a prompt
MAINTAINER_REPO_PATH, MAINTAINER_REPO_ORIGIN, MAINTAINER_STATE_DIRwhere a profile's review checkout lives, where it is cloned from, and where runs are recorded
MAINTAINER_<KEY>any key in the table above

run.sh sets these for the tools it calls, so a tool called from inside a run acts on that run's repository and nothing else. Setting them by hand is how a tool is pointed at the wrong project:

variablewhat it carries
MAINTAINER_SLUG, MAINTAINER_REPO, MAINTAINER_STATE, MAINTAINER_ACCOUNTthe profile's REPO_SLUG, REPO_PATH, STATE_DIR and GH_ACCOUNT
MAINTAINER_TASK, MAINTAINER_TASKS, MAINTAINER_SKILLthe task being run, the profile's task list, the skill that task loads
MAINTAINER_IN_RUN<profile>/<task>. A tool that sees it refuses to start another run, and maintainer-merge refuses an asserted receipt
MAINTAINER_SCRIPTSthe directory holding scripts/
MAINTAINER_VERSION, MAINTAINER_COMMITthe deployed build, stamped into the run report
MAINTAINER_ALERT_TASK, MAINTAINER_ALERT_LOGwhich run an alert is about, and its log
MAINTAINER_SCRUB_NEEDLEthe secret the exit-time scrub removes from the run's files. It travels in the environment, never in argv

A profile key spelled like one: MAINTAINER_NAME in profile.env is the maintainer's name, written into the doctrine as __MAINTAINER__.