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:
Mevy Assistant 2026-04-18 18:48:18 +00:00
parent 6cd78dddf7
commit 6b9d8f0f24
3 changed files with 11 additions and 3 deletions

View file

@ -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 its missing).
### Key Files

View file

@ -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.

View file

@ -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