m³OS docs GitHub

Phase 59

Cross Compiled Toolchains

m3OS can host larger post-1.0 development tools built on the host and bundled into the disk image. git, Python, and Clang become routine parts of the developer environment instead of future one-off experiments.

Planned

Learning goal

Understand how large host-built toolchains are staged into the m3OS image.

Category

productivity

Why this phase matters

m3OS can host larger post-1.0 development tools built on the host and bundled into the disk image. git, Python, and Clang become routine parts of the developer environment instead of future one-off experiments.

How it works in m3OS

The roadmap entry defines the learning scope for this phase; a deeper implementation doc has not been matched yet.

How it builds on earlier phases

This phase builds on Release 1 0 Gate and turns that foundation into Cross Compiled Toolchains.

Implementation outline

  • Define the supported post-1.0 toolchain set and image layout.
  • Implement reproducible host-build and staging flows for git, Python, and Clang.
  • Validate local git workflows, Python scripts/REPL use, and Clang-based compilation inside m3OS.
  • Update developer docs and standalone roadmaps to align with the official phase.
  • Record the disk, RAM, and support-boundary implications of the added toolchains.

Task progress snapshot

No checklist tasks were discovered for this phase yet.

Documentation targets

  • Documentation deliverables have not been listed yet.

Deferred follow-on work

  • Networked git operations and GitHub integration
  • Python package installation and richer networking-heavy modules
  • Self-hosting the larger toolchains inside m3OS
  • Broader language/runtime stacks beyond the documented set

Source materials

Important code

Code spotlight cards

Code spotlight

Cargo

kernel/Cargo.toml See file

When the phase lands, bump kernel/Cargo.toml and any release/version references to 0.59.0.

Key files

  • kernel/Cargo.toml — When the phase lands, bump kernel/Cargo.toml and any release/version references to 0.59.0.

How real OSes differ

  • Mature systems ship many more toolchains, package feeds, and update mechanisms than m3OS should attempt here.
  • The important thing is to make a small number of powerful tools reliable instead of pretending to offer a whole distribution overnight.
  • Post-1.0 growth should remain intentional and supportable, not a dumping ground for every interesting package.

Success criteria

  • git supports the documented local repository workflows inside m3OS.
  • Python can run the documented REPL and script workloads inside m3OS.
  • Clang/LLD can build and run the documented sample programs inside m3OS.
  • The host-build and image-staging flow for the supported toolchains is reproducible and documented.
  • Disk, memory, and support-boundary changes introduced by the larger toolchains are documented.

Related phases

Keep exploring the roadmap