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
2026-05-29 01:23:43 +01:00

125 lines
4 KiB
Markdown

# 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](/E:/Projects/EpiphanyAgent/epiphany-core/src/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`
- optional `mood_timing`
- `cooldown_multiplier`
- scalar timing pressures: `anxiety`, `urgency`, `arousal`,
`thought_pressure`, `guardedness`, `reaction_intensity`
- `emotional_dimensions`: the 32-axis current affect vector used by
utterance-state projection, including anger, despair, sadness, fear,
contempt, annoyance, dismissal, flippancy, tenderness, warmth, shame,
pride, fatigue, secrecy, hesitation, emotional containment, and command
force
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 Organ State
Heartbeat is physiology, not identity.
Organ-state records describe what an organ is. Heartbeat describes how often it gets
the floor, how reactive it is, and how current pressure bends that timing.
Current emotional state is heartbeat physiology. Appraisals write a bounded
named affect vector into `mood_timing`; utterance state consumes that live vector
before falling back to slower organ-state traits. If anger, despair, annoyance,
dismissal, flippancy, or any other speech-relevant feeling is meant to color a
voice, it must exist here or in the typed appraisal feeding this field, not only
as prose in a prompt.
Birth-time repo personality may seed heartbeat timing once. After that, routine
state, appraisal, mood, continuity pressure, and live work should carry the
motion.