# Settings

Every key in the factory settings document: 169 keys with type, allowed values, default and where each is stored.

Factory settings are one revisioned document per tenant. Change them on the Resolve Platform's Factory settings page or with `PUT /v1/factory/settings`. Keys stored on **sandbox** belong to the Pix Sandbox and are edited here for convenience. A key marked **locked** cannot be changed.

Sections: [agents](#agents) · [approve](#approve) · [audit](#audit) · [autonomy](#autonomy) · [belai](#belai) · [budget](#budget) · [crews](#crews) · [defaults](#defaults) · [delivery](#delivery) · [factory](#factory) · [other](#other) · [forge](#forge) · [hosts](#hosts) · [jail](#jail) · [kanban](#kanban) · [notify](#notify) · [persistence](#persistence) · [pix](#pix) · [providers](#providers) · [schedules](#schedules) · [scope](#scope) · [security](#security) · [signing](#signing) · [systemone](#systemone) · [tea](#tea) · [vault](#vault)

## agents

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="agents.finalize_at"></span>`agents.finalize_at` | num 0 to 0.95: share of any per-card limit at which the worker is told to wrap up (commit, record findings, publish a draft pull request); a value under 0.5 is raised to 0.5 (0 keeps the agent's own, 0.85 for the built-ins) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_attempts"></span>`agents.max_attempts` | int 0 to 10: failed attempts at one stage before Belai blocks the card (0 keeps the agent's own). Not `autonomy.max_attempts`, which retries a workflow step | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_continuations"></span>`agents.max_continuations` | int 0 to 50: times a card may go back to be resumed after its budget ran out with progress made, before it is blocked for a person (0 keeps the agent's own, 5 by default) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_cost_usd_per_item"></span>`agents.max_cost_usd_per_item` | num 0 to 10000: estimated cost in US dollars at which a worker's claim on one card ends (0 keeps each agent's own; the built-in agents allow $8 to $25) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_iterations"></span>`agents.max_iterations` | int 0 to 400: tool rounds per pass (0 keeps the agent's own) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_passes_per_item"></span>`agents.max_passes_per_item` | int 0 to 1000: goal passes per card, a safety rail beside the cost limit (0 keeps the agent's own) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |
| <span id="agents.max_wall_minutes"></span>`agents.max_wall_minutes` | int 0 to 10080: minutes per card, a safety rail (0 keeps the agent's own) | `0` | factory | [Per-agent and per-card limits](/software-factory/cost/budgets.md) |

## approve

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="approve.sensitive_paths"></span>`approve.sensitive_paths` | list. list of path globs (feGlobMatch dialect) that stop an approval, besides the built-in list | `[]` | factory |  |

## audit

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="audit.calls"></span>`audit.calls` | bool. bool: log every model call with its input hash | `true` | factory | [The audit ledger](/software-factory/evidence/audit-ledger.md) |
| <span id="audit.sign"></span>`audit.sign` | bool. bool: sign the decision ledger | `true` | factory | [The audit ledger](/software-factory/evidence/audit-ledger.md) |
| <span id="audit.weekly_report"></span>`audit.weekly_report` | bool | `true` | factory | [The audit ledger](/software-factory/evidence/audit-ledger.md) |

## autonomy

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="autonomy.claim_ttl_minutes"></span>`autonomy.claim_ttl_minutes` | int 1 to 1440. int 1 to 1440: minutes a started crew or worker dispatch may go without a session before the attempt fails `card_unclaimed` and retries | `60` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.concurrency"></span>`autonomy.concurrency` | int 1 to 64 | `4` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.default"></span>`autonomy.default` | enum: `observe`, `suggest`, `draft_pr`, `auto_merge_low_risk` | `draft_pr` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.max"></span>`autonomy.max` | enum: `observe`, `suggest`, `draft_pr`, `auto_merge_low_risk` | `draft_pr` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.max_attempts"></span>`autonomy.max_attempts` | int 1 to 10 | `3` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.no_host_ttl_hours"></span>`autonomy.no_host_ttl_hours` | int 1 to 168. int 1 to 168: hours a crew step may wait for a machine before the run ends `no_host_timeout` | `6` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.parked_concurrency"></span>`autonomy.parked_concurrency` | int 1 to 1000. int 1 to 1000: runs of the tenant that may wait for a machine at once; they do not count against `autonomy.concurrency` | `50` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |
| <span id="autonomy.plan_approval"></span>`autonomy.plan_approval` | bool. bool (plan approval for `belai:feature`) | `true` | factory | [Autonomy levels](/software-factory/control/autonomy.md) |

## belai

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="belai.a2a.show"></span>`belai.a2a.show` | bool. bool: transcripts show A2A rows (broadcasts, messages, replies, acks) by default; a viewer can override it locally | `true` | factory |  |
| <span id="belai.ask_permission"></span>`belai.ask_permission` | bool: whether the workers and crews a workflow or schedule starts stop at permission asks (sent as the dispatch's `ask`; docs/factory-engine.md, "Stay and replicas") | `false` | factory |  |
| <span id="belai.auto_commit_per_task"></span>`belai.auto_commit_per_task` | bool | `true` | factory |  |
| <span id="belai.guardrails"></span>`belai.guardrails` | enum: `on`, `strict`, `off` | `on` | factory |  |
| <span id="belai.mode"></span>`belai.mode` | enum: `goal`, `agent`, `plan`, `auto` | `goal` | factory |  |
| <span id="belai.show_internal_work"></span>`belai.show_internal_work` | enum: `decisions`, `security`, `all`, `hidden` | `decisions` | factory |  |
| <span id="belai.tests.on_fail"></span>`belai.tests.on_fail` | enum: `fix`, `diagnose`, `off` | `fix` | factory |  |
| <span id="belai.tests.post_end"></span>`belai.tests.post_end` | enum: `goal`, `goal_plan`, `session`, `off` | `goal` | factory |  |

## budget

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="budget.alerts"></span>`budget.alerts` | list. list of int 1 to 100, ascending | `[50, 80, 100]` | factory | [Budgets](/software-factory/cost/budgets.md) |
| <span id="budget.factory_share"></span>`budget.factory_share` | pct. pct of the Pix allowance | `75` | factory | [Budgets](/software-factory/cost/budgets.md) |
| <span id="budget.month"></span>`budget.month` | int 0 to 1e15. int tokens, all providers | `30000000` | factory | [Budgets](/software-factory/cost/budgets.md) |
| <span id="budget.on_exceed"></span>`budget.on_exceed` | enum: `pause_run`, `downgrade_to_fast`, `switch_to_pix_allocation`, `escalate_human`, `hard_stop` | `switch_to_pix_allocation` | factory | [Budgets](/software-factory/cost/budgets.md) |

## crews

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="crews.lease"></span>`crews.lease` | enum: `15m`, `30m`, `2h` | `30m` | factory |  |

## defaults

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="defaults.approve-ready.enabled"></span>`defaults.approve-ready.enabled` | bool | `true` | factory |  |
| <span id="defaults.ci-fix.enabled"></span>`defaults.ci-fix.enabled` | bool | `true` | factory |  |
| <span id="defaults.conflict-fix.enabled"></span>`defaults.conflict-fix.enabled` | bool | `true` | factory |  |
| <span id="defaults.enabled"></span>`defaults.enabled` | bool. bool: master switch | `true` | factory |  |
| <span id="defaults.issue-to-pr.enabled"></span>`defaults.issue-to-pr.enabled` | bool | `true` | factory |  |
| <span id="defaults.lint-sweep.enabled"></span>`defaults.lint-sweep.enabled` | bool | `true` | factory |  |
| <span id="defaults.pr-review.enabled"></span>`defaults.pr-review.enabled` | bool | `true` | factory |  |
| <span id="defaults.test-sweep.enabled"></span>`defaults.test-sweep.enabled` | bool | `true` | factory |  |

## delivery

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="delivery.companyDomain"></span>`delivery.companyDomain` | str. str: an email domain such as `acme.example`, or empty |  | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.compare"></span>`delivery.compare` | bool. bool: the hand-worked comparison, which adds the refinement and hand-off overhead | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.decisions"></span>`delivery.decisions` | bool. bool: price the decisions System One scored | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.enabled"></span>`delivery.enabled` | bool. bool: master switch. Off, every `/delivery` read answers `{"enabled":false}` and nothing is computed | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.hoursPerMonth"></span>`delivery.hoursPerMonth` | num 1 to 400: productive hours per person-month | `150` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.idleGapMin"></span>`delivery.idleGapMin` | int 1 to 120. int 1 to 120: minutes without an action that end a sitting | `5` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.goal.enabled"></span>`delivery.kinds.goal.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.goal.minutes"></span>`delivery.kinds.goal.minutes` | num 0 to 480 | `3` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.merge.enabled"></span>`delivery.kinds.merge.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.merge.minutes"></span>`delivery.kinds.merge.minutes` | num 0 to 480 | `8` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.mode.enabled"></span>`delivery.kinds.mode.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.mode.minutes"></span>`delivery.kinds.mode.minutes` | num 0 to 480 | `0.5` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.other.enabled"></span>`delivery.kinds.other.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.other.minutes"></span>`delivery.kinds.other.minutes` | num 0 to 480 | `2` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.plan.enabled"></span>`delivery.kinds.plan.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.plan.minutes"></span>`delivery.kinds.plan.minutes` | num 0 to 480 | `4` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.toolcall.enabled"></span>`delivery.kinds.toolcall.enabled` | bool | `false` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.toolcall.minutes"></span>`delivery.kinds.toolcall.minutes` | num 0 to 480 | `0` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.triage.enabled"></span>`delivery.kinds.triage.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.kinds.triage.minutes"></span>`delivery.kinds.triage.minutes` | num 0 to 480 | `6` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.manualCardDays"></span>`delivery.manualCardDays` | num 0 to 365: days a team takes per card | `5` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.manualCycleDays"></span>`delivery.manualCycleDays` | num 0 to 365: days a team takes per pull request | `4.5` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.manualDecisionWait"></span>`delivery.manualDecisionWait` | num 0 to 720: hours a team waits to decide, compared with the measured time | `6` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.manualIssueDays"></span>`delivery.manualIssueDays` | num 0 to 365: days a team takes per issue | `3` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.multiplier"></span>`delivery.multiplier` | num 0.5 to 10: multiplier for agent work no role covers | `2.4` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.overheadPct"></span>`delivery.overheadPct` | pct. pct: refinement and hand-off overhead as a share of build and decision hours | `20` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.overheadRate"></span>`delivery.overheadRate` | num 0 to 10000: USD per hour for the overhead | `105` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.people"></span>`delivery.people` | bool. bool: the People and Contributors pages | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.peopleRate"></span>`delivery.peopleRate` | num 0 to 10000: USD per hour for the hours people spent in the factory (the cost side) | `110` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.rate"></span>`delivery.rate` | num 0 to 10000: USD per hour for agent work no role covers | `95` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.reviewMinPer100"></span>`delivery.reviewMinPer100` | num 0 to 60: minutes of reading per 100 changed lines of a review | `4` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.devops.enabled"></span>`delivery.roles.devops.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.devops.mult"></span>`delivery.roles.devops.mult` | num 0.5 to 10 | `2.0` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.devops.rate"></span>`delivery.roles.devops.rate` | num 0 to 10000 | `90` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.planner.enabled"></span>`delivery.roles.planner.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.planner.mult"></span>`delivery.roles.planner.mult` | num 0.5 to 10 | `1.6` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.planner.rate"></span>`delivery.roles.planner.rate` | num 0 to 10000 | `120` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.qa.enabled"></span>`delivery.roles.qa.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.qa.mult"></span>`delivery.roles.qa.mult` | num 0.5 to 10 | `2.2` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.qa.rate"></span>`delivery.roles.qa.rate` | num 0 to 10000 | `70` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.reviewer.enabled"></span>`delivery.roles.reviewer.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.reviewer.mult"></span>`delivery.roles.reviewer.mult` | num 0.5 to 10 | `1.5` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.reviewer.rate"></span>`delivery.roles.reviewer.rate` | num 0 to 10000 | `95` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.security.enabled"></span>`delivery.roles.security.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.security.mult"></span>`delivery.roles.security.mult` | num 0.5 to 10 | `2.0` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.security.rate"></span>`delivery.roles.security.rate` | num 0 to 10000 | `110` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.sse.enabled"></span>`delivery.roles.sse.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.sse.mult"></span>`delivery.roles.sse.mult` | num 0.5 to 10 | `2.4` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.sse.rate"></span>`delivery.roles.sse.rate` | num 0 to 10000 | `95` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.writer.enabled"></span>`delivery.roles.writer.enabled` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.writer.mult"></span>`delivery.roles.writer.mult` | num 0.5 to 10 | `1.8` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.roles.writer.rate"></span>`delivery.roles.writer.rate` | num 0 to 10000 | `60` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.admin"></span>`delivery.sources.admin` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.chat"></span>`delivery.sources.chat` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.checkpoint"></span>`delivery.sources.checkpoint` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.comment"></span>`delivery.sources.comment` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.commit"></span>`delivery.sources.commit` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.notification"></span>`delivery.sources.notification` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.pixcall"></span>`delivery.sources.pixcall` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.sources.review"></span>`delivery.sources.review` | bool | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |
| <span id="delivery.value"></span>`delivery.value` | bool. bool: price agent work by role | `true` | factory | [Delivery](/software-factory/evidence/delivery.md) |

## factory

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="factory.fanoutCap"></span>`factory.fanoutCap` | int 1 to 50. int 1 to 50: runs one delivery or sighting may start; triggers past it, by priority, are skipped as `fanout_cap` | `feDefaultFanoutCap` | factory |  |

## other

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="firewall_enabled"></span>`firewall_enabled` | bool | `true` | factory, locked | [Package and AI firewalls on factory work](/software-factory/evidence/firewalls.md) |

## forge

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="forge.branch_prefix"></span>`forge.branch_prefix` | str. str, 1 to 40 chars, `[A-Za-z0-9/_.-]` | `belai/K-` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.calls_per_hour"></span>`forge.calls_per_hour` | int 100 to 100_000 | `5000` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.check_runs"></span>`forge.check_runs` | bool. bool: publish gate results as check runs (needs `checks: write`) | `false` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.etag"></span>`forge.etag` | bool. bool: send `If-None-Match` on every live read | `true` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.poll.fallback"></span>`forge.poll.fallback` | enum: `conditional_poll_10m`, `none` | `conditional_poll_10m` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.polling.forbidden"></span>`forge.polling.forbidden` | bool. bool, locked `true` | `true` | factory, locked | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.pr_state"></span>`forge.pr_state` | enum: `draft`, `ready` | `draft` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.protected"></span>`forge.protected` | bool. bool: never push to protected branches | `true` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.quota.factory_share"></span>`forge.quota.factory_share` | pct | `10` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.quota.on_exhausted"></span>`forge.quota.on_exhausted` | enum: `pause_live_reads`, `defer_to_next_window`, `escalate` | `pause_live_reads` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.quota.proactive_writes_per_hour"></span>`forge.quota.proactive_writes_per_hour` | int 0 to 5000. int 0 to 5000: most calls an installation makes in a clock hour for default workflows (13.4) | `60` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.quota.reserve"></span>`forge.quota.reserve` | pct | `20` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.read.default"></span>`forge.read.default` | enum: `posture_mirror`, `s3_raw`, `live_api` | `posture_mirror` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.stale.alerts"></span>`forge.stale.alerts` | duration. dur | `1h` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.stale.checks"></span>`forge.stale.checks` | duration. dur | `2m` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.stale.pulls"></span>`forge.stale.pulls` | duration. dur | `5m` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |
| <span id="forge.stale.repo"></span>`forge.stale.repo` | duration. dur | `6h` | factory | [Forge quota and the data plane](/software-factory/cost/github-quota.md) |

## hosts

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="hosts.runOn"></span>`hosts.runOn` | str. string `auto`, `pix_sandbox`, `self_hosted`, `host:<uuid>` or `label:<name>`, the crew node's `runOn` grammar (`factoryRunOnValid`): where a crew node, a default or a scan that names no `runOn` runs, and the preference that orders the hosts a node's own `runOn` admits (12.5) | `auto` | factory | [Hosts and placement](/software-factory/workforce/hosts-and-placement.md) |
| <span id="hosts.runOnFallback"></span>`hosts.runOnFallback` | enum: `none`, `auto` | `auto` | factory | [Hosts and placement](/software-factory/workforce/hosts-and-placement.md) |

## jail

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="jail.enforcementMode"></span>`jail.enforcementMode` | enum: `enforce`, `warn` | `enforce` | jail | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |

## kanban

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="kanban.conflict_comment"></span>`kanban.conflict_comment` | bool | `true` | factory |  |
| <span id="kanban.mode"></span>`kanban.mode` | enum: `all`, `skip_review`, `off` | `all` | factory |  |
| <span id="kanban.opt_out_label"></span>`kanban.opt_out_label` | str | `no-github` | factory |  |

## notify

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="notify.connector"></span>`notify.connector` | enum: `slack`, `teams`, `discord`, `google_chat`, `webhook`, `jira` | `slack` | factory | [The messaging centre: connections, routes and templates](/software-factory/workforce/messaging-centre.md) |
| <span id="notify.events"></span>`notify.events` | enum: `escalations_holds_budget`, `everything`, `escalations_only` | `escalations_holds_budget` | factory | [The messaging centre: connections, routes and templates](/software-factory/workforce/messaging-centre.md) |

## persistence

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="persistence.export"></span>`persistence.export` | enum: `daily_jsonl_s3`, `manual` | `manual` | factory |  |
| <span id="persistence.postgres"></span>`persistence.postgres` | enum: `on`, `off` | `on` | factory |  |
| <span id="persistence.retention"></span>`persistence.retention` | enum: `400d`, `90d`, `30d`, `forever` | `400d` | factory |  |

## pix

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="pix.classifier"></span>`pix.classifier` | enum: `clef`, `jev`, `tev1` | `clef` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.egressMode"></span>`pix.egressMode` | enum. enum `deny_except_allow`, `allow_all_logged` | `deny_except_allow` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.extensionMode"></span>`pix.extensionMode` | enum: `packs_only`, `any_indexed` | `packs_only` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.jevDailyCap"></span>`pix.jevDailyCap` | int 0 to 100_000_000. int, calls per day, shared with the sandbox | `2000` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.maintenance"></span>`pix.maintenance` | list. list of `{days:["sun"],start:"02:00",end:"04:00",tz:"Australia/Melbourne"}`, same value as `PUT /v1/belai/sandboxes/{id}/maintenance-window` | `[]` | sandbox | [Holds, maintenance windows and blackouts](/software-factory/control/holds-and-blackouts.md) |
| <span id="pix.reservePercent"></span>`pix.reservePercent` | pct. pct (same value as budgets `reserveInteractivePct`) | `20` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.size"></span>`pix.size` | enum. enum `small`, `medium`, `large` | `medium` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |
| <span id="pix.versionPolicy"></span>`pix.versionPolicy` | enum. enum `safest`, `stable`, `latest`, `rolling`, `pinned` (the first four are the Safe Harbour picks, see `pix-sandbox-safe-harbour.md`) | `safest` | sandbox | [Pix Sandboxes](/software-factory/workforce/pix-sandboxes.md) |

## providers

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="providers.code"></span>`providers.code` | str. `pix-smart`, `pix-fast` or `vault:<entryId>` | `pix-smart` | factory | [Model routing and the Pix allowance](/software-factory/cost/model-routing.md) |

## schedules

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="schedules.blackout"></span>`schedules.blackout` | list. list of `{from:{day,time},to:{day,time},label}`; `day` is `mon` to `sun`, `time` `HH:MM` | `[]` | factory | [Holds, maintenance windows and blackouts](/software-factory/control/holds-and-blackouts.md) |
| <span id="schedules.missed"></span>`schedules.missed` | enum: `run_once`, `skip`, `run_all` | `run_once` | factory | [Holds, maintenance windows and blackouts](/software-factory/control/holds-and-blackouts.md) |
| <span id="schedules.tz"></span>`schedules.tz` | tz. IANA zone | `UTC` | factory | [Holds, maintenance windows and blackouts](/software-factory/control/holds-and-blackouts.md) |

## scope

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="scope.archived"></span>`scope.archived` | bool | `false` | factory | [Managed orgs and repositories](/software-factory/control/managed-scope.md) |
| <span id="scope.dependencies"></span>`scope.dependencies` | bool | `false` | factory | [Managed orgs and repositories](/software-factory/control/managed-scope.md) |
| <span id="scope.interest"></span>`scope.interest` | enum: `any_signal`, `scanned_or_pix`, `watched_only` | `any_signal` | factory | [Managed orgs and repositories](/software-factory/control/managed-scope.md) |
| <span id="scope.orgs"></span>`scope.orgs` | list. `"all_active"` or list of installation logins; same write as `PUT /orgs/{id}` | `[]` | factory | [Managed orgs and repositories](/software-factory/control/managed-scope.md) |
| <span id="scope.sync"></span>`scope.sync` | enum: `6h`, `1h`, `webhook_only` | `6h` | factory | [Managed orgs and repositories](/software-factory/control/managed-scope.md) |

## security

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="security.evidence"></span>`security.evidence` | enum: `cdx_slsa`, `sbom_only` | `cdx_slsa` | factory | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |
| <span id="security.scanners"></span>`security.scanners` | enum: `minimum`, `all`, `custom` | `minimum` | factory | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |
| <span id="security.scanners.custom"></span>`security.scanners.custom` | list | `[]` | factory | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |
| <span id="security.slsa_min"></span>`security.slsa_min` | enum: `L1`, `L2`, `L3` | `L3` | factory | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |

## signing

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="signing.auto_add"></span>`signing.auto_add` | bool. bool: add a new key's public key to the person's GitHub account | `true` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |
| <span id="signing.email"></span>`signing.email` | enum: `primary`, `noreply`, `ask` | `primary` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |
| <span id="signing.mode"></span>`signing.mode` | enum: `required`, `preferred`, `off` | `preferred` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |
| <span id="signing.on_missing"></span>`signing.on_missing` | enum: `readd`, `ask` | `readd` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |
| <span id="signing.retire_days"></span>`signing.retire_days` | enum: `30`, `7`, `0`, `-1` | `30` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |
| <span id="signing.rotate_days"></span>`signing.rotate_days` | enum: `365`, `180`, `90`, `0` | `365` | factory | [Commit signing](/software-factory/decisions/commit-signing.md) |

## systemone

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="systemone.below_threshold"></span>`systemone.below_threshold` | enum: `escalate_human`, `route_to_fallback_model`, `take_safest_outcome`, `end_run` | `escalate_human` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.fallback"></span>`systemone.fallback` | enum: `jev`, `pix-fast`, `none` | `jev` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.min_confidence"></span>`systemone.min_confidence` | num 0 to 1 | `0.8` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.min_confidence.adapter"></span>`systemone.min_confidence.adapter` | str. str, read-only, identity the threshold was set for | `clef-flash` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.model"></span>`systemone.model` | enum adapter name: `clef-flash`, `clef`, `jev`, `tev1` | `clef-flash` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.on_abstain"></span>`systemone.on_abstain` | enum: `escalate_human`, `retry_once_then_escalate`, `end_run` | `escalate_human` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.override"></span>`systemone.override` | bool. bool: a person may override any decision | `true` | factory | [System One decisions](/software-factory/decisions/system-one.md) |
| <span id="systemone.retention"></span>`systemone.retention` | enum: `full_400d`, `hash_only`, `days_30` | `full_400d` | factory | [System One decisions](/software-factory/decisions/system-one.md) |

## tea

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="tea.publish"></span>`tea.publish` | enum: `on_release_tag`, `on_merge_main`, `never` | `on_release_tag` | factory | [Trust and SLSA](/software-factory/evidence/trust-and-slsa.md) |

## vault

| Key | Type and values | Default | Stored | Explained in |
|---|---|---|---|---|
| <span id="vault.grant"></span>`vault.grant` | object. `{"mode":"specific","entries":["ve_1"]}` for the `pix_sandbox` surface; `mode` is `specific`, `all` or `all_except` | `{"mode": "all"}` | vault |  |
| <span id="vault.on_error"></span>`vault.on_error` | enum: `pause_affected_workflows`, `fall_back_to_pix` | `pause_affected_workflows` | factory |  |
