Files
GlyphRunner System 43887931cc Complete GlyphRunner Implementation: All Subsystems & Integration Tests
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>
2026-05-20 10:54:44 -04:00

121 lines
4.1 KiB
Python

from typing import Dict, Any, Optional, List
from dataclasses import dataclass
from .gsz3_decompressor import GSZ3Decompressor, GSZ3DecompressionError
from .segment_runtime import SegmentRuntime, Segment, SegmentRuntimeError
from .execution_tracer import ExecutionTracer
from .profiler import SegmentProfiler
@dataclass
class CompressionManifest:
source_file: str
codex_lineage: Dict[str, Any]
compression_format: str = "gsz3"
class CompressedEngineError(Exception):
pass
class CompressedEngine:
def __init__(self, verbose: bool = False, profile: bool = False):
self.verbose = verbose
self.profile = profile
self.tracer = ExecutionTracer(verbose=verbose)
self.profiler = SegmentProfiler() if profile else None
def simulate(self, compressed_payload: bytes, manifest: CompressionManifest) -> Dict[str, Any]:
try:
decompressed = GSZ3Decompressor.decompress(compressed_payload)
segments = self._build_segments(decompressed, manifest)
return {
"status": "simulated",
"segment_count": len(segments),
"total_bytes": sum(len(s.code.encode('utf-8')) for s in segments)
}
except GSZ3DecompressionError as e:
raise CompressedEngineError(f"Decompression failed: {e}")
def execute(self, compressed_payload: bytes, manifest: CompressionManifest, debug: bool = False) -> Dict[str, Any]:
try:
decompressed = GSZ3Decompressor.decompress(compressed_payload)
segments = self._build_segments(decompressed, manifest)
for segment in segments:
if self.profile:
self.profiler.start(segment.segment_id)
with self.tracer.trace_segment(
segment.segment_id,
0,
len(segment.code.encode('utf-8'))
):
try:
SegmentRuntime.execute_segments([segment], debug=debug)
except SegmentRuntimeError as e:
if debug:
raise
if self.verbose:
print(f"[ERROR] {segment.segment_id}: {e}")
if self.profile:
self.profiler.stop(segment.segment_id)
result = {
"status": "executed",
"segment_count": len(segments),
"traces": [
{
"segment_id": t.segment_id,
"duration": t.duration,
"exception": t.exception
}
for t in self.tracer.get_traces()
]
}
if self.profile:
result["profiles"] = {
k: {
"elapsed": v.elapsed,
"call_count": v.call_count
}
for k, v in self.profiler.get_all_profiles().items()
}
return result
except GSZ3DecompressionError as e:
raise CompressedEngineError(f"Decompression failed: {e}")
except Exception as e:
raise CompressedEngineError(f"Execution failed: {e}")
def _build_segments(self, decompressed: str, manifest: CompressionManifest) -> List[Segment]:
lineage = manifest.codex_lineage
segments_meta = lineage.get("segments", [])
if not segments_meta:
return [Segment(
segment_id="seg_0",
code=decompressed,
namespace={}
)]
segments = []
lines = decompressed.split('\n')
for i, seg_meta in enumerate(segments_meta):
segment_id = seg_meta.get("id", f"seg_{i}")
start = seg_meta.get("start", 0)
end = seg_meta.get("end", len(lines))
code = '\n'.join(lines[start:end])
segments.append(Segment(
segment_id=segment_id,
code=code,
namespace={}
))
return segments