plan: add WS-H NixOS module + CLI install card, TODO phase 4, DEC-9..11

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
ariandClaude Sonnet 5.5 committed 2026-10-15 19:00:48 -04:00
1 parent 936efaf97e
commit af73d118bb
5 files changed
+109

No files matched your search

+30
View File
@@ -105,3 +105,33 @@ Options:
The MCP spec requires Origin validation on Streamable HTTP servers. If the pinned `rmcp` version has a built-in allowed-hosts or Origin option, use it. Otherwise add a small tower layer on `/mcp` that rejects requests whose `Origin` is present and not in an allowlist. Default allowlist: loopback origins plus `server.bind`.
**Decision:** Resolved by spike P0-3, 2026-10-15. `rmcp` 3.5.1 validates both headers itself: `StreamableHttpServerConfig::with_allowed_hosts` (default: loopback names only) and `with_allowed_origins` (default empty = Origin validation off; requests without `Origin` always pass). **No custom tower layer is needed.** F8 must set both. Hosts: loopback names + `server.bind` + `server.allowed_hosts`. Origins: `http://localhost:*`, `http://127.0.0.1:*`, `http://[::1]:*`, `http://<bind>:*` + `server.allowed_origins`. The config keys `server.allowed_hosts` and `server.allowed_origins` already exist.
---
## DEC-9 — Port 1984 lives in the NixOS module
**Status:** Proposed
The module defaults `port = 1984` and `bind = 127.0.0.1`. The binary's own default is unchanged, so non-Nix installs are unaffected. Exposure beyond loopback is an explicit opt-in (`openFirewall` or an interface-scoped rule). Bearer tokens over plain HTTP are readable on a LAN, so Tailscale or a TLS proxy is the recommended path.
**Decision:**
---
## DEC-10 — CLI wrapper for token commands
**Status:** Proposed
The DB is in a 0700 state dir owned by the service user, so a login user cannot run `slinuxm token …` directly. The module installs `slinuxm` on `PATH` as a wrapper that re-execs `token` subcommands via `sudo -u <service user>` and passes everything else through. Alternative: ship the bare binary and document `sudo -u`.
**Decision:**
---
## DEC-11 — No declarative or bootstrap tokens in v1
**Status:** Proposed
A `bootstrapTokens` option would write plaintext secrets to disk, and importing pre-hashed tokens needs a `slinuxm` change. Tokens stay imperative: printed once, never stored in plaintext.
**Decision:**