feat(v4, kernel): ONE adaptive heartbeat -- it paces itself on the Stadium's resident heat; every VM ticks on it, in lockstep

Captain Bob, 2026-11-17: "The adaptive heartbeat is its own thing ... It has its own independent RWOT and slope
provider. Only one output from the entire stadium is used as a load measurement for heart rate pacing. ... ONE
AS IN THE NUMBER 1 heartbeat (the adaptive one) runs the entire system." Ruled one at a time: the kernel's
heartbeat; resident heat its one input; held in POST; the Stadium charged as before today
(docs/v4.0.0/plans/2026-11-17-one-adaptive-heartbeat.md, its first version kept as superseded).

- kernel/src/heartbeat.c, timer.h: heartbeat_pace_from(load) -- its own window of samples, its own slope
  provider (v4's inference arithmetic) every HEARTBEAT_PACE_EVERY samples, Loop #7 setting its own period
  (not stable 20% faster, stable 25% slower, 1/4..4x the 10 ms base). No source (v3's path): nothing runs.
- kernel/src/vm/stadium.c: stadium_resident_heat_total(), read only -- the one output it paces by.
- v4/system/mesh.c, mesh.h: the owner's clock read at every fabric step; each tick delivered, one by one, to
  every node present -- its heartbeat cycle run, active, idle or blocked alike. The tick by execution, the
  nodes' own Loop #7 and the heartrate callback are gone.
- kernel/src/v4/sk_v4.c: the clock gives the heartbeat's bottom half its turn; 0 until POST has ended.
- Tests first, each seen to fail (does not build): kernel/tests/test_heartbeat.c (11 checks),
  test_stadium_node.c (16), test_mesh_boot.c's lockstep checks. Seven Phase 7 checks that assumed the tick by
  execution now drive the test's heartbeat (ruled). POST 990/990 with v3's heat cases as written;
  mesh-boot 103, -on 112, -noop 100, san-mesh-boot 103, every v4 program at both widths, every kernel host
  test: 0 failures. The full `sanitize` target not run (it outlasts the foreground limit).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
This commit is contained in:
Claude
2026-11-17 20:55:14 +00:00
parent 4a5c9bfd42
commit 00be537503
12 changed files with 462 additions and 88 deletions
+16
View File
@@ -192,6 +192,22 @@ void heartbeat_service(void);
*/
uint64_t heartbeat_read_counter(void);
/* ---- The one adaptive heartbeat paces itself (StarForth v4; Captain Bob, 2026-11-17: "It has its own independent
* RWOT and slope provider. Only one output from the entire stadium is used as a load measurement for heart rate
* pacing"; docs/v4.0.0/plans/2026-11-17-one-adaptive-heartbeat.md). Given a load source -- the Stadium's resident
* heat, on v4 -- every serviced tick samples it into the heartbeat's own rolling window; every
* HEARTBEAT_PACE_EVERY samples its own slope provider (v4's inference arithmetic) runs on that window, and Loop
* #7's rule sets the period: not stable, 20% faster; stable, 25% slower; within a quarter to four times the base.
* The source is only read. With none (v3's path) nothing of this runs and the period is left to its setter. */
#ifndef HEARTBEAT_PACE_EVERY
#define HEARTBEAT_PACE_EVERY 1000u /* samples between runs: Kconfig.heartbeat's inference frequency */
#endif
#define HEARTBEAT_PACE_WINDOW 1024u /* the heartbeat's own rolling window, in samples */
typedef uint64_t (*heartbeat_load_fn)(void);
void heartbeat_pace_from(heartbeat_load_fn load); /* 0: no source, no pacing */
uint64_t heartbeat_pace_samples(void);
uint64_t heartbeat_pace_runs(void);
/**
* Get current TIME-TICKS (monotonic heartbeat count).
*/
+4
View File
@@ -393,6 +393,10 @@ int stadium_quota_slot_for_vm(VMUuid vm_id);
*/
uint64_t stadium_resident_sum(VMUuid vm_id);
/* The heat of every patron on the floor, summed over the whole Stadium: the one output the adaptive heartbeat paces
* by (kernel/src/heartbeat.c, heartbeat_pace_from; Captain Bob, 2026-11-17). Read only. */
uint64_t stadium_resident_heat_total(void);
/*
* stadium_conserved - Boolean analogue of vm_physics_conserved(), for the
* Stadium per-VM quota invariant rather than fleet-wide execution heat