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 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 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 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, framework store, changelog, GHCR base images) and owns the geodro->lerd-env move: old org first, new as fallback, flipping on a new-org hit.

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

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 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 sitedoctor runs Laravel app-level health checks for a single site: APP_KEY, .env drift against .env.example, the APP_DEBUG-in-production footgun, the public/storage symlink, and pending migrations.

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.