fix(rules): restore export compatibility

Accept the pre-rename MG4Tasker format marker and preserve all action fields during export. Include a disabled example rule set for safe review before activation.

Author: malys

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.4] - 2026-08-22
+
+### Fixed
+
+- Rule exports made before the MG4Tasker to EVTasker rename are importable again. The
+  importer accepts the former `mg4tasker-rules` format marker while new exports keep the
+  `evtasker-rules` marker.
+- Rule exports preserve action time ranges, webhook payloads and contact display names.
+
+### Added
+
+- An import-ready, disabled-by-default example set with useful rules for display brightness,
+  morning media volume and an Eco/high-regeneration parked start.
+
 ## [2.1.3] - 2026-08-22
 
 ### Fixed

README.md

@@ -563,6 +563,11 @@ refuses it whole rather than applying its first case alone.
 Renaming a `ConditionType` / `ActionType` constant therefore invalidates older files — the
 import reports the unknown entry rather than guessing.
 
+An import-ready [example rule set](examples/useful-rules.json) contains three broadly useful
+starting points. They are disabled on import so each driver can review the values before
+enabling them. Exports from the former MG4Tasker name (`mg4tasker-rules`) remain accepted;
+new exports always use `evtasker-rules`.
+
 ---
 
 ## Install

app/build.gradle.kts

@@ -10,8 +10,8 @@ android {
         applicationId = "com.evsuite.tasker"
         minSdk = 28
         targetSdk = 34
-        versionCode = 7
-        versionName = "2.1.3"
+        versionCode = 8
+        versionName = "2.1.4"
     }
 
     // EVTasker doit être signé avec la MÊME clé plateforme que EVProfile : c'est la seule

app/src/main/java/com/evsuite/tasker/store/RuleTransfer.kt

@@ -30,6 +30,9 @@ object RuleTransfer {
 
     const val FORMAT = "evtasker-rules"
 
+    /** Format written before MG4Tasker was renamed to EVTasker. Import remains compatible. */
+    private const val LEGACY_FORMAT = "mg4tasker-rules"
+
     /** The format this build writes and reads. Version 2 added the "else if" / "else" branches. */
     const val VERSION = 2
 
@@ -107,7 +110,11 @@ object RuleTransfer {
         type = action.type.name,
         number = action.number,
         flag = action.flag,
-        text = action.text
+        text = action.text,
+        payload = action.payload,
+        displayName = action.displayName,
+        minutesFrom = action.minutesFrom,
+        minutesTo = action.minutesTo
     )
 
     fun decode(json: String): Result {
@@ -119,7 +126,9 @@ object RuleTransfer {
             return Result.NotARulesFile
         } ?: return Result.NotARulesFile
 
-        if (envelope.format != FORMAT) return Result.NotARulesFile
+        if (envelope.format != FORMAT && envelope.format != LEGACY_FORMAT) {
+            return Result.NotARulesFile
+        }
 
         val version = envelope.version ?: return Result.Invalid(Reason.MALFORMED)
         if (version > VERSION) return Result.Invalid(Reason.VERSION)
@@ -262,6 +271,8 @@ object RuleTransfer {
                 number = raw.number ?: 0,
                 flag = raw.flag ?: true,
                 text = raw.text.orEmpty(),
+                payload = raw.payload,
+                displayName = raw.displayName,
                 minutesFrom = raw.minutesFrom ?: 0,
                 minutesTo = raw.minutesTo ?: 0
             )
@@ -318,6 +329,8 @@ object RuleTransfer {
         val number: Int? = null,
         val flag: Boolean? = null,
         val text: String? = null,
+        val payload: String? = null,
+        val displayName: String? = null,
         val minutesFrom: Int? = null,
         val minutesTo: Int? = null
     )

app/src/test/java/com/evsuite/tasker/store/RuleFilesTest.kt

@@ -112,4 +112,14 @@ class RuleFilesTest {
 
         assertEquals(RuleTransfer.Result.NotARulesFile, RuleFiles.read(other))
     }
+
+    @Test
+    fun `the bundled useful rules example is importable`() {
+        val example = File("../examples/useful-rules.json")
+
+        assertTrue(example.absolutePath, example.isFile)
+        val imported = RuleFiles.read(example) as RuleTransfer.Result.Ok
+        assertEquals(3, imported.rules.size)
+        assertTrue(imported.rules.all { !it.enabled })
+    }
 }

app/src/test/java/com/evsuite/tasker/store/RuleTransferTest.kt

@@ -49,13 +49,35 @@ class RuleTransferTest {
 
     @Test
     fun `round trip preserves every field`() {
-        val rules = listOf(rule(), rule(id = "r2", name = "Weekend"))
+        val rules = listOf(
+            rule().copy(
+                actions = listOf(
+                    Action(
+                        type = ActionType.WEBHOOK,
+                        text = "https://example.invalid/hook",
+                        payload = "{\"ready\":true}",
+                        displayName = "Example webhook",
+                        minutesFrom = 1320,
+                        minutesTo = 360
+                    )
+                )
+            ),
+            rule(id = "r2", name = "Weekend")
+        )
 
         val decoded = decodeOf(RuleTransfer.encode(rules))
 
         assertEquals(RuleTransfer.Result.Ok(rules), decoded)
     }
 
+    @Test
+    fun `an MG4Tasker export remains importable after the rename`() {
+        val legacy = RuleTransfer.encode(listOf(rule()))
+            .replace("\"format\":\"evtasker-rules\"", "\"format\":\"mg4tasker-rules\"")
+
+        assertEquals(RuleTransfer.Result.Ok(listOf(rule())), decodeOf(legacy))
+    }
+
     @Test
     fun `json from another app is not a rules file`() {
         assertEquals(RuleTransfer.Result.NotARulesFile, decodeOf("""{"some":"other file"}"""))

examples/useful-rules.json

@@ -0,0 +1,45 @@
+{
+  "format": "evtasker-rules",
+  "version": 1,
+  "rules": [
+    {
+      "id": "example-night-display",
+      "name": "Night: dim display",
+      "enabled": false,
+      "match": "ALL",
+      "conditions": [
+        { "type": "TIME_OF_DAY", "op": "EQ", "minutesFrom": 1200, "minutesTo": 390 }
+      ],
+      "actions": [
+        { "type": "SET_SCREEN_BRIGHTNESS", "number": 25 }
+      ]
+    },
+    {
+      "id": "example-quiet-morning",
+      "name": "Weekday morning: quiet media",
+      "enabled": false,
+      "match": "ALL",
+      "conditions": [
+        { "type": "TIME_OF_DAY", "op": "EQ", "minutesFrom": 360, "minutesTo": 540 },
+        { "type": "DAY_OF_WEEK", "op": "EQ", "days": [2, 3, 4, 5, 6] }
+      ],
+      "actions": [
+        { "type": "SET_MEDIA_VOLUME", "number": 8 }
+      ]
+    },
+    {
+      "id": "example-eco-start",
+      "name": "Parked start: Eco and high regen",
+      "enabled": false,
+      "match": "ALL",
+      "conditions": [
+        { "type": "IN_PARK", "op": "EQ", "flag": true },
+        { "type": "SPEED", "op": "EQ", "number": 0 }
+      ],
+      "actions": [
+        { "type": "SET_DRIVE_MODE", "number": 2 },
+        { "type": "SET_REGEN_LEVEL", "number": 2 }
+      ]
+    }
+  ]
+}