plan: DEC-9/10 decided, DEC-12 TLS proposed, add WS-I TLS card, update WS-H

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
ariandClaude Sonnet 5.5 committed 2026-10-16 06:53:26 -04:00
1 parent b5b3466e1d
commit 7b588120e0
6 files changed
+91 -27

No files matched your search

+15 -4
View File
@@ -103,14 +103,25 @@ Design: [`plan.md`](plan.md) · Review fixes: [`plan/review.md`](plan/review.md)
- [x] **I5** Release build: `ldd` shows only libc + libsystemd and its deps. Record binary size.
- [ ] **I6** Full manual Verification #1–#6 from `plan.md` passes on a real host
## Phase 4 — NixOS packaging · [card](plan/workstreams/WS-H-nixos.md)
## Phase 4 — TLS and NixOS packaging
### WS-I TLS · [card](plan/workstreams/WS-I-tls.md)
- [ ] **I1** (TLS) Config `server.tls.{enabled,cert_file,key_file}` with validation and documented example keys
- [ ] **I2** (TLS) Serve over rustls with a single pinned crypto provider. No openssl.
- [ ] **I3** (TLS) Reload cert and key on SIGHUP without dropping connections. A bad cert keeps the old one.
- [ ] **I4** (TLS) MCP allowed origins use `https://` when TLS is on
- [ ] **I5** (TLS) Startup warning for non-loopback bind without TLS
- [ ] **I6** (TLS) Tests with a generated self-signed cert: HTTPS, 401/200 over TLS, plain HTTP rejected, SIGHUP reload, bad files, bounded shutdown
- [ ] **I7** (TLS) README TLS section
- [ ] **I8** (TLS) Live check with `curl --cacert` and an `/mcp` initialize over HTTPS
### WS-H NixOS · [card](plan/workstreams/WS-H-nixos.md)
- [ ] **H1** `nix/package.nix`: `buildRustPackage` from `Cargo.lock` with pkg-config, cmake, systemd. Binary `slinuxm`.
- [ ] **H2** `flake.nix` with `packages.default`, `nixosModules.default` and `checks`
- [ ] **H3** `nix/module.nix` options: `enable`, `package`, `port` (default 1984), `bind`, `openFirewall`, `allowedHosts`, `docker.enable`, `settings`, `environmentFile`
- [ ] **H3** `nix/module.nix` options: `enable`, `package`, `port` (default 1984), `bind` (default loopback), `tls.*`, `openFirewall`, `allowedHosts`, `docker.enable`, `settings`, `environmentFile`
- [ ] **H4** Service: dedicated user, `StateDirectory` 0700, `systemd-journal` group, P3 hardening set, config at `/etc/skyg-linux-tracker.toml`
- [ ] **H5** **CLI installed system-wide** with a wrapper that runs `slinuxm token …` as the service user (DEC-10)
- [ ] **H5** **CLI installed system-wide**, plain binary (DEC-10). Token commands refuse to run as root against another user's DB and print the `sudo -u skyg-linux-tracker …` command.
- [ ] **H6** Firewall: global `openFirewall` plus interface-scoped option. Eval assertion: non-loopback bind requires auth.
- [ ] **H7** README NixOS section: flake input, token workflow, exposure model, `allowedHosts`
- [ ] **H8** NixOS VM test: healthz, 401, mint token via CLI, 200, `/mcp`, revoke, 401, bad Origin 403
- [ ] **H8** NixOS VM test: healthz, 401, mint token via CLI (`sudo -u`), 200, `/mcp`, revoke, 401, bad Origin 403, plus a TLS case
- [ ] **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.