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

Add docs/lithosananke/DICTIONARY.md: full core word dictionary reference

Browse Source 
No document like this existed. Covers every core C-primitive FORTH word
(~470 registrations, 435 unique names after collapsing double-registered
ones) across all 36 src/word_source/*.c files plus
src/starkernel/capsule/mama_forth_words.c, organized into 34 category
sections matching the module order in register_forth79_words().

Each entry has word name, stack effect, and a one-sentence description
pulled from the doc comment above its implementation (or inferred where
none existed). Explicitly scoped to core primitives, not the ~330
FORTH-defined words inside .4th capsules -- those track individual
experiments/policies rather than the language itself and would need
their own document with a different update cadence.

Resolved, not just noted, the two real name collisions in the live
dictionary: [ ] STATE (dictionary_manipulation_words.c vs.
defining_words.c) and MOD /MOD */ */MOD (arithmetic_words.c vs.
mixed_arithmetic_words.c) -- checked actual registration order in
word_registry.c against the newest-first FIND search to determine which
implementation is actually reachable by name, rather than guessing.

Includes a "keeping this current" section documenting how to extend it
when words are added/removed/re-registered.

Also includes BLOCK_MAP.md/artemis.img/amd64.csv regenerated by builds
during this session, and a qemu boot log/DoE run that weren't from any
command in this session -- kept per repo convention, logs are audit
artifacts, not deleted.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Robert Allan James
2026-08-12 19:09:18 -04:00
co-authored by Claude Sonnet 5
parent aba0b01a08
commit f75228dda5
6 changed files with 9437 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
experiments/bare_metal/latest/amd64.csv
+31 -31
View File
@@ -77,34 +77,34 @@ tick_number,elapsed_ns,tick_interval_ns,cache_hits_delta,bucket_hits_delta,word_
3,30000,10000,0,0,101,13,7,4096,0,0,0,12,65536,0,0,65536,0,0
4,40000,10000,0,0,63,19,8,4096,0,0,0,13,65536,0,0,65536,0,0
5,50000,10000,0,0,92,25,8,4096,2,0,0,15,65536,0,0,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,18,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,22,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,23,65536,0,0,65536,0,0
9,90000,10000,0,0,256,36,10,4096,722,0,0,24,65536,0,0,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,24,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,25,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,26,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,26,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,29,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,30,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,31,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,32,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,33,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,35,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,36,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,37,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,37,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,39,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,39,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,40,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,41,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,43,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,43,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,44,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,45,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,46,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,49,65536,0,1,65536,0,0
33,330000,10000,0,0,256,45,27,256,256,0,0,50,65536,0,1,65536,0,0
34,340000,10000,0,0,256,45,27,256,256,0,0,52,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,53,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,53,65536,0,1,65536,0,0
6,60000,10000,0,0,64,27,8,4096,2,0,0,17,65536,0,0,65536,0,0
7,70000,10000,0,0,228,32,8,4096,210,0,0,21,65536,0,0,65536,0,0
8,80000,10000,0,0,256,34,9,4096,466,0,0,22,65536,0,0,65536,0,0
9,90000,10000,0,0,256,36,10,4096,722,0,0,23,65536,0,0,65536,0,0
10,100000,10000,0,0,256,36,11,4096,978,0,0,23,65536,0,0,65536,0,0
11,110000,10000,0,0,256,36,11,4096,1234,0,0,24,65536,0,0,65536,0,0
12,120000,10000,0,0,256,36,12,4096,1490,0,0,24,65536,0,0,65536,0,0
13,130000,10000,0,0,256,37,12,4096,1746,0,0,25,65536,0,0,65536,0,0
14,140000,10000,0,0,230,39,12,4096,1949,0,0,27,65536,0,0,65536,0,0
15,150000,10000,0,0,256,39,13,4096,2204,0,0,28,65536,0,0,65536,0,0
16,160000,10000,0,0,256,39,14,4096,2459,0,0,29,65536,0,0,65536,0,0
17,170000,10000,0,0,256,39,15,4096,2713,0,0,31,65536,0,0,65536,0,0
18,180000,10000,0,0,256,39,15,4096,2969,0,0,31,65536,0,0,65536,0,0
19,190000,10000,0,0,256,39,16,4096,3224,0,0,34,65536,0,1,65536,0,0
20,200000,10000,0,0,256,41,17,4096,3480,0,0,34,65536,0,1,65536,0,0
21,210000,10000,0,0,256,41,17,4096,3736,0,0,35,65536,0,1,65536,0,0
22,220000,10000,0,0,256,41,18,4096,3992,0,0,35,65536,0,1,65536,0,0
23,230000,10000,0,0,256,41,19,4096,4096,0,0,37,65536,0,1,65536,0,0
24,240000,10000,0,0,256,41,20,4096,4096,0,0,37,65536,0,1,65536,0,0
25,250000,10000,0,0,256,43,20,2048,2048,0,0,38,65536,0,1,65536,0,0
26,260000,10000,0,0,256,45,21,2048,2048,0,0,39,65536,0,1,65536,0,0
27,270000,10000,0,0,256,45,22,1024,1024,0,0,40,65536,0,1,65536,0,0
28,280000,10000,0,0,256,45,23,1024,1024,0,0,41,65536,0,1,65536,0,0
29,290000,10000,0,0,256,45,24,512,512,0,0,41,65536,0,1,65536,0,0
30,300000,10000,0,0,256,45,24,512,512,0,0,42,65536,0,1,65536,0,0
31,310000,10000,0,0,256,45,25,256,256,0,0,42,65536,0,1,65536,0,0
32,320000,10000,0,0,255,45,26,256,256,0,0,44,65536,0,1,65536,0,0
33,330000,10000,0,0,256,45,27,256,256,0,0,45,65536,0,1,65536,0,0
34,340000,10000,0,0,256,45,27,256,256,0,0,47,65536,0,1,65536,0,0
35,350000,10000,0,0,256,45,28,256,256,0,0,47,65536,0,1,65536,0,0
36,360000,10000,0,0,256,45,29,256,256,0,0,47,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
77 3 30000 10000 0 0 101 13 7 4096 0 0 0 12 65536 0 0 65536 0 0
78 4 40000 10000 0 0 63 19 8 4096 0 0 0 13 65536 0 0 65536 0 0
79 5 50000 10000 0 0 92 25 8 4096 2 0 0 15 65536 0 0 65536 0 0
80 6 60000 10000 0 0 64 27 8 4096 2 0 0 18 17 65536 0 0 65536 0 0
81 7 70000 10000 0 0 228 32 8 4096 210 0 0 22 21 65536 0 0 65536 0 0
82 8 80000 10000 0 0 256 34 9 4096 466 0 0 23 22 65536 0 0 65536 0 0
83 9 90000 10000 0 0 256 36 10 4096 722 0 0 24 23 65536 0 0 65536 0 0
84 10 100000 10000 0 0 256 36 11 4096 978 0 0 24 23 65536 0 0 65536 0 0
85 11 110000 10000 0 0 256 36 11 4096 1234 0 0 25 24 65536 0 0 65536 0 0
86 12 120000 10000 0 0 256 36 12 4096 1490 0 0 26 24 65536 0 0 65536 0 0
87 13 130000 10000 0 0 256 37 12 4096 1746 0 0 26 25 65536 0 0 65536 0 0
88 14 140000 10000 0 0 230 39 12 4096 1949 0 0 29 27 65536 0 0 65536 0 0
89 15 150000 10000 0 0 256 39 13 4096 2204 0 0 30 28 65536 0 0 65536 0 0
90 16 160000 10000 0 0 256 39 14 4096 2459 0 0 31 29 65536 0 0 65536 0 0
91 17 170000 10000 0 0 256 39 15 4096 2713 0 0 32 31 65536 0 0 65536 0 0
92 18 180000 10000 0 0 256 39 15 4096 2969 0 0 33 31 65536 0 0 65536 0 0
93 19 190000 10000 0 0 256 39 16 4096 3224 0 0 35 34 65536 0 1 65536 0 0
94 20 200000 10000 0 0 256 41 17 4096 3480 0 0 36 34 65536 0 1 65536 0 0
95 21 210000 10000 0 0 256 41 17 4096 3736 0 0 37 35 65536 0 1 65536 0 0
96 22 220000 10000 0 0 256 41 18 4096 3992 0 0 37 35 65536 0 1 65536 0 0
97 23 230000 10000 0 0 256 41 19 4096 4096 0 0 39 37 65536 0 1 65536 0 0
98 24 240000 10000 0 0 256 41 20 4096 4096 0 0 39 37 65536 0 1 65536 0 0
99 25 250000 10000 0 0 256 43 20 2048 2048 0 0 40 38 65536 0 1 65536 0 0
100 26 260000 10000 0 0 256 45 21 2048 2048 0 0 41 39 65536 0 1 65536 0 0
101 27 270000 10000 0 0 256 45 22 1024 1024 0 0 43 40 65536 0 1 65536 0 0
102 28 280000 10000 0 0 256 45 23 1024 1024 0 0 43 41 65536 0 1 65536 0 0
103 29 290000 10000 0 0 256 45 24 512 512 0 0 44 41 65536 0 1 65536 0 0
104 30 300000 10000 0 0 256 45 24 512 512 0 0 45 42 65536 0 1 65536 0 0
105 31 310000 10000 0 0 256 45 25 256 256 0 0 46 42 65536 0 1 65536 0 0
106 32 320000 10000 0 0 255 45 26 256 256 0 0 49 44 65536 0 1 65536 0 0
107 33 330000 10000 0 0 256 45 27 256 256 0 0 50 45 65536 0 1 65536 0 0
108 34 340000 10000 0 0 256 45 27 256 256 0 0 52 47 65536 0 1 65536 0 0
109 35 350000 10000 0 0 256 45 28 256 256 0 0 53 47 65536 0 1 65536 0 0
110 36 360000 10000 0 0 256 45 29 256 256 0 0 53 47 65536 0 1 65536 0 0