internal/

Package activityping is the host-side client for the lerd-watcher's idle control socket: it keeps a worked-on site awake under idle-suspend and asks the watcher to resume all suspended workers when the feature is switched off.

Package agentenv forwards AI coding-agent detection variables across the container boundary so tools like laravel/pao (via laravel/agent-detector) still switch to JSON output when run through `lerd php`, tinker, or MCP.

Package cfgedit is a small service for editing user-owned config files that lerd seeds but never overwrites (per-site nginx overrides, the global http-level nginx override, php.ini overrides).

Package cleanup reclaims podman disk lerd's own image rebuilds leave behind.

Package composer holds settings shared by every code path that runs composer inside a lerd FPM container — the `lerd composer` CLI and the MCP composer tools alike — so they stay consistent.

Package devtoolsops contains the shared logic for toggling the lerd_devtools collector.

Package dumps receives, buffers, and fans out PHP `dump()`/`dd()` events captured by the lerd debug bridge (auto_prepend_file).

Package dumpsops contains the shared business logic for toggling the lerd debug bridge.

Package envfile provides helpers for reading and updating .env files while preserving comments, blank lines, and line order.

Package eventbus is an in-process pub/sub hub for UI state-change events.

Package feedback renders lerd's CLI progress output (animated steps, a live line, summaries, prompts, warnings) and owns the shared lerd colour palette.

Package freeport provides a shared, dependency-free TCP host-port allocator: a dual-stack bindability probe and a predicate-injected free-port search.

Package grouping manages site groups: a main site that owns a base domain and one or more secondary sites that each occupy a chosen subdomain label of that base domain (e.g.

Package idle implements activity-driven worker suspension: it tracks when each site was last active and (later) suspends a quiet site's suspendable workers, resuming them on the next activity.

Package imgledger records the container image refs lerd itself pulled.

Package logsource gives a single, filtered view over every log lerd can reach: framework application log files, PHP-FPM/nginx/dns/service container stdout, and worker/watcher/ui units (systemd journal on Linux, launchd log files on macOS).

Package origin centralises every URL lerd fetches its own assets from: release binaries, the framework and service stores, the changelog, and the GHCR base images.

Package phpantom manages the phpantom_lsp PHP language server binary that powers tinker autocomplete, diagnostics, and hover in the web UI.

Package presetfixtures embeds the add-on service presets that ship in the external lerd-env/services store rather than the binary, and exposes them as an fs.FS.

Package profiler turns the SPX profiler on or off globally.

Package push owns Web Push plumbing: per-install VAPID keys, browser subscription store, and the encrypted POST that wakes a service worker when the notifier dispatches a new event.

Package registry queries OCI registries for available tags so lerd can surface "update available" badges and apply minor/patch updates to default services.

Package reqstats turns the nginx access feed into a per-site view of request timing: the typical response time and the routes that run well above their own baseline.

Package serviceops contains the shared business logic for installing, starting, stopping, and removing lerd services.

Package services provides a platform-agnostic abstraction over the underlying service manager (systemd on Linux, launchd on macOS).

Package shims is the single owner of the client-tool host shims that lerd services expose (mysqldump, pg_dump, psql…): the tri-state install decisions, host-conflict detection, script generation, and the reconcile that brings the shim dir in line with the installed services.

Package sitedoctor runs app-level health checks for a single site.

Package spxreport reads the SPX profiler's on-disk captures and distills each into a handful of timing outliers.

Package stats reads cheap per-container resource usage via `podman stats` and exposes a structured view both lerd-ui (for the dashboard widget) and the TUI (for its Dashboard pane) can share.

Package-level UI helpers: small render primitives that don't fit cleanly into any one feature module.

Package unitlog centralises how lerd locates a unit's logs across platforms: whether a unit runs as a detached podman container (logs via `podman logs`) versus a launchd-supervised service on macOS (logs in ~/Library/Logs/lerd), and the framework-worker classification both decisions lean on.

Package version holds build-time version information injected via ldflags.

Package workerheal detects and recovers worker units stuck in systemd's "failed" state.

Package wsl holds the WSL2-specific detection and config-patching logic that `lerd wsl:setup` and the doctor's WSL checks share.

Package xdebugops contains the shared business logic for toggling Xdebug on a PHP version: mode validation, config persistence, ini write, FPM quadlet update, and unit restart.