internal/

Package analytics turns raw filesystem signals into the FS Janitor "Maintenance Score" and the storage-health report that headlines the dashboard.

Package app is FS Janitor's service layer: the single seam where the reused CleanX scanning/cleanup stack, the new job/engine/store/analytics modules, and the macOS probes are wired together into high-level operations.

Package appindex builds and holds the index of installed macOS applications that CleanX's detection engine consults to decide whether a Library item belongs to an app that is still present.

Package cleaner performs the actual deletion of selected leftover groups and reports how much space was reclaimed.

Package tui implements CleanX's Bubble Tea terminal UI, replacing the raw ANSI escape sequences of the reference script with a proper full-screen, terminal-agnostic interface.

Package cli defines FS Janitor's command-line interface: the scriptable surface that mirrors every TUI action, built on Cobra.

Package config holds the static configuration that drives CleanX's leftover detection: which directories to scan, which patterns to protect, how folder and bundle-ID names map to applications, and the age thresholds that gate deletion.

Package detect implements CleanX's leftover-attribution logic: given a filesystem component name (a folder, a plist, a bundle-ID directory) it decides whether that component belongs to a currently installed app, and whether it is a *confirmed leftover* of an uninstalled one.

Package duration parses and formats the compact, human-friendly retention and expiry durations that fs-janitor jobs are configured with (for example "expire after 30d" or "keep for 2w").

Package engine executes jobs against the filesystem.

Package humanize formats byte/kilobyte quantities for display in the CLI and TUI.

Package job defines the central domain object of FS Janitor: the Job.

Package launchd installs, uninstalls, and renders the macOS LaunchAgent that drives fs-janitor's periodic cleanup (the PRD's "Automation" module).

Package osprobe provides the production implementation of scan.Probes: the real filesystem and system interactions the scanner needs on macOS.

Package scan walks the configured Library and developer directories, applies CleanX's safety gates (installed / in-use / staleness, via package detect), and groups the surviving leftovers by vendor for presentation and deletion.

Package store is FS Janitor's persistence layer: an embedded SQLite database holding the user's jobs and the history of every run the engine performs.

Package tmutil lists and deletes local Time Machine snapshots via the macOS `tmutil` command.

Package toolclean discovers developer tools present on the machine and runs each tool's own cache-cleanup command (e.g.

Package trash implements fs-janitor's "safe by default" deletion: instead of permanently removing a file or folder, the target is moved to the macOS Trash so the user can recover it later (Finder's Put-Back restores it to its original location).

cleanup.go renders the Cleanup module: the reused CleanX scan surfaced as an interactive, sectioned multi-select inside the app shell.