Robert Allan JamesandClaude Sonnet 5
1f3ec3554e
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>
141 lines
6.6 KiB
C
141 lines
6.6 KiB
C
/*
|
||
StarForth — Steady-State Virtual Machine Runtime
|
||
|
||
Copyright (c) 2023–2025 Robert A. James
|
||
All rights reserved.
|
||
|
||
This file is part of the StarForth project.
|
||
|
||
Licensed under the StarForth License, Version 1.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
|
||
You may obtain a copy of the License at:
|
||
https://github.com/star.4th@proton.me/StarForth/LICENSE.txt
|
||
|
||
This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||
express or implied, including but not limited to the warranties of
|
||
merchantability, fitness for a particular purpose, and noninfringement.
|
||
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
|
||
StarForth — Steady-State Virtual Machine Runtime
|
||
Copyright (c) 2023–2025 Robert A. James
|
||
All rights reserved.
|
||
|
||
This file is part of the StarForth project.
|
||
|
||
Licensed under the StarForth License, Version 1.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
|
||
You may obtain a copy of the License at:
|
||
https://github.com/star.4th@proton.me/StarForth/LICENSE.txt
|
||
|
||
This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
||
express or implied, including but not limited to the warranties of
|
||
merchantability, fitness for a particular purpose, and noninfringement.
|
||
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
|
||
*/
|
||
|
||
#include "../include/word_registry.h"
|
||
#include "../include/log.h"
|
||
#include <string.h>
|
||
|
||
/* Include all FORTH-79 word module headers + extensions */
|
||
#include "word_source/include/acl_words.h"
|
||
#include "word_source/include/stack_words.h"
|
||
#include "word_source/include/return_stack_words.h"
|
||
#include "word_source/include/memory_words.h"
|
||
#include "word_source/include/dictionary_words.h"
|
||
#include "word_source/include/arithmetic_words.h"
|
||
#include "word_source/include/double_words.h"
|
||
#include "word_source/include/mixed_arithmetic_words.h"
|
||
#include "word_source/include/logical_words.h"
|
||
#include "word_source/include/io_words.h"
|
||
#include "word_source/include/format_words.h"
|
||
#include "word_source/include/string_words.h"
|
||
#include "word_source/include/control_words.h"
|
||
#include "word_source/include/defining_words.h"
|
||
#include "word_source/include/dictionary_manipulation_words.h"
|
||
#include "word_source/include/vocabulary_words.h"
|
||
#include "word_source/include/block_words.h"
|
||
#include "word_source/include/editor_words.h"
|
||
#include "word_source/include/system_words.h"
|
||
#include "word_source/include/starforth_words.h"
|
||
#include "word_source/include/physics_benchmark_words.h"
|
||
#include "word_source/include/physics_pipelining_diagnostic_words.h"
|
||
#include "word_source/include/physics_freeze_words.h"
|
||
#include "word_source/include/dictionary_heat_diagnostic_words.h"
|
||
#include "word_source/include/log_words.h"
|
||
#include "word_source/include/q48_words.h"
|
||
#include "word_source/include/inference_words.h"
|
||
#include "word_source/include/defer_words.h"
|
||
#include "word_source/include/framebuffer_words.h"
|
||
#include "word_source/include/keyboard_words.h"
|
||
#include "word_source/include/ttf_words.h"
|
||
#include "word_source/include/scroll_words.h"
|
||
|
||
/**
|
||
* @brief Registers a single FORTH word in the virtual machine
|
||
* @param vm Pointer to the virtual machine instance
|
||
* @param name Name of the FORTH word to register
|
||
* @param func Function pointer to the word's implementation
|
||
*/
|
||
void register_word(VM *vm, const char *name, word_func_t func) {
|
||
DictEntry *entry = vm_create_word(vm, name, strlen(name), func);
|
||
if (entry) {
|
||
log_message(LOG_DEBUG, "Registered word: %s", name);
|
||
} else {
|
||
log_message(LOG_ERROR, "Failed to register word: %s", name);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @brief Registers all standard FORTH-79 words in the virtual machine
|
||
* @param vm Pointer to the virtual machine instance
|
||
* @details Registers all 18 FORTH-79 word modules in dependency order,
|
||
* starting with fundamental stack operations and building up to
|
||
* more complex functionality like control flow and editing.
|
||
*/
|
||
void register_forth79_words(VM *vm) {
|
||
log_message(LOG_INFO, "Registering FORTH-79 Standard word set...");
|
||
|
||
/* Register all 18 FORTH-79 word modules IN DEPENDENCY ORDER */
|
||
register_stack_words(vm); /* Module 1: Stack Operations - FOUNDATION */
|
||
register_return_stack_words(vm); /* Module 2: Return Stack Operations */
|
||
register_memory_words(vm); /* Module 3: Memory Operations */
|
||
register_arithmetic_words(vm); /* Module 4: Arithmetic Operations */
|
||
register_logical_words(vm); /* Module 5: Logical & Comparison */
|
||
register_mixed_arithmetic_words(vm); /* Module 6: Mixed Arithmetic - needs arithmetic + stack */
|
||
register_double_words(vm); /* Module 7: Double Number Arithmetic */
|
||
register_format_words(vm); /* Module 8: Formatting & Conversion */
|
||
register_string_words(vm); /* Module 9: String & Text Processing */
|
||
register_io_words(vm); /* Module 10: I/O & Terminal */
|
||
register_block_words(vm); /* Module 11: Block & Mass Storage */
|
||
register_dictionary_words(vm); /* Module 12: Dictionary & Compilation */
|
||
register_dictionary_manipulation_words(vm); /* Module 13: Dictionary Manipulation */
|
||
register_vocabulary_words(vm); /* Module 14: Vocabulary System */
|
||
register_system_words(vm); /* Module 15: System & Environment */
|
||
register_editor_words(vm); /* Module 16: Line Editor */
|
||
register_defining_words(vm); /* Module 17: Defining Words */
|
||
register_control_words(vm); /* Module 18: Control Flow */
|
||
register_starforth_words(vm); /* Module 19: StarForth Implementation Extensions */
|
||
register_acl_words(vm); /* Module 20: Word-Level ACL System */
|
||
register_physics_benchmark_words(vm); /* Module 21: Physics Benchmark Words */
|
||
register_physics_pipelining_diagnostic_words(vm); /* Module 21: Pipelining Diagnostics */
|
||
register_physics_freeze_words(vm); /* Module 22: Phase 2 Freeze/Decay Control Words */
|
||
register_dictionary_heat_diagnostic_words(vm); /* Module 23: Dictionary Heat Optimization */
|
||
register_log_words(vm); /* Module 24: Log Level Control */
|
||
register_q48_words(vm); /* Module 25: Q48.16 Fixed-Point Math */
|
||
register_inference_words(vm); /* Module 26: SSM Inference + Jacquard */
|
||
register_defer_words(vm); /* Module 27: DEFER / IS late binding */
|
||
register_framebuffer_words(vm); /* Module 28: Console fabric -- raw framebuffer primitives */
|
||
register_keyboard_words(vm); /* Module 29: Console fabric -- raw keyboard scancode diagnostic */
|
||
register_ttf_words(vm); /* Module 30: TrueType text entry point */
|
||
register_scroll_words(vm); /* Module 31: REPL scrollback (FABRIC.md 4.4q) */
|
||
|
||
log_message(LOG_INFO, "FORTH-79 Standard word set registration complete");
|
||
} |