96 lines
3.7 KiB
Markdown
96 lines
3.7 KiB
Markdown
|
# SuperDave GlyphRunner - Project Guide
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
SuperDave GlyphRunner is a Python system that compiles Python source code into GX binary format (XIC format) and executes it through the LAIN cognition engine — an 8-lane symbolic processor with glyph resonance analysis. Includes a FedMart telemetry system with real-time dashboard.
|
||
|
|
|
||
|
|
## Language & Runtime
|
||
|
|
|
||
|
|
- Python 3.14
|
||
|
|
- No virtual environment or package manager configured
|
||
|
|
- No requirements.txt or pyproject.toml
|
||
|
|
|
||
|
|
## Directory Structure
|
||
|
|
|
||
|
|
```
|
||
|
|
gx_compiler/ — Python → .gx binary compiler (compressor, segmenter, packer)
|
||
|
|
gx_lain/ — LAIN cognition engine (8-lane symbolic processor, glyph bridge, runtime)
|
||
|
|
gx_cli/ — CLI interface (compile, run, inspect, summary, lain commands)
|
||
|
|
runtime_executor/ — GX binary loader and execution runtime
|
||
|
|
glyphs/ — Supercharged glyph registry (600 glyphs from LedoGlyph600.json)
|
||
|
|
glyphos/ — Symbolic pipeline, cognitive kernel, event system
|
||
|
|
xic_extensions/ — Compressed engine, segment runtime, profiler, execution tracer
|
||
|
|
xic_*.py — XIC VM, executor, shell, validator, cache, diagnostics, profiler, visualizer
|
||
|
|
fedmart_ui/ — Web dashboard for XIC telemetry monitoring
|
||
|
|
integrations/ — FedMart integration adapter
|
||
|
|
codex_lineage/ — Grammar hooks, contributor index, lineage model, epoch mapper
|
||
|
|
LLMCompress/ — LLM compression utilities
|
||
|
|
tests/ — Unit tests (plain Python, no framework)
|
||
|
|
integration_tests/ — Integration tests (plain Python, no framework)
|
||
|
|
```
|
||
|
|
|
||
|
|
## Test Commands
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Run all integration tests
|
||
|
|
python3 /home/dave/superdave/integration_tests/run_all_tests.py
|
||
|
|
|
||
|
|
# Run individual integration tests
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_compile.py
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_run.py
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_inspect.py
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_summary.py
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_errors.py
|
||
|
|
python3 /home/dave/superdave/integration_tests/test_determinism.py
|
||
|
|
|
||
|
|
# Run unit tests
|
||
|
|
python3 /home/dave/superdave/tests/test_supercharged_registry.py
|
||
|
|
python3 /home/dave/superdave/tests/test_lain_glyph_bridge.py
|
||
|
|
python3 /home/dave/superdave/tests/test_cognitive_kernel.py
|
||
|
|
python3 /home/dave/superdave/tests/test_events.py
|
||
|
|
python3 /home/dave/superdave/tests/test_control_flow.py
|
||
|
|
|
||
|
|
# Run FedMart validation tests
|
||
|
|
python3 /home/dave/superdave/tests/validate_fedmart_integration.py
|
||
|
|
python3 /home/dave/superdave/tests/validate_ui_integration.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## Lint / Typecheck
|
||
|
|
|
||
|
|
No linter or typecheck configuration found. Run tests as verification.
|
||
|
|
|
||
|
|
## Code Conventions
|
||
|
|
|
||
|
|
- Tests use plain Python (no pytest/unittest) with subprocess and assertions
|
||
|
|
- Tests exit 0 on pass, non-zero on fail
|
||
|
|
- Packages use relative imports (`from .module import`)
|
||
|
|
- Lane processors return `{"summary": str, "key_points": list, "constraints": list, "open_questions": list}`
|
||
|
|
- Lane processors use error recovery (catch exceptions, return safe defaults)
|
||
|
|
- No comments in code unless explicitly requested
|
||
|
|
- GSZ3 compression ensures deterministic output (no timestamps in payload)
|
||
|
|
|
||
|
|
## CLI Usage
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Compile Python source to GX binary
|
||
|
|
python3 -m gx_cli.main compile source.py -o source.gx
|
||
|
|
|
||
|
|
# Execute through LAIN cognition
|
||
|
|
python3 -m gx_cli.main lain source.gx
|
||
|
|
|
||
|
|
# Inspect GX binary
|
||
|
|
python3 -m gx_cli.main inspect source.gx
|
||
|
|
|
||
|
|
# Run GX binary
|
||
|
|
python3 -m gx_cli.main run source.gx
|
||
|
|
|
||
|
|
# Summary of GX binary
|
||
|
|
python3 -m gx_cli.main summary source.gx
|
||
|
|
```
|
||
|
|
|
||
|
|
## Key Data
|
||
|
|
|
||
|
|
- 600 glyphs in LedoGlyph600.json (~2.2 MB)
|
||
|
|
- 8 glyph categories, bands 0-41, scores 0-300+
|
||
|
|
- Resonance formula: 40% activation + 30% frequency + 30% symbolic
|
||
|
|
- Typical compile: ~600 byte source → ~960 byte .gx, 6 segments, ~280 bytes compressed
|