GameCult/Epiphany
Archived
Watch
9
0
Fork
You've already forked Epiphany
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/schemas/heartbeat-state-schema.md

3.1 KiB
Raw Blame History

Heartbeat State Schema

Epiphany's heartbeat store is the typed initiative and routine-state organ for the swarm.

The executable truth lives in heartbeat_state.rs.

Store Identity

  • document type: epiphany.agent_heartbeat
  • schema version: epiphany.agent_heartbeat.v0
  • key: default

Related emitted schemas:

  • ghostlight.initiative_schedule.v0
  • epiphany.void_routine.v0
  • epiphany.agent_heartbeat_status.v0

Top-Level Fields

The heartbeat store currently carries:

  • target heartbeat rate
  • scene clock
  • selection policy
  • pacing policy
  • participants
  • history
  • optional routine/sleep surfaces:
    • sleep_cycle
    • memory_resonance
    • incubation
    • thought_lanes
    • bridge
    • candidate_interventions
    • appraisals
    • reactions

The routine surfaces now have a little more anatomy than they used to:

  • incubation.sourceCoverage
    • versioned coverage receipt for which role families and memory kinds have been feeding the current routine
  • incubation.themes[*]
    • now include noveltyToSelf, noveltyToRoom, saturationScore, refractoryPenalty, supportCount, evidenceDiversity, explorationBonus, priorityScore, status, and short holding/attraction lines
  • bridge.sourceCoverage
    • mirrored terrain coverage for the bridge decision layer
  • bridge.topicSaturation
    • repeated-theme pressure derived from both bridge syntheses and current incubating themes
  • bridge.refractoryTopics
    • temporary cooling records for seams the machine has been worrying too hard

Participant Shape

Each participant tracks:

  • agent_id
  • role_id
  • display_name
  • arena
  • participant_kind
  • initiative_speed
  • next_ready_at
  • reaction_bias
  • interrupt_threshold
  • current_load
  • status
  • constraints
  • last action metadata
  • optional pending_turn

Maintenance participants are the standing Epiphany organs. Scene participants reuse the same timing law for Ghostlight-style character turns.

Key Policy

The important semantics are:

  • cooldown starts after turn completion, not launch
  • a participant with a pending turn should not be woken again
  • calm systems can slow toward sleep
  • urgent systems can raise tempo and concurrency
  • idle turns are for rumination, not fake work
  • sleep/dream passes are the intended distillation window
  • a live, unsaturated thought is allowed to sit and deepen without performing a fake novelty errand every pass
  • novelty is split in two on purpose:
    • noveltyToSelf asks whether the swarm is repeating itself
    • noveltyToRoom asks whether the swarm-facing surface has already been fed the same seam
  • saturation and refractory cooling exist to keep one rewarding theme from annexing the whole machine

Relation To Agent Dossiers

Heartbeat is physiology, not identity.

Role dossiers describe what an organ is. Heartbeat describes how often it gets the floor, how reactive it is, and how current pressure bends that timing.

Birth-time repo personality may seed heartbeat timing once. After that, routine state, appraisal, mood, continuity pressure, and live work should carry the motion.