addKVNodeIfNotEmpty adds a key-value node to the host if the value is not empty.

GetFieldPlaceholder returns an appropriate placeholder for a form field It returns either the default value, an example, or an empty string nolint:go

addDropDownWithHelp adds a dropdown field with help support

findOptionIndex finds the index of a value in options slice

createOptionsWithDefault creates dropdown options with default value indicated

validateField validates a single field and updates the validation state

addValidatedInputField adds an input field with real-time validation

addInputFieldWithHelp adds a regular input field with help support

SetError sets or clears an error for a field

showStatusTemp displays a temporary message in the status bar (default green) and then restores the default text.

showStatusTempColor displays a temporary colored message in the status bar and restores default text after 2s.

============================================================================= Internal Operations (perform actual work) ==============================

quoteIfNeeded returns the value quoted if it contains spaces.

addOption adds an SSH option in the format "-o Key=Value" if value is not empty

handleSave validates and saves the form, returns true if successful

GetErrorCount returns the number of validation errors

createAlgorithmAutocomplete creates an autocomplete function for algorithm input fields

escapeForTview escapes special characters for tview display

removeNodesByKey removes all nodes with the specified key from the nodes slice

convertCLIForwardToConfigFormat converts CLI format forwarding spec to SSH config format. CLI format: [bind_address:]port:host:hostport Config format:

getDefaultValues returns default form values based on mode

setupFormShortcuts sets up keyboard shortcuts for a form

updateHelp updates the help panel with information for the given field

Clear removes all validation errors

NewValidationState creates a new validation state

stripColorTags removes tview color tags from a string e.g., "[red]Port:[-]" becomes "Port:"

loadConfig reads and parses the SSH config file. If the file does not exist, it returns an empty config without error to support first-run behavior.

sortServersForUI sorts servers according to the rules required by the UI. Pinned servers are always at the top, ordered by pinned date (newest first).

validateBindAddress validates a bind address (IP, hostname, or *)

BuildSSHCommand constructs a ready-to-run ssh command for the given server. Format: ssh [options] [user@]host [command]

GetAvailableKnownHostsFiles returns a list of available known_hosts files in common locations. It safely handles file permission issues and only retur

GetAvailableSSHKeys returns a list of available SSH private key files in the user's .ssh directory. It safely handles file permission issues and only

GetFieldHelp returns help information for a specific field

HasErrors checks if there are any validation errors

convertConfigForwardToCLIFormat converts SSH config format forwarding spec to CLI format. Config format: [bind_address:]port host:hostport CLI format:

matchesSequence checks if all characters in pattern appear in sequence within text

saveConfig writes the SSH config back to the file with atomic operations and backup management.

GetAllErrors returns all validation errors in field order

GetFieldValidators returns validation rules for SSH configuration fields

GetSSHFieldDefault returns the default value for a given SSH field Returns empty string if no default is defined

addQuotedOption adds an SSH option with quoted value if needed

cellPad pads a string with spaces so its display width is at least `width` cells. This keeps emoji-based icons from breaking alignment in tview.

copyFile copies a file from src to dst

findHostByAlias finds a host by its alias in the SSH config.

hostContainsPattern checks if a host contains a specific pattern.

insertKVNodeAfterLastKV inserts a KV node immediately after the last existing KV node in the host. This preserves any trailing non-KV nodes (blank lin

makeTag returns a rectangular-looking colored chip for the given text.

serverExists checks if a server with the given alias already exists in the config.

stripColorTags removes tview color tags from a string

validateFilePaths validates multiple file paths with a custom separator

validateHost validates a hostname or IP address

validatePort validates port number

validateServer performs core validation of server fields.

GetAllCategories returns all available help categories

GetFieldsByCategory returns all fields in a specific category

GetNetworkInterfaces returns a list of available network interface names

New constructs a Sugared Logger that writes to a file and provides human-readable timestamps.