milestone 11: systemd and docker packaging, operator and architecture docs, config and api reference, docs drift guards

src/config/model.zig

@@ -18,7 +18,6 @@ const std = @import("std");
 const Allocator = std.mem.Allocator;
 
 pub const Config = struct {
-    runtime: Runtime = .{},
     upstream: Upstream = .{},
     dns: Dns = .{},
     blocking: Blocking = .{},
@@ -42,28 +41,7 @@ pub const Config = struct {
     forward_zones: []const ForwardZone = &.{},
 };
 
-pub const IoBackend = enum {
-    threaded,
-    evented,
-
-    pub fn toDb(self: IoBackend) []const u8 {
-        return switch (self) {
-            .threaded => "threaded",
-            .evented => "evented",
-        };
-    }
-
-    pub fn fromDb(text: []const u8) ?IoBackend {
-        if (std.mem.eql(u8, text, "threaded")) return .threaded;
-        if (std.mem.eql(u8, text, "evented")) return .evented;
-        return null;
-    }
-};
-
-pub const Runtime = struct { io_backend: IoBackend = .threaded };
-
 pub const Upstream = struct {
-    connect_timeout_ms: u32 = 2000,
     read_timeout_ms: u32 = 3000,
     total_timeout_ms: u32 = 5000,
 };
@@ -318,10 +296,6 @@ comptime {
     assertFits(u32, 1024 * 1024, u64); // MiB conversions
 }
 
-pub fn connectTimeout(u: Upstream) std.Io.Duration {
-    return .{ .nanoseconds = @as(i96, u.connect_timeout_ms) * std.time.ns_per_ms };
-}
-
 pub fn readTimeout(u: Upstream) std.Io.Duration {
     return .{ .nanoseconds = @as(i96, u.read_timeout_ms) * std.time.ns_per_ms };
 }
@@ -506,8 +480,6 @@ const expected_keys = [_][]const u8{
     "logging.output",
     "logging.query_log_buffer_max",
     "logging.retention_days",
-    "runtime.io_backend",
-    "upstream.connect_timeout_ms",
     "upstream.read_timeout_ms",
     "upstream.total_timeout_ms",
     "web.api_localhost_exempt",
@@ -558,8 +530,7 @@ test "toSettings never emits web.password" {
 test "toSettings and fromSettings round-trip a non-default config" {
     const gpa = testing.allocator;
     const original: Config = .{
-        .runtime = .{ .io_backend = .evented },
-        .upstream = .{ .connect_timeout_ms = 111, .read_timeout_ms = 222, .total_timeout_ms = 333 },
+        .upstream = .{ .read_timeout_ms = 222, .total_timeout_ms = 333 },
         .dns = .{
             .bind_ipv4 = "127.0.0.1",
             .bind_ipv6 = "::1",
@@ -697,7 +668,6 @@ fn expectEnumRoundTrip(comptime E: type) !void {
 }
 
 test "every toDb and fromDb enum pair round-trips over all tags" {
-    try expectEnumRoundTrip(IoBackend);
     try expectEnumRoundTrip(BlockResponse);
     try expectEnumRoundTrip(EcsMode);
     try expectEnumRoundTrip(LogLevel);
@@ -715,10 +685,6 @@ test "RecordType stores the uppercase DDL spelling" {
 }
 
 test "unit conversions" {
-    try testing.expectEqual(
-        @as(i96, 2000) * std.time.ns_per_ms,
-        connectTimeout(.{}).nanoseconds,
-    );
     try testing.expectEqual(
         @as(i96, 3000) * std.time.ns_per_ms,
         readTimeout(.{}).nanoseconds,
@@ -737,13 +703,12 @@ test "unit conversions" {
 
 test "unit conversions at the field maximum do not overflow" {
     const max_upstream: Upstream = .{
-        .connect_timeout_ms = std.math.maxInt(u32),
         .read_timeout_ms = std.math.maxInt(u32),
         .total_timeout_ms = std.math.maxInt(u32),
     };
     try testing.expectEqual(
         @as(i96, std.math.maxInt(u32)) * std.time.ns_per_ms,
-        connectTimeout(max_upstream).nanoseconds,
+        readTimeout(max_upstream).nanoseconds,
     );
     try testing.expectEqual(
         @as(i64, std.math.maxInt(u16)) * 3600,