installer-compatibility

Pure verdict on whether a resolved (Obsidian app, installer) version pair is compatible, computed offline from the metadata.json thresholds. Kept separate from the integration-only transport-factory (which drives real downloads/launches and is excluded from unit tests) so the tier logic stays unit-testable — mirroring the renderer-boot-detection split.

Two thresholds drive the verdict, both installer versions directly comparable to the resolved installer/shell version:

minRunnableInstallerVersion — the run floor. Below it the app cannot boot ('unrunnable'); the caller turns this into a proactive IncompatibleInstallerVersionError before any download/launch — unless the caller has disabled the proactive throw (shouldThrowOnIncompatibleInstaller false), in which case the boot proceeds and the reactive dead-boot fast-fail catches it. - minRecommendedInstallerVersion — the recommended floor (older versions only). At/above the run floor but below this, the app runs but is below Obsidian’s recommendation ('nagged'), surfaced as a warning.

When the installer version is unknown (e.g. an undetectable Linux shell) or the app version is absent from the table, the verdict is 'unknown' and nothing is thrown or warned — the reactive dead-boot fast-fail remains the safety net.

Interfaces

Interface	Description
InstallerCompatibility	The compatibility verdict for a resolved (app, installer) version pair, carried as data on the transport / connection result so consumers can assert on it.
ResolveInstallerCompatibilityParams	Parameters for resolveInstallerCompatibility.

Functions

Function	Description
resolveInstallerCompatibility	Computes the compatibility verdict for a resolved (app, installer) version pair. Only `'unrunnable'` warrants an error; `'nagged'` warrants a warning; `'ok'` and `'unknown'` are silent. Comparisons are pure `x.y.z` version compares — no I/O.

Types

Type Description

InstallerCompatibilityTier The compatibility tier of a resolved (app, installer) version pair. - 'ok' — the installer is at or above the recommended floor (or no recommended floor is known); runs with full compatibility. - 'nagged' — at/above the run floor but below the recommended floor; runs but Obsidian would show its “installer too old” recommendation. - 'unrunnable' — below the run floor; the app cannot boot on this installer. - 'unknown' — cannot be determined (installer version unknown, or the app version is absent from the table).

Type	Description
InstallerCompatibilityTier	The compatibility tier of a resolved (app, installer) version pair. - `'ok'` — the installer is at or above the recommended floor (or no recommended floor is known); runs with full compatibility. - `'nagged'` — at/above the run floor but below the recommended floor; runs but Obsidian would show its “installer too old” recommendation. - `'unrunnable'` — below the run floor; the app cannot boot on this installer. - `'unknown'` — cannot be determined (installer version unknown, or the app version is absent from the table).