feat: add version pre-checks to executor commands before BSON writes

Add checkFeature() helper that queries the YAML registry and returns
actionable errors with version requirement, current version, and hint.

Pre-checks added to:
- CREATE VIEW ENTITY (requires 10.18+)
- CREATE PAGE with parameters (requires 11.0+)
- CREATE REST CLIENT (requires 10.1+)
- EXECUTE DATABASE QUERY (requires 10.6+, runtime connection 11.0+)

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

Author: ako

mdl/executor/cmd_entities.go

@@ -237,6 +237,13 @@ func (e *Executor) execCreateViewEntity(s *ast.CreateViewEntityStmt) error {
 		return fmt.Errorf("not connected to a project")
 	}
 
+	// Version pre-check
+	if err := e.checkFeature("domain_model", "view_entities",
+		"CREATE VIEW ENTITY",
+		"upgrade your project to 10.18+ or use a regular entity with a microflow data source"); err != nil {
+		return err
+	}
+
 	// Validate OQL syntax before creating the view entity
 	// This prevents creating view entities that will crash Studio Pro
 	if s.Query.RawQuery != "" {

mdl/executor/cmd_features.go

@@ -10,6 +10,40 @@ import (
 	"github.com/mendixlabs/mxcli/sdk/versions"
 )
 
+// checkFeature verifies that a feature is available in the connected project's
+// version. Returns nil if available, or an actionable error with the version
+// requirement and a hint. Safe to call when e.reader is nil (returns nil).
+func (e *Executor) checkFeature(area, name, statement, hint string) error {
+	if e.reader == nil {
+		return nil // No project connected; skip check
+	}
+	reg, err := versions.Load()
+	if err != nil {
+		return nil // Registry unavailable; don't block execution
+	}
+	rpv := e.reader.ProjectVersion()
+	pv := versions.SemVer{Major: rpv.MajorVersion, Minor: rpv.MinorVersion, Patch: rpv.PatchVersion}
+	if reg.IsAvailable(area, name, pv) {
+		return nil
+	}
+
+	// Find the min_version for the error message.
+	features := reg.FeaturesForVersion(versions.SemVer{Major: 99, Minor: 0, Patch: 0})
+	minV := "a newer version"
+	for _, f := range features {
+		if f.Area == area && f.Name == name {
+			minV = "Mendix " + f.MinVersion.String() + "+"
+			break
+		}
+	}
+
+	msg := fmt.Sprintf("%s requires %s (project is %s)", statement, minV, rpv.ProductVersion)
+	if hint != "" {
+		msg += "\n  hint: " + hint
+	}
+	return fmt.Errorf("%s", msg)
+}
+
 // execShowFeatures handles SHOW FEATURES, SHOW FEATURES FOR VERSION, and
 // SHOW FEATURES ADDED SINCE commands.
 func (e *Executor) execShowFeatures(s *ast.ShowFeaturesStmt) error {

mdl/executor/cmd_microflows_builder_calls.go

@@ -798,6 +798,18 @@ func (fb *flowBuilder) addSendRestRequestAction(s *ast.SendRestRequestStmt) mode
 
 // addExecuteDatabaseQueryAction creates an EXECUTE DATABASE QUERY statement.
 func (fb *flowBuilder) addExecuteDatabaseQueryAction(s *ast.ExecuteDatabaseQueryStmt) model.ID {
+	// Version pre-check: database connector requires 10.6+
+	if fb.reader != nil {
+		pv := fb.reader.ProjectVersion()
+		if !pv.IsAtLeast(10, 6) {
+			fb.addError("EXECUTE DATABASE QUERY requires Mendix 10.6+ (project is %s)\n  hint: upgrade your project to 10.6+", pv.ProductVersion)
+		}
+		// Runtime connection override requires 11.0+
+		if len(s.ConnectionArguments) > 0 && !pv.IsAtLeast(11, 0) {
+			fb.addError("EXECUTE DATABASE QUERY with runtime connection override requires Mendix 11.0+ (project is %s)", pv.ProductVersion)
+		}
+	}
+
 	// DynamicQuery is a Mendix expression — string literals need single quotes
 	dynamicQuery := s.DynamicQuery
 	if dynamicQuery != "" && !strings.HasPrefix(dynamicQuery, "'") {

mdl/executor/cmd_pages_create_v3.go

@@ -19,6 +19,15 @@ func (e *Executor) execCreatePageV3(s *ast.CreatePageStmtV3) error {
 		return fmt.Errorf("not connected to a project")
 	}
 
+	// Version pre-check: page parameters require 11.0+
+	if len(s.Parameters) > 0 {
+		if err := e.checkFeature("pages", "page_parameters",
+			"CREATE PAGE with parameters",
+			"pass data via a non-persistent entity or microflow parameter instead"); err != nil {
+			return err
+		}
+	}
+
 	// Find or auto-create module
 	module, err := e.findOrCreateModule(s.Name.Module)
 	if err != nil {

mdl/executor/cmd_rest_clients.go

@@ -216,6 +216,13 @@ func (e *Executor) createRestClient(stmt *ast.CreateRestClientStmt) error {
 		return fmt.Errorf("not connected to a project (read-only mode)")
 	}
 
+	// Version pre-check: REST clients require 10.1+
+	if err := e.checkFeature("integration", "rest_client_basic",
+		"CREATE REST CLIENT",
+		"upgrade your project to 10.1+"); err != nil {
+		return err
+	}
+
 	moduleName := stmt.Name.Module
 	module, err := e.findModule(moduleName)
 	if err != nil {