From 6387f4455bffc230245773678bfd2385eededfeb Mon Sep 17 00:00:00 2001 From: Ari Sosnovsky Date: Mon, 19 Oct 2026 14:16:09 -0400 Subject: [PATCH] WS-H: is done --- TODO.md | 12 ++++++------ docs/workstreams/WS-H-nixos.md | 4 ++-- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/TODO.md b/TODO.md index e8b4cee..d276edf 100644 --- a/TODO.md +++ b/TODO.md @@ -6,7 +6,7 @@ _Last updated: 2026-10-19_ ## Status -The build is functionally complete and merged to `main`. REST, MCP, OTel, TLS and the NixOS module are implemented. Verification #1–#4 and #6 passed live on minipc1 (2026-10-19). The only item in flight is the WS-H nix gate. Everything else open is in the Backlog. +The build is functionally complete and merged to `main`. REST, MCP, OTel, TLS and the NixOS module are implemented. Verification #1–#4 and #6 passed live on minipc1 (2026-10-19). The WS-H nix gate passed on 2026-10-19. Nothing is in flight; everything open is in the Backlog. | Milestone | Gate | Status | |---|---|---| @@ -14,16 +14,16 @@ The build is functionally complete and merged to `main`. REST, MCP, OTel, TLS an | M1 Sources live | All four Phase 1 examples run against a real host | Done (systemd, journal, docker verified live) | | M2 Surfaces | Verification #3, #4 and #5 pass | Partial: #3 and #4 pass live (minipc1, 2026-10-19, all 8 MCP tools); #5 OTel deferred to I6-5 (collector on minipc1 is down) | | M3 Release | Verification #1–#6 pass. Unit file and README shipped. | Partial: #1–#4 and #6 pass, unit installed on minipc1; needs #5 (I6-5) | -| M4 NixOS | `nix flake check` passes including the VM test. `:1984` serves and a token is minted with the system-installed CLI. | **Pending the WS-H gate** (result to be recorded here and in [WS-H log](docs/workstreams/WS-H-nixos.md#log)) | +| M4 NixOS | `nix flake check` passes including the VM test. `:1984` serves and a token is minted with the system-installed CLI. | ✅ 2026-10-19: `nix build` and `nix flake check` (incl. VM test, plain + TLS) pass; see [WS-H log](docs/workstreams/WS-H-nixos.md#log) | | M5 TLS | HTTPS serves REST and `/mcp`, SIGHUP reloads certs, no openssl. | Done | ## In progress / Review | Item | Owner | State | |---|---|---| -| [WS-H NixOS](docs/workstreams/WS-H-nixos.md) gate | Ari | PR #1 merged to `main` (34da657). Outstanding: `nix build`, `nix flake check` incl. VM test. Gate result: _pending_ | +| — | | Nothing in flight | -- [ ] **WS-H Gate:** `nix build` and `nix flake check` pass. `ldd` shows no openssl. A fresh NixOS host serves `:1984` and a token can be minted from a login shell. +- [x] **WS-H Gate:** `nix build` and `nix flake check` pass. `ldd` shows no openssl. A fresh NixOS host serves `:1984` and a token can be minted from a login shell. ## Backlog @@ -65,7 +65,7 @@ Design notes, owned files and logs for each are archived under [`docs/workstream | [WS-G](docs/workstreams/WS-G-otel.md) | OTel export | Traces, observable-gauge metrics, journal/docker log fan-out with reconcile, flush on shutdown, `dev/otelcol.yaml` | G1..G7 | merged to `main` | | [P3](docs/workstreams/P3-integration.md) | Integration and hardening | One axum server, negative tests, hardened unit, README; I6 verified on minipc1 (#1–#4, #6) | I1..I6 (I6-5 in Backlog) | 2026-10-19 | | [WS-I](docs/workstreams/WS-I-tls.md) | Native TLS (rustls) | `server.tls.*`, SIGHUP reload, HTTPS tests, live `curl --cacert` check | T1..T8 | merged to `main` | -| [WS-H](docs/workstreams/WS-H-nixos.md) | NixOS package, module, VM test | H1..H8 merged (PR #1, 34da657); **gate pending, see above** | H1..H8 | merged; gate open | +| [WS-H](docs/workstreams/WS-H-nixos.md) | NixOS package, module, VM test | H1..H8 merged (PR #1, 34da657); gate passed 2026-10-19 | H1..H8 | merged; gate passed 2026-10-19 | ### Done (archive) @@ -81,6 +81,6 @@ All ticked. One line per workstream; the full task text is on each card. - **WS-G** — `telemetry::init` (G1); tracing subscriber (G2); snapshot + observable gauges (G3); metric set and allowlists (G4); log export with reconcile (G5); shutdown flush (G6); `dev/otelcol.yaml` (G7). - **P3** — serve wiring and shutdown (I1); negative tests (I2); systemd unit, verified with `systemd-analyze security --offline` (1.5 OK) and installed as a system unit on minipc1, 2026-10-19 (I3); README (I4); release build, `ldd` clean (I5); manual Verification #1–#4 and #6 on minipc1, 2026-10-19; #5 deferred as I6-5 (I6). - **WS-I** — `server.tls.*` config (T1); rustls with pinned provider (T2); SIGHUP reload (T3); `https://` MCP origins (T4); non-loopback-without-TLS warning (T5); self-signed cert tests (T6); README TLS section (T7); live check (T8). -- **WS-H** — `nix/package.nix` (H1); `flake.nix` (H2); module options (H3); service definition (H4); system-wide CLI with root guard (H5); firewall options and eval assertion (H6); README NixOS section (H7); VM test (H8). Gate still open. +- **WS-H** — `nix/package.nix` (H1); `flake.nix` (H2); module options (H3); service definition (H4); system-wide CLI with root guard (H5); firewall options and eval assertion (H6); README NixOS section (H7); VM test (H8). Gate passed 2026-10-19 (build, flake check, VM test). Early decisions (DEC-1..DEC-8) were accepted before work started; all decisions are recorded in [`ARCHITECTURE.md`](ARCHITECTURE.md#decisions). diff --git a/docs/workstreams/WS-H-nixos.md b/docs/workstreams/WS-H-nixos.md index 03a46a6..c8e414e 100644 --- a/docs/workstreams/WS-H-nixos.md +++ b/docs/workstreams/WS-H-nixos.md @@ -2,7 +2,7 @@ | Field | Value | |---|---| -| Status | Review (gate outstanding) | +| Status | Done | | Owner | Ari | | Phase | 4 (single track, after release candidate) | | Depends on | P3 (final unit hardening, `--print-config`, README); WS-I (TLS options) | @@ -62,4 +62,4 @@ Tick these in [`TODO.md`](../../TODO.md). - 2026-10-15: Card created from design discussion. - 2026-10-19: Merged to `main` as PR #1 (34da657): `nix/package.nix`, `nix/module.nix`, `flake.nix`, `nix/tests/vm.nix`, and the README NixOS section. H1–H8 ticked in `TODO.md`. **Only the Gate remains** (`nix build`, `nix flake check` incl. the VM test, `ldd` check); it is being run and the result will be logged here. Card stays in Review until then. -- _WS-H gate result (`nix build`, `nix flake check` incl. VM test, `ldd`): pending. Append it here, then update the In progress / Review row and milestone M4 in [`TODO.md`](../../TODO.md)._ +- 2026-10-19: **Gate passed.** `nix build .#default` exit 0 (17 min, remote builder): `bin/slinuxm` 24 MB; `ldd` lists only libsystemd, libgcc_s, libm, libc and the loader, no ssl/crypto library (the string `openssl` in the binary is ring's bundled asm banners, not a dependency). `nix flake check` exit 0 with KVM: `nixosModules.default`, `packages`, `checks.package` and `checks.vm` pass; the VM test's 7 subtests pass (plain: healthz public + API 401, token minted via `sudo -u` system CLI, `/mcp` initialize + tools/list, bad Origin rejected, revoke without restart, root refused by token CLI; TLS: HTTPS healthz, plain HTTP refused, token works). aarch64-linux skipped (incompatible; `--all-systems` would include it). Harmless noise: post-build-hook cache-push 404 to the local binary cache. The fresh-host criterion is met by the VM test; deployment on a real host (minipc1) is not confirmed to use this module.