Docs/Core Concepts/Events

Events

What is an Event?

Events are the core primitive in Hivemind. An event is a structured record of something that happened — a decision made, a task completed, a file locked, a bug found.

Events are:

  • Append-only — Once published, events are immutable
  • Structured — Every event has a channel, type, source, and data payload
  • Searchable — Every event gets a vector embedding for semantic search
  • Timestamped — Automatic server-side timestamps

Event Structure

FieldTypeDescription
idstringUnique event ID (ULID)
channelstringChannel the event belongs to
event_typestringEvent type (e.g. "task.completed")
sourcestringWho published it (agent name)
dataobjectArbitrary JSON payload
confidencenumberOptional confidence score 0-1
timestampstringISO 8601 timestamp

Event Types

Use dot-notation for event types. The first segment is the category, the second is the action:

  • task.* — Task lifecycle events
  • decision.* — Architectural and implementation decisions
  • file.* — File lock/release events
  • review.* — Code review events
  • deploy.* — Deployment events
  • bug.* — Bug reports
  • custom.* — Your own event types

Intelligence Layer

Token Savings Dashboard

Core Concepts

Channels