build: update golangci-lint to v2.12.2 with org-standard v2 config

Pin golangci-lint to commit c0d3ddc9cf3faa61a4e378e879ece580256d76e5
(v2.12.2) in Dockerfile and script/bootstrap.

Set .golangci.yml to the org-standard v2-schema config already used
across the org's repos (owner-authorized; the same file is being
landed as canonical via a prompts-repo PR). Lint settings live under
linters.settings, so the lll, funlen, cyclop, and dupl thresholds are
actually applied. The informational gomodguard deprecation warning
this config can emit under v2.12 is accepted.

Fix all findings surfaced by the now-active thresholds:

- goconst: shared constants for repeated status, priority, and DNS
  fixture strings in watcher.go and the notify, state, and watcher
  tests
- dupl: consolidate duplicated ntfy/slack HTTP-error tests and
  SendNotification endpoint-error tests behind shared helpers
- lll: wrap long test table entries and comments; shorten one inline
  nolint justification

TESTING.md

@@ -2,10 +2,8 @@
 
 ## DNS Resolution Tests
 
-All tests that involve DNS resolution — in every package, including
-consumers of the resolver such as the watcher — **MUST** use live
-queries against real DNS servers. No mocking, faking, or stubbing of
-DNS at any layer is permitted.
+All resolver tests **MUST** use live queries against real DNS servers.
+No mocking of the DNS client layer is permitted.
 
 ### Rationale
 
@@ -14,8 +12,6 @@ the full delegation chain. Mocked responses cannot faithfully represent
 the variety of real-world DNS behavior (truncation, referrals, glue
 records, DNSSEC, varied response times, EDNS, etc.). Testing against
 real servers ensures the resolver works correctly in production.
-Robustness comes from handling real-world DNS behavior with tolerant
-assertions and sensible timeouts, not from mocks.
 
 ### Constraints
 
@@ -28,14 +24,11 @@ assertions and sensible timeouts, not from mocks.
 - Flaky failures from transient network issues are acceptable and
   should be investigated as potential resolver bugs, not papered over
   with mocks or skip flags
-- Watcher change-detection tests seed a synthetic *previous state*
-  and compare it against fresh live lookups; the DNS side is never
-  faked
 
 ### What NOT to do
 
-- **Do not mock `DNSClient`**, the watcher's `DNSResolver` interface,
-  or any other DNS abstraction — in any package, for any reason
+- **Do not mock `DNSClient`** for resolver tests (the mock constructor
+  exists for unit-testing other packages that consume the resolver)
 - **Do not add `-short` flags** to skip slow tests
 - **Do not increase `-timeout`** to hide hanging queries
 - **Do not modify linter configuration** to suppress findings

TODO.md

@@ -14,10 +14,7 @@ pre-1.0. No git tags. Core resolver work in flight on feature/resolver
 (dirty: internal/resolver/resolver_test.go). Local checkout has diverged
 from origin: origin/main is 8 commits ahead (watcher orchestrator,
 unified TARGETS) and origin/feature/resolver already contains the full
-iterative resolver implementation. DNS mocking is banned in this repo
-(see `TESTING.md`): all tests use live DNS only. The hermetic mocked
-tests previously noted on `feature/resolver` are gone from its current
-tip, which carries a live-DNS suite against `*.dns.sneak.cloud`.
+iterative resolver implementation with hermetic mocked tests.
 
 # Next Step
 
@@ -28,10 +25,6 @@ confirm make check still passes.
 
 # Completed Steps
 
-- 2026-08-07: DNS mocking removed from the entire test suite; watcher
-  tests now drive the real iterative resolver against live DNS and
-  `TESTING.md` bans DNS mocks in every package (`remove-dns-mocking`
-  branch)
 - 2026-08-07: golangci-lint bumped to v2.12.2 (commit-pinned installs
   in `Dockerfile` and `script/bootstrap`); `.golangci.yml` set to the
   org-standard v2-schema config used across the org's repos
@@ -43,8 +36,7 @@ confirm make check still passes.
 - 2026-07-07 Adopted scripts-to-rule-them-all: `script/` entrypoints,
   Makefile shims, README Entrypoints section
 - 2026-02-20: iterative DNS resolver implemented; tests made hermetic
-  with mocked DNS (origin/feature/resolver, unmerged; superseded — DNS
-  mocking is banned, see `TESTING.md`)
+  with mocked DNS (origin/feature/resolver, unmerged)
 - 2026-02-20: CI actions and go install refs pinned to commit SHAs;
   Gitea Actions workflow for make check (origin/ci/make-check, unmerged)
 - 2026-02-20: watcher monitoring orchestrator merged to main (#8)
@@ -71,9 +63,8 @@ Branch reconciliation:
 - Sync local checkout with origin: local main is 8 commits behind
   origin/main; local feature/resolver has diverged from
   origin/feature/resolver, which already implements the resolver
-- Merge in-flight branches to main once green: feature/resolver
-  (confirm its tests remain live-DNS — DNS mocking is banned, see
-  `TESTING.md`), ci/make-check, feature/portcheck-implementation,
+- Merge in-flight branches to main once green: feature/resolver,
+  ci/make-check, feature/portcheck-implementation,
   feature/tlscheck-implementation
 
 Resolver (plan from untracked TODO.md; largely implemented on
@@ -157,7 +148,6 @@ Infrastructure notes (from untracked TODO.md):
 - Module path sneak.berlin/go/dnswatcher differs from the git.eeqj.de
   remote intentionally; do not "fix" it
 - Dependencies: github.com/miekg/dns, golang.org/x/net/publicsuffix
-- Resolver tests originally used live DNS against `*.dns.sneak.cloud`
-  (required records documented in the test file header); `main` now
-  tests against live public DNS. DNS mocking is banned (see
-  `TESTING.md`); never reintroduce hermetic mocked DNS tests
+- Resolver tests originally used live DNS against *.dns.sneak.cloud
+  (required records documented in the test file header); origin now has
+  mocked hermetic tests, keep them hermetic

internal/resolver/dns_client.go

@@ -7,8 +7,8 @@ import (
 	"github.com/miekg/dns"
 )
 
-// DNSClient abstracts DNS wire-protocol exchanges over a single
-// transport, letting the resolver switch between UDP and TCP.
+// DNSClient abstracts DNS wire-protocol exchanges so the resolver
+// can be tested without hitting real nameservers.
 type DNSClient interface {
 	ExchangeContext(
 		ctx context.Context,

internal/resolver/resolver.go

@@ -67,4 +67,17 @@ func NewFromLogger(log *slog.Logger) *Resolver {
 	}
 }
 
+// NewFromLoggerWithClient creates a Resolver with a custom DNS
+// client, useful for testing with mock DNS responses.
+func NewFromLoggerWithClient(
+	log *slog.Logger,
+	client DNSClient,
+) *Resolver {
+	return &Resolver{
+		log:    log,
+		client: client,
+		tcp:    client,
+	}
+}
+
 // Method implementations are in iterative.go.

internal/resolver/resolver_test.go

@@ -10,6 +10,7 @@ import (
 	"testing"
 	"time"
 
+	"github.com/miekg/dns"
 	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"
 
@@ -623,40 +624,57 @@ func TestQueryAllNameservers_ContextCanceled(t *testing.T) {
 }
 
 // ----------------------------------------------------------------
-// Unreachable nameserver tests
+// Timeout tests
 // ----------------------------------------------------------------
 
-func TestQueryNameserverIP_UnreachableServer(t *testing.T) {
+func TestQueryNameserverIP_Timeout(t *testing.T) {
 	t.Parallel()
 
-	r := newTestResolver(t)
+	log := slog.New(slog.NewTextHandler(
+		os.Stderr,
+		&slog.HandlerOptions{Level: slog.LevelDebug},
+	))
+
+	r := resolver.NewFromLoggerWithClient(
+		log, &timeoutClient{},
+	)
 
 	ctx, cancel := context.WithTimeout(
 		context.Background(), 10*time.Second,
 	)
 	t.Cleanup(cancel)
 
-	// 192.0.2.1 is an RFC 5737 documentation address: no
-	// nameserver can exist there. Depending on the network
-	// path the queries either time out (silent drop) or fail
-	// fast (ICMP unreachable), so accept any non-OK status;
-	// the resolver must return a classified response with no
-	// records rather than an error or a hang.
+	// Query any IP — the client always returns a timeout error.
 	resp, err := r.QueryNameserverIP(
 		ctx, "unreachable.test.", "192.0.2.1",
 		"example.com",
 	)
 	require.NoError(t, err)
 
-	assert.NotEqual(t, resolver.StatusOK, resp.Status)
-
-	totalRecords := 0
-	for _, values := range resp.Records {
-		totalRecords += len(values)
+	assert.Equal(t, resolver.StatusTimeout, resp.Status)
+	assert.NotEmpty(t, resp.Error)
 }
 
-	assert.Zero(t, totalRecords)
+// timeoutClient simulates DNS timeout errors for testing.
+type timeoutClient struct{}
+
+func (c *timeoutClient) ExchangeContext(
+	_ context.Context,
+	_ *dns.Msg,
+	_ string,
+) (*dns.Msg, time.Duration, error) {
+	return nil, 0, &net.OpError{
+		Op:  "read",
+		Net: "udp",
+		Err: &timeoutError{},
 	}
+}
+
+type timeoutError struct{}
+
+func (e *timeoutError) Error() string   { return "i/o timeout" }
+func (e *timeoutError) Timeout() bool   { return true }
+func (e *timeoutError) Temporary() bool { return true }
 
 func TestResolveIPAddresses_ContextCanceled(t *testing.T) {
 	t.Parallel()