49 lines (38 loc) · 1.45 KB

Architecture

Overview

The project uses a modular bootstrap architecture:

Entry wrapper: install-macos.sh
Core orchestrator: scripts/bootstrap/bootstrap.sh
OS dispatcher: scripts/bootstrap/os/*.sh
Domain modules: scripts/bootstrap/modules/**
Shared helpers: scripts/bootstrap/lib/common.sh

Bootstrap flow

Parse CLI flags in bootstrap.sh.
Detect target OS (or accept --os override).
Load shared helpers.
Load OS module.
Execute domain modules in fixed order.
Run health checks.

Domain isolation

System and shell setup are isolated from language modules.
Each technology domain has its own script.
Modules are intended to remain idempotent and composable.
Domain details and recovery procedures are documented in docs/wiki/*.

Version control points

JS runtime:
- Bun from oven-sh/bun
- Node active version pinned to node@24
Kubernetes runtime:
- kubectl, helm, kustomize, kind, minikube, kubectx, k9s
Container runtime control point:
- container module enforces deterministic context selection.
- Preferred context: orbstack, fallback: colima.
Python:
- python@3.13 linked as default python3
- python@3.14 installed as additional interpreter
Rust:
- rustup-managed stable toolchain

Cross-platform strategy

darwin module is production-ready.
linux and windows modules are placeholders.
Shared logic remains centralized in lib/common.sh.