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>
143 lines
4.2 KiB
Python
143 lines
4.2 KiB
Python
import sys
|
|
from pathlib import Path
|
|
|
|
from gx_compiler.compiler import GXCompiler, CompilerError
|
|
from runtime_executor.integration import run_gx_with_summary
|
|
from runtime_executor.gx_loader import load_gx, GXLoaderError
|
|
|
|
|
|
def cmd_compile(source_path: str, output_path: str = None) -> int:
|
|
try:
|
|
source = Path(source_path)
|
|
|
|
if not source.exists():
|
|
print(f"Error: Source file not found: {source_path}", file=sys.stderr)
|
|
return 1
|
|
|
|
if output_path is None:
|
|
output_path = str(source.with_suffix(".gx"))
|
|
|
|
print(f"Compiling {source_path} → {output_path}")
|
|
|
|
GXCompiler.compile_to_gx(
|
|
source_path=source_path,
|
|
output_path=output_path,
|
|
verbose=False
|
|
)
|
|
|
|
output = Path(output_path)
|
|
size = output.stat().st_size
|
|
print(f"Success: {output_path} ({size} bytes)")
|
|
return 0
|
|
|
|
except CompilerError as e:
|
|
print(f"Compilation error: {e}", file=sys.stderr)
|
|
return 1
|
|
except Exception as e:
|
|
print(f"Error: {e}", file=sys.stderr)
|
|
return 1
|
|
|
|
|
|
def cmd_run(gx_path: str) -> int:
|
|
try:
|
|
gx = Path(gx_path)
|
|
|
|
if not gx.exists():
|
|
print(f"Error: File not found: {gx_path}", file=sys.stderr)
|
|
return 1
|
|
|
|
print(f"Running {gx_path}")
|
|
|
|
summary = run_gx_with_summary(gx_path)
|
|
|
|
if summary['success']:
|
|
print(f"Success: Executed {summary['segments_executed']} segments in {summary['duration']:.4f}s")
|
|
return 0
|
|
else:
|
|
print(f"Failed: {len(summary['errors'])} error(s)")
|
|
for err in summary['errors']:
|
|
print(f" - {err}", file=sys.stderr)
|
|
return 1
|
|
|
|
except Exception as e:
|
|
print(f"Error: {e}", file=sys.stderr)
|
|
return 1
|
|
|
|
|
|
def cmd_inspect(gx_path: str) -> int:
|
|
try:
|
|
gx = Path(gx_path)
|
|
|
|
if not gx.exists():
|
|
print(f"Error: File not found: {gx_path}", file=sys.stderr)
|
|
return 1
|
|
|
|
print(f"Inspecting {gx_path}")
|
|
|
|
try:
|
|
from codex_lineage.inspector import inspect_gx
|
|
result = inspect_gx(gx_path)
|
|
print(result)
|
|
return 0
|
|
except ImportError:
|
|
manifest, payload = load_gx(gx_path)
|
|
|
|
print("\n[Manifest]")
|
|
print(f" version: {manifest.get('version')}")
|
|
print(f" origin: {manifest.get('origin')}")
|
|
print(f" source_file: {manifest.get('source_file')}")
|
|
print(f" source_type: {manifest.get('source_type')}")
|
|
print(f" compression_model: {manifest.get('compression_model')}")
|
|
print(f" contributor: {manifest.get('contributor')}")
|
|
|
|
segments = manifest.get('codex_lineage', {}).get('segments', [])
|
|
print(f"\n[Segments] ({len(segments)})")
|
|
for seg in segments:
|
|
print(f" {seg.get('id')}: lines {seg.get('start')}-{seg.get('end')}")
|
|
|
|
print(f"\n[Payload] {len(payload)} bytes (compressed)")
|
|
|
|
return 0
|
|
|
|
except GXLoaderError as e:
|
|
print(f"Load error: {e}", file=sys.stderr)
|
|
return 1
|
|
except Exception as e:
|
|
print(f"Error: {e}", file=sys.stderr)
|
|
return 1
|
|
|
|
|
|
def cmd_summary(gx_path: str) -> int:
|
|
try:
|
|
gx = Path(gx_path)
|
|
|
|
if not gx.exists():
|
|
print(f"Error: File not found: {gx_path}", file=sys.stderr)
|
|
return 1
|
|
|
|
try:
|
|
from codex_lineage.inspector import inspect_gx
|
|
result = inspect_gx(gx_path)
|
|
print(result)
|
|
return 0
|
|
except ImportError:
|
|
manifest, payload = load_gx(gx_path)
|
|
|
|
segments = manifest.get('codex_lineage', {}).get('segments', [])
|
|
|
|
print(f"GX File: {gx_path}")
|
|
print(f"Source: {manifest.get('source_file')}")
|
|
print(f"Type: {manifest.get('source_type')}")
|
|
print(f"Segments: {len(segments)}")
|
|
print(f"Compressed: {len(payload)} bytes")
|
|
print(f"Version: {manifest.get('version')}")
|
|
|
|
return 0
|
|
|
|
except GXLoaderError as e:
|
|
print(f"Load error: {e}", file=sys.stderr)
|
|
return 1
|
|
except Exception as e:
|
|
print(f"Error: {e}", file=sys.stderr)
|
|
return 1
|