This guide is for contributors extending @neith/linux.
Prerequisites#
| Tool | Minimum Version | Purpose |
|---|---|---|
| Rust | stable / 2021 edition | Workspace crate development |
| Cargo | bundled with Rust | Build, test, lint, and formatting |
| Nix | flakes enabled | Flake validation, package composition, and ISO builds |
Workspace Layout#
text
libs/neith/linux/
Cargo.toml Rust workspace root
flake.nix system and ISO flake outputs
iso/ full, minimal, and recovery ISO definitions
modules/neith/ Neith workstation, services, update, and rollback modules
modules/profiles/ installation/live profile composition
packages/ package flake, catalog, overlay, templates
crates/
neith-distro-core
neith-pkg-manager
neith-update-agent
neith-services
neith-installer
...
Development Rules#
- Keep module and flake outputs reproducible. Do not hide environment-specific assumptions in generated commands or Nix expressions.
- Preserve the separation between sovereign core behavior and transitional compatibility integrations.
- When you add a new Rust crate, wire it into the Cargo workspace and explain its role in the Neith Linux docs.
- When you add a new NixOS capability, keep the owning module explicit and update the self-hostability evidence if that capability supports a certified Phase 52 claim.
Verification Commands#
bash
pnpm nx run @neith/linux:build
pnpm nx run @neith/linux:test
pnpm nx run @neith/linux:lint
pnpm nx run @neith/linux:fmt
pnpm nx run @neith/linux:nix-check
build-iso is available when you need to materialize the ISO output directly,
but nix-check is the normal fast verification path for documentation and
configuration changes.
High-Value Extension Areas#
modules/neith/for platform policy, services, rollback, updates, security, and workstation behaviorpackages/for sovereign package definitions and overlay behavioriso/for full, minimal, and recovery image compositioncrates/for package lifecycle, update transactions, installation, and service runtime capabilities
Cross-Surface Coordination#
@neith/linux is not isolated work. Changes here often need corresponding
updates in:
docs/domains/neith/linux/for contributor documentationdocs/domains/neith/core-neith-stack-self-hostability-certification.mdwhen self-hostability evidence changesdocs/domains/neith/phase-52-sbom.*.jsonwhen the workspace component inventory changes@neith/qaauditors and tests when a certification boundary moves