Muonium Native

Muonium Native is the repository for Muonium's native code-intelligence work. It currently has two major implementation areas:

• prism/: lexical highlighting and export pipelines across Kotlin, Swift, Rust, C++, and C.
• cortex/: parser and structure-aware runtime work across Swift, Kotlin, and Rust.

The repository also carries the vendored grammars and reference lexer sources used to validate ports and release artifacts.

Current Status

prism is the most runnable path from the repo root today. The root make targets build, test, and run the Prism Kotlin CLI.

cortex is active parser/runtime work. It has working language-specific build targets, but the different implementations are at different maturity levels, so use the subproject commands rather than assuming a single repo-wide Cortex entrypoint.

Quick Start

From a fresh clone:

make setup
make build
make test
make run

What those do today:

• make setup: syncs and initializes the required git submodules.
• make build: builds the Prism Kotlin workspace.
• make test: runs the Prism Kotlin test path.
• make run: runs the Prism Kotlin CLI against a sample fixture.

Project Layout

Prism

prism/ contains the lexical highlighting implementations and validation tooling.

Useful entrypoints:

• prism/Makefile: umbrella build, test, OCR, and comparison targets.
• prism/muonium-c/README.md: details for the single-file C lexer path.
• prism/muonium-kotlin/: Kotlin JVM and Kotlin/Native CLI implementations.
• prism/muonium-swift/, prism/muonium-rust/, prism/muonium-cpp/, prism/muonium-c/: language-specific ports and release artifacts.

Common commands:

make -C prism build
make -C prism test
make -C prism run

Cortex

cortex/ contains the parser/runtime work and parity harnesses.

Useful entrypoints:

• cortex/swift/README.md: current Swift parser package status.
• cortex/kotlin/README.md: Kotlin parser/runtime modules and parity tooling.
• cortex/rust/: Rust parser/runtime workspace and CLI.

Common commands:

make -C cortex/swift build
make -C cortex/kotlin build
make -C cortex/rust build

Supporting Directories

• vendor/: vendored grammars and reference sources, primarily used for parity and release validation. Do not edit vendored contents directly; see THIRD_PARTY_NOTICES.md.
• tickets/: MuonTickets board for queued work and archived tasks.
• electron/: UI and benchmarking experiments that are not part of the root build/test/run path.
• architecture.md: high-level notes on repository structure and direction.

Releases

Version baselines are tracked in:

• cortex/VERSION
• prism/VERSION

The current GitHub Actions release build workflow is:

• .github/workflows/release-builds.yml
• RELEASE_CHECKLIST.md: v0.1.0 release checklist, artifact verification, and manual tag/release steps
• CHANGELOG.md: draft release notes source for v0.1.0
• release-metadata.md: public CLI labels, compatibility aliases, and current metadata gaps

Project Policies

• LICENSE
• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• SECURITY.md
• THIRD_PARTY_NOTICES.md
• tickets/T-000009.md: remaining GitHub issue, PR, and ownership templates work

First-party repository code is MIT licensed. Vendored code under vendor/ may carry its own upstream license files.