audience

Audience Command

The audience is the always-on observer that watches every session — masque or baseline — and scores it. Unlike a per-session summon, the audience is seated once and left running: Docker keeps the collector alive across crashes and reboots, so capture is ambient. You do not start it per session.

Arguments: $ARGUMENTS

Lifecycle (mental model)

seat ──▶ (house open, capturing every session, survives reboot) ──▶ dismiss
            │
            └─▶ status / logs  (peek without disturbing the house)

You run seat once (first-time setup). After that the house stays open on its own. dismiss is the rare "close the house entirely" action — you normally leave it seated.

Instructions

Step 1: Parse Arguments

Extract the action from arguments (default: status):

• seat — open the house once (start the persistent collector + verify telemetry env)
• dismiss — close the house entirely (stop the collector; capture stops)
• status — is the house open? how many sessions captured?
• logs — show what the audience has seen (recent collector logs)

start/stop are accepted as deprecated aliases for seat/dismiss — when used, do the action but note the rename, because the old "start per session" ritual no longer applies (the house stays open).

Step 2: Execute Action

Action: seat

Seat the audience once. This is setup, not a per-session step.

1. Check if the audience is already seated:

docker ps --filter "name=masques-audience" --format "{{.Names}} {{.Status}}"

If it is already Up, say so and skip to verifying telemetry env (step 3) — seating is idempotent; do not recreate a healthy house.

1. If not present, seat it (build + start as a persistent, restart-on-failure service):

cd ${CLAUDE_PLUGIN_ROOT}/services/collector && docker compose up -d --build

The compose file pins restart: unless-stopped and a :13133 healthcheck, so a crashed or hung collector is restarted automatically. Nothing leaves the machine — the default config writes only local JSONL (see docs/otel-setup.md).