feat: add per-statement version gates for doctype integration tests

The nightly build fails on Mendix 10.24 because some MDL statements
use features unavailable in older versions (VIEW ENTITY, page
parameters, design properties, REST/DB connector BSON format).

Add a -- @Version: directive system that gates individual sections
within MDL test scripts by Mendix version:

  -- @Version: 11.0+          (minimum version)
  -- @Version: 10.6..10.24    (version range)
  -- @Version: ..10.24        (maximum version)
  -- @Version: any            (reset to unconditional)

The test runner preprocesses MDL content before parsing, stripping
lines in sections that don't match the project's Mendix version.
Line numbers are preserved (replaced with blank lines) for error
attribution.

Gated sections in doctype scripts:
- 01-domain-model: VIEW ENTITY sections (11.0+)
- 02-microflow: page parameter pages/microflows (11.0+)
- 03-page: pages with Params blocks (11.0+)
- 05-database-connection: entire file (11.0+)
- 06-rest-client: entire file (11.0+)
- 12-styling: Atlas v3 design properties (11.0+)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

mdl-examples/doctype-tests/01-domain-model-examples.mdl

@@ -699,8 +699,9 @@ TYPE ReferenceSet
 OWNER Both;
 /
 
+-- @version: 11.0+
 -- ############################################################################
--- PART 7: VIEW ENTITIES (OQL)
+-- PART 7: VIEW ENTITIES (OQL) — requires Mendix 11.0+
 -- ############################################################################
 
 -- MARK: View Entities
@@ -895,6 +896,7 @@ BEGIN
 END;
 /
 
+-- @version: any
 -- ############################################################################
 -- PART 8: NON-PERSISTENT ENTITIES
 -- ############################################################################
@@ -1233,8 +1235,9 @@ CREATE OR MODIFY NON-PERSISTENT ENTITY DmTest.FilterParameters (
 );
 /
 
+-- @version: 11.0+
 -- ============================================================================
--- Level 9.5: CREATE OR MODIFY for View Entity
+-- Level 9.5: CREATE OR MODIFY for View Entity — requires Mendix 11.0+
 -- ============================================================================
 --
 -- View entities can also use CREATE OR MODIFY to update their definition.
@@ -1307,6 +1310,7 @@ CREATE OR MODIFY VIEW ENTITY DmTest.ActiveConfigs (
   WHERE c.IsActive = true;
 /
 
+-- @version: any
 -- ############################################################################
 -- PART 10: ALTER ENTITY (Incremental Schema Changes)
 -- ############################################################################
@@ -1449,8 +1453,9 @@ ALTER ENTITY DmTest.VATRate
 ALTER ENTITY DmTest.VATRate
   SET POSITION (300, 400);
 
+-- @version: 11.0+
 -- ============================================================================
--- PART 11: COMPLEX VIEW ENTITIES WITH SUBQUERIES
+-- PART 11: COMPLEX VIEW ENTITIES WITH SUBQUERIES — requires Mendix 11.0+
 -- ============================================================================
 -- Demonstrates advanced OQL features including:
 --   - Inline subqueries (derived tables)
@@ -1603,6 +1608,7 @@ move entity DmTest.ActiveConfigs to DmTest3;
 show entities in DmTest2;
 show enumerations in DmTest3;
 
+-- @version: any
 -- ############################################################################
 -- PART 12: ENTITY GENERALIZATION (INHERITANCE)
 -- ############################################################################

mdl-examples/doctype-tests/02-microflow-examples.mdl

@@ -2575,8 +2575,9 @@ BEGIN
 END;
 /
 
+-- @version: 11.0+
 /**
- * Helper page for M090.
+ * Helper page for M090 — requires Mendix 11.0+ (page parameters).
  */
 CREATE PAGE MfTest.ProductDetail
 (
@@ -2619,6 +2620,7 @@ BEGIN
 END;
 /
 
+-- @version: any
 /**
  * M091: Annotations on VALIDATION FEEDBACK activity.
  */

mdl-examples/doctype-tests/03-page-examples.mdl

@@ -251,7 +251,8 @@ CREATE PAGE PgTest.P005_OrderEdit
   }
 }
 
--- MARK: DATA FORM
+-- @version: 11.0+
+-- MARK: DATA FORM — requires Mendix 11.0+ (page parameters)
 
 /**
  * Edit customer form

mdl-examples/doctype-tests/05-database-connection-examples.mdl

@@ -1,5 +1,6 @@
+-- @version: 11.0+
 -- ============================================================================
--- Database Connection Examples - Formula 1 Database
+-- Database Connection Examples - Formula 1 Database (requires Mendix 11.0+)
 -- ============================================================================
 --
 -- This file demonstrates CREATE DATABASE CONNECTION features using

mdl-examples/doctype-tests/06-rest-client-examples.mdl

@@ -1,5 +1,6 @@
+-- @version: 11.0+
 -- ============================================================================
--- REST Client Examples - Consumed REST Service Showcase
+-- REST Client Examples - Consumed REST Service Showcase (requires Mendix 11.0+)
 -- ============================================================================
 --
 -- This file demonstrates REST client features supported by the Mendix REPL,

mdl-examples/doctype-tests/12-styling-examples.mdl

@@ -134,7 +134,8 @@ CREATE PAGE StyleTest.P002_Inline_Styles
   }
 }
 
--- MARK: DesignProperties
+-- @version: 11.0+
+-- MARK: DesignProperties — requires Mendix 11.0+ (Atlas v3 design properties)
 
 -- ============================================================================
 -- LEVEL 3: Design Properties (Atlas UI structured properties)

mdl/executor/roundtrip_doctype_test.go

@@ -5,15 +5,18 @@
 package executor
 
 import (
+	"fmt"
 	"os"
 	"os/exec"
 	"path/filepath"
 	"sort"
+	"strconv"
 	"strings"
 	"testing"
 
 	"github.com/mendixlabs/mxcli/mdl/ast"
 	"github.com/mendixlabs/mxcli/mdl/visitor"
+	"github.com/mendixlabs/mxcli/sdk/mpr/version"
 )
 
 // scriptModuleDeps maps script filenames to marketplace module MPKs they require.
@@ -129,8 +132,15 @@ func TestMxCheck_DoctypeScripts(t *testing.T) {
 				}
 			}
 
+			// Filter out version-gated sections that don't match this project's Mendix version
+			pv := env.executor.reader.ProjectVersion()
+			filtered, skippedLines := filterByVersion(string(content), pv)
+			if skippedLines > 0 {
+				t.Logf("Mendix %s: skipped %d version-gated lines", pv.ProductVersion, skippedLines)
+			}
+
 			// Execute the script
-			prog, errs := visitor.Build(string(content))
+			prog, errs := visitor.Build(filtered)
 			if len(errs) > 0 {
 				t.Fatalf("Parse error: %v", errs[0])
 			}
@@ -192,3 +202,131 @@ func allErrorsKnown(output string, knownCodes []string) bool {
 	}
 	return true
 }
+
+// versionConstraint represents a min/max Mendix version range for -- @version: directives.
+type versionConstraint struct {
+	minMajor, minMinor int // -1 means no minimum
+	maxMajor, maxMinor int // -1 means no maximum
+}
+
+// matches returns true if the project version satisfies this constraint.
+func (vc *versionConstraint) matches(pv *version.ProjectVersion) bool {
+	if vc.minMajor >= 0 {
+		if !pv.IsAtLeast(vc.minMajor, vc.minMinor) {
+			return false
+		}
+	}
+	if vc.maxMajor >= 0 {
+		// Check that version is at most maxMajor.maxMinor
+		if pv.MajorVersion > vc.maxMajor || (pv.MajorVersion == vc.maxMajor && pv.MinorVersion > vc.maxMinor) {
+			return false
+		}
+	}
+	return true
+}
+
+func (vc *versionConstraint) String() string {
+	if vc.minMajor >= 0 && vc.maxMajor >= 0 {
+		return fmt.Sprintf("%d.%d..%d.%d", vc.minMajor, vc.minMinor, vc.maxMajor, vc.maxMinor)
+	}
+	if vc.minMajor >= 0 {
+		return fmt.Sprintf("%d.%d+", vc.minMajor, vc.minMinor)
+	}
+	if vc.maxMajor >= 0 {
+		return fmt.Sprintf("..%d.%d", vc.maxMajor, vc.maxMinor)
+	}
+	return "any"
+}
+
+// parseVersionDirective parses a "-- @version: <constraint>" line.
+// Returns nil for "any" or unparseable directives.
+// Formats: "11.0+", "10.6..10.24", "..10.24", "any"
+func parseVersionDirective(line string) *versionConstraint {
+	s := strings.TrimPrefix(line, "-- @version:")
+	s = strings.TrimSpace(s)
+
+	if s == "" || s == "any" {
+		return nil
+	}
+
+	// Range: "10.6..10.24"
+	if parts := strings.SplitN(s, "..", 2); len(parts) == 2 {
+		vc := &versionConstraint{minMajor: -1, minMinor: -1, maxMajor: -1, maxMinor: -1}
+		if parts[0] != "" {
+			major, minor, ok := parseMajorMinor(parts[0])
+			if !ok {
+				return nil
+			}
+			vc.minMajor, vc.minMinor = major, minor
+		}
+		if parts[1] != "" {
+			major, minor, ok := parseMajorMinor(parts[1])
+			if !ok {
+				return nil
+			}
+			vc.maxMajor, vc.maxMinor = major, minor
+		}
+		return vc
+	}
+
+	// Minimum: "11.0+"
+	if strings.HasSuffix(s, "+") {
+		s = strings.TrimSuffix(s, "+")
+		major, minor, ok := parseMajorMinor(s)
+		if !ok {
+			return nil
+		}
+		return &versionConstraint{minMajor: major, minMinor: minor, maxMajor: -1, maxMinor: -1}
+	}
+
+	return nil
+}
+
+// parseMajorMinor parses "10.24" into (10, 24, true).
+func parseMajorMinor(s string) (int, int, bool) {
+	parts := strings.SplitN(s, ".", 2)
+	if len(parts) != 2 {
+		return 0, 0, false
+	}
+	major, err := strconv.Atoi(parts[0])
+	if err != nil {
+		return 0, 0, false
+	}
+	minor, err := strconv.Atoi(parts[1])
+	if err != nil {
+		return 0, 0, false
+	}
+	return major, minor, true
+}
+
+// filterByVersion removes MDL content sections that don't match the project's Mendix version.
+// Sections are delimited by "-- @version: <constraint>" directives.
+// A directive applies to all following lines until the next directive or end of file.
+// "-- @version: any" resets to unconditional inclusion.
+func filterByVersion(content string, pv *version.ProjectVersion) (string, int) {
+	var result strings.Builder
+	var currentConstraint *versionConstraint // nil = no constraint (always include)
+	skippedLines := 0
+
+	for _, line := range strings.Split(content, "\n") {
+		trimmed := strings.TrimSpace(line)
+		if strings.HasPrefix(trimmed, "-- @version:") {
+			currentConstraint = parseVersionDirective(trimmed)
+			// Keep the directive line as a comment (so line numbers stay close)
+			result.WriteString(line)
+			result.WriteString("\n")
+			continue
+		}
+		if currentConstraint == nil || currentConstraint.matches(pv) {
+			result.WriteString(line)
+			result.WriteString("\n")
+		} else {
+			// Replace with empty line to preserve line numbering for error messages
+			result.WriteString("\n")
+			if strings.TrimSpace(line) != "" && !strings.HasPrefix(trimmed, "--") {
+				skippedLines++
+			}
+		}
+	}
+	return result.String(), skippedLines
+}