Replace jar-resource EBNF extraction with Grammar API tool

- Add Scala 3.7.4 main program (src/main/scala/ExtractGrammar.scala)
  that calls Grammar.loadEbnfGrammarOrThrow() from riddl-language
- Add shell script (tools/extract-grammar.sh) to run it with java
- Update build.sbt: extractGrammar task compiles and invokes the tool,
  Scala 3.7.4 via With.Scala3.configure(), riddl-language 1.7.0
- Remove project/ExtractEbnf.scala (old jar-resource approach)
- Rename ebnf-grammar.ebnf → riddl-grammar.ebnf (it's a RIDDL grammar)
- Upgrade sbt to 1.12.1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: respencer-ncl

build.sbt

@@ -9,35 +9,36 @@ lazy val developers: List[Developer] = List(
   )
 )
 
-// Task to extract EBNF grammar from riddl-language jar
-lazy val extractEbnf = taskKey[File]("Extract EBNF grammar from riddl-language jar if newer")
+lazy val extractGrammar = taskKey[Unit]("Extract RIDDL grammar via Grammar API")
 
 lazy val root = Root(
   ghRepoName = "ossum-tech",
   ghOrgName = "ossuminc",
   startYr = 2025,
   devs = developers
 ).configure(
-  With.Scala3
+  With.Scala3.configure(version = Some("3.7.4"))
 ).settings(
   resolvers += "GitHub Package Registry" at "https://maven.pkg.github.com/ossuminc/riddl",
   libraryDependencies += "com.ossuminc" %% "riddl-language" % "1.7.0",
 
-  // Define the extractEbnf task - automatically triggers update via dependencyClasspath
-  extractEbnf := ExtractEbnf(
-    baseDirectory.value,
-    (Compile / dependencyClasspath).value.files,
-    streams.value.log
-  ),
-
-  // Automatically extract EBNF after update resolves dependencies
-  update := {
-    val updateReport = update.value
-    ExtractEbnf.fromUpdateReport(
+  // Extract RIDDL grammar by compiling and running ExtractGrammar
+  extractGrammar := {
+    (Compile / compile).value
+    val log = streams.value.log
+    val cp = (Runtime / fullClasspathAsJars).value
+      .map(_.data.getAbsolutePath)
+      .mkString(java.io.File.pathSeparator)
+    val target = baseDirectory.value / "docs" / "riddl" / "references" / "riddl-grammar.ebnf"
+    val script = baseDirectory.value / "tools" / "extract-grammar.sh"
+    log.info("Extracting RIDDL grammar...")
+    val exitCode = scala.sys.process.Process(
+      Seq("bash", script.getAbsolutePath, target.getAbsolutePath),
       baseDirectory.value,
-      updateReport,
-      streams.value.log
-    )
-    updateReport
+      "CLASSPATH" -> cp
+    ).!
+    if (exitCode != 0) {
+      throw new MessageOnlyException("Grammar extraction failed")
+    }
   }
 )

docs/riddl/references/ebnf-grammar.md

@@ -7,5 +7,5 @@ automatically extracted from the `riddl-language` library and kept in sync
 with the reference grammar written in Scala/fastparse form.
 
 ```ebnf
---8<-- "riddl/references/ebnf-grammar.ebnf"
+--8<-- "riddl/references/riddl-grammar.ebnf"
 ```

docs/riddl/references/ebnf-grammar.ebnf docs/riddl/references/riddl-grammar.ebnfdocs/riddl/references/ebnf-grammar.ebnf renamed to docs/riddl/references/riddl-grammar.ebnf

@@ -1 +1 @@
-sbt.version=1.10.7
+sbt.version=1.12.1

project/ExtractEbnf.scala

@@ -0,0 +1,7 @@
+import com.ossuminc.riddl.language.Grammar
+import java.nio.file.{Files, Path}
+
+@main def extractGrammar(outputPath: String): Unit =
+  val ebnf = Grammar.loadEbnfGrammarOrThrow
+  Files.writeString(Path.of(outputPath), ebnf)
+  println(s"Wrote ${ebnf.length} chars to $outputPath")

project/build.properties

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Extract the RIDDL grammar using Grammar.loadEbnfGrammarOrThrow().
+#
+# Usage:
+#   CLASSPATH=<jars> ./tools/extract-grammar.sh <output-file>
+#
+# Called by `sbt extractGrammar` which sets CLASSPATH automatically.
+
+OUTPUT="${1:?Usage: extract-grammar.sh <output-file>}"
+
+if [ -z "${CLASSPATH:-}" ]; then
+  echo "Error: CLASSPATH not set. Run via 'sbt extractGrammar' instead." >&2
+  exit 1
+fi
+
+java -cp "$CLASSPATH" extractGrammar "$OUTPUT"