From 06bb1a744d0240b4bde7b6a3168d388aa43dc405 Mon Sep 17 00:00:00 2001
From: Charles Oliver Nutter <headius@headius.com>
Date: Wed, 30 Sep 2026 01:05:28 -0500
Subject: [PATCH 1/4] Update jffi dependency scope to 'provided'

JFFI should not be a hard dependency of Redline, because that disallows having the version float in projects that utilize Redline like JRuby. Moving this to "provided" makes the dependency soft, expecting that Redline users will "provide" JFFI at an appropriate level.

This was previously fixed for Redline in https://github.com/roastedroot/chicory-redline/pull/20 but it appears to have gotten lost along the way.
---
 redline/runner-jffi/pom.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/redline/runner-jffi/pom.xml b/redline/runner-jffi/pom.xml
index 19da77872..1e29c0035 100644
--- a/redline/runner-jffi/pom.xml
+++ b/redline/runner-jffi/pom.xml
@@ -17,6 +17,7 @@
     <dependency>
       <groupId>com.github.jnr</groupId>
       <artifactId>jffi</artifactId>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>run.endive</groupId>
@@ -38,7 +39,7 @@
       <groupId>com.github.jnr</groupId>
       <artifactId>jffi</artifactId>
       <classifier>native</classifier>
-      <scope>runtime</scope>
+      <scope>provided</scope>
     </dependency>
   </dependencies>
 </project>

From 29c9826bd2a46eb087c76aca0f9c43c5d384875f Mon Sep 17 00:00:00 2001
From: andreatp <andrea.peruffo1982@gmail.com>
Date: Wed, 30 Sep 2026 13:20:37 +0100
Subject: [PATCH 2/4] Declare jffi explicitly where the JFFI runner is used

With jffi in provided scope, the dependency analyzer flags the native
classifier jar as unused, since it has no classes. Its pattern filter
cannot match a classifier, so exempt com.github.jnr:jffi in
runner-jffi; the main jar is genuinely used there.

Provided is not transitive, so runner-jffi-tests and the redline-e2e
IT now declare jffi and jffi:native themselves; without them the IT
fails with NoClassDefFoundError: com/kenai/jffi/MemoryIO.

Document that jffi users add both artifacts, and that a missing jffi
is an error rather than a silent fallback.
---
 docs/docs/experimental/redline.md     | 26 ++++++++++++++++++++++++--
 redline/it/src/it/redline-e2e/pom.xml | 15 +++++++++++++--
 redline/runner-jffi-tests/pom.xml     | 20 ++++++++++++++++++++
 redline/runner-jffi/pom.xml           | 24 +++++++++++++++++++-----
 4 files changed, 76 insertions(+), 9 deletions(-)

diff --git a/docs/docs/experimental/redline.md b/docs/docs/experimental/redline.md
index c43929162..74ede4c27 100644
--- a/docs/docs/experimental/redline.md
+++ b/docs/docs/experimental/redline.md
@@ -96,7 +96,28 @@ versions use `redline-runner-jffi-experimental`, which needs only Java 11:
 </dependency>
 ```
 
-If both are present, the Panama runner is used wherever the JDK supports it.
+The jffi runner does not bring in [jffi](https://github.com/jnr/jffi) itself, so its version can
+follow the rest of your application. Add it next to the runner, together with its native
+libraries:
+
+```xml
+<dependency>
+  <groupId>com.github.jnr</groupId>
+  <artifactId>jffi</artifactId>
+  <version>${jffi.version}</version>
+</dependency>
+<dependency>
+  <groupId>com.github.jnr</groupId>
+  <artifactId>jffi</artifactId>
+  <version>${jffi.version}</version>
+  <classifier>native</classifier>
+</dependency>
+```
+
+Without them, `builder()` fails with `NoClassDefFoundError: com/kenai/jffi/MemoryIO` instead of
+falling back.
+
+If both runners are present, the Panama runner is used wherever the JDK supports it.
 
 Your module is then used exactly as it would be without redline:
 
@@ -110,7 +131,8 @@ try (var instance = MyModule.builder().build()) {
 
 When native code cannot be used, `builder()` falls back to the bytecode produced by the
 [Build Time Compiler](../execution/build-time-compiler.md), which is always generated alongside it.
-This happens on platforms outside the table above, or when no runner is on the classpath.
+This happens on platforms outside the table above, or when no runner is on the classpath. A jffi
+runner without jffi is an error, not a fallback.
 
 Your module keeps working either way, so the fallback is silent. To check which one you got:
 
diff --git a/redline/it/src/it/redline-e2e/pom.xml b/redline/it/src/it/redline-e2e/pom.xml
index b6b1a7a47..3932dfe0a 100644
--- a/redline/it/src/it/redline-e2e/pom.xml
+++ b/redline/it/src/it/redline-e2e/pom.xml
@@ -8,8 +8,19 @@
   <packaging>jar</packaging>
 
   <dependencies>
-    <!-- The only dependency a consumer needs. It brings in redline-api (used by
-         the generated builder), runtime and wasm transitively. -->
+    <!-- What a consumer needs: jffi, which the runner declares as provided, and the
+         runner, which brings in redline-api, runtime and wasm transitively. -->
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <version>@jffi.version@</version>
+    </dependency>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <version>@jffi.version@</version>
+      <classifier>native</classifier>
+    </dependency>
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-runner-jffi-experimental</artifactId>
diff --git a/redline/runner-jffi-tests/pom.xml b/redline/runner-jffi-tests/pom.xml
index 3c4a56fcc..df72e2c3c 100644
--- a/redline/runner-jffi-tests/pom.xml
+++ b/redline/runner-jffi-tests/pom.xml
@@ -18,6 +18,17 @@
   </properties>
 
   <dependencies>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <classifier>native</classifier>
+      <scope>test</scope>
+    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
@@ -67,6 +78,15 @@
 
   <build>
     <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <configuration>
+          <ignoredUnusedDeclaredDependencies combine.children="append">
+            <dependency>com.github.jnr:jffi</dependency>
+          </ignoredUnusedDeclaredDependencies>
+        </configuration>
+      </plugin>
       <plugin>
         <groupId>run.endive</groupId>
         <artifactId>test-gen-plugin</artifactId>
diff --git a/redline/runner-jffi/pom.xml b/redline/runner-jffi/pom.xml
index 1e29c0035..9d94b82db 100644
--- a/redline/runner-jffi/pom.xml
+++ b/redline/runner-jffi/pom.xml
@@ -14,11 +14,6 @@
   <description>Native code execution via JFFI (Java 11+)</description>
 
   <dependencies>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <scope>provided</scope>
-    </dependency>
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-api-experimental</artifactId>
@@ -35,6 +30,11 @@
       <groupId>run.endive</groupId>
       <artifactId>wasm</artifactId>
     </dependency>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <scope>provided</scope>
+    </dependency>
     <dependency>
       <groupId>com.github.jnr</groupId>
       <artifactId>jffi</artifactId>
@@ -42,4 +42,18 @@
       <scope>provided</scope>
     </dependency>
   </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-dependency-plugin</artifactId>
+        <configuration>
+          <ignoredUnusedDeclaredDependencies combine.children="append">
+            <dependency>com.github.jnr:jffi</dependency>
+          </ignoredUnusedDeclaredDependencies>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
 </project>

From 2887a771bf53933c1c96dcffe869d38d8f24371f Mon Sep 17 00:00:00 2001
From: andreatp <andrea.peruffo1982@gmail.com>
Date: Thu, 1 Oct 2026 10:19:46 +0100
Subject: [PATCH 3/4] Keep jffi transitive and mark the runner provided in
 libraries

Restore jffi to its normal scopes in redline-runner-jffi, so an
application that adds the runner gets jffi with it, and drop the
analyzer exclusion and the explicit jffi dependencies that the
provided scope required.

The version conflict comes from libraries such as prism-parser-wasm
depending on the runner at compile scope, which forces their jffi
version on applications like JRuby. Document that libraries declare
the runner as provided, so the application picks the runner and jffi.
---
 docs/docs/experimental/redline.md     | 29 +++++++++------------------
 redline/it/src/it/redline-e2e/pom.xml | 15 ++------------
 redline/runner-jffi-tests/pom.xml     | 20 ------------------
 redline/runner-jffi/pom.xml           | 25 +++++------------------
 4 files changed, 17 insertions(+), 72 deletions(-)

diff --git a/docs/docs/experimental/redline.md b/docs/docs/experimental/redline.md
index 74ede4c27..20be4ec81 100644
--- a/docs/docs/experimental/redline.md
+++ b/docs/docs/experimental/redline.md
@@ -96,29 +96,21 @@ versions use `redline-runner-jffi-experimental`, which needs only Java 11:
 </dependency>
 ```
 
-The jffi runner does not bring in [jffi](https://github.com/jnr/jffi) itself, so its version can
-follow the rest of your application. Add it next to the runner, together with its native
-libraries:
+If both are present, the Panama runner is used wherever the JDK supports it.
+
+If you publish a library rather than an application, declare the runner as `provided`. The
+application using your library then picks the runner, and with it the jffi version, instead of
+inheriting yours:
 
 ```xml
 <dependency>
-  <groupId>com.github.jnr</groupId>
-  <artifactId>jffi</artifactId>
-  <version>${jffi.version}</version>
-</dependency>
-<dependency>
-  <groupId>com.github.jnr</groupId>
-  <artifactId>jffi</artifactId>
-  <version>${jffi.version}</version>
-  <classifier>native</classifier>
+  <groupId>run.endive</groupId>
+  <artifactId>redline-runner-jffi-experimental</artifactId>
+  <version>${endive.version}</version>
+  <scope>provided</scope>
 </dependency>
 ```
 
-Without them, `builder()` fails with `NoClassDefFoundError: com/kenai/jffi/MemoryIO` instead of
-falling back.
-
-If both runners are present, the Panama runner is used wherever the JDK supports it.
-
 Your module is then used exactly as it would be without redline:
 
 ```text
@@ -131,8 +123,7 @@ try (var instance = MyModule.builder().build()) {
 
 When native code cannot be used, `builder()` falls back to the bytecode produced by the
 [Build Time Compiler](../execution/build-time-compiler.md), which is always generated alongside it.
-This happens on platforms outside the table above, or when no runner is on the classpath. A jffi
-runner without jffi is an error, not a fallback.
+This happens on platforms outside the table above, or when no runner is on the classpath.
 
 Your module keeps working either way, so the fallback is silent. To check which one you got:
 
diff --git a/redline/it/src/it/redline-e2e/pom.xml b/redline/it/src/it/redline-e2e/pom.xml
index 3932dfe0a..b6b1a7a47 100644
--- a/redline/it/src/it/redline-e2e/pom.xml
+++ b/redline/it/src/it/redline-e2e/pom.xml
@@ -8,19 +8,8 @@
   <packaging>jar</packaging>
 
   <dependencies>
-    <!-- What a consumer needs: jffi, which the runner declares as provided, and the
-         runner, which brings in redline-api, runtime and wasm transitively. -->
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <version>@jffi.version@</version>
-    </dependency>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <version>@jffi.version@</version>
-      <classifier>native</classifier>
-    </dependency>
+    <!-- The only dependency a consumer needs. It brings in redline-api (used by
+         the generated builder), runtime and wasm transitively. -->
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-runner-jffi-experimental</artifactId>
diff --git a/redline/runner-jffi-tests/pom.xml b/redline/runner-jffi-tests/pom.xml
index df72e2c3c..3c4a56fcc 100644
--- a/redline/runner-jffi-tests/pom.xml
+++ b/redline/runner-jffi-tests/pom.xml
@@ -18,17 +18,6 @@
   </properties>
 
   <dependencies>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <scope>test</scope>
-    </dependency>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <classifier>native</classifier>
-      <scope>test</scope>
-    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
@@ -78,15 +67,6 @@
 
   <build>
     <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-dependency-plugin</artifactId>
-        <configuration>
-          <ignoredUnusedDeclaredDependencies combine.children="append">
-            <dependency>com.github.jnr:jffi</dependency>
-          </ignoredUnusedDeclaredDependencies>
-        </configuration>
-      </plugin>
       <plugin>
         <groupId>run.endive</groupId>
         <artifactId>test-gen-plugin</artifactId>
diff --git a/redline/runner-jffi/pom.xml b/redline/runner-jffi/pom.xml
index 9d94b82db..19da77872 100644
--- a/redline/runner-jffi/pom.xml
+++ b/redline/runner-jffi/pom.xml
@@ -14,6 +14,10 @@
   <description>Native code execution via JFFI (Java 11+)</description>
 
   <dependencies>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+    </dependency>
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-api-experimental</artifactId>
@@ -30,30 +34,11 @@
       <groupId>run.endive</groupId>
       <artifactId>wasm</artifactId>
     </dependency>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-      <scope>provided</scope>
-    </dependency>
     <dependency>
       <groupId>com.github.jnr</groupId>
       <artifactId>jffi</artifactId>
       <classifier>native</classifier>
-      <scope>provided</scope>
+      <scope>runtime</scope>
     </dependency>
   </dependencies>
-
-  <build>
-    <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-dependency-plugin</artifactId>
-        <configuration>
-          <ignoredUnusedDeclaredDependencies combine.children="append">
-            <dependency>com.github.jnr:jffi</dependency>
-          </ignoredUnusedDeclaredDependencies>
-        </configuration>
-      </plugin>
-    </plugins>
-  </build>
 </project>

From b79d220caba32a71f80a5559d49870ceb590edfc Mon Sep 17 00:00:00 2001
From: andreatp <andrea.peruffo1982@gmail.com>
Date: Thu, 1 Oct 2026 13:16:28 +0100
Subject: [PATCH 4/4] Mark jffi as provided in the JFFI runner

---
 docs/docs/experimental/redline.md     | 29 ++++++++++++++++++---------
 redline/it/src/it/redline-e2e/pom.xml | 15 ++++++++++++--
 redline/runner-jffi-tests/pom.xml     | 11 ++++++++++
 redline/runner-jffi/pom.xml           |  7 +------
 4 files changed, 44 insertions(+), 18 deletions(-)

diff --git a/docs/docs/experimental/redline.md b/docs/docs/experimental/redline.md
index 20be4ec81..74ede4c27 100644
--- a/docs/docs/experimental/redline.md
+++ b/docs/docs/experimental/redline.md
@@ -96,21 +96,29 @@ versions use `redline-runner-jffi-experimental`, which needs only Java 11:
 </dependency>
 ```
 
-If both are present, the Panama runner is used wherever the JDK supports it.
-
-If you publish a library rather than an application, declare the runner as `provided`. The
-application using your library then picks the runner, and with it the jffi version, instead of
-inheriting yours:
+The jffi runner does not bring in [jffi](https://github.com/jnr/jffi) itself, so its version can
+follow the rest of your application. Add it next to the runner, together with its native
+libraries:
 
 ```xml
 <dependency>
-  <groupId>run.endive</groupId>
-  <artifactId>redline-runner-jffi-experimental</artifactId>
-  <version>${endive.version}</version>
-  <scope>provided</scope>
+  <groupId>com.github.jnr</groupId>
+  <artifactId>jffi</artifactId>
+  <version>${jffi.version}</version>
+</dependency>
+<dependency>
+  <groupId>com.github.jnr</groupId>
+  <artifactId>jffi</artifactId>
+  <version>${jffi.version}</version>
+  <classifier>native</classifier>
 </dependency>
 ```
 
+Without them, `builder()` fails with `NoClassDefFoundError: com/kenai/jffi/MemoryIO` instead of
+falling back.
+
+If both runners are present, the Panama runner is used wherever the JDK supports it.
+
 Your module is then used exactly as it would be without redline:
 
 ```text
@@ -123,7 +131,8 @@ try (var instance = MyModule.builder().build()) {
 
 When native code cannot be used, `builder()` falls back to the bytecode produced by the
 [Build Time Compiler](../execution/build-time-compiler.md), which is always generated alongside it.
-This happens on platforms outside the table above, or when no runner is on the classpath.
+This happens on platforms outside the table above, or when no runner is on the classpath. A jffi
+runner without jffi is an error, not a fallback.
 
 Your module keeps working either way, so the fallback is silent. To check which one you got:
 
diff --git a/redline/it/src/it/redline-e2e/pom.xml b/redline/it/src/it/redline-e2e/pom.xml
index b6b1a7a47..3932dfe0a 100644
--- a/redline/it/src/it/redline-e2e/pom.xml
+++ b/redline/it/src/it/redline-e2e/pom.xml
@@ -8,8 +8,19 @@
   <packaging>jar</packaging>
 
   <dependencies>
-    <!-- The only dependency a consumer needs. It brings in redline-api (used by
-         the generated builder), runtime and wasm transitively. -->
+    <!-- What a consumer needs: jffi, which the runner declares as provided, and the
+         runner, which brings in redline-api, runtime and wasm transitively. -->
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <version>@jffi.version@</version>
+    </dependency>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <version>@jffi.version@</version>
+      <classifier>native</classifier>
+    </dependency>
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-runner-jffi-experimental</artifactId>
diff --git a/redline/runner-jffi-tests/pom.xml b/redline/runner-jffi-tests/pom.xml
index 3c4a56fcc..e84f52570 100644
--- a/redline/runner-jffi-tests/pom.xml
+++ b/redline/runner-jffi-tests/pom.xml
@@ -18,6 +18,17 @@
   </properties>
 
   <dependencies>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <scope>runtime</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.github.jnr</groupId>
+      <artifactId>jffi</artifactId>
+      <classifier>native</classifier>
+      <scope>runtime</scope>
+    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
diff --git a/redline/runner-jffi/pom.xml b/redline/runner-jffi/pom.xml
index 19da77872..17917a57c 100644
--- a/redline/runner-jffi/pom.xml
+++ b/redline/runner-jffi/pom.xml
@@ -14,10 +14,6 @@
   <description>Native code execution via JFFI (Java 11+)</description>
 
   <dependencies>
-    <dependency>
-      <groupId>com.github.jnr</groupId>
-      <artifactId>jffi</artifactId>
-    </dependency>
     <dependency>
       <groupId>run.endive</groupId>
       <artifactId>redline-api-experimental</artifactId>
@@ -37,8 +33,7 @@
     <dependency>
       <groupId>com.github.jnr</groupId>
       <artifactId>jffi</artifactId>
-      <classifier>native</classifier>
-      <scope>runtime</scope>
+      <scope>provided</scope>
     </dependency>
   </dependencies>
 </project>