Distillation

Date: Aug 24, 2026

• 🔴 (15:15) User asserted that pre-release relaxation in checkMinimalConfigVersion applies only to the current Craft version, never to the configured minVersion side.
• 🟡 (15:15) src/config.ts loadConfiguration() and loadConfigurationFromString(configContent) both validate YAML configuration, call checkMinimalConfigVersion(parsed), then cache applyWorkspaceSelection(parsed) in _configCache.
• 🟡 (15:15) checkMinimalConfigVersion(config) skips the compatibility check when config.minVersion is absent (debug message contains typo: skpipping); otherwise it obtains getPackageVersion(), parses configured and current versions with parseVersion(), throws on missing/unparseable versions, and throws ConfigurationError if current version is incompatible.
• 🟡 (15:15) checkMinimalConfigVersion currently normalizes only a pre-release current version into effectiveCurrentVersion by removing pre and build before calling versionGreaterOrEqualThan(effectiveCurrentVersion, minVersion); the compatibility error reports the original currentVersionRaw and minVersionRaw.
• 🟡 (15:15) requiresMinVersion(requiredVersion) obtains getConfiguration() and returns isVersionGteMinVersion(config.minVersion, requiredVersion). AUTO_VERSION_MIN_VERSION is '2.14.0'.
• 🟡 (15:15) Assistant identified that versionGreaterOrEqualThan rejects any build field and proposed normalizing both sides for compatibility comparisons, retaining major/minor/patch and pre-release state where relevant.