Execution Plane Code Smell Remediation

Copy Markdown View Source

This guide records the repo-local implementation posture after the GN-TEN code smell remediation pass.

What Changed

  • Subprocess transport state is split so OS command, polling, spooling, and GenServer state do not live in one broad module.
  • Public starts route through transport supervisors instead of bypassing owner supervision.
  • OS command execution is kept behind named lower runtime boundaries with attestation and evidence.
  • File spooling is moved out of transport GenServer state.
  • Guest bridge state is narrowed and supervised.

Maintainer Rules

  • Execution Plane owns lower lane contracts, target validation, placement, and evidence. It does not own product policy or connector semantics.
  • Do not add unsupervised public starts or fallback ladders inside lane hosts.
  • Lower command execution must carry explicit target and authority evidence.

QC

Use the repo root gate:

mix ci