NovusEdge / NovusEdge/stoat

Add a qualified native macOS arm64 runtime and release

Open
#82 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Go
Stars
2
Forks
0
Avg merge
3h 51m
Merged PRs (30d)
80

Description

Problem

Stoat can compile selected host primitives on macOS, but it does not yet have a qualified native macOS runtime or release. Cross-compilation is insufficient evidence for VM lifecycle support.

Initial target

  • Host: macOS arm64
  • Accelerator: QEMU HVF
  • Guest: Ubuntu arm64 first, then Debian arm64
  • Distribution: signed and documented native release artifact

Acceptance criteria

  • Define and enforce the supported macOS and QEMU version floor from current primary sources.
  • Add native process lifecycle, identity checks, private file handling, Unix control endpoints, dependency discovery, and seed-generation behavior.
  • Select the correct firmware and arm64 cloud-image artifacts without changing Linux/amd64 behavior.
  • Qualify create, start, SSH, recipe application, copy, sharing, stop/restart, and cleanup on real macOS arm64 hardware.
  • Add a hosted or self-hosted hardware gate that records the exact host, QEMU, guest image, and Stoat build identities.
  • Produce a signed release artifact with installation, upgrade, rollback, and uninstall documentation.
  • Keep unsupported macOS configurations fail-closed with actionable diagnostics.

Out of scope

  • macOS guests
  • Intel macOS support until suitable hardware is available
  • Cross-architecture emulation as a supported performance profile

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the existing native host, QEMU, cloud-image, release, and hardware-gate entry points; the issue does not name specific files or tests. Define the macOS arm64 qualification matrix from the acceptance criteria, then verify the lifecycle flows and signed artifact on real hardware while recording the required host, QEMU, guest image, and build identities.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, macos, ubuntu
Domain
devops, infrastructure, operating-systems, release
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.