oracle-samples · k13gomez · Dec 27, 2023 · Dec 27, 2023 · Dec 27, 2023 · Dec 27, 2023
diff --git a/.github/workflows/clojure.yml b/.github/workflows/clojure.yml
@@ -2,36 +2,40 @@ name: Clojure CI
 
 on:
   push:
-    branches: [ "main" ]
+    branches:
+      - 'main'
   pull_request:
-    branches: [ "main" ]
+    branches:
+      - '**'
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: Setup Java JDK
-      uses: actions/setup-java@v1.4.4
+    - name: Checkout code
+      uses: actions/checkout@v3
+    - name: Tools setup
+      uses: jdx/mise-action@v2
       with:
-        # The Java version to make available on the path. Takes a whole or semver Java version, or 1.x syntax (e.g. 1.8 => Java 8.x). Early access versions can be specified in the form of e.g. 14-ea, 14.0.0-ea, or 14.0.0-ea.28
-        java-version: 1.8
-    - name: Setup Node.js environment
-      uses: actions/setup-node@v2.5.2
-      with:
-        # Version Spec of the version to use.  Examples: 12.x, 10.15.1, >=10.15.0
-        node-version: 18.16.0
-    - name: Install Puppeteer
-      run: npm install puppeteer
-    - name: Install Chrome
-      run: npx puppeteer browsers install chrome
-    - name: Install dependencies
-      run: lein deps
+        install: true
+        cache: true
+    - name: Tools config
+      run: |
+        echo "JAVA_HOME=$(mise where java)" >> $GITHUB_ENV
+        echo "GRAALVM_HOME=$(mise where java)" >> $GITHUB_ENV
+        echo "$(mise where java)/bin" >> $GITHUB_PATH
+        gu install native-image
     - name: Run tests
-      run: lein test
+      run: make test
+    - name: Run coverage tests
+      run: make test-coverage
     - name: Run generative tests
-      run: lein test :generative
-    - name: Run recent-clj tests
-      run: lein with-profile dev,recent-clj test
+      run: make test-generative
     - name: Run clj-kondo linter
-      run: lein with-profile dev,recent-clj clj-kondo-lint
+      run: make lint
+    - name: Run build jar
+      run: make build
+    - name: Run build app
+      run: |
+        make build-native
+        build/clara-test-app this is a test invocation of native app
diff --git a/.gitignore b/.gitignore
@@ -1,9 +1,9 @@
+/build
 /target
 /lib
 /classes
 /checkouts
 /resources/public/js/*
-pom.xml
 pom.xml.asc
 *.jar
 *.class
@@ -17,4 +17,5 @@ figwheel_server.log
 *.iml
 .clj-kondo
 .lsp
-node_modules/*
+.cpcache
+node_modules/*
diff --git a/.mise.toml b/.mise.toml
@@ -0,0 +1,5 @@
+[plugins]
+clojure = "https://github.com/asdf-community/asdf-clojure.git"
+[tools]
+java = "graalvm-22.3.1+java11"
+clojure = "1.11"
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,7 +1,86 @@
-This is a history of changes to clara-rules.
+This is a history of changes to k13labs/clara-rules.
 
-# 0.25.0-SNAPSHOT
+# 1.4.0
+* (breaking change) renamed the protocol `IRuleSource/load-rules` to `IClaraSource/load-source`, which can load rules and hierarchies.
+* (breaking change) rename `clear-ns-productions!` to `clear-ns-vars!` since now there are ns-installed vars that are not productions.
+* update linter config for new macros.
+* `defrule` now defines rules as functions with two arities, no args returns the rule map, and 2 args is the compiled RHS.
+* `defrule` separator `=>` symbol is now optional when there is no LHS expressions
+* `clojure.lang.Fn` now implements `clara.rules.compiler/IClaraSource`, and returns a single rule by invoking the like `(a-rule)`.
+* add built-in support to serialize `clojure.lang.Var` so that a rule handler var can be serialized correctly.
+* add function `clara.rules.compiler/load-source*` to simplify recursively loading using `IClaraSource/load-source`.
+* add `defhierarchy` macro to define hierarchies of facts allowing to easily establish parent/child relationships.
 
+# 1.3.5
+* Update sum accumulator to support default-value, set to 0 if not specified, to avoid NPE during sum.
+
+# 1.3.4
+* Update CyclicalRulesListener to return the cycles-count value when converted to persistent.
+
+# 1.3.3
+* Upgrade to clojure 1.11.2 to fix `CVE-2024-22871`, despite not really affecting clara-rules.
+* Add clj-kondo linter updates to fix bad docstring expression.
+
+# 1.3.2
+* Enhance memory add-activations implementation by replacing get/set with compute!
+
+# 1.3.1
+* Enhance caching performance by more predictable md5 caching and sorting productions
+
+# 1.3.0
+* Enhance compilation performance by using mutable maps from ham-fisted lib
+
+# 1.2.0
+* Enhance caching support by adding compile caching using core CacheProtocol
+
+# 1.1.0
+* Enhance caching support by adding session caching using core CacheProtocol
+
+# 1.0.2
+* Bump futurama version to 1.0.2 to get enhancements
+
+# 1.0.1
+* Bump futurama version to 1.0.1 to get enhancements
+
+# 1.0.0
+* Bump futurama version to first major version
+* Initial major release of k13labs/clara-rules
+
+# 0.9.9
+* Bump futurama version to latest
+
+# 0.9.8
+* Update to latest async library (futurama) to get fixes for async-reduce
+
+# 0.9.7
+* Update to latest async library
+
+# 0.9.6
+* Async enhancements and add engine test with thousands of async rules fired for stress test
+
+# 0.9.5
+* Update docs and explicit async-future in fire-rules-async
+
+# 0.9.4
+* Update `futurama` to latest version
+
+# 0.9.3
+* Implement interruptible sessions using futurama's async-cancel capabilities.
+* Add tests for infinite loop runaway sessions which can be interrupted.
+
+# 0.9.2
+* Update docs and futurama version bump again
+
+# 0.9.1
+* Update docs and futurama version bump
+
+# 0.9.0
+* Add parallel support to Node and RHS activation.
+* Remove ClojureScript support, general cleanup.
+* Refactor engine to support both fire-rules and fire-rules-async
+* Replace mutable/transient collections with [ham-fisted](https://github.com/cnuernber/ham-fisted) data structures.
+
+This is a history of changes to clara-rules prior to forking to k13labs/clara-rules.
 
 ### 0.24.0
 * uplift to cljs 1.11.132

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -30,10 +30,10 @@ Thanks.
 * Open a [pull request][7].
 * The pull request will be reviewed by the community and merged by the project committers.
 
-[1]: https://github.com/cerner/clara-rules/issues
+[1]: https://github.com/k13labs/clara-rules/issues
 [2]: http://gun.io/blog/how-to-github-fork-branch-and-pull-request
 [3]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
 [4]: ./CHANGELOG.md
 [5]: ./LICENSE
 [6]: http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html
-[7]: https://help.github.com/articles/using-pull-requests
+[7]: https://help.github.com/articles/using-pull-requests
diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md
@@ -1,17 +1,15 @@
-Cerner Corporation
+Clara Rules Contributors
 
 - Ryan Brush [@rbrush]
 - Mike Rodriguez [@mrrodriguez]
 - William Parker [@WilliamParker]
 - Ethan Christian [@EthanEChristian]
 - Pushkar Kulkarni [@kulkarnipushkar]
-
-Community
-
 - David Goeke [@dgoeke]
 - Dave Dixon [@sparkofreason]
 - Baptiste Fontaine [@bfontaine]
 - Jose Gomez [@k13gomez]
+- Lucio Assis [@luciolucio]
 - Imre Kószó [@imrekoszo]
 
 [@rbrush]: https://github.com/rbrush
@@ -24,4 +22,5 @@ Community
 [@bfontaine]: https://github.com/bfontaine
 [@sunilgunisetty]: https://github.com/sunilgunisetty
 [@k13gomez]: https://github.com/k13gomez
+[@luciolucio]: https://github.com/luciolucio
 [@imrekoszo]: https://github.com/imrekoszo
diff --git a/Makefile b/Makefile
@@ -0,0 +1,70 @@
+.PHONY: repl test clean compile-main-java compile-test-java deploy install format-check format-fix
+
+SHELL := /bin/bash
+
+env:
+	env
+
+compile-main-java:
+	clojure -T:build compile-main-java
+
+compile-test-java: compile-main-java
+	clojure -T:build compile-test-java
+
+repl: compile-test-java
+	clojure -M:dev:test:app:repl
+
+test: compile-test-java
+	clojure -M:dev:test:app:runner --focus :unit --reporter kaocha.report/documentation --no-capture-output
+
+test-coverage: compile-test-java
+	clojure -M:dev:test:app:runner --focus :coverage --reporter kaocha.report/documentation --no-capture-output
+	jq '.coverage["clara/coverage_ruleset.clj"]|join("_")' target/coverage/codecov.json | grep "_1___1____1_0_1__1__" || echo "Unexpected coverage output for clara.coverage-ruleset." exit 1
+
+test-generative: compile-test-java
+	clojure -M:dev:test:app:runner --focus :generative --reporter kaocha.report/documentation --no-capture-output
+
+test-config:
+	clojure -M:dev:test:app:runner --print-config
+
+clean:
+	rm -rf target build
+
+lint: compile-test-java
+	clojure -M:dev:test:app:clj-kondo --copy-configs --dependencies --parallel --lint "$(shell clojure -A:dev:test -Spath)"
+	clojure -M:dev:test:app:clj-kondo --lint "src/main:src/test" --fail-level "error"
+
+build: compile-main-java
+	clojure -X:jar :sync-pom true :jar "build/clara-rules.jar"
+
+build-native: build
+	mkdir -p build/graalvm-config
+	clojure -X:uberjar :sync-pom false :jar "build/clara-test-app.jar"
+	java -agentlib:native-image-agent=config-output-dir=build/graalvm-config -jar "build/clara-test-app.jar" clara.main
+	native-image -jar "build/clara-test-app.jar" \
+		"-H:+ReportExceptionStackTraces" \
+		"-H:+JNI" \
+		"-H:EnableURLProtocols=http,https,jar" \
+		"-J-Dclojure.spec.skip-macros=true" \
+		"-J-Dclojure.compiler.direct-linking=true" \
+		"--report-unsupported-elements-at-runtime" \
+		"--verbose" \
+		"--no-fallback" \
+		"--no-server" \
+		"--allow-incomplete-classpath" \
+		"--trace-object-instantiation=java.lang.Thread" \
+		"--features=clj_easy.graal_build_time.InitClojureClasses" \
+		"-H:ConfigurationFileDirectories=build/graalvm-config" \
+		"build/clara-test-app"
+
+deploy: clean build
+	clojure -X:deploy-maven
+
+install:
+	clojure -X:install-maven
+
+format-check:
+	clojure -M:format-check
+
+format-fix:
+	clojure -M:format-fix
diff --git a/NOTICE b/NOTICE
@@ -1,4 +1,4 @@
-Copyright 2016 Cerner Innovation, Inc.
+Copyright 2023 Jose Gomez
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

diff --git a/README.md b/README.md
@@ -1,16 +1,19 @@
-[![Build Status](https://github.com/cerner/clara-rules/actions/workflows/clojure.yml/badge.svg)](https://github.com/cerner/clara-rules/actions/workflows/clojure.yml)
+[![Build Status](https://github.com/k13labs/clara-rules/actions/workflows/clojure.yml/badge.svg)](https://github.com/k13labs/clara-rules/actions/workflows/clojure.yml)
 
 # _About_
 
 Clara is a forward-chaining rules engine written in Clojure(Script) with Java interoperability. It aims to simplify code with a developer-centric approach to expert systems. See [clara-rules.org](http://www.clara-rules.org) for more.
 
+NOTE: this fork only supports the JVM/Clojure, and not ClojureScript.
+
 # _Usage_
 
 Here's a simple example. Complete documentation is at [clara-rules.org](http://www.clara-rules.org/docs/firststeps/).
 
 ```clj
 (ns clara.support-example
-  (:require [clara.rules :refer :all]))
+  (:require [clara.rules :refer :all]
+            [futurama.core :refer [!<!!]))
 
 (defrecord SupportRequest [client level])
 
@@ -29,12 +32,20 @@ Here's a simple example. Complete documentation is at [clara-rules.org](http://w
   =>
   (println "Notify" ?name "that"  ?client "has a new support request!"))
 
-;; Run the rules! We can just use Clojure's threading macro to wire things up.
+;; We can just use Clojure's threading macro to wire things up below.
+
+;; Run the rules!
 (-> (mk-session)
     (insert (->ClientRepresentative "Alice" "Acme")
             (->SupportRequest "Acme" :high))
     (fire-rules))
 
+;; Run the rules asynchronously!
+(!<!! (-> (mk-session)
+          (insert (->ClientRepresentative "Alice" "Acme")
+                  (->SupportRequest "Acme" :high))
+          (fire-rules-async {:parallel-batch-size 50})))
+
 ;;;; Prints this:
 
 ;; High support requested!
@@ -43,35 +54,41 @@ Here's a simple example. Complete documentation is at [clara-rules.org](http://w
 
 # _Building_
 
-Clara is built, tested, and deployed using [Leiningen](http://leiningen.org). 
-ClojureScript tests are executed via [puppeteer](https://pptr.dev/). 
-``` 
-npm install -g puppeteer
-npx puppeteer browsers install chrome
-```
+Clara is built, tested, and deployed using [Clojure Tools Deps](https://clojure.org/guides/deps_and_cli).
+
+GNU Make is used to simplify invocation of some commands.
 
 # _Availability_
 
-Clara releases are on [Clojars](https://clojars.org/). Simply add the following to your project:
+Clara releases for this project are on [Clojars](https://clojars.org/). Simply add the following to your project:
 
-[![Clojars Project](http://clojars.org/com.cerner/clara-rules/latest-version.svg)](http://clojars.org/com.cerner/clara-rules)
+[![Clojars Project](http://clojars.org/com.github.k13labs/clara-rules/latest-version.svg)](http://clojars.org/com.github.k13labs/clara-rules)
 
 # _Communication_
 
-Questions can be posted to the [Clara Rules Google Group](https://groups.google.com/forum/?hl=en#!forum/clara-rules) or the [Slack channel](https://clojurians.slack.com/messages/clara/).  
+- Questions about Clara rules can be posted to the [Clara Rules Google Group](https://groups.google.com/forum/?hl=en#!forum/clara-rules) or the [Slack channel](https://clojurians.slack.com/messages/clara/).
+- For any other questions or issues about this Clara rules fork specifically feel free to browse or open a [Github Issue](https://github.com/k13labs/clara-rules/issues).
 
 # Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)
 
+# YourKit
+
+[![YourKit](https://www.yourkit.com/images/yklogo.png)](https://www.yourkit.com/)
+
+YourKit supports open source projects with innovative and intelligent tools
+for monitoring and profiling Java and .NET applications.
+YourKit is the creator of [YourKit Java Profiler](https://www.yourkit.com/java/profiler/),
+[YourKit .NET Profiler](https://www.yourkit.com/dotnet-profiler/),
+and [YourKit YouMonitor](https://www.yourkit.com/youmonitor/).
+
 # LICENSE
 
-Copyright 2018 Cerner Innovation, Inc.
+Copyright 2023 Jose Gomez
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
 
 &nbsp;&nbsp;&nbsp;&nbsp;http://www.apache.org/licenses/LICENSE-2.0
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-
-