v4 fabric to spec: the mesh boot, the one adaptive heartbeat, mechanism A (#189) #197

Merged
rajames merged 160 commits from StarForth-v4.0.0 into master 2026-11-19 11:19:50 +00:00
4 changed files with 34 additions and 1 deletions
Showing only changes of commit b5d99ba98b - Show all commits
@@ -143,7 +143,9 @@ Phase 4).
through `card_bits` -- v3 applies the card's number, one bit off (#196; ruled "v4 correct, v3 as
is"). `v4_mesh_l8_force` as v3's `ssm_l8_force_config`. Test first (67 checks; 75 on). amd64 PASS,
156 s.
- [ ] The snapshot.
- [x] The snapshot (v3's `heartbeat_publish_snapshot`): each cycle, the tick, window, slope and the
dictionary's heat as inference counted it (v3's `*_at_check`). One copy: v3 double-buffers for its
heartbeat thread, which v4 has no counterpart of. Test first (73 checks; 81 on).
### Task 4: the words that read and set them (`FREEZE-WORD`, the inference words, ...), and their POST
### Task 5: the StarForth words (Phase 3's: `init.4th`, `starforth.4th`), and their POST
### Task 6: the ACL (Phase 4's: `ACL.4th`, the word card, the countdown), and its POST
+7
View File
@@ -179,6 +179,13 @@ typedef struct {
uint8_t inference_early_exited;
uint64_t inference_runs, inference_early_exits;
uint64_t tick_target_ns; /* v3's tick_target_ns: HEARTBEAT_TICK_NS, a quarter to four times it */
/* the dictionary as inference last counted it (v3's *_at_check): words over heat 50, words cooling (heat
* 1..9), the heat in all; and the snapshot each cycle publishes (v3's HeartbeatSnapshot) */
uint64_t hot_at_check, stale_at_check, total_heat_at_check;
struct {
uint64_t tick, decay_slope_q48, hot, stale, total_heat;
uint32_t window_width, fill;
} snapshot;
} v4_mesh_physics;
typedef struct v4_mesh v4_mesh;
+20
View File
@@ -535,6 +535,18 @@ static void inference_tick(unsigned place, v4_mesh_physics *p)
if (!p->is_warm || !x) return;
p->inference_runs++;
window_service(p);
{ /* the dictionary's heat, counted (as v3's) */
uint64_t hot = 0, stale = 0, total = 0;
unsigned k;
for (k = 0; k < V4_MESH_WORD_IDS; k++) {
const v4_mesh_account *a = &accounts_of(place)[k];
if (!a->xt) continue;
if (a->heat > V4_MESH_HOT_HEAT) hot++;
else if (a->heat > 0 && a->heat < 10) stale++;
total += a->heat;
}
p->hot_at_check = hot; p->stale_at_check = stale; p->total_heat_at_check = total;
}
/* the heat of each word in the window, the newest `span` of them, oldest first (v3's extract_heat_trajectory) */
have = p->total_executions < V4_MESH_WINDOW ? p->total_executions : V4_MESH_WINDOW;
span = p->effective_window_size < have ? p->effective_window_size : have;
@@ -571,6 +583,14 @@ static void heartbeat_cycle(unsigned place, v4_mesh_physics *p)
background_decay(place, p);
window_service(p);
l8_update(p);
/* the snapshot (v3's heartbeat_publish_snapshot) */
p->snapshot.tick = p->tick;
p->snapshot.window_width = p->effective_window_size;
p->snapshot.fill = (uint32_t)(p->total_executions < V4_MESH_WINDOW ? p->total_executions : V4_MESH_WINDOW);
p->snapshot.decay_slope_q48 = p->decay_slope_q48;
p->snapshot.hot = p->hot_at_check;
p->snapshot.stale = p->stale_at_check;
p->snapshot.total_heat = p->total_heat_at_check;
}
/* at `call` (exec.h), on a word -- any other target, nothing -- in v3's order (physics_pre_execute,
+4
View File
@@ -232,6 +232,10 @@ int main(void)
CHECK(heartrates > 0 && heartrate_ns == (p->tick_target_ns * 10000000ULL) / HEARTBEAT_TICK_NS,
"and on Hera re-armed the kernel's heartbeat: %lu ns", (unsigned long)heartrate_ns);
CHECK(!p->inference.early_exited ? p->last_inference_tick > 0 : 1, "a full run marks its tick");
CHECK(p->snapshot.tick == p->tick && p->snapshot.window_width == p->effective_window_size
&& p->snapshot.decay_slope_q48 == p->decay_slope_q48 && p->snapshot.fill == V4_MESH_WINDOW
&& p->snapshot.total_heat == p->total_heat_at_check && p->total_heat_at_check > 0,
"the cycle's snapshot: its tick, window, slope, and the dictionary's heat as inference counted it");
r = line(V4_MESH_HERA, "FORGET IW", &how);
}