# Core Neith Stack Self-Hostability Certification

Phase 52 completion criterion:
`Core Neith stack self-hostable on Neith Linux infrastructure with transitional external integrations`.

This certification is generated from `@neith/qa` path, manifest, and
capability-marker audits. It verifies that the core Neith stack can be
bootstrapped, operated, updated, and distributed on Neith Linux infrastructure
while optional external integrations remain transitional.

## Summary

- Self-hostable with transitional integrations: PASS
- Certified lanes: 5/5
- Certified self-hostable surfaces: 20
- Missing paths: 0
- Identity mismatches: 0
- Missing capability markers: 0
- Bootstrap image surfaces: 4
- System-module surfaces: 6
- Service-runtime surfaces: 4
- Package-lifecycle surfaces: 4
- Release-distribution surfaces: 2

## Certification Rules

- Each self-hostability lane must expose real in-repo operating surfaces, not
  just planning references or empty shells.
- Workspace manifests and crate manifests must advertise the expected Neith
  identity for the self-hosted surface.
- System configs and source entrypoints must prove ISO bootstrap, service
  orchestration, A/B update and rollback, package lifecycle, and release
  distribution capabilities needed to run Neith on Neith Linux.
- Transitional external integrations may remain available, but they must be
  optional compatibility surfaces rather than foundations of the core stack.

## Certified Self-Hostable Surfaces

| Lane                 | Kind               | Package            | Path                                                    | Detail                                                                                          |
| -------------------- | ------------------ | ------------------ | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| package-lifecycle    | workspace-manifest | neith-installer    | `libs/neith/linux/crates/neith-installer/Cargo.toml`    | Neith installer manifest for installation, migration, and recovery workflows                    |
| package-lifecycle    | source-entrypoint  | n/a                | `libs/neith/linux/crates/neith-installer/src/lib.rs`    | Neith installer entrypoint for installer, partitioning, migration, and recovery flows           |
| package-lifecycle    | workspace-manifest | neith-pkg-manager  | `libs/neith/linux/crates/neith-pkg-manager/Cargo.toml`  | Neith package manager manifest for catalog queries and channel switching                        |
| package-lifecycle    | source-entrypoint  | n/a                | `libs/neith/linux/crates/neith-pkg-manager/src/lib.rs`  | Neith package manager entrypoint exposing catalog, flake, and channel abstractions              |
| service-runtime      | workspace-manifest | neith-services     | `libs/neith/linux/crates/neith-services/Cargo.toml`     | Neith service-runtime crate manifest for system lifecycle orchestration                         |
| service-runtime      | source-entrypoint  | n/a                | `libs/neith/linux/crates/neith-services/src/lib.rs`     | Neith services runtime entrypoint exposing lifecycle, metrics, and scheduler capabilities       |
| service-runtime      | workspace-manifest | neith-update-agent | `libs/neith/linux/crates/neith-update-agent/Cargo.toml` | Neith update-agent manifest for atomic updates and recovery transactions                        |
| service-runtime      | source-entrypoint  | n/a                | `libs/neith/linux/crates/neith-update-agent/src/lib.rs` | Neith update-agent entrypoint for slot-state persistence, deltas, and rollback hooks            |
| bootstrap-images     | system-config      | n/a                | `libs/neith/linux/flake.nix`                            | Neith Linux flake exporting reproducible system configurations and ISO build targets            |
| bootstrap-images     | system-config      | n/a                | `libs/neith/linux/iso/default.nix`                      | Deterministic Neith ISO pipeline exposing full, minimal, and recovery images                    |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/ab-update.nix`          | A/B update integration module for atomic slot selection and boot validation                     |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/base.nix`               | Base Neith Linux system identity and binary-cache configuration with transitional cache support |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/default.nix`            | Composed Neith Linux module entrypoint for the full workstation profile                         |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/packages.nix`           | Neith package/update policy module with optional third-party Flatpak integration                |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/rollback.nix`           | Rollback management module for automatic and manual recovery after failed updates               |
| system-modules       | system-config      | n/a                | `libs/neith/linux/modules/neith/services.nix`           | Neith system-services orchestration module for systemd units, sockets, metrics, and alerting    |
| bootstrap-images     | workspace-manifest | @neith/linux       | `libs/neith/linux/package.json`                         | Neith Linux workspace manifest with flake validation and ISO build entrypoints                  |
| bootstrap-images     | system-config      | n/a                | `libs/neith/linux/packages/flake.nix`                   | Standalone Neith package collection flake for sovereign package/bootstrap delivery              |
| release-distribution | source-entrypoint  | n/a                | `libs/neith/release/src/platform/docker.ts`             | Neith release Docker publisher for self-hosted registries and multi-arch container delivery     |
| release-distribution | source-entrypoint  | n/a                | `libs/neith/release/src/platform/linux.ts`              | Neith release Linux platform builders for native package distribution and app delivery          |

## Audit Result

All required self-hostability surfaces are present and expose the expected Neith
Linux operating capabilities. The repository currently proves bootstrap,
system-module composition, service runtime, package lifecycle, and
release-distribution readiness for self-hosted operation.

## Interpretation

Oshun can continue using transitional external integrations where they add
value, but the core Neith stack already has auditable in-repo foundations for
self-hosted Linux bootstrap, updates, recovery, package management, and
distribution. That is the relevant completion bar for this Phase 52 item.
