feat: add min version of main app

Author: BolverBlitz

README.md

@@ -185,6 +185,7 @@ Each feature folder needs a `feature.json` or `config.json` manifest:
 {
   "name": "foodorders",
   "version": "0.0.1",
+  "minCoreVersion": "0.3.0",
   "navbar": {
     "insert": true,
     "href": "/foodorders",
@@ -202,7 +203,7 @@ Each feature folder needs a `feature.json` or `config.json` manifest:
 }
 ```
 
-On startup the app scans `installed_features/<featureName>`. Folder presence enables the feature. If the feature version is newer than `config/features/<featureName>.json`, or if the installed config does not exist yet, the feature files are copied into the application.
+On startup the app scans `installed_features/<featureName>`. Folder presence enables the feature. `minCoreVersion` defines the oldest compatible SimpleStrichliste version. Incompatible source versions are skipped and logged without stopping startup or replacing an already installed compatible version. If the feature version is newer than `config/features/<featureName>.json`, or if the installed config does not exist yet, the feature files are copied into the application.
 
 Supported feature folders include application folders such as `api`, `lib`, `src`, `views`, `public`, and `config`. A top-level `templates` folder is installed into `config/templates`. Feature page translations live in:
 

lib/features.js

@@ -7,13 +7,15 @@ const featureConfigDir = path.join(appRoot, 'config', 'features');
 const featureMigrationRoot = path.join(appRoot, 'migrations', 'features');
 const featureSeedRoot = path.join(appRoot, 'seeds', 'features');
 const localsMapPath = path.join(appRoot, 'config', 'locals_map.js');
+const coreVersion = require(path.join(appRoot, 'package.json')).version;
 
 const manifestCandidates = ['feature.json', 'config.json'];
 
 /**
  * @typedef {Object} FeatureManifest
  * @property {String} name Safe feature identifier used for settings, config files, and install paths.
  * @property {String} version Feature version used to decide whether an installed feature should be updated.
+ * @property {String} minCoreVersion Minimum SimpleStrichliste version required by the feature.
  * @property {Object} navbar Navbar metadata used when a feature adds a navigation entry.
  * @property {Object} adminCard Admin feature-card metadata for the admin overview.
  * @property {Object} db Database migration and seed file references.
@@ -108,6 +110,7 @@ const normalizeManifest = (manifest, fallbackName) => {
         ...manifest,
         name,
         version: manifest.version || '0.0.0',
+        minCoreVersion: manifest.minCoreVersion || '0.0.0',
         navbar: {
             insert: manifest.navbar?.insert === true,
             href: manifest.navbar?.href || `/${name}`,
@@ -167,6 +170,14 @@ const compareVersions = (left, right) => {
     return 0;
 };
 
+/**
+ * Checks whether a feature supports the currently running core application version.
+ * @param {FeatureManifest} manifest
+ * @returns {Boolean} True when the feature supports the running core version.
+ */
+const isCoreCompatible = (manifest) =>
+    compareVersions(coreVersion, manifest.minCoreVersion) >= 0;
+
 /**
  * Resolves a feature-provided relative install path and prevents writes outside the app root.
  * @param {String} relativePath Relative path from the application root.
@@ -296,6 +307,18 @@ const installFeatures = () => {
             ? normalizeManifest(readJsonFile(installedConfigPath), sourceManifest.name)
             : null;
 
+        if (!isCoreCompatible(sourceManifest)) {
+            const retainedVersion = currentManifest
+                ? ` Existing installed version ${currentManifest.version} remains active.`
+                : '';
+            process.log?.error?.(
+                `[FEATURES] Skipping ${sourceManifest.name}@${sourceManifest.version}: requires ` +
+                `SimpleStrichliste ${sourceManifest.minCoreVersion} or newer; running ${coreVersion}.` +
+                retainedVersion
+            );
+            return;
+        }
+
         if (currentManifest && compareVersions(sourceManifest.version, currentManifest.version) <= 0) {
             return;
         }
@@ -364,4 +387,5 @@ module.exports = {
     loadFeatureDefinitions,
     getFeaturePublicFilePath,
     compareVersions,
+    isCoreCompatible,
 };

test/features.test.js

@@ -0,0 +1,22 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+require('module-alias/register');
+
+const { isCoreCompatible } = require('@lib/features');
+
+test('features accept compatible minimum core versions', () => {
+    assert.equal(isCoreCompatible({
+        name: 'compatible',
+        version: '1.0.0',
+        minCoreVersion: '0.3.0',
+    }), true);
+});
+
+test('features reject newer minimum core versions', () => {
+    assert.equal(isCoreCompatible({
+        name: 'future-feature',
+        version: '1.0.0',
+        minCoreVersion: '999.0.0',
+    }), false);
+});