Testing

Use this checklist to validate core features outside the automated suite.

What this page covers

Manual coverage for startup, auth, REST, search, tasks, CLI, MCP, migration, and backup.

Core workflow

1. Prerequisites:

• Node 22+
• Docker + Docker Compose
• gpg
• OpenAI API key

2. Baseline stack:

• clone and install
• copy .env
• run docker compose up -d --build
• health check on /health

3. Execute core test groups:

• Admin key creation and validation
• REST CRUD and stale-write conflict check
• Async enrichment + delayed search visibility
• Task CRUD and completion
• CLI CRUD/task flows
• MCP tool list + store + search
• Talon dry-run then real migration
• Encrypted backup creation and restore restore sanity checks

4. Exit checks:

• health green
• CRUD and search successful
• queue operations stable
• latency and resource checks within targets

Notes

• Keep IDs returned by REST and CLI flows as variables for quick scripted reruns.
• When tests run in CI-like environments, prefer non-interactive flags and -T on docker exec calls.