mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
cfde4369b1
* feat(gateway): claim-scoped context briefing — heavy sections only on context-acquisition verbs
* feat(gateway): cap unbounded LLM-facing payloads — embedded diffs, notification bodies, handoff journal content, north star
* feat(mcp): role-scope the optimal server's tool groups; index management becomes dev/test-only
* feat(mcp): cap per-result content on kb/error/learning search, mentor sources, rag citations
* refactor(gateway): extract heavy-briefing sections + clip helper to keep xenon ranks
* feat(orchestrator): cross-tick cooldown for notification-triggered spawns
* feat(usage,orchestrator): scope spawn-waste to anthropic sessions; cap agent Bash output via settings env
* docs: claim-scoped briefing, payload caps, optimal role-scoping, notification-spawn cooldown
* test(mcp): type the mixed-item cap fixture explicitly
* fix(orchestrator): lazy-init the notification-spawn cooldown store
* fix(lifecycle): admin-override claim reconciliation + PM request_changes verb (S6 postmortem B3+B4)
B3 — admin_set_status now reconciles claim ownership when leaving BLOCKED:
review/queue targets clear claimed_by/claimed_at/active_claimant_id and
consume the pre-block snapshot (a stale escalation claim was stranding the
next claimant: give_me_work handed the task out while note() bounced
not_authorized — the live b8fe0494 wedge). The pending/in_progress restore
path also syncs active_claimant_id, and a REST PATCH unassign releases the
claim with it.
B4 — new PM verb request_changes: awaiting_pm_review -> needs_revision with
concrete issues. The PM previously had no reject at merge review (only
complete/escalate), so an AC/scope violation looped i_am_blocked->escalate
4x live. Full vertical: lifecycle transition + ActionSpec + IntentSpec,
TaskService.request_changes (routes like a QA fail — original dev for a
leaf, revision PM for assembled; issues appended to dev_notes), verb-runner
compose, choreographer verb (spec gate + non-empty issues + soup check +
a2a delivery of the reject reason), HTTP routes on both PM flows, MCP tool,
journal:decision tracing, PM prompts, regenerated lifecycle artifacts.
* fix(panel): stop scorecard fetches for fallback-roster placeholder ids
useAgents() serves the static AGENT_ROSTER (ids "1".."22") while agent
definitions load; the Scorecards tab fetched a member scorecard per row
immediately, firing 22 guaranteed-422 requests per refetch cycle. Through
the browser's per-origin connection limit those queued every metrics-page
query behind them (~10s of skeletons on every tab). Gate the fetch on a
real member id (agent UUID or the "ceo" alias).
* Upgraded uv.lock
* fix(sequencing): declared deps become real edges + full loop-breaker coverage + assembled-branch freshness (S6 postmortem B1/B2/B6 + breaker)
B1a — code delegations REQUIRE a collision surface: new TASK_AT_DELEGATE
completeness spec (conditional FieldRequirement, when=('task_type','code'))
enforced at the gateway delegate gate. A no-surface code sibling is
'parallel to everything' by analyzer design, which is how two devs ran the
CEO's explicitly-ordered work out of order (f3e1afc5: seq#1 started before
seq#0, zero dependency edges). PM prompts updated; REST/manual creation
(TASK_AT_CREATE) unchanged.
B1b — the CEO's declared 'Depends on' lists become real edges: DraftSurface
gains declared_depends_on; SequencingService.analyze unions declared edges
(validated: self/out-of-range rejected) with the derived collision rules,
cycle-checked by the existing toposort. confirm_live_batch/preview_batch
map each draft's depends_on through (string indices coerced); intake tool
doc + prompter role prompt instruct verbatim copying. The live S6 root got
1 of its 3 declared in-batch edges and started alongside still-running R3.
Breaker coverage — the progress-aware respawn circuit breaker
(_pm_respawn_should_gate: strike counting, status-advance reset,
tracing-gap budget, DB durability, one-shot CEO notification) was consulted
by only 3 spawn paths; the doc/QA/dev/PR-review/PR-gate/revision/board
paths spawned unguarded at fixed cadence (the 26-respawn fe-doc loop,
~$7.20). Now consulted at every task-keyed spawn site (14 total).
B2 — assembled-branch freshness: submit_up/submit_root auto-sync the
assembled branch when it has fallen behind its base (children are terminal
at submit time, so the rebase is safe; master is never written). A rebase
conflict is a hard reject naming the files instead of a blind re-review —
kills the needs_revision↔awaiting_pr_review ping-pong of re-submitting a
stale head. Leaf i_am_done already had the behind-base gate; claim-time
fetch-fresh cut already existed.
B6 — documenter revision-pass loop: the awaiting_documentation bail
rejections (i_am_blocked/unclaim) now name the actual exit (i_documented
re-affirm) and the documenter prompt gets an explicit revision-pass rule.
* fix(orchestration): assembly-integrity gate + dispatcher heartbeat (incidents #11, #1)
Assembly integrity — submit_up/submit_root refuse when a completed child's
commits are not patch-present in the assembled branch (git cherry —
rebase-safe; branch pruned after merge or any git error fails open). Live
incident #11: a completed revert subtask's merge was lost from the cell
branch and the review gate re-flagged the exact violation the revert fixed,
spawning another revision cycle.
Dispatcher heartbeat — a dispatcher.alive audit row every 5 minutes from
the dispatch loop. The 2026-07-01 outage was 4h25m of fleet-wide silence
with no way to distinguish 'loop dead' from 'no work'; the loop's stdout
died with the container while audit_log survives. CHANGELOG for tonight's
full sweep included.
* style: ruff format for the orchestration sweep
* refactor(gateway): fold the assembled-submit guards + trim complexity under the xenon gate
_assembled_submit_guards combines the #11 integrity check and B2 freshen for
submit_up/submit_root; lifecycle's invalid-source remediate and git's
per-child cherry probe extracted into helpers. Test harnesses built via
__new__ stub the respawn tracker (the breaker now runs on their paths).
---------
Co-authored-by: Renn F <rennf93@users.noreply.github.com>
9.4 KiB
9.4 KiB
Configuration Reference
Environment variables for RoboCo (prefix: ROBOCO_).
API Server
| Variable | Default | Description |
|---|---|---|
ROBOCO_HOST |
127.0.0.1 |
API host (0.0.0.0 for containers) |
ROBOCO_PORT |
8000 |
API port |
ROBOCO_DEBUG |
false |
Debug mode |
ROBOCO_ENVIRONMENT |
development |
development/staging/production |
Database
| Variable | Default | Description |
|---|---|---|
ROBOCO_DATABASE_HOST |
localhost |
PostgreSQL host |
ROBOCO_DATABASE_PORT |
5432 |
PostgreSQL port |
ROBOCO_DATABASE_USER |
roboco |
Database user |
ROBOCO_DATABASE_PASSWORD |
roboco |
Database password |
ROBOCO_DATABASE_NAME |
roboco |
Database name |
Redis
| Variable | Default | Description |
|---|---|---|
ROBOCO_REDIS_HOST |
localhost |
Redis host |
ROBOCO_REDIS_PORT |
6379 |
Redis port |
ROBOCO_REDIS_DB |
0 |
Redis database |
Workspaces
| Variable | Default | Description |
|---|---|---|
ROBOCO_WORKSPACES_ROOT |
/data/workspaces |
Root for agent workspaces |
ROBOCO_WORKSPACE_AUTO_CLONE |
true |
Auto-clone on first access |
ROBOCO_WORKSPACE_CLONE_TIMEOUT |
300 |
Clone timeout (seconds) |
RAG/Embeddings
| Variable | Default | Description |
|---|---|---|
ROBOCO_DEFAULT_EMBEDDING_MODEL |
qwen3-embedding:0.6b |
Embedding model |
ROBOCO_EMBEDDING_DIMENSIONS |
1024 |
Embedding dimensions |
ROBOCO_RAG_CHUNK_STRATEGY |
fixed |
fixed/semantic/hierarchical/contextual |
ROBOCO_RAG_CHUNK_SIZE |
512 |
Base chunk size |
ROBOCO_RAG_CHUNK_SIZE_DOCS |
1536 |
Chunk size for docs |
ROBOCO_RAG_CHUNK_SIZE_JOURNALS |
1024 |
Chunk size for journals |
ROBOCO_RAG_CHUNK_OVERLAP |
128 |
Chunk overlap |
ROBOCO_RAG_USE_HYBRID_SEARCH |
true |
BM25 + vector search |
ROBOCO_RAG_USE_CROSS_ENCODER |
true |
Neural reranking |
ROBOCO_RAG_AUTO_UPDATE_ENABLED |
true |
Auto-update indexes |
ROBOCO_RAG_AUTO_UPDATE_INTERVAL |
300 |
Update interval (seconds) |
LLM
| Variable | Default | Description |
|---|---|---|
ROBOCO_LOCAL_LLM_MODEL |
glm-5.2:cloud |
Local LLM for RAG |
ROBOCO_LOCAL_LLM_BASE_URL |
http://roboco-ollama:11434/v1 |
OpenAI-compat API |
ROBOCO_OLLAMA_BASE_URL |
http://roboco-ollama:11434 |
Native Ollama API |
Grok provider (xAI)
Agents whose provider is GROK run xAI's official grok CLI. Auth is the host SuperGrok subscription (mounted ~/.grok), not a metered API key.
| Variable | Default | Description |
|---|---|---|
ROBOCO_HOST_GROK_DIR |
~/.grok |
Host dir holding auth.json, mounted into Grok agents; the orchestrator auto-refreshes the ~6h token in place. Set up once with grok login. |
ROBOCO_GROK_CLI_MODEL |
grok-build |
Grok CLI model id |
ROBOCO_GROK_AGENT_IMAGE |
roboco-agent-grok:latest |
Image for Grok delivery agents |
ROBOCO_GROK_REASONING_EFFORT |
(blank) | Per-run reasoning-effort override; blank = the grok CLI default |
ROBOCO_GROK_IDLE_KILL_SECONDS |
900 |
Kill + evict a Grok container that has been ACTIVE-yet-idle (no gateway verb) this long |
ROBOCO_GROK_MAX_COST_USD |
0.0 |
Per-agent Grok cost ceiling (USD); 0 disables |
Feature flags
Env-gated subsystems, default-off except the overload break. Each takes effect on the next backend restart; the panel's Settings → Feature Flags card toggles them without hand-editing env.
| Variable | Default | Description |
|---|---|---|
ROBOCO_CONVENTIONS_ENABLED |
false |
Architectural Conventions Standard: auto-scaffold .roboco/conventions.yml, inject the architecture map, attach baseline constraints, and block i_am_done / pr_pass on block-level placement and hygiene violations. Off = fully inert. |
ROBOCO_TOOLCHAIN_MATCH_ENABLED |
false |
Provision each agent workspace with the target project's Python (resolved from its requires-python / .python-version) and block delivery gates when the suite cannot be executed under it. Off = today's behavior. |
ROBOCO_OVERLOAD_BREAK_ENABLED |
true |
Park a provider on a persistent model-API overload (HTTP 529 / 500 / 503) the same way a 429 is parked — queue its spawns and probe until it recovers — instead of crash-retrying into the overload. Off = crash-retry behavior. |
ROBOCO_SPAWN_PREFLIGHT_ENABLED |
false |
Refuse to spawn a non-human delivery role absent from GATEWAY_ENABLED_ROLES (no manifest → can never claim → would respawn on the same task forever); refuse + alert the overseer once instead. Inert in practice (all delivery roles are gateway-enabled). Armed on the NAS composes. |
ROBOCO_NOTIFICATION_SPAWN_COOLDOWN_SECONDS |
600 |
Cross-tick damper for notification-triggered spawns (escalation/approval/audit/a2a — task-less, so the readiness gate and respawn breaker never see them): one spawn per (agent, notification) per window; the notification stays pending so the next window retries. 0 = legacy every-tick respawn. |
The company-in-a-box subsystems toggle the same way and are all default-off: web research (ROBOCO_RESEARCH_ENABLED), the strategy engine (ROBOCO_STRATEGY_ENGINE_ENABLED), and pitch provisioning (ROBOCO_PROVISIONING_ENABLED).
Self-Healing CI loop
RoboCo watching its own repo's CI. All default-off / dormant.
| Variable | Default | Description |
|---|---|---|
ROBOCO_SELF_HEAL_ENABLED |
false |
Master switch (detect + notify the CEO); off = the loop never runs and no CI is fetched |
ROBOCO_SELF_HEAL_ORIGINATE_ENABLED |
false |
Second opt-in: also open a PENDING fix task on a regression — CEO-gated, never auto-started/merged/deployed |
ROBOCO_SELF_HEAL_PROJECT_SLUG |
(empty) | The registered project that IS RoboCo itself — the only repo it watches and fixes; empty = no-op |
ROBOCO_SELF_HEAL_CI_WORKFLOW |
(empty) | GitHub Actions workflow to scope the CI signal to (e.g. ci.yml); empty = latest across all workflows |
ROBOCO_SELF_HEAL_INTERVAL_SECONDS |
1800 |
Seconds between assessment passes |
ROBOCO_SELF_HEAL_MAX_OPEN_TASKS |
3 |
Rolling cap on concurrently-open self-heal tasks |
ROBOCO_SELF_HEAL_MAX_PER_CYCLE |
1 |
Max fix tasks originated per cycle |
Autonomous maintenance
The fan-out generalizations of self-heal — they watch any opted-in project, not just RoboCo's own. All default-off; neither ever auto-merges (every task rides the normal delivery + PR-review gate). Per-project opt-in lives on the project row (set in the panel's edit-project dialog), not in env.
| Variable | Default | Description |
|---|---|---|
ROBOCO_CI_WATCH_ENABLED |
false |
Master switch for multi-repo CI-watch; off = the loop never runs. Per-project opt-in via projects.ci_watch_enabled |
ROBOCO_CI_WATCH_DEFAULT_WORKFLOW |
ci.yml |
Workflow file the CI signal is scoped to when a project sets no ci_watch_workflow |
ROBOCO_CI_WATCH_INTERVAL_SECONDS |
1800 |
Seconds between CI-watch passes |
ROBOCO_CI_WATCH_MAX_OPEN_TASKS |
3 |
Rolling cap on concurrently-open ci_watch tasks |
ROBOCO_CI_WATCH_MAX_PER_CYCLE |
1 |
Max ci_watch fix tasks originated per cycle |
ROBOCO_DEP_UPDATE_ENABLED |
false |
Master switch for the dependency-update bot; off = the loop never runs. Per-project opt-in via projects.dep_update_command |
ROBOCO_DEP_UPDATE_INTERVAL_SECONDS |
604800 |
Seconds between dependency-update passes (default weekly) |
ROBOCO_DEP_UPDATE_MAX_OPEN_TASKS |
3 |
Rolling cap on concurrently-open dep_update tasks |
ROBOCO_DEP_UPDATE_MAX_PER_CYCLE |
1 |
Max dep_update tasks originated per cycle |
ROBOCO_RELEASE_MANAGER_ENABLED |
false |
Master switch for the gated release manager; off = the loop never runs. Even on it only PROPOSES — the CEO approves before any publish |
ROBOCO_RELEASE_MIN_COMMITS |
8 |
Minimum unreleased commits since the last tag before a release is proposed (a feat/security change also qualifies) |
ROBOCO_RELEASE_MANAGER_INTERVAL_SECONDS |
3600 |
Seconds between release-readiness assessment passes |
ROBOCO_ORG_MEMORY_ENABLED |
false |
Master switch for the org-memory loop (distill at completion, index journals, auto-inject lessons/playbooks); off = legacy capture, no inject |
ROBOCO_ORG_MEMORY_TOP_K |
3 |
Max institutional-memory items injected into a briefing on claim |
ROBOCO_ORG_MEMORY_MIN_SCORE |
0.6 |
Cosine-similarity floor for injected memory; below it nothing is injected |
ROBOCO_IMAGE_PRUNE_ENABLED |
true |
Background sweep prunes dangling (<none>) Docker images from agent-image rebuilds (only dangling; ~6h throttle). Always-on safety net, not a feature flag |
ROBOCO_IMAGE_PRUNE_INTERVAL_SECONDS |
21600 |
Minimum seconds between dangling-image prune passes |
Security
| Variable | Default | Description |
|---|---|---|
ROBOCO_ENCRYPTION_KEY |
(required) | Fernet key that encrypts secrets at rest (e.g. per-project git tokens). Generate with Fernet.generate_key(). |
ROBOCO_AGENT_AUTH_SECRET |
(required) | HMAC secret the orchestrator signs each agent's X-Agent-Token with. |
ROBOCO_AGENT_AUTH_REQUIRED |
false |
When true, every request must carry a valid agent token (secure mode). |
ROBOCO_PANEL_AGENT_TOKEN |
(unset) | The control panel's CEO token, injected by nginx in secure mode. Get it with make panel-token. |