You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Make the VM-only repository execution boundary a first-class installation/configuration capability on both host families:
Windows -> Hyper-V;
Linux -> KVM/QEMU/libvirt.
By this stage the active host sandbox should already have been removed in Stage 1 and repository execution restored through VMs in Stage 6. Setup must never recreate direct-host repository execution when VM readiness is absent.
Setup should discover first, recommend safe defaults second, and prompt only for unresolved choices or explicit local consent.
inspect completed provider/image/environment/bridge implementation and enumerate what can be discovered, provisioned, repaired, or only diagnosed per platform;
map every setup action to the existing provider/image/environment/composition interface; setup-only raw Hyper-V/libvirt bypasses are architecture defects;
research Hyper-V feature/privilege/reboot behavior and Linux KVM/QEMU/libvirt package/service/group/socket/storage/network setup plus safe cleanup;
research base-image acquisition/provisioning, storage requirements, networking, and guest bootstrap prerequisites;
selected system-provider access, normally qemu:///system where policy allows;
DevBridge image/environment inventory.
Both:
storage/free space;
existing repo/provider/guest environments;
image generations;
bridge/bootstrap health;
approved repositories and immutable repo IDs;
configured guest profiles/resources;
installed-but-unusable prerequisites.
Do not infer readiness from /dev/kvm, virsh, Hyper-V installation, or a VM/domain name alone.
Guided choices
Present a proposed configuration covering repositories, guest profiles, provider, image generations, storage implications, memory/vCPU/lifecycle defaults, prerequisites requiring elevation/reboot/package/service/group/session changes, and exact DevBridge-owned objects that will be created/changed/removed.
Do not silently create authority-bearing environments merely because capability was discovered.
Provisioning / repair / re-entry
Use the same provider/lifecycle studs used by runtime/doctor; do not duplicate raw provider management.
Support re-entry for:
adding/removing repo environments;
enabling/disabling guest profiles;
image migration;
degraded provider/bridge repair;
reset/reseed;
resource/storage policy changes;
cleanup of obsolete owned images/environments;
recovery after host/provider changes.
Temporary provider unavailability must degrade execution, not reactivate a host fallback or delete persistent configuration.
Sandbox-era configuration migration
Stage 1 removes the execution effect of sandbox-era configuration. Stage 8 owns the deliberate operator-facing migration/deprecation of remaining keys such as:
workspace.externalReadRoots;
execution.allowUncontainedTools;
proposal/tool profile sandbox.* fields.
These keys must never be silently reinterpreted as permission for direct host repository execution. Migrate when semantics are unambiguous; otherwise emit an actionable error/reviewed change.
Non-interactive setup
Support declarative automation through the same validation/authority/provider interfaces. It must not bypass repository approval, image/provider/environment identity, host path ownership, or prerequisites.
Parent: #107
Depends on: #108–#115
Coordinates with: #103
Goal
Make the VM-only repository execution boundary a first-class installation/configuration capability on both host families:
By this stage the active host sandbox should already have been removed in Stage 1 and repository execution restored through VMs in Stage 6. Setup must never recreate direct-host repository execution when VM readiness is absent.
Setup should discover first, recommend safe defaults second, and prompt only for unresolved choices or explicit local consent.
Mandatory planning gate
Before changing code:
AGENTS.md, DB-020,docs/vm-migration.md,docs/vm-lego-studs.md, Stage-1 sandbox-removal/no-provider evidence, all VM stages, Reduce setup/configuration burden with guided auto-discovery and confirmation #103, setup/bootstrap docs, doctor behavior, and transactional configuration rules;Provider discovery
Windows:
Linux:
qemu:///systemwhere policy allows;Both:
Do not infer readiness from
/dev/kvm,virsh, Hyper-V installation, or a VM/domain name alone.Guided choices
Present a proposed configuration covering repositories, guest profiles, provider, image generations, storage implications, memory/vCPU/lifecycle defaults, prerequisites requiring elevation/reboot/package/service/group/session changes, and exact DevBridge-owned objects that will be created/changed/removed.
Do not silently create authority-bearing environments merely because capability was discovered.
Provisioning / repair / re-entry
Use the same provider/lifecycle studs used by runtime/doctor; do not duplicate raw provider management.
Support re-entry for:
Temporary provider unavailability must degrade execution, not reactivate a host fallback or delete persistent configuration.
Sandbox-era configuration migration
Stage 1 removes the execution effect of sandbox-era configuration. Stage 8 owns the deliberate operator-facing migration/deprecation of remaining keys such as:
workspace.externalReadRoots;execution.allowUncontainedTools;sandbox.*fields.These keys must never be silently reinterpreted as permission for direct host repository execution. Migrate when semantics are unambiguous; otherwise emit an actionable error/reviewed change.
Non-interactive setup
Support declarative automation through the same validation/authority/provider interfaces. It must not bypass repository approval, image/provider/environment identity, host path ownership, or prerequisites.
Uninstall / cleanup
Distinguish DevBridge state, repo writable layers, immutable images, DevBridge-owned Hyper-V/libvirt objects, and operator/system virtualization infrastructure.
Do not casually disable Hyper-V, remove KVM/libvirt packages, stop shared services, or delete operator-owned provider objects.
Acceptance criteria
doctorremains diagnostic; authority-changing operations belong to explicit setup/lifecycle actions.