Glyim is organized as a Cargo workspace of small, single-responsibility crates. Each phase consumes the previous phase’s IR and exposes a minimal trait-based interface, so tests can substitute mocks for any phase. All crates live under crates/.
| Crate |
Description |
glyim-core |
Foundation types: index vectors, definition IDs, interner, paths, ABI constants, the lint registry. |
glyim-span |
Source locations (file, byte index, span), hygiene contexts, multispan diagnostics. |
glyim-diag |
Diagnostic types, error codes, DiagSink, miette integration. |
glyim-vfs |
Virtual file system with in-memory file content tracking. |
glyim-db |
Compilation database: interners, VFS, type context, trait context. |
| Crate |
Description |
glyim-syntax |
CST definition (Rowan-based), SyntaxKind enum, AST node helpers, including the Gsx* node kinds. |
glyim-frontend |
Lexer and parser (merged), produces SyntaxNode. The parser handles GSX elements with zero lexer changes. |
glyim-meta |
Macro expansion: macro_rules! declarative macros and built-in macros. |
glyim-proc-macro |
C-compatible proc-macro ABI, registry, and dlopen loader. |
| Crate |
Description |
glyim-def-map |
Module graph, item scopes, name resolution. |
glyim-hir |
High-level IR (untyped), lowered from the CST. Preserves GSX element structure. |
glyim-type |
Type interning (TyCtx), type kinds, substitutions, regions, predicates, auto-traits, object safety, layout hints, printing. |
glyim-solve |
InferenceTable, unification, trait solver, fulfillment context, HRTB support. |
glyim-typeck |
Type checker: HIR to THIR with inference and trait resolution, including check_gsx. |
glyim-const-eval |
Constant expression evaluator over HIR. |
| Crate |
Description |
glyim-mir |
Mid-level IR (CFG), place types, statement and terminator kinds. |
glyim-lower |
THIR to MIR lowering, monomorphization, CGU partitioning, polymorphization, post-mono lint checks. |
glyim-borrowck |
NLL borrow checker with two-phase borrows, move analysis, and drop-flag elaboration. |
glyim-opt |
MIR optimization passes: constant propagation, DCE, CFG simplification, unreachable block elimination, slice desugaring, drop elaboration. |
glyim-mir-interp |
Interpreter for MIR, used for const fn evaluation and test execution. |
| Crate |
Description |
glyim-layout |
Type layout computation (size, alignment, ABI, vtables) with ABI-aware argument passing (sret, byval, Ignore, Direct, Split). |
glyim-codegen |
Abstract code generation backend trait plus the bytecode backend. |
glyim-codegen-llvm |
LLVM backend (via inkwell, LLVM 23) with full ABI handling, debug info, exception handling, and LTO. |
glyim-bytecode-vm |
Switch-dispatch VM executing the bytecode backend’s output. |
glyim-runtime |
Runtime FFI: alloc, dealloc, drop glue, panic, fs/net/thread/time/process. |
| Crate |
Description |
glyim-gsx |
View IR (skeleton, slots, regions), flat-u32 blueprints, read/write-set analysis, mutation-specialized patches, SSR emitter, Host trait and headless test host, keyed-list LIS reconciliation. |
| Crate |
Description |
glyim-pipeline |
End-to-end compilation driver: lex, parse, def-map, HIR, typeck, lower, borrowck, opt, codegen. |
glyim-cli |
Command-line interface (clap) and linker driver. Built as glyim-cli. |
glyim-lsp |
Language Server Protocol implementation: diagnostics (push, per-file pull with related documents, and workspace pull), hover, completion, navigation (definition, type definition, declaration, implementation, references), call hierarchy, signature help, inlay hints, document highlight, selection ranges, semantic tokens, folding, formatting, rename with prepare, symbols, code actions, document links for include-macro literals, linked editing ranges. |
glyim-test |
Testing framework: discovery, five test modes, snapshots, mocks, property testing. |
glyip |
Package manager and build tool. |
The tools/ directory holds the workspace’s own engineering harnesses —
the readiness ledger and measurement toolchain the CI jobs run:
| Tool |
Description |
glyim-ledger |
Readiness Ledger CLI: feature/gap registries, evidence store, readiness levels, release gates, STATUS/KNOWN_GAPS rendering and their drift checks. |
glyim-bench |
Measurement harness: compile/bench reports, diff, scaling, matrix, budget, history, and trend engines. |
glyim-metrics |
Repo-health metrics (code lines, test count, doc coverage, inline-allow count) checked against metrics/baseline.json. |
glyim-pilot |
Multi-provider overnight coding-agent orchestrator (waves/streams, commit gates). |
ledger-schema |
Strict TOML registry schema: load, validate, JSON-Schema export. |
| Crate |
Contents |
glyim-lang-core |
Core library source (.g files): Option, Result, iter, slice, str, cell, mem, ptr, ops, cmp, marker, panic, hint, convert, default, future. |
glyim-lang-alloc |
Allocation library source: Box, Vec, String, Rc, RawVec. |
glyim-lang-std |
Standard library source: io, fs, net, thread, sync, env, time, process, task. |