Docs: align split-brain and doctor with dev mode
- Clarify that missing skills artifact degrades knowledge but is expected in dev. - Update monitoring doc to use STATUS: warn HOST_STARTED: 18.apr.2026 13:37:38 MESSAGE_LOOP: 18.apr.2026 18:48:17 SCHEDULER: 18.apr.2026 18:47:47 TELEGRAM_CONNECTED: 18.apr.2026 13:37:38 LAST_INBOUND: 18.apr.2026 12:20:27 LAST_RUN_STARTED: 18.apr.2026 12:20:29 LAST_RUN_FINISHED: 18.apr.2026 12:21:07 LAST_REPLY_SENT: 18.apr.2026 12:21:07 JAIL_LAST_SUCCESS: 18.apr.2026 12:21:07 JAIL_LAST_FAILURE: 16.apr.2026 20:46:47 JAIL_LAST_ERROR: n/a (Warning: Model "glm-5-turbo" not found for provider "zai". Using custom model id. Unhandled stop reason: model_context_window_exceeded) STRIPE_STATUS: disabled STRIPE_KEY_MODE: missing STRIPE_REFUNDS: disabled WATCHDOG_MODE: auto WATCHDOG_THROTTLED: false WATCHDOG_FREE_MEMORY_MB: 3294 WATCHDOG_ACTIVE_JAILS: 0 WATCHDOG_QUEUED: 0 CONTROLPLANE: ok CONTROLPLANE_HOSTD: ok CONTROLPLANE_DB_HOST: ok CONTROLPLANE_LLAMA_SERVER: ok SPLIT_BRAIN: degraded SKILLS_DB: available SKILLS_ARTIFACT: missing SKILLS_ARTIFACT_VERSION: v1.0.0-complete SKILLS_ARTIFACT_DB_VERSION: unknown SKILLS_RUNTIME_LOOKUP: present SKILLS_DOCUMENT_ROWS: 0 SKILLS_CHUNK_ROWS: 0 MEMORY_DB: available MEMORY_ROWS: 135 MEMORY_CHUNKS: 467 MEMORY_EMBEDDINGS: 137 ISSUES: - built-in knowledge artifact is missing and document ok/warn/error exit behavior. - Sync skills artifact plan wording with current doctor output. --- Build: pass | Tests: not run
This commit is contained in:
parent
6cd78dddf7
commit
6b9d8f0f24
3 changed files with 11 additions and 3 deletions
|
|
@ -96,7 +96,7 @@ FreeBSD worker jail(s)
|
|||
Agent response
|
||||
```
|
||||
|
||||
**Single Node.js process.** Agents execute in isolated FreeBSD jails with filesystem isolation via nullfs mounts. Only mounted directories are accessible. Per-group message queue with concurrency control. PostgreSQL in a dedicated `{agent}-db` jail provides split-brain memory across three databases: agent-system skills (preloaded, read-only), user/agent memory (dynamic, grows with use), and operational state (messages, tasks, sessions, routing). All three databases are required.
|
||||
**Single Node.js process.** Agents execute in isolated FreeBSD jails with filesystem isolation via nullfs mounts. Only mounted directories are accessible. Per-group message queue with concurrency control. PostgreSQL in a dedicated `{agent}-db` jail provides split-brain memory across three databases: agent-system skills (preloaded, read-only), user/agent memory (dynamic, grows with use), and operational state (messages, tasks, sessions, routing). Ops + memory are required; the built-in skills artifact is optional during development (agent runs with degraded built-in knowledge when it’s missing).
|
||||
|
||||
### Key Files
|
||||
|
||||
|
|
|
|||
|
|
@ -147,7 +147,7 @@ If `bootstrap/skills-memory/artifact.sql` does not exist:
|
|||
|
||||
- Agent starts normally
|
||||
- Knowledge retrieval returns empty results (no crash, no error to user)
|
||||
- `just doctor` prints: `SKILLS_ARTIFACT: absent — built-in knowledge unavailable`
|
||||
- `just doctor` reports `SKILLS_ARTIFACT: missing` and overall `STATUS: warn` (built-in knowledge unavailable; system still runs)
|
||||
- `npm run setup -- --step verify` prints a warning, not a failure
|
||||
|
||||
This is the correct behaviour during development before v1.
|
||||
|
|
|
|||
|
|
@ -74,7 +74,7 @@ Severity:
|
|||
## Doctor Command
|
||||
|
||||
```sh
|
||||
npm run doctor
|
||||
just doctor
|
||||
```
|
||||
|
||||
Reports (in order):
|
||||
|
|
@ -88,6 +88,14 @@ Reports (in order):
|
|||
- control plane check results per service
|
||||
- split-brain DB availability and row counts
|
||||
|
||||
Exit codes:
|
||||
|
||||
- `STATUS: ok` → exit 0
|
||||
- `STATUS: warn` → exit 0 (degraded but running)
|
||||
- `STATUS: error` → exit 1 (action required)
|
||||
|
||||
Note: a missing built-in knowledge artifact is expected during development and is reported as `warn` (built-in knowledge unavailable) rather than failing the entire health check.
|
||||
|
||||
Timestamps are printed in European format (`DD.mmm.YYYY HH:MM`).
|
||||
|
||||
## Why This Split Exists
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue