smoke-test

Smoke Test Skillpack

Run gbrain smoke-test or bash scripts/smoke-test.sh after any container restart.

Contract

This skill guarantees:

• 8 core tests verify gbrain + OpenClaw health after restart
• Known failures are auto-fixed before reporting
• User-extensible via ~/.gbrain/smoke-tests.d/*.sh drop-in scripts
• Results logged to /tmp/gbrain-smoke-test.log
• Exit code = number of unfixed failures (0 = all pass)

Built-in Tests

#	Test	Auto-Fix
1	Bun runtime	Install from bun.sh
2	GBrain CLI loads	Reinstall deps
3	GBrain database (doctor)	—
4	GBrain worker process	Start worker
5	OpenClaw Codex plugin (Zod CJS)	npm install zod@4 --force
6	OpenClaw gateway	— (may not be started yet)
7	Embedding API key	— (check .env)
8	Brain repo exists	—

Usage

CLI

gbrain smoke-test

Direct

bash scripts/smoke-test.sh

From OpenClaw bootstrap

Add to your ensure-services.sh or equivalent:

bash /path/to/gbrain/scripts/smoke-test.sh >> /tmp/bootstrap.log 2>&1

From an agent

exec: bash /data/gbrain/scripts/smoke-test.sh

Adding Custom Tests

Create executable scripts in ~/.gbrain/smoke-tests.d/:

# ~/.gbrain/smoke-tests.d/check-redis.sh
#!/bin/bash
redis-cli ping | grep -q PONG

Rules:

• Exit 0 = pass, non-zero = fail
• Filename becomes the test name (e.g. check-redis from check-redis.sh)
• Keep tests fast (< 10s each)
• Tests run in alphabetical order

Adding Built-in Tests

Edit scripts/smoke-test.sh. Follow this pattern:

# ── N. [Service Name] ──────────────────────────────────────
if [test condition]; then
  pass "[Service Name]"
else
  # Auto-fix attempt
  [fix command]
  if [re-test condition]; then
    fixed "[What was fixed]"
    pass "[Service Name] (after fix)"
  else
    fail "[Service Name] — [error detail]"
  fi
fi

Design rules:

1. Test first — never fix without confirming broken
2. Re-test after fix — verify the fix worked
3. Timeout everything — timeout N on any command that could hang
4. Use helpers — pass(), fail(), fixed(), skip()
5. Idempotent fixes — safe to run repeatedly
6. Skip gracefully — skip() when a prerequisite is missing, don't fail