[Task]: Task 6 — Add an install-time “smoke test” (fail fast)

[devils-shadow]

Problem

Install can “succeed” while mail ingest is broken, because nothing forces an end-to-end check.

Goal

install.sh should optionally run a smoke test that validates:

• Quail web reachable locally
• Postfix transport configured
• A locally injected email is ingested

Proposed change

• Add --smoke-test (or environment flag) to install script:
  • Verifies systemctl is-active quail
  • Checks that transport_maps is configured and that the domain lookup returns quail:
  • Sends a swaks message to test@<domain> and waits briefly for ingest
  • Prints clear pass/fail summary.

Acceptance criteria

• On failure, install exits non-zero with actionable output.
• On success, it prints where to access the UI and confirms one message ingested.

Test plan

• Fresh VM run with smoke test enabled.
• Break ingest, confirm smoke test fails.
• Fix ingest, confirm smoke test passes.