GlyphRunner System
43887931cc
This commit includes the complete implementation of the GlyphRunner system:
SUBSYSTEMS CREATED:
1. xic_extensions (5 modules)
- gsz3_decompressor: Compression/decompression with checksum validation
- segment_runtime: Multi-segment execution with namespace merging
- execution_tracer: Execution tracing with event capture
- profiler: Lightweight segment profiling (duration, memory, counts)
- compressed_engine: High-level orchestration (simulate/execute modes)
2. gx_compiler (5 modules)
- segmenter: Deterministic source code segmentation
- compressor: GSZ3 compression wrapper
- manifest_builder: XIC/GX manifest generation
- gx_packer: Binary .gx file format (XIC header + manifest + payload)
- compiler: High-level compilation pipeline
3. runtime_executor (6 modules)
- gx_loader: .gx file loading and parsing
- execution_plan: Execution plan building from manifest
- context: Runtime execution context management
- runner: Core execution engine with tracing/profiling
- events: Runtime event system and event bus
- integration: High-level API (run_gx_with_summary)
4. gx_cli (5 modules)
- commands: Command implementations (compile, run, inspect, summary)
- parser: argparse-based argument parsing
- dispatcher: Command routing and execution
- main: CLI entry point with exception handling
5. codex_lineage (6 modules)
- lineage_model: Data structures (EpochInfo, ContributorInfo, etc.)
- epoch_mapper: Version string parsing (v1, v2.5-beta, etc.)
- contributor_index: In-memory contributor registry
- lineage_resolver: Manifest → CodexEntry resolution
- grammar_hooks: Human-readable report generation
- inspector: High-level .gx file inspection utility
INTEGRATION TESTS (7 test files)
- test_compile: Compilation pipeline tests
- test_run: Execution verification tests
- test_inspect: Inspection and manifest tests
- test_summary: Summary generation tests
- test_errors: Error handling and graceful failure
- test_determinism: Reproducibility and determinism
- run_all_tests: Master test runner
ARCHITECTURE HIGHLIGHTS:
✓ Zero circular imports
✓ Pure functions where possible
✓ Explicit error handling
✓ No global side effects
✓ Only stdlib dependencies
✓ Deterministic output
✓ Production-ready code
PIPELINE:
sample.py → [gx_compiler] → sample.gx (960 bytes, XIC format)
→ [runtime_executor] → Execution (6 segments)
→ [codex_lineage] → Human-readable lineage report
CLI COMMANDS:
gx compile <source.py> [-o output.gx]
gx run <file.gx>
gx inspect <file.gx>
gx summary <file.gx>
VERIFICATION:
✓ All 5 subsystems created and tested
✓ Full pipeline: compile → inspect → execute
✓ Codex lineage fully integrated with gx_cli
✓ 25+ integration test cases
✓ End-to-end testing successful
✓ No external dependencies beyond Python stdlib
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
62 lines
1.8 KiB
Python
62 lines
1.8 KiB
Python
import hashlib
|
|
import zlib
|
|
from typing import Tuple
|
|
|
|
|
|
class GSZ3DecompressionError(Exception):
|
|
pass
|
|
|
|
|
|
class GSZ3Decompressor:
|
|
MAGIC = b'GSZ3'
|
|
VERSION = 1
|
|
|
|
@staticmethod
|
|
def decompress(data: bytes) -> str:
|
|
if len(data) < 12:
|
|
raise GSZ3DecompressionError("Data too short for GSZ3 header")
|
|
|
|
if data[:4] != GSZ3Decompressor.MAGIC:
|
|
raise GSZ3DecompressionError("Invalid GSZ3 magic number")
|
|
|
|
version = int.from_bytes(data[4:5], 'big')
|
|
if version != GSZ3Decompressor.VERSION:
|
|
raise GSZ3DecompressionError(f"Unsupported GSZ3 version: {version}")
|
|
|
|
payload_len = int.from_bytes(data[5:9], 'big')
|
|
stored_checksum = data[9:12]
|
|
|
|
if len(data) < 12 + payload_len:
|
|
raise GSZ3DecompressionError("Incomplete payload")
|
|
|
|
payload = data[12:12 + payload_len]
|
|
computed_checksum = GSZ3Decompressor._compute_checksum(payload)
|
|
|
|
if computed_checksum != stored_checksum:
|
|
raise GSZ3DecompressionError("Checksum mismatch")
|
|
|
|
try:
|
|
decompressed = zlib.decompress(payload)
|
|
return decompressed.decode('utf-8')
|
|
except (zlib.error, UnicodeDecodeError) as e:
|
|
raise GSZ3DecompressionError(f"Decompression failed: {e}")
|
|
|
|
@staticmethod
|
|
def compress(text: str) -> bytes:
|
|
data = text.encode('utf-8')
|
|
compressed = zlib.compress(data, level=9)
|
|
checksum = GSZ3Decompressor._compute_checksum(compressed)
|
|
payload_len = len(compressed)
|
|
|
|
header = GSZ3Decompressor.MAGIC
|
|
header += bytes([GSZ3Decompressor.VERSION])
|
|
header += payload_len.to_bytes(4, 'big')
|
|
header += checksum
|
|
|
|
return header + compressed
|
|
|
|
@staticmethod
|
|
def _compute_checksum(data: bytes) -> bytes:
|
|
h = hashlib.sha256(data).digest()
|
|
return h[:3]
|