dsh-fovea

Configuration

The bundle patch inserts one row with id dsh-fovea. Override it in the selected profile's $DSH_HOME/profiles/ /cordis.patch.yml (or a later --patch layer):

- id: dsh-fovea
  config:
    defaultBudget: 768
    toolTimeoutMs: 120000
    sync:
      mode: enabled
      scope: session
      budget: 512
      steerThreshold: 0.15
      pushFocus: true
      ackClean: false
      warmMutations: true

Key	Default	Valid values
defaultBudget	512	integer 256–16000
toolTimeoutMs	120000	integer 1000–2147483647
sync.mode	enabled	enabled, hidden, or disabled
sync.scope	session	session or repository
sync.budget	512	integer 128–8192
sync.steerThreshold	0.15	finite number 0.02–8
sync.pushFocus	true	boolean
sync.ackClean	false	boolean — tiny "nothing new" ack after a clean structural check
sync.warmMutations	true	boolean

Unknown configuration keys fail plugin loading. enabled emits plugin notice messages; hidden uses plugin instructions messages for the model; disabled removes sync and mutation-attribution hooks while keeping explicit tools, command, and skill. The deployment-level FOVEA_TURN_SYNC=off (also 0 or false) escape hatch always forces disabled mode.

Advanced environment controls

These are deployment-level tuning controls read when modules load:

Variable	Default	Range / meaning
FOVEA_AST_GREP	packaged CLI	Execution-world ast-grep path/name override
FOVEA_TURN_SYNC	unset	off, 0, or false disables continuous sync
FOVEA_MAX_FILES	8000	100–100000 discovered files
FOVEA_MAX_FILE_BYTES	1048576	65536–67108864 bytes per source
FOVEA_MAX_ROOTS	2	1–32 resident workspace graphs
FOVEA_MAX_AGENT_SESSIONS	32	1–4096 resident agent/session attention states
FOVEA_SPAWN_CONCURRENCY	3	1–32 concurrent subprocess stages
FOVEA_IO_CONCURRENCY	32	4–512 concurrent provider I/O operations
FOVEA_MAX_SUBMODULE_DEPTH	4	1–16 nested repository depth
FOVEA_AST_GREP_CHUNK	160	32–2048 files per parser chunk
FOVEA_PROBE_TTL_MS	1200	200–60000 send-path Git probe interval
FOVEA_MEMORY_HALF_LIFE_HOURS	48	1–8760 surprise-memory half-life
FOVEA_COCHANGE_HALF_LIFE_DAYS	30	1–3650 co-change half-life
FOVEA_WALK_GAP_MS	4000	500–300000 plain-root relist gap
FOVEA_SWEEP_GAP_MS	20000	2000–600000 plain-root full sweep gap

Invalid integer environment values fall back to the listed default.