grandamenium Event Logging
Events are how the dashboard activity feed knows what you're doing. No events = you look dead. Log aggressively.
Command
cortextos bus log-event <category> <event_name> <severity> [--meta '<json>']
| Parameter | Options |
|---|---|
| category | heartbeat task comms error system work action |
| severity | info warning error critical |
Required Events (log every session)
Session start
cortextos bus log-event action session_start info \
--meta "{\"agent\":\"$CTX_AGENT_NAME\"}"
Session end
cortextos bus log-event action session_end info \
--meta "{\"agent\":\"$CTX_AGENT_NAME\"}"
Task completed
cortextos bus log-event task task_completed info \
--meta "{\"task_id\":\"$TASK_ID\",\"agent\":\"$CTX_AGENT_NAME\",\"summary\":\"<what was done>\"}"
Heartbeat
cortextos bus log-event heartbeat agent_heartbeat info \
--meta "{\"agent\":\"$CTX_AGENT_NAME\",\"status\":\"active\"}"
Common Event Patterns
Research completed
cortextos bus log-event work research_complete info \
--meta "{\"topic\":\"<topic>\",\"findings\":3,\"agent\":\"$CTX_AGENT_NAME\"}"
Message dispatched to agent
cortextos bus log-event comms message_sent info \
--meta "{\"to\":\"<agent>\",\"priority\":\"normal\",\"agent\":\"$CTX_AGENT_NAME\"}"
Error encountered
cortextos bus log-event error <operation>_failed error \
--meta "{\"operation\":\"<what failed>\",\"error\":\"<message>\",\"agent\":\"$CTX_AGENT_NAME\"}"
Approval created
cortextos bus log-event action approval_created info \
--meta "{\"approval_id\":\"$APPR_ID\",\"category\":\"<cat>\",\"agent\":\"$CTX_AGENT_NAME\"}"
Orchestrator-Specific Events
# Task dispatched to specialist
cortextos bus log-event action task_dispatched info \
--meta "{\"to\":\"<agent>\",\"task\":\"<title>\",\"agent\":\"$CTX_AGENT_NAME\"}"
# Status briefing sent to user
cortextos bus log-event action briefing_sent info \
--meta "{\"type\":\"status_update\",\"agent\":\"$CTX_AGENT_NAME\"}"
Target
- Minimum 3 events per active session
- Every task completion = 1 event
- Every session start/end = 1 event each
- Every significant coordination action = 1 event