Merge branch '3.8-dev'

Author: spmallette

AGENTS.md

@@ -32,6 +32,7 @@ These rules apply to any AI/IDE assistant operating on this repository.
 - Update or add tests when behavior changes.
 - Update documentation and/or changelog when you change public behavior or APIs.
 - Follow existing patterns for code structure, documentation layout, and naming.
+- If code is ready, stop and ask to commit, push or merge manually.
 
 ### Don't
 
@@ -41,6 +42,9 @@ These rules apply to any AI/IDE assistant operating on this repository.
 - Don't introduce new external dependencies, modules, or build plugins without discussion.
 - Don't invent project policies, version numbers, or release names.
 - Don't remove or weaken tests to "fix" failures; adjust the implementation or test data instead.
+- Don't push to any branch.
+- Don't merge any PR or branch.
+- Don't create tags or releases.
 
 ### When In Doubt
 

docs/src/dev/developer/for-committers.asciidoc

@@ -437,6 +437,16 @@ value, causing the map pattern to consume part of the surrounding bracket syntax
 set-of-sets) and nesting of scalar types (vertices, edges, numbers, strings) inside lists or sets works as
 expected.
 
+When using this syntax, it is important to remember that lists and sets may contain other lists or sets as elements,
+allowing for nested collection notation such as `l[l[d[1].i,d[2].i],l[d[3].i,d[4].i]]`. The step definitions across all
+language variants parse these correctly by tracking bracket depth so that commas inside inner brackets are not treated
+as top-level separators. However, mixed-type nesting is not supported — a list or set may not contain a map as a direct
+element (e.g. `l[m[{"name":"marko"}]]` will not parse correctly). This limitation exists because the type notation
+matchers are applied in order using substring matching, and the `m[...]` matcher fires before `l[...]` on the outer
+value, causing the map pattern to consume part of the surrounding bracket syntax. Same-type nesting (list-of-lists,
+set-of-sets) and nesting of scalar types (vertices, edges, numbers, strings) inside lists or sets works as
+expected.
+
 In addition, parameter names should adhere to a common form as they hold some meaning to certain language variant
 implementations:
 

gremlin-test/src/main/resources/org/apache/tinkerpop/gremlin/language/translator/translations.json

@@ -23283,6 +23283,40 @@
             }
         ]
     },
+    {
+        "scenario": "g_injectXlist1_list2X_fold",
+        "traversals": [
+            {
+                "original": "g.inject([1, 2], [3, 4]).fold()",
+                "language": "g.inject([1, 2], [3, 4]).fold()",
+                "canonical": "g.inject([1, 2], [3, 4]).fold()",
+                "anonymized": "g.inject(list0, list1).fold()",
+                "dotnet": "g.Inject<object>(new List<object> { 1, 2 }, new List<object> { 3, 4 }).Fold()",
+                "go": "g.Inject([]interface{}{1, 2}, []interface{}{3, 4}).Fold()",
+                "groovy": "g.inject([1, 2], [3, 4]).fold()",
+                "java": "g.inject(new ArrayList<Object>() {{ add(1); add(2); }}, new ArrayList<Object>() {{ add(3); add(4); }}).fold()",
+                "javascript": "g.inject([1, 2], [3, 4]).fold()",
+                "python": "g.inject([1, 2], [3, 4]).fold()"
+            }
+        ]
+    },
+    {
+        "scenario": "g_injectXlist1_list2_list3X_fold",
+        "traversals": [
+            {
+                "original": "g.inject([1, 2], [3, 4], [5, 6]).fold()",
+                "language": "g.inject([1, 2], [3, 4], [5, 6]).fold()",
+                "canonical": "g.inject([1, 2], [3, 4], [5, 6]).fold()",
+                "anonymized": "g.inject(list0, list1, list2).fold()",
+                "dotnet": "g.Inject<object>(new List<object> { 1, 2 }, new List<object> { 3, 4 }, new List<object> { 5, 6 }).Fold()",
+                "go": "g.Inject([]interface{}{1, 2}, []interface{}{3, 4}, []interface{}{5, 6}).Fold()",
+                "groovy": "g.inject([1, 2], [3, 4], [5, 6]).fold()",
+                "java": "g.inject(new ArrayList<Object>() {{ add(1); add(2); }}, new ArrayList<Object>() {{ add(3); add(4); }}, new ArrayList<Object>() {{ add(5); add(6); }}).fold()",
+                "javascript": "g.inject([1, 2], [3, 4], [5, 6]).fold()",
+                "python": "g.inject([1, 2], [3, 4], [5, 6]).fold()"
+            }
+        ]
+    },
     {
         "scenario": "g_VX1X_formatXstrX",
         "traversals": [