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/amd64.csv
+34 -34
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
@@ -76,35 +76,35 @@ tick_number,elapsed_ns,tick_interval_ns,cache_hits_delta,bucket_hits_delta,word_
2,20000,10000,0,0,78,10,7,4096,0,0,0,17,65536,0,0,65536,0,0
3,30000,10000,0,0,101,13,7,4096,0,0,0,21,65536,0,0,65536,0,0
4,40000,10000,0,0,63,19,8,4096,0,0,0,24,65536,0,0,65536,0,0
5,50000,10000,0,0,92,25,8,4096,2,0,0,31,65536,0,0,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,35,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,117,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,210,65536,0,0,65536,0,0
9,90000,10000,0,0,256,36,10,4096,722,0,0,306,65536,0,0,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,400,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,495,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,592,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,688,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,767,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,860,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,953,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,1049,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,1151,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,1250,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,1350,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,1451,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,1544,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,1639,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,1734,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,1828,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,1920,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,2014,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,2107,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,2202,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,2296,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,2391,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,2489,65536,0,1,65536,0,0
33,330000,10000,0,0,256,45,27,256,256,0,0,2587,65536,0,1,65536,0,0
34,340000,10000,0,0,256,45,27,256,256,0,0,2682,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,2777,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,2873,65536,0,1,65536,0,0
5,50000,10000,0,0,92,25,8,4096,2,0,0,30,65536,0,0,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,34,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,113,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,206,65536,0,0,65536,0,0
9,90000,10000,0,0,256,36,10,4096,722,0,0,304,65536,0,0,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,403,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,502,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,594,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,690,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,766,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,858,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,950,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,1042,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,1135,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,1228,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,1320,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,1412,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,1504,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,1598,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,1694,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,1788,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,1881,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,1978,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,2071,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,2164,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,2259,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,2351,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,2443,65536,0,1,65536,0,0
33,330000,10000,0,0,256,45,27,256,256,0,0,2536,65536,0,1,65536,0,0
34,340000,10000,0,0,256,45,27,256,256,0,0,2632,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,2726,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,2818,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
76 2 20000 10000 0 0 78 10 7 4096 0 0 0 17 65536 0 0 65536 0 0
77 3 30000 10000 0 0 101 13 7 4096 0 0 0 21 65536 0 0 65536 0 0
78 4 40000 10000 0 0 63 19 8 4096 0 0 0 24 65536 0 0 65536 0 0
79 5 50000 10000 0 0 92 25 8 4096 2 0 0 31 30 65536 0 0 65536 0 0
80 6 60000 10000 0 0 64 27 8 4096 2 0 0 35 34 65536 0 0 65536 0 0
81 7 70000 10000 0 0 228 32 8 4096 210 0 0 117 113 65536 0 0 65536 0 0
82 8 80000 10000 0 0 256 34 9 4096 466 0 0 210 206 65536 0 0 65536 0 0
83 9 90000 10000 0 0 256 36 10 4096 722 0 0 306 304 65536 0 0 65536 0 0
84 10 100000 10000 0 0 256 36 11 4096 978 0 0 400 403 65536 0 0 65536 0 0
85 11 110000 10000 0 0 256 36 11 4096 1234 0 0 495 502 65536 0 0 65536 0 0
86 12 120000 10000 0 0 256 36 12 4096 1490 0 0 592 594 65536 0 0 65536 0 0
87 13 130000 10000 0 0 256 37 12 4096 1746 0 0 688 690 65536 0 0 65536 0 0
88 14 140000 10000 0 0 230 39 12 4096 1949 0 0 767 766 65536 0 0 65536 0 0
89 15 150000 10000 0 0 256 39 13 4096 2204 0 0 860 858 65536 0 0 65536 0 0
90 16 160000 10000 0 0 256 39 14 4096 2459 0 0 953 950 65536 0 0 65536 0 0
91 17 170000 10000 0 0 256 39 15 4096 2713 0 0 1049 1042 65536 0 0 65536 0 0
92 18 180000 10000 0 0 256 39 15 4096 2969 0 0 1151 1135 65536 0 0 65536 0 0
93 19 190000 10000 0 0 256 39 16 4096 3224 0 0 1250 1228 65536 0 1 65536 0 0
94 20 200000 10000 0 0 256 41 17 4096 3480 0 0 1350 1320 65536 0 1 65536 0 0
95 21 210000 10000 0 0 256 41 17 4096 3736 0 0 1451 1412 65536 0 1 65536 0 0
96 22 220000 10000 0 0 256 41 18 4096 3992 0 0 1544 1504 65536 0 1 65536 0 0
97 23 230000 10000 0 0 256 41 19 4096 4096 0 0 1639 1598 65536 0 1 65536 0 0
98 24 240000 10000 0 0 256 41 20 4096 4096 0 0 1734 1694 65536 0 1 65536 0 0
99 25 250000 10000 0 0 256 43 20 2048 2048 0 0 1828 1788 65536 0 1 65536 0 0
100 26 260000 10000 0 0 256 45 21 2048 2048 0 0 1920 1881 65536 0 1 65536 0 0
101 27 270000 10000 0 0 256 45 22 1024 1024 0 0 2014 1978 65536 0 1 65536 0 0
102 28 280000 10000 0 0 256 45 23 1024 1024 0 0 2107 2071 65536 0 1 65536 0 0
103 29 290000 10000 0 0 256 45 24 512 512 0 0 2202 2164 65536 0 1 65536 0 0
104 30 300000 10000 0 0 256 45 24 512 512 0 0 2296 2259 65536 0 1 65536 0 0
105 31 310000 10000 0 0 256 45 25 256 256 0 0 2391 2351 65536 0 1 65536 0 0
106 32 320000 10000 0 0 255 45 26 256 256 0 0 2489 2443 65536 0 1 65536 0 0
107 33 330000 10000 0 0 256 45 27 256 256 0 0 2587 2536 65536 0 1 65536 0 0
108 34 340000 10000 0 0 256 45 27 256 256 0 0 2682 2632 65536 0 1 65536 0 0
109 35 350000 10000 0 0 256 45 28 256 256 0 0 2777 2726 65536 0 1 65536 0 0
110 36 360000 10000 0 0 256 45 29 256 256 0 0 2873 2818 65536 0 1 65536 0 0