admin/LithosAnanake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

starkernel: REPL scrollback, ~1000 lines (FABRIC.md item 4.4q)

Browse Source 
Scope decided with Captain Bob before implementation: ring buffer +
recall on today's full-screen vt100 grid, not also confining REPL text
to the 4.4o 640x480 box (that confinement stays open as its own future
item, not a third silent deferral). No keyboard input path exists yet
(M8 unstarted), so the trigger is two new FORTH words, SCROLL-BACK
( n -- ) / SCROLL-FWD ( n -- ), exercised via serial injection.

vt100.c gains a text-only 1000-line ring buffer (kmalloc'd, tens of KB
-- not pixel snapshots, which would be ~1000x larger for no benefit)
plus a shadow buffer mirroring the current screen. scroll_up() now
pushes evicted rows into the ring before the pixel scroll. History is
one continuous sequence (ring then shadow); scrolling always redraws
from that sequence -- no separate pixel-scroll path for scrollback,
decided up front to avoid retrofitting later.

New src/word_source/scroll_words.c (Module 31), thin wrappers over
console_fb_scroll_back()/_fwd() -> vt100_scroll_back()/_fwd(). Bug
caught during live testing: both words initially used an off-by-one
underflow check (dsp < 1) copied from a different, older dsp
convention elsewhere in this codebase; vm_pop() (which these words
actually call) uses dsp as a 0-based top-of-stack index, so the check
rejected every legitimate single-argument call. Fixed by removing the
separate precheck and relying on vm_pop()'s own guard.

Live-verified on all three architectures (exceeds this item's
amd64-minimum bar): generated 50+ lines via a FORTH loop, confirmed
SCROLL-BACK recovers correctly older content, and on amd64 confirmed
SCROLL-FWD returns to genuinely live state (not a frozen snapshot) by
showing the injected commands' own echo. Known limitation confirmed by
direct pixel measurement: redrawn lines lose their original SGR color
(not stored per-cell) -- text recovers exactly, color does not.

Three-arch verified: Failed: 0, dict-hashes identical across all
three (values changed correctly from prior items -- two new words
were added).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-11 21:23:25 -04:00
co-authored by Claude Sonnet 5
parent 277845e3bf
commit 1f3ec3554e
27 changed files with 73487 additions and 112 deletions
Download Patch File Download Diff File Expand all files Collapse all files
experiments/bare_metal/latest/aarch64.csv
+33 -33
View File
@@ -20,8 +20,8 @@ tick_number,elapsed_ns,tick_interval_ns,cache_hits_delta,bucket_hits_delta,word_
19,190000,10000,0,0,154,35,40,731,731,0,0,0,65536,0,0,65536,0,0
20,200000,10000,0,0,154,35,38,567,567,0,0,0,65536,0,0,65536,0,0
21,210000,10000,0,0,153,38,37,4096,0,0,0,0,65536,0,0,65536,0,0
22,220000,10000,0,0,167,38,38,582,582,0,0,0,65536,0,0,65536,0,0
23,230000,10000,0,0,176,12,40,685,685,0,0,0,65536,0,0,65536,0,0
22,220000,10000,0,0,167,39,38,582,582,0,0,0,65536,0,0,65536,0,0
23,230000,10000,0,0,176,14,39,685,685,0,0,0,65536,0,0,65536,0,0
24,240000,10000,0,0,175,10,25,731,731,0,0,0,65536,0,0,65536,0,0
25,250000,10000,0,0,196,11,23,731,731,0,0,0,65536,0,0,65536,0,0
26,260000,10000,0,0,192,14,24,4096,0,0,0,0,65536,0,0,65536,0,0
@@ -72,39 +72,39 @@ tick_number,elapsed_ns,tick_interval_ns,cache_hits_delta,bucket_hits_delta,word_
71,710000,10000,0,0,44,22,39,4096,1757,0,0,0,65536,0,0,65536,0,0
72,720000,10000,0,0,130,24,27,4096,1757,0,0,0,65536,0,0,65536,0,0
73,730000,10000,0,0,134,26,21,4096,1757,0,0,0,65536,0,0,65536,0,0
1,10000,18446744073708831616,0,0,117,4,4,4096,0,0,4895412794951728796,25,65536,0,0,65536,0,0
2,20000,10000,0,0,78,10,7,4096,0,0,0,33,65536,0,0,65536,0,0
1,10000,18446744073708831616,0,0,117,4,4,4096,0,0,4895412794951728796,26,65536,0,0,65536,0,0
2,20000,10000,0,0,78,10,7,4096,0,0,0,34,65536,0,0,65536,0,0
3,30000,10000,0,0,101,13,7,4096,0,0,0,41,65536,0,0,65536,0,0
4,40000,10000,0,0,63,19,8,4096,0,0,0,47,65536,0,0,65536,0,0
5,50000,10000,0,0,92,25,8,4096,2,0,0,57,65536,0,0,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,65,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,215,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,392,65536,0,0,65536,0,0
5,50000,10000,0,0,92,25,8,4096,2,0,0,58,65536,0,0,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,66,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,217,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,393,65536,0,0,65536,0,0
9,90000,10000,0,0,256,36,10,4096,722,0,0,570,65536,0,0,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,748,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,926,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,1104,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,1280,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,1425,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,1602,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,1776,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,1954,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,2131,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,2308,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,2485,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,2661,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,2838,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,3015,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,3191,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,3369,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,3547,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,3725,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,3904,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,4081,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,4259,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,4437,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,4612,65536,0,1,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,745,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,921,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,1096,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,1271,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,1417,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,1593,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,1768,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,1944,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,2120,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,2300,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,2476,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,2652,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,2829,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,3006,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,3182,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,3360,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,3539,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,3719,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,3897,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,4074,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,4254,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,4432,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,4608,65536,0,1,65536,0,0
33,330000,10000,0,0,256,45,27,256,256,0,0,4789,65536,0,1,65536,0,0
34,340000,10000,0,0,256,45,27,256,256,0,0,4969,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,5146,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,5325,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,5147,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,5326,65536,0,1,65536,0,0
1 tick_number elapsed_ns tick_interval_ns cache_hits_delta bucket_hits_delta word_executions_delta hot_word_count avg_word_heat_q48 window_width actual_window_size predicted_label_hits jitter_bits apic_ticks time_trust_q48 variance_q48 vm_call_depth_max hera_heat_q48 hermes_heat_q48 artemis_heat_q48
20 19 190000 10000 0 0 154 35 40 731 731 0 0 0 65536 0 0 65536 0 0
21 20 200000 10000 0 0 154 35 38 567 567 0 0 0 65536 0 0 65536 0 0
22 21 210000 10000 0 0 153 38 37 4096 0 0 0 0 65536 0 0 65536 0 0
23 22 220000 10000 0 0 167 38 39 38 582 582 0 0 0 65536 0 0 65536 0 0
24 23 230000 10000 0 0 176 12 14 40 39 685 685 0 0 0 65536 0 0 65536 0 0
25 24 240000 10000 0 0 175 10 25 731 731 0 0 0 65536 0 0 65536 0 0
26 25 250000 10000 0 0 196 11 23 731 731 0 0 0 65536 0 0 65536 0 0
27 26 260000 10000 0 0 192 14 24 4096 0 0 0 0 65536 0 0 65536 0 0
72 71 710000 10000 0 0 44 22 39 4096 1757 0 0 0 65536 0 0 65536 0 0
73 72 720000 10000 0 0 130 24 27 4096 1757 0 0 0 65536 0 0 65536 0 0
74 73 730000 10000 0 0 134 26 21 4096 1757 0 0 0 65536 0 0 65536 0 0
75 1 10000 18446744073708831616 0 0 117 4 4 4096 0 0 4895412794951728796 25 26 65536 0 0 65536 0 0
76 2 20000 10000 0 0 78 10 7 4096 0 0 0 33 34 65536 0 0 65536 0 0
77 3 30000 10000 0 0 101 13 7 4096 0 0 0 41 65536 0 0 65536 0 0
78 4 40000 10000 0 0 63 19 8 4096 0 0 0 47 65536 0 0 65536 0 0
79 5 50000 10000 0 0 92 25 8 4096 2 0 0 57 58 65536 0 0 65536 0 0
80 6 60000 10000 0 0 64 27 8 4096 2 0 0 65 66 65536 0 0 65536 0 0
81 7 70000 10000 0 0 228 32 8 4096 210 0 0 215 217 65536 0 0 65536 0 0
82 8 80000 10000 0 0 256 34 9 4096 466 0 0 392 393 65536 0 0 65536 0 0
83 9 90000 10000 0 0 256 36 10 4096 722 0 0 570 65536 0 0 65536 0 0
84 10 100000 10000 0 0 256 36 11 4096 978 0 0 748 745 65536 0 0 65536 0 0
85 11 110000 10000 0 0 256 36 11 4096 1234 0 0 926 921 65536 0 0 65536 0 0
86 12 120000 10000 0 0 256 36 12 4096 1490 0 0 1104 1096 65536 0 0 65536 0 0
87 13 130000 10000 0 0 256 37 12 4096 1746 0 0 1280 1271 65536 0 0 65536 0 0
88 14 140000 10000 0 0 230 39 12 4096 1949 0 0 1425 1417 65536 0 0 65536 0 0
89 15 150000 10000 0 0 256 39 13 4096 2204 0 0 1602 1593 65536 0 0 65536 0 0
90 16 160000 10000 0 0 256 39 14 4096 2459 0 0 1776 1768 65536 0 0 65536 0 0
91 17 170000 10000 0 0 256 39 15 4096 2713 0 0 1954 1944 65536 0 0 65536 0 0
92 18 180000 10000 0 0 256 39 15 4096 2969 0 0 2131 2120 65536 0 0 65536 0 0
93 19 190000 10000 0 0 256 39 16 4096 3224 0 0 2308 2300 65536 0 1 65536 0 0
94 20 200000 10000 0 0 256 41 17 4096 3480 0 0 2485 2476 65536 0 1 65536 0 0
95 21 210000 10000 0 0 256 41 17 4096 3736 0 0 2661 2652 65536 0 1 65536 0 0
96 22 220000 10000 0 0 256 41 18 4096 3992 0 0 2838 2829 65536 0 1 65536 0 0
97 23 230000 10000 0 0 256 41 19 4096 4096 0 0 3015 3006 65536 0 1 65536 0 0
98 24 240000 10000 0 0 256 41 20 4096 4096 0 0 3191 3182 65536 0 1 65536 0 0
99 25 250000 10000 0 0 256 43 20 2048 2048 0 0 3369 3360 65536 0 1 65536 0 0
100 26 260000 10000 0 0 256 45 21 2048 2048 0 0 3547 3539 65536 0 1 65536 0 0
101 27 270000 10000 0 0 256 45 22 1024 1024 0 0 3725 3719 65536 0 1 65536 0 0
102 28 280000 10000 0 0 256 45 23 1024 1024 0 0 3904 3897 65536 0 1 65536 0 0
103 29 290000 10000 0 0 256 45 24 512 512 0 0 4081 4074 65536 0 1 65536 0 0
104 30 300000 10000 0 0 256 45 24 512 512 0 0 4259 4254 65536 0 1 65536 0 0
105 31 310000 10000 0 0 256 45 25 256 256 0 0 4437 4432 65536 0 1 65536 0 0
106 32 320000 10000 0 0 255 45 26 256 256 0 0 4612 4608 65536 0 1 65536 0 0
107 33 330000 10000 0 0 256 45 27 256 256 0 0 4789 65536 0 1 65536 0 0
108 34 340000 10000 0 0 256 45 27 256 256 0 0 4969 65536 0 1 65536 0 0
109 35 350000 10000 0 0 256 45 28 256 256 0 0 5146 5147 65536 0 1 65536 0 0
110 36 360000 10000 0 0 256 45 29 256 256 0 0 5325 5326 65536 0 1 65536 0 0