Suppress the revive package-name findings with no fix (closes #61)

Three findings remain that cannot be fixed without making a repo-wide
naming decision, so each carries a per-site //nolint directive with its
justification.

revive var-naming (internal/log, internal/crypto, internal/types):
fixing these means renaming packages across the whole codebase, which
is the repo owner's call, not a lint fix. Neither stdlib log nor stdlib
crypto is imported anywhere in the repo, so nothing is actually
shadowed today. The rename decision is tracked in issue #76. revive
reports a package-name failure only once per package directory, on
whichever file it happens to lint first, so every file of the affected
packages carries the directive and lists nolintlint alongside revive so
the ones that lose the race are not reported as unused.

No gosec directives are needed: the pinned golangci-lint v2.12.2 that
CI and the Dockerfile use reports nothing at the term.IsTerminal
conversions in internal/log and internal/ui or at the os.Remove calls
in internal/vaultik/verify.go, so suppressing there would itself fail
nolintlint as an unused directive.

Verification is script/cibuild, which builds the hash-pinned lint
image: it exits 0, with make lint reporting "0 issues" under the
canonical .golangci.yml (sha256
021cc83f4e6fc7c31b95b34b846723dfcf20b66b7baeea1dc40406e643346bcb,
unmodified), plus make fmt-check, make test and the release build. That
also unblocks issue #59. make check is not a valid gate here: script/lint
runs whatever golangci-lint is on PATH rather than the pinned version,
which is tracked in issue #78.

Also corrects the capacity comment in collectBatchFlushData: an empty
file contributes no chunk mappings, so the pending-file count is a
rough starting capacity, not a lower bound.

TODO.md: record this work, note that the previous next step (reconciling
uncommitted ARCHITECTURE.md edits) needed no work because the tree is
clean, and move the next step on to the stale-branch triage.

TODO.md

@@ -20,15 +20,22 @@ or delete the branch.
 # Completed Steps
 
 - 2026-08-09: Finished the lint remediation under the canonical
-  `.golangci.yml` (issue #61, which also unblocks issue #59). Fixed the
-  last 80 findings behavior-preservingly — `wsl_v5` 60, `sqlclosecheck`
-  10, `gosec` 4, `prealloc` 3, `revive` 3 — so `make check` now exits 0
-  on `main`. The `sqlclosecheck` sites now close `sql.Rows` in a
-  deferred closure instead of via the `CloseRows` helper, which the
-  linter could not see through; the four `gosec` and three `revive`
-  findings carry per-site `//nolint` directives with justifications, and
-  the package-rename question behind the `revive` ones is tracked in
-  issue #76.
+  `.golangci.yml` (issue #61, which also unblocks issue #59). The
+  remaining findings were fixed behavior-preservingly: `wsl_v5`
+  whitespace, `sqlclosecheck`, and `prealloc`. The `sqlclosecheck` sites
+  now close `sql.Rows` in a deferred closure instead of via the
+  `CloseRows` helper, which the linter could not see through. Only the
+  `revive` package-name findings remain suppressed, with per-site
+  `//nolint` directives; the package-rename question behind them is
+  tracked in issue #76. Verified with `script/cibuild`, which exits 0 —
+  that is the only trustworthy gate, because `script/lint` runs whatever
+  `golangci-lint` happens to be on `PATH` rather than the pinned
+  v2.12.2 that CI and the `Dockerfile` use, so `make check` can report
+  green on findings CI still fails. That tooling gap is tracked in issue
+  #78.
+- 2026-08-09: The earlier next step "reconcile the uncommitted
+  `ARCHITECTURE.md` edits on `main`" needed no work: the working tree is
+  clean and `ARCHITECTURE.md` is committed on `main`.
 - 2026-08-07: Updated golangci-lint to v2.12.2 everywhere it is pinned
   (`Dockerfile` lint stage, `Makefile` deps target), replaced
   `.golangci.yml` with the canonical config (v2 schema, `default: all`),

internal/log/log.go

@@ -69,10 +69,8 @@ func Initialize(cfg Config) {
 		Level: level,
 	}
 
-	// Check if stdout is a TTY. term.IsTerminal takes an int, and a file
-	// descriptor always fits in one on every platform Go supports; a
-	// closed file yields -1, which IsTerminal reports as not a terminal.
-	if term.IsTerminal(int(os.Stdout.Fd())) { //nolint:gosec // G115: fd fits in int
+	// Check if stdout is a TTY.
+	if term.IsTerminal(int(os.Stdout.Fd())) {
 		// Use colorized TTY handler
 		logger = slog.New(NewTTYHandler(os.Stdout, opts))
 	} else {

internal/snapshot/scanner.go

@@ -624,9 +624,10 @@ func (s *Scanner) collectBatchFlushData(
 
 	collectStart := time.Now()
 
-	// Every pending file contributes at least one file-chunk and one
-	// chunk-file mapping, so the file count is a safe lower bound for the
-	// initial capacity of both slices.
+	// A pending file contributes one mapping of each kind per chunk, and
+	// an empty file contributes none, so the file count is only a rough
+	// starting capacity for the mapping slices; append grows them as
+	// needed. It is exact for the file and file-ID slices.
 	allFileChunks := make([]database.FileChunk, 0, len(canFlush))
 	allChunkFiles := make([]database.ChunkFile, 0, len(canFlush))
 	allFileIDs := make([]types.FileID, 0, len(canFlush))

internal/ui/ui.go

@@ -113,10 +113,7 @@ func shouldColor(w io.Writer) bool {
 		return false
 	}
 
-	// term.IsTerminal takes an int, and a file descriptor always fits in
-	// one on every platform Go supports; a closed file yields -1, which
-	// IsTerminal reports as not a terminal.
-	return term.IsTerminal(int(f.Fd())) //nolint:gosec // G115: fd fits in int
+	return term.IsTerminal(int(f.Fd()))
 }
 
 // ───────────────────────── message methods ─────────────────────────

internal/vaultik/verify.go

@@ -306,10 +306,6 @@ func (v *Vaultik) decryptAndLoadDatabase(reader io.ReadCloser) (*tempDB, error)
 		return nil, fmt.Errorf("failed to create temp file: %w", err)
 	}
 
-	// tempPath is generated by os.CreateTemp above and never derives from
-	// user input, but gosec's G703 taint analysis treats every path that
-	// originates from an *os.File as tainted, so the os.Remove calls
-	// below carry per-site nolint directives.
 	tempPath := tempFile.Name()
 
 	// Stream decompress directly to file
@@ -318,7 +314,7 @@ func (v *Vaultik) decryptAndLoadDatabase(reader io.ReadCloser) (*tempDB, error)
 	written, err := io.Copy(tempFile, decompressor)
 	if err != nil {
 		_ = tempFile.Close()
-		_ = os.Remove(tempPath) //nolint:gosec // G703: path from os.CreateTemp
+		_ = os.Remove(tempPath)
 
 		return nil, fmt.Errorf("failed to decompress database: %w", err)
 	}
@@ -330,7 +326,7 @@ func (v *Vaultik) decryptAndLoadDatabase(reader io.ReadCloser) (*tempDB, error)
 	// Open the database
 	db, err := sql.Open("sqlite", tempPath)
 	if err != nil {
-		_ = os.Remove(tempPath) //nolint:gosec // G703: path from os.CreateTemp
+		_ = os.Remove(tempPath)
 
 		return nil, fmt.Errorf("failed to open database: %w", err)
 	}