fix: add ref() macro override for dbt-core 1.11 compatibility (#2137)

* fix: add ref() macro override for dbt-core 1.11 compatibility

Some adapters (e.g. dbt-dremio) override the ref() Jinja macro with a
signature that doesn't support the two-argument positional form used for
cross-package references: ref('package', 'model').

dbt-dremio's ref(model_name, v=None) intercepts the second positional
arg as a version identifier, breaking refs like ref('elementary', 'dbt_models').

This override in the elementary_cli monitor project forwards all arguments
directly to builtins.ref(), which correctly handles all ref() forms in
dbt-core 1.11+. It also supports the legacy package= keyword form for
backward compatibility.

Co-Authored-By: Itamar Hartstein <haritamar@gmail.com>

* fix: handle combined cross-package + versioned refs for forward compatibility

Co-Authored-By: Itamar Hartstein <haritamar@gmail.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Itamar Hartstein <haritamar@gmail.com>

Author: devin-ai-integration[bot]

elementary/monitor/dbt_project/macros/overrides/ref.sql

@@ -0,0 +1,40 @@
+{#
+  Override adapter-specific ref() macros (e.g. dbt-dremio) that don't properly
+  handle the two-argument positional form: ref('package', 'model').
+
+  dbt-dremio's ref(model_name, v=None) intercepts the second positional arg as
+  a version identifier, breaking cross-package refs like ref('elementary', 'dbt_models').
+
+  This override forwards all arguments directly to builtins.ref(), which correctly
+  handles all ref() forms in dbt-core 1.11+:
+    - ref('model')                      -> single model lookup
+    - ref('package', 'model')           -> cross-package ref
+    - ref('model', v=1)                 -> versioned ref
+    - ref('model', version=1)           -> versioned ref (alias)
+    - ref('model', package='package')   -> cross-package ref (legacy keyword form)
+#}
+
+{%- macro ref(model_name_or_package, model_name=none, v=none, version=none, package=none) -%}
+  {%- set effective_version = v if v is not none else version -%}
+  {%- if model_name is not none -%}
+    {#- Two-arg positional: ref('package', 'model') -#}
+    {%- if effective_version is not none -%}
+      {%- do return(builtins.ref(model_name_or_package, model_name, v=effective_version)) -%}
+    {%- else -%}
+      {%- do return(builtins.ref(model_name_or_package, model_name)) -%}
+    {%- endif -%}
+  {%- elif package is not none -%}
+    {#- Legacy keyword: ref('model', package='pkg') -#}
+    {%- if effective_version is not none -%}
+      {%- do return(builtins.ref(package, model_name_or_package, v=effective_version)) -%}
+    {%- else -%}
+      {%- do return(builtins.ref(package, model_name_or_package)) -%}
+    {%- endif -%}
+  {%- elif effective_version is not none -%}
+    {#- Versioned: ref('model', v=1) or ref('model', version=1) -#}
+    {%- do return(builtins.ref(model_name_or_package, v=effective_version)) -%}
+  {%- else -%}
+    {#- Simple: ref('model') -#}
+    {%- do return(builtins.ref(model_name_or_package)) -%}
+  {%- endif -%}
+{%- endmacro -%}