AGENTS.md@pkg/utils git:20260724.cb0170cA

Immutable. This exact content is served forever at /api/v1/blob/779c3220aa62dbd4.

# Utilities

General-purpose helpers with co-located tests.

## Entry points

Package root (`utils.go`, `file.go`, …) plus `reexec/`, `sets/`, `syncx/`.

## Non-obvious rules

- Prefer `*_test.go` per non-trivial `.go` file (`reexec/command_*.go` may share package tests)
- `CheckSingleton()` for thread-safe single init; `SignalHandler()` for SIGTERM/SIGINT (+ SIGHUP)
- Browser markdown: `MarkdownToSafeHTML` (not raw `MarkdownToHTML` + `templ.Raw`)

## Testing

```bash
go test ./pkg/utils/...
```