stacklok / stacklok/mecatl

Expose operator-approved microVM profiles to sessions and mecatui

Open
#533 0 comments 0 reactions 1 assignee View on GitHub

@JAORMX is already working on this.

Since Aug 14, 2026.

config enhancement tui
Dominant language
Go
Stars
152
Forks
16
Avg merge
14h 48m
Merged PRs (30d)
536

Description

Parent: #526

Outcome

Operators can enable approved microVM environment profiles and local clients can select one without exposing images, mounts, endpoints, resource controls, or security policy to the model/project configuration.

Scope

  • Add strict operator-global execution-environments settings containing driver endpoints and public profile aliases.
  • Keep privileged image, resource, networking, seccomp, lifecycle, and quota policy enforced by microvmd.
  • Add environment_profile to session creation independently from the existing profile tool-surface field.
  • Reject project-tier attempts to define or weaken environment drivers/profiles.
  • Wire provisioning before durable session creation and per-session engine construction.
  • Persist the prepared host worktree as session Workspace while the live Environment Workspace exposes guest /workspace.
  • Add safe profile inventory and resolved-environment status to clients without exposing control endpoints or credentials.
  • Update mecatui local mode to pass the source path, display source/worktree/guest roles, and support multiple concurrent sessions from one repository.
  • Explicitly reject microVM-backed schedules in the first release.

Acceptance

  • Empty selection uses the operator default; unknown, disabled, unavailable, or unauthorized profiles fail loudly without local fallback.
  • Project settings cannot change the environment selection policy.
  • The model can neither select arbitrary images nor alter mounts, egress, resources, seccomp, lifecycle, driver endpoint, or trust roots.
  • Existing default/no-fs sessions are byte-compatible when microVM support is disabled.
  • Multiple mecatui processes can create independent sessions/worktrees/VMs for one repository and receive accurate resolved paths/status.
  • User-facing docs distinguish source checkout, host session worktree, guest /workspace, guest egress, and host service egress.

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.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.