Initial commit: 2125_GCE project

2026-07-09 12:54:44 -04:00
parent c3a826b65c
commit ae13f78c22
299 changed files with 124289 additions and 1031 deletions
@@ -0,0 +1,96 @@
+# 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