From fe208fdb8074475c2d8f830300add1bbf026447a Mon Sep 17 00:00:00 2001
From: Thomas Walker Lynch <xtujpz@reasoningtechnology.com>
Date: Tue, 1 Oct 2024 14:15:24 +0000
Subject: [PATCH] checkpoint while splitting out the dependency graph build
 tool to its own project

---
 #README.md#                                   |  31 +
 .gitignore                                    |   3 +-
 README.md                                     |  14 +-
 build.gradle                                  |  24 +-
 developer/Lethe/Hibou_build.gradle            | 106 ---
 developer/Lethe/buid_from_leaf.gradle         |  68 --
 developer/Lethe/build.gradle                  |  71 --
 developer/Lethe/build.html                    |  90 ---
 developer/Lethe/make                          |  15 -
 developer/Lethe/makefile-project.mk           | 251 -------
 developer/Lethe/makefile-tool.mk              |  61 --
 developer/Lethe/makefile-top.mk               |  62 --
 developer/executor/env_build                  | 155 ----
 .../Arithmetic2_SyntaxAnnotate.java           |  81 ---
 ...ithmetic2_SyntaxAnnotate_PrintVisitor.java | 663 ------------------
 developer/ologist/.githolder                  |   0
 .../ANTLR/ANTLRv4Lexer.g4                     |   0
 .../ANTLR/ANTLRv4Parser.g4                    |   0
 {developer => developers}/ANTLR/Arithmetic.g4 |   0
 .../ANTLR/Arithmetic2.g4                      |   0
 .../ANTLR/GQL_20240412.g4                     |   0
 .../ANTLR/GQL_20240412_rf1_literals.g4        |   0
 .../ANTLR/GQL_20240412_substituted.g4         |   0
 {developer => developers}/ANTLR/LexBasic.g4   |   0
 .../ANTLR/LexerAdaptor.java                   |   0
 .../ANTLR/lexer_rules.g4                      |   0
 .../Erebus => developers/Somnus}/.gitignore   |   0
 developers/build.gradle                       |  13 +
 developers/dependency_graph_definition.groovy | 387 ++++++++++
 .../executor/ANTLR_OUT_FL                     |   0
 .../build_from_dependency_graph.groovy        | 559 ++-------------
 .../executor/cat_w_names                      |   0
 {developer => developers}/executor/clean      |   0
 .../executor/clean_directory                  |   0
 .../executor/clean_file_list                  |   0
 .../executor/clean_grammar                    |   0
 .../executor/clean_program                    |   0
 {developer => developers}/executor/gradle     |   0
 .../experiment}/.githolder                    |   0
 .../experiment/script2.sh                     |   0
 .../javac/ANTLR/.gitignore                    |   0
 .../javac/leaf/ANTLR_OUT_FL.java              |   0
 .../javac/leaf/Arithmetic_Echo.java           |   0
 .../leaf/Arithmetic_Echo_PrintVisitor.java    |   0
 .../javac/leaf/Arithmetic_Echo__Test.java     |   0
 .../javac/leaf/Arithmetic_Swap.java           |   0
 .../javac/leaf/Arithmetic_SwapVisitor.java    |   0
 .../javac/leaf/Arithmetic_SyntaxAnnotate.java |   0
 ...rithmetic_SyntaxAnnotate_PrintVisitor.java |   0
 .../leaf/Arithmetic_SyntaxAnnotate__Test.java |   0
 .../javac/leaf/RuleNameList.java              |   0
 .../javac/leaf/RuleNameListRegx.java          |   0
 .../javac/leaf/StringUtils.java               |   0
 .../javac/leaf/Synthesize_SyntaxAnnotate.java |   0
 ...ynthesize_SyntaxAnnotate_PrintVisitor.java |   0
 ...ize_SyntaxAnnotate_PrintVisitorMethod.java |   0
 .../javac/leaf/TestBench.java                 |   0
 .../javac/synthesized}/.gitignore             |   0
 {tool => developers/jvm}/.gitignore           |   0
 .../readers}/#rule_list.txt#                  |   0
 .../readers}/.githolder                       |   0
 .../readers}/.ispell_antlr                    |   0
 .../readers}/Cypher_GQL_differences.txt       |   0
 .../readers}/GQL_20240412_rule_list.txt       |   0
 .../readers}/antlr-mode.el                    |   0
 .../readers}/cycle_dection.html               |   0
 .../readers}/dependency_graph.html            |   0
 .../readers}/deps.gradle                      |   0
 .../ologist => developers/readers}/emacs.txt  |   0
 .../readers}/for_developers.md                |   0
 .../readers}/grammar_source.txt               |   0
 .../ologist => developers/readers}/groovy.el  |   0
 .../readers}/node_labels_unique_q.txt         |   0
 .../readers}/rule_list.txt                    |   0
 .../readers}/rules_by_catebory.txt            |   0
 .../readers}/rules_by_category.html           |   0
 .../readers}/terminal_symbol_list.txt         |   0
 .../terminal_symbol_list_unsorted.txt         |   0
 developers/tanuki/.gitignore                  |   4 +
 .../Arithmetic_SyntaxAnnotate__Test_0.txt     |   0
 .../Arithmetic_SyntaxAnnotate__Test_1.txt     |   0
 .../Arithmetic_SyntaxAnnotate__Test_2.txt     |   0
 .../Arithmetic_SyntaxAnnotate__Test_3.txt     |   0
 .../Arithmetic_SyntaxAnnotate__Test_4.txt     |   0
 .../test/Neo4NBA/create_relationship_0.cypher |   0
 .../test/Neo4NBA/create_team_0.cypher         |   0
 .../delete_player_and_relationship.cypher     |   0
 .../test/Neo4NBA/notes.txt                    |   0
 .../Neo4NBA/query_players_by_team_0.cypher    |   0
 .../test/Neo4NBA/updating_nodes_0.cypher      |   0
 ...d_graph_from_graph_type_(double_colon).gql |   0
 ...closed_graph_from_graph_type_(lexical).gql |   0
 ..._from_nested_graph_type_(double_colon).gql |   0
 .../create_graph.gql                          |   0
 .../create_schema.gql                         |   0
 .../insert_statement.gql                      |   0
 .../match_and_insert_example.gql              |   0
 ...cate_(match_block_statement_in_braces).gql |   0
 ...(match_block_statement_in_parentheses).gql |   0
 ...sts_predicate_(nested_match_statement).gql |   0
 .../session_set_graph_to_current_graph.gql    |   0
 ...on_set_graph_to_current_property_graph.gql |   0
 .../session_set_property_as_value.gql         |   0
 .../session_set_time_zone.gql                 |   0
 .../transcript_Arithmetic_Syntax__Test.sh     |   0
 .../test/transcript_RuleNameList.sh           |   0
 .../test/transcript_notes.txt                 |   0
 .../test/transcript_test_Arithmetic_Echo.sh   |   0
 .../test/transcript_test_Arithmetic_Syntax.sh |   0
 .../transcript_test_PrintRuleNameListRegx.sh  |   0
 executor/clean_ANTLR                          |   2 +-
 executor/clean_Java                           |   2 +-
 executor/clean_upstream                       |   6 +-
 executor/env_dev                              |   6 +-
 executor/env_pm                               |  11 +-
 executor/install_tools.txt                    |  36 +
 ologist/directory_structure.md                | 159 -----
 ologist/gradle_notes.txt                      |  30 -
 {ologist => readers}/README.md                |   0
 readers/directory_naming.txt                  |  40 ++
 {ologist => readers}/log.md                   |   6 +
 {Erebus => tanuki}/.gitignore                 |   0
 toolsmiths/.gitignore                         |   4 +
 123 files changed, 650 insertions(+), 2310 deletions(-)
 create mode 100644 #README.md#
 delete mode 100644 developer/Lethe/Hibou_build.gradle
 delete mode 100644 developer/Lethe/buid_from_leaf.gradle
 delete mode 100644 developer/Lethe/build.gradle
 delete mode 100644 developer/Lethe/build.html
 delete mode 100755 developer/Lethe/make
 delete mode 100644 developer/Lethe/makefile-project.mk
 delete mode 100644 developer/Lethe/makefile-tool.mk
 delete mode 100644 developer/Lethe/makefile-top.mk
 delete mode 100755 developer/executor/env_build
 delete mode 100644 developer/javac/synthesized/Arithmetic2_SyntaxAnnotate.java
 delete mode 100644 developer/javac/synthesized/Arithmetic2_SyntaxAnnotate_PrintVisitor.java
 delete mode 100644 developer/ologist/.githolder
 rename {developer => developers}/ANTLR/ANTLRv4Lexer.g4 (100%)
 rename {developer => developers}/ANTLR/ANTLRv4Parser.g4 (100%)
 rename {developer => developers}/ANTLR/Arithmetic.g4 (100%)
 rename {developer => developers}/ANTLR/Arithmetic2.g4 (100%)
 rename {developer => developers}/ANTLR/GQL_20240412.g4 (100%)
 rename {developer => developers}/ANTLR/GQL_20240412_rf1_literals.g4 (100%)
 rename {developer => developers}/ANTLR/GQL_20240412_substituted.g4 (100%)
 rename {developer => developers}/ANTLR/LexBasic.g4 (100%)
 rename {developer => developers}/ANTLR/LexerAdaptor.java (100%)
 rename {developer => developers}/ANTLR/lexer_rules.g4 (100%)
 rename {developer/Erebus => developers/Somnus}/.gitignore (100%)
 create mode 100644 developers/build.gradle
 create mode 100644 developers/dependency_graph_definition.groovy
 rename {developer => developers}/executor/ANTLR_OUT_FL (100%)
 rename developer/build.gradle => developers/executor/build_from_dependency_graph.groovy (53%)
 rename {developer => developers}/executor/cat_w_names (100%)
 rename {developer => developers}/executor/clean (100%)
 rename {developer => developers}/executor/clean_directory (100%)
 rename {developer => developers}/executor/clean_file_list (100%)
 rename {developer => developers}/executor/clean_grammar (100%)
 rename {developer => developers}/executor/clean_program (100%)
 rename {developer => developers}/executor/gradle (100%)
 rename {developer/Lethe => developers/experiment}/.githolder (100%)
 rename {developer => developers}/experiment/script2.sh (100%)
 rename {developer => developers}/javac/ANTLR/.gitignore (100%)
 rename {developer => developers}/javac/leaf/ANTLR_OUT_FL.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_Echo.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_Echo_PrintVisitor.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_Echo__Test.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_Swap.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_SwapVisitor.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_SyntaxAnnotate.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_SyntaxAnnotate_PrintVisitor.java (100%)
 rename {developer => developers}/javac/leaf/Arithmetic_SyntaxAnnotate__Test.java (100%)
 rename {developer => developers}/javac/leaf/RuleNameList.java (100%)
 rename {developer => developers}/javac/leaf/RuleNameListRegx.java (100%)
 rename {developer => developers}/javac/leaf/StringUtils.java (100%)
 rename {developer => developers}/javac/leaf/Synthesize_SyntaxAnnotate.java (100%)
 rename {developer => developers}/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitor.java (100%)
 rename {developer => developers}/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java (100%)
 rename {developer => developers}/javac/leaf/TestBench.java (100%)
 rename {developer/jvm => developers/javac/synthesized}/.gitignore (100%)
 rename {tool => developers/jvm}/.gitignore (100%)
 rename {developer/ologist => developers/readers}/#rule_list.txt# (100%)
 rename {developer/experiment => developers/readers}/.githolder (100%)
 rename {developer/ologist => developers/readers}/.ispell_antlr (100%)
 rename {developer/ologist => developers/readers}/Cypher_GQL_differences.txt (100%)
 rename {developer/ologist => developers/readers}/GQL_20240412_rule_list.txt (100%)
 rename {developer/ologist => developers/readers}/antlr-mode.el (100%)
 rename {developer/ologist => developers/readers}/cycle_dection.html (100%)
 rename {developer/ologist => developers/readers}/dependency_graph.html (100%)
 rename {developer/ologist => developers/readers}/deps.gradle (100%)
 rename {developer/ologist => developers/readers}/emacs.txt (100%)
 rename {developer/ologist => developers/readers}/for_developers.md (100%)
 rename {developer/ologist => developers/readers}/grammar_source.txt (100%)
 rename {developer/ologist => developers/readers}/groovy.el (100%)
 rename {developer/ologist => developers/readers}/node_labels_unique_q.txt (100%)
 rename {developer/ologist => developers/readers}/rule_list.txt (100%)
 rename {developer/ologist => developers/readers}/rules_by_catebory.txt (100%)
 rename {developer/ologist => developers/readers}/rules_by_category.html (100%)
 rename {developer/ologist => developers/readers}/terminal_symbol_list.txt (100%)
 rename {developer/ologist => developers/readers}/terminal_symbol_list_unsorted.txt (100%)
 create mode 100644 developers/tanuki/.gitignore
 rename {developer => developers}/test/Arithmetic_SyntaxAnnotate__Test_0.txt (100%)
 rename {developer => developers}/test/Arithmetic_SyntaxAnnotate__Test_1.txt (100%)
 rename {developer => developers}/test/Arithmetic_SyntaxAnnotate__Test_2.txt (100%)
 rename {developer => developers}/test/Arithmetic_SyntaxAnnotate__Test_3.txt (100%)
 rename {developer => developers}/test/Arithmetic_SyntaxAnnotate__Test_4.txt (100%)
 rename {developer => developers}/test/Neo4NBA/create_relationship_0.cypher (100%)
 rename {developer => developers}/test/Neo4NBA/create_team_0.cypher (100%)
 rename {developer => developers}/test/Neo4NBA/delete_player_and_relationship.cypher (100%)
 rename {developer => developers}/test/Neo4NBA/notes.txt (100%)
 rename {developer => developers}/test/Neo4NBA/query_players_by_team_0.cypher (100%)
 rename {developer => developers}/test/Neo4NBA/updating_nodes_0.cypher (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(double_colon).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(lexical).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/create_closed_graph_from_nested_graph_type_(double_colon).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/create_graph.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/create_schema.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/insert_statement.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/match_and_insert_example.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_braces).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_parentheses).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(nested_match_statement).gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/session_set_graph_to_current_graph.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/session_set_graph_to_current_property_graph.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/session_set_property_as_value.gql (100%)
 rename {developer => developers}/test/opengql_grammar_samples_20240801/session_set_time_zone.gql (100%)
 rename {developer => developers}/test/transcript_Arithmetic_Syntax__Test.sh (100%)
 rename {developer => developers}/test/transcript_RuleNameList.sh (100%)
 rename {developer => developers}/test/transcript_notes.txt (100%)
 rename {developer => developers}/test/transcript_test_Arithmetic_Echo.sh (100%)
 rename {developer => developers}/test/transcript_test_Arithmetic_Syntax.sh (100%)
 rename {developer => developers}/test/transcript_test_PrintRuleNameListRegx.sh (100%)
 create mode 100644 executor/install_tools.txt
 delete mode 100644 ologist/directory_structure.md
 delete mode 100644 ologist/gradle_notes.txt
 rename {ologist => readers}/README.md (100%)
 create mode 100644 readers/directory_naming.txt
 rename {ologist => readers}/log.md (91%)
 rename {Erebus => tanuki}/.gitignore (100%)
 create mode 100644 toolsmiths/.gitignore

diff --git a/#README.md# b/#README.md#
new file mode 100644
index 0000000..a089cdd
--- /dev/null
+++ b/#README.md#
@@ -0,0 +1,31 @@
+
+Directories are named after the agent that uses the files in them. See
+`readers/directory_naming.txt` for more information.
+
+
+
+Document readers will find material in the 'readers' directory.
+
+As you are reading this you might be a GQL_to_Cypter-ologist.  Please read
+documents in the ./ologist directory for project information, and the
+documents in the developer/ologist directory for documents on building
+the project.
+
+The project top level is for project management and imported tools. Developers
+do development work in the `developer` directory.
+
+For developers, from the top of the project get started by typing:
+```
+> . executor/env_dev
+``
+
+This will setup the environment and `cd` to the developer directory.  (`env_dev`
+is analogous to the Python virtual environment `activate`.)
+
+# About
+
+This is a project to develope a transpiler from GQL to Cypher.
+
+
+
+
diff --git a/.gitignore b/.gitignore
index 02b640c..79a93aa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,4 @@
-#note also the .gitignore files in the tool and developer directories and any
-# other directory that might have one.
+# be careful to note also the .gitignore files in various directories.
 
 #*#
 *~
diff --git a/README.md b/README.md
index 6d0d30a..ad94442 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,17 @@
 
-# Project management
+Directories are named after the agent that uses the files in them. See
+`readers/directory_naming.txt` for more information.
+
+The top level directory is reserved for project management. This includes
+the git repo, virtual environment tool installs, and the startup scripts.
+
+An `executor` is a generic name for a program that runs a file. It is used to
+name directories that might have a mix of directly loaded, interpreted, and
+shell script files. Files in an 'exector' directory are for the executor.
+
+
+
+Document readers will find material in the 'readers' directory.
 
 As you are reading this you might be a GQL_to_Cypter-ologist.  Please read
 documents in the ./ologist directory for project information, and the
diff --git a/build.gradle b/build.gradle
index 4312062..1358aa3 100644
--- a/build.gradle
+++ b/build.gradle
@@ -121,9 +121,27 @@ task installJava {
   }
 }
 
+task installGroovyWrapper {
+  doLast {
+    def groovyJar = file("${gradle.gradleHomeDir}/lib/groovy-all.jar")
+    def wrapperDest = file("${toolDir}/bin/groovy-wrapper")
+    
+    if (groovyJar.exists()) {
+      println "Creating Groovy wrapper script in ${wrapperDest}"
+      wrapperDest.text = 
+      '''#!/bin/bash
+      exec java -cp ${groovyJar.absolutePath} groovy.ui.GroovyMain "$@"
+      '''
+      wrapperDest.setExecutable(true)
+    } else {
+      throw new GradleException("Groovy .jar file not found in Gradle library")
+    }
+  }
+}
+
 // Add a task to install both tools
 task installTools {
-  dependsOn installAntlr, installJava
+  dependsOn installAntlr, installJava, installGroovyWrapper
 }
 
 //--------------------------------------------------------------------------------
@@ -152,8 +170,8 @@ task cleanTool {
   }
 }
 
-task cleanErebus {
-  description = "Cleans the project level temporary directory 'Erebus'"  
+task Tanuki {
+  description = "Cleans the project level temporary directory"  
   doLast {
     if (erebusDir.exists()) {
       erebusDir.eachFile { file ->
diff --git a/developer/Lethe/Hibou_build.gradle b/developer/Lethe/Hibou_build.gradle
deleted file mode 100644
index ca38ddd..0000000
--- a/developer/Lethe/Hibou_build.gradle
+++ /dev/null
@@ -1,106 +0,0 @@
-task setup {
-  doLast {
-    def dirs = [
-      "$(ANTLR_IN_PRIMARY_DIR)",
-      "$(JAVA_COMP_IN_DIR)",
-      "$(JAVA_COMP_IN_PRIMARY_DIR)",
-      "$(JAVA_COMP_IN_ANTLR_DIR)",
-      "$(JAVA_COMP_IN_SYN_DIR)",
-      "$(JVM_IN_DIR)",
-      "$(EXECUTOR_IN_DIR)",
-      "test",
-      "deprecated",
-      "experiment",
-      "ologist",
-      "temporary"
-    ]
-    dirs.each { dir ->
-      if (!file(dir).exists()) {
-        mkdir dir
-      }
-    }
-  }
-}
-
-def compileJava(source, target) {
-  tasks.create(name: "compile${source}", type: Exec) {
-    commandLine '$(JAVA_COMP)', '-d', '$(JAVA_COMP_OUT_DIR)', '-sourcepath', '$(JAVA_COMP_IN_DL)', source
-    doLast {
-      println "Compiled ${source} to ${target}"
-    }
-  }
-}
-
-def createJar(source, target) {
-  tasks.create(name: "jar${source}", type: Exec) {
-    commandLine '$(JAVA_ARCHIVE)', 'cf', target, '-C', '$(JAVA_COMP_OUT_DIR)', source
-    doLast {
-      println "Created ${target}"
-    }
-  }
-}
-
-def createWrapper(source, target) {
-  tasks.create(name: "wrapper${source}", type: Exec) {
-    doLast {
-      def script = new File(target)
-      script.text = "#!/usr/bin/env bash\n$(JAVA_INTERP) -cp ${CLASSPATH}:${JVM_IN_DP}:${JVM_IN_DP}/${source}.jar ${source} \$@"
-      script.setExecutable(true)
-      println "Created program ${target}"
-    }
-  }
-}
-
-task ANTLR_OUT_FL {
-  dependsOn setup
-  doLast {
-    println "Building ANTLR_OUT_FL..."
-    // Add specific build steps for ANTLR_OUT_FL here
-  }
-}
-
-task all {
-  dependsOn ANTLR_OUT_FL
-  doLast {
-    println "Building all targets..."
-  }
-}
-
-task clean {
-  doLast {
-    println "Use the command `clean <option>` instead of make."
-  }
-}
-
-task version {
-  doLast {
-    println "ANTLR_JAR is '${notdir(ANTLR_JAR)}'"
-    exec {
-      commandLine '$(JAVA_COMP)', '--version'
-    }
-    exec {
-      commandLine '$(JAVA_ARCHIVE)', '--version'
-    }
-    exec {
-      commandLine 'make', '-v'
-    }
-    println "makefile 0.4"
-  }
-}
-
-task nothing {
-  doLast {
-    // useful for distinguishing between make syntax errors and build errors
-  }
-}
-
-tasks.withType(Exec) {
-  doFirst {
-    println "Executing $name"
-  }
-}
-
-// Example usage
-compileJava('$(JAVA_COMP_IN_PRIMARY_DIR)/Example.java', '$(JAVA_COMP_OUT_DIR)/Example.class')
-createJar('Example.class', '$(JAVA_COMP_OUT_DIR)/Example.jar')
-createWrapper('Example', '$(EXECUTOR_IN_DIR)/Example')
diff --git a/developer/Lethe/buid_from_leaf.gradle b/developer/Lethe/buid_from_leaf.gradle
deleted file mode 100644
index c23a159..0000000
--- a/developer/Lethe/buid_from_leaf.gradle
+++ /dev/null
@@ -1,68 +0,0 @@
-/*--------------------------------------------------------------------------------
- build_from_leaf
-
- Accepts `build_result_fpl` and `leaf_dependency_fpl` (fpl = file path list). 
- Typically, `build_result_fpl` will hold a single item, representing the target 
- to be built, and `leaf_dependency_fpl` contains the leaf dependencies for that 
- target.
-
- This function checks the build status of the target relative to its dependencies.
-
- It returns a dictionary with the following fields based on the result of the check:
-
-     type   -> A string indicating the result type:
-               'no_build_target_specified', 'non_existent_build_target',
-               'up_to_date', or 'need_to_build'.
-
-     message -> A string message describing the result (optional).
-
-     missing -> If type is 'non_existent_build_target', this field contains the 
-                list of missing build targets.
-
-     build_result -> If type is 'need_to_build', this field contains the list 
-                     of build result filenames that need to be rebuilt.
-*/
-
-def build_from_leaf(build_result_fpl ,leaf_dependency_fpl) {
-
-  if( !build_result_fpl || build_result_fpl.isEmpty() ){
-    return [
-      type: "no_build_target_specified"
-      ,message: "No build target specified"
-    ]
-  }
-
-  // Check if any build result file does not exist
-  def missing_build_fpl = build_result_fpl.findAll{ file_path ->
-    !new File(file_path).exists()
-  }
-  
-  if( !missing_build_fpl.isEmpty() ){
-    return [
-      type: "non_existent_build_target"
-      ,message: "Missing build targets"
-      ,missing: missing_build_fpl
-    ]
-  }
-
-  // Check if any dependency is newer than the build result files
-  def all_up_to_date_bool = build_result_fpl.every{ result_file_path ->
-    def result_file = new File(result_file_path)
-    !leaf_dependency_fpl.any{ dep_path ->
-      new File(dep_path).lastModified() > result_file.lastModified()
-    }
-  }
-
-  if( all_up_to_date_bool ){
-    return [
-      type: "up_to_date"
-      ,message: "Build result is up to date"
-    ]
-  }else{
-    return [
-      type: "need_to_build"
-      ,message: "Build result needs to be rebuilt"
-      ,build_result: build_result_fpl
-    ]
-  }
-}
diff --git a/developer/Lethe/build.gradle b/developer/Lethe/build.gradle
deleted file mode 100644
index e53add0..0000000
--- a/developer/Lethe/build.gradle
+++ /dev/null
@@ -1,71 +0,0 @@
-task setup {
-  doLast {
-    def dirs = [
-      "$(ANTLR_IN_PRIMARY_DIR)"
-      ,"$(JAVA_COMP_IN_DIR)"
-      ,"$(JAVA_COMP_IN_PRIMARY_DIR)"
-      ,"$(JAVA_COMP_IN_ANTLR_DIR)"
-      ,"$(JAVA_COMP_IN_SYN_DIR)"
-      ,"$(JVM_IN_DIR)"
-      ,"$(EXECUTOR_IN_DIR)"
-      ,"test"
-      ,"deprecated"
-      ,"experiment"
-      ,"ologist"
-      ,"temporary"
-    ]
-    dirs.each { dir ->
-      if (!file(dir).exists()) {
-        mkdir dir
-      }
-    }
-  }
-}
-
-task tool(type: Exec) {
-  dependsOn setup
-  commandLine '$(BIN_MAKE)', '-f', '$(EXECUTOR_IN_DIR)/makefile-tool.mk', '-$(MAKEFLAGS)', 'all'
-}
-
-task project(type: Exec) {
-  dependsOn tool
-  commandLine '$(BIN_MAKE)', '-f', '$(EXECUTOR_IN_DIR)/makefile-project.mk', '-$(MAKEFLAGS)', 'all'
-}
-
-task clean {
-  doLast {
-    println "Use the command `clean <option>` instead of make."
-  }
-}
-
-task version {
-  doLast {
-    println "ANTLR_JAR is '${notdir(ANTLR_JAR)}'"
-    exec {
-      commandLine '$(JAVA_COMP)', '--version'
-    }
-    exec {
-      commandLine '$(JAVA_ARCHIVE)', '--version'
-    }
-    exec {
-      commandLine 'make', '-v'
-    }
-    println "makefile 0.4"
-  }
-}
-
-task all {
-  dependsOn project
-}
-
-task nothing {
-  doLast {
-    // useful for distinguishing between make syntax errors and build errors
-  }
-}
-
-tasks.withType(Exec) {
-  doFirst {
-    println "Executing $name"
-  }
-}
diff --git a/developer/Lethe/build.html b/developer/Lethe/build.html
deleted file mode 100644
index ac24ab4..0000000
--- a/developer/Lethe/build.html
+++ /dev/null
@@ -1,90 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Building the Project: A Developer's Guide</title>
-</head>
-<body>
-
-  <h1>Building the Project: A Developer’s Guide</h1>
-
-  <p>This document is intended to guide developers on how to build existing programs and extend the build environment when needed.</p>
-
-  <h2>Section 1: Building Existing Programs</h2>
-
-  <h3>1.1 Prerequisites</h3>
-  <ul>
-    <li><strong>Setting Up Your Environment:</strong> 
-      Ensure that <code>make</code> is available in your system’s <code>PATH</code>.
-      Make sure necessary environment variables such as <code>DEVELOPER_HOME</code> and <code>EXECUTOR_IN_DIR</code> are set.
-      Source the <code>env_build</code> script to configure the environment:
-      <pre><code>source /path/to/env_build</code></pre>
-    </li>
-  </ul>
-
-  <h3>1.2 Basic Build Process</h3>
-  <ul>
-    <li><strong>How to Use Make:</strong> 
-      Developers can use the <code>make</code> command to build specific programs. 
-      For example:
-      <pre><code>make X</code></pre>
-      Here, <code>X</code> is the name of the program you wish to build. 
-      If you do not specify any program, <code>make</code> will build the entire project:
-      <pre><code>make</code></pre>
-    </li>
-    <li><strong>Sample Commands:</strong>
-      <pre><code>make Arithmetic_Echo</code></pre>
-      <pre><code>make Arithmetic_Syntax</code></pre>
-    </li>
-  </ul>
-
-  <h3>1.3 Understanding the Output</h3>
-  <ul>
-    <li>After a successful build, executables will be created in the <code>executor</code> directory.
-      <br>The <code>makefile-top.mk</code> file will be the top-level control file for managing the build process.
-    </li>
-  </ul>
-
-  <h2>Section 2: Advanced Usage for Developers</h2>
-
-  <h3>2.1 Adding New Programs</h3>
-  <ul>
-    <li><strong>Steps to Add a New Program:</strong>
-      <ul>
-        <li>Modify <code>makefile-project.mk</code> and <code>makefile-tool.mk</code> to include the new program.</li>
-        <li>Add the program name to the <code>EXECUTOR_IN_FL</code> list in <code>env_build</code>.</li>
-        <li>Ensure that source files (e.g., <code>.java</code> or ANTLR grammar files) are properly placed in the relevant directories.</li>
-      </ul>
-    </li>
-  </ul>
-
-  <h3>2.2 Advanced Make Commands</h3>
-  <ul>
-    <li><strong>Using <code>project-X</code> and <code>tool-Y</code>:</strong>
-      Developers can use advanced make commands to build only specific components.
-      For example:
-      <pre><code>make project-Arithmetic_Syntax</code></pre>
-      This command builds the <code>Arithmetic_Syntax</code> component only.
-      Similarly, use <code>make tool-X</code> to build a specific tool:
-      <pre><code>make tool-Y</code></pre>
-    </li>
-  </ul>
-
-  <h3>2.3 Debugging and Extending the Build Environment</h3>
-  <ul>
-    <li><strong>Environment Variables:</strong>
-      Developers can modify environment variables in the <code>env_build</code> script to add or remove programs, directories, or paths.
-      <br>Common variables include:
-      <ul>
-        <li><code>EXECUTOR_IN_FL</code>: The list of programs to build.</li>
-        <li><code>ANTLR_OUT_DIR</code>: Directory for ANTLR-generated files.</li>
-        <li><code>JAVA_COMP_IN_FPL</code>: File list for Java compilation.</li>
-      </ul>
-    </li>
-  </ul>
-
-</body>
-</html>
-
-
diff --git a/developer/Lethe/make b/developer/Lethe/make
deleted file mode 100755
index 714a070..0000000
--- a/developer/Lethe/make
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-
-if [[ -z "${DEVELOPER_HOME}" || -z "${EXECUTOR_IN_DIR}" ]]; then
-  echo "required variables not set. As seen by:"
-  echo "  DEVELOPER_HOME: $DEVELOPER_HOME"
-  echo "  EXECUTOR_IN_DIR: $EXECUTOR_IN_DIR"
-  exit 1
-fi
-
-cd "$DEVELOPER_HOME"
-
-# in case there have been edits to the environment
-source "${EXECUTOR_IN_DIR}"/env_build
-
-${BIN_MAKE} --no-print-directory -f "${EXECUTOR_IN_DIR}"/makefile-top.mk $@
diff --git a/developer/Lethe/makefile-project.mk b/developer/Lethe/makefile-project.mk
deleted file mode 100644
index 7f8d6ef..0000000
--- a/developer/Lethe/makefile-project.mk
+++ /dev/null
@@ -1,251 +0,0 @@
-#--------------------------------------------------------------------------------
-# Project build
-#
-# GNU makefile
-
-# turn off implicit rules, because they can do unexpected things.
-.SUFFIXES:
-MAKEFLAGS += -r
-
-# `make` considers that PHONY targets do not correspond to files (other
-# targets do and the files have their dates checked). This declaration renders
-# innocuous the "feature" where `make` always tries to make its own
-# makefiles. There is no command line switch to turn this "feature" off.
-.PHONY: $(MAKEFILE_LIST)
-
-# 'make' has a "feature" where it deletes what it determines to be intermediate
-# files. There is no command line switch to turn this "feature" off. Combine
-# this "feature" with implicit rules and have loads of fun.
-.PRECIOUS: $(MAKEFILE_LIST)
-
-#$(info makefile: $(MAKEFILE_LIST))
-#$(info project_MAKECMDGOALS: $(MAKECMDGOALS))
-
-# for recursive make without leaving this makefile
-REMAKE = $(MAKE) -$(MAKEFLAGS) -f $(MAKEFILE_LIST)
-
-#================================================================================
-# Custom make targets
-#
-
-all: $(EXECUTOR_IN_FPL)
-
-
-#-----------------------------------------------
-# These do not require antlr generated java files
-
-RuleNameListRegx: $(EXECUTOR_IN_DIR)/RuleNameListRegx
-RuleNameList: $(EXECUTOR_IN_DIR)/RuleNameList
-
-Synthesize_SyntaxAnnotate_PrintVisitorMethod:\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/StringUtils.java\
-  $(EXECUTOR_IN_DIR)/Synthesize_SyntaxAnnotate_PrintVisitorMethod
-Synthesize_SyntaxAnnotate_PrintVisitor:\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/StringUtils.java\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java\
-  $(EXECUTOR_IN_DIR)/Synthesize_SyntaxAnnotate_PrintVisitor
-
-Synthesize_SyntaxAnnotate:\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/StringUtils.java\https://github.com/Thomas-Walker-Lynch/GQL_to_Cypher
-  $(EXECUTOR_IN_DIR)/Synthesize_SyntaxAnnotate
-
-#-----------------------------------------------
-# Arithmetic
-
-ANTLR_OUT_Arithmetic_FPL:= $(shell ANTLR_OUT_FL Arithmetic -path $(ANTLR_OUT_DIR))
-#$(info ANTLR_OUT_Arithmetic_FPL: $(ANTLR_OUT_Arithmetic_FPL))
-Arithmetic_Echo:\
-  $(ANTLR_OUT_Arithmetic_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_Echo_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic_Echo
-
-Arithmetic_Echo__Test:\
-  $(ANTLR_OUT_Arithmetic_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_Echo_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic_Echo__Test
-
-Arithmetic_SyntaxAnnotate:\
-  $(ANTLR_OUT_Arithmetic_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic_SyntaxAnnotate
-
-Arithmetic_SyntaxAnnotate__Test:\
-  $(ANTLR_OUT_Arithmetic_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic_SyntaxAnnotate__Test
-
-Arithmetic_Swap:\
-  $(ANTLR_OUT_Arithmetic_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_SwapVisitor.java\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic_Echo_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic_Swap
-
-#-----------------------------------------------
-# Arithmetic2
-# 
-
-ANTLR_OUT_Arithmetic2_FPL:= $(shell ANTLR_OUT_FL Arithmetic2 -path $(ANTLR_OUT_DIR))
-Arithmetic2_SyntaxAnnotate:\
-  $(ANTLR_OUT_Arithmetic2_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic2_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic2_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic2_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic2_SyntaxAnnotate
-
-Arithmetic2_SyntaxAnnotate__Test:\
-  $(ANTLR_OUT_Arithmetic2_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/Arithmetic2_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_Arithmetic2_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_Arithmetic2_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/Arithmetic2_SyntaxAnnotate__Test
-
-#-----------------------------------------------
-# Parsing/Analyzing ANTLR grammars
-#
-
-ANTLR_OUT_ANTLRv4_FPL:= $(shell ANTLR_OUT_FL ANTLRv4 -path $(ANTLR_OUT_DIR))
-ANTLRv4_SyntaxAnnotate:\
-  $(ANTLR_OUT_ANTLRv4_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/ANTLRv4_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_ANTLRv4_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_ANTLRv4_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/ANTLRv4_SyntaxAnnotate
-
-
-#-----------------------------------------------
-#  GQL_20240412
-
-ANTLR_OUT_GQL_20240412_FPL := $(shell ANTLR_OUT_FL GQL_20240412 -path $(ANTLR_OUT_DIR))
-GQL_20240412_SyntaxAnnotate:\
-  $(ANTLR_OUT_GQL_20240412_FPL)\
-  $(JAVA_COMP_IN_PRIMARY_DIR)/GQL_20240412_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_GQL_20240412_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_GQL_20240412_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/GQL_20240412_SyntaxAnnotate
-
-GQL_20240412_SyntaxAnnotate__Test: \
-  $(ANTLR_OUT_GQL_20240412_FPL) \
-  $(JAVA_COMP_IN_PRIMARY_DIR)/GQL_20240412_SyntaxAnnotate_PrintVisitor.java
-	@if [ -z "$(ANTLR_OUT_GQL_20240412_FPL)" ]; then \
-	  echo "variable ANTLR_OUT_GQL_20240412_FPL empty."; \
-	  exit 1; \
-	fi
-	$(REMAKE) $(EXECUTOR_IN_DIR)/GQL_20240412_SyntaxAnnotate__Test
-
-
-TerminalToCategory: 
-	$(REMAKE) $(EXECUTOR_IN_DIR)/TerminalToCategory
-
-GrammarSplitter: 
-	$(REMAKE) $(EXECUTOR_IN_DIR)/GrammarSplitter
-
-#-----------------------------------------------
-# Compile all the .java files.
-
-java: $(JAVA_COMP_OUT_FPL)
-
-
-#================================================================================
-# generic targets, aka recipes
-#
-
-# this section is not parallel make friendly
-# $(ANTLR_OUT_DIR)/%Lexer.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-# $(ANTLR_OUT_DIR)/%Parser.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-# $(ANTLR_OUT_DIR)/%BaseListener.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-# $(ANTLR_OUT_DIR)/%Listener.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-# $(ANTLR_OUT_DIR)/%BaseVisitor.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-# $(ANTLR_OUT_DIR)/%Visitor.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-# 	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-
-#--------------------
-# for a single `<name>.g4` grammar file
-
-$(ANTLR_OUT_DIR)/%Lexer.java \
-$(ANTLR_OUT_DIR)/%Parser.java \
-$(ANTLR_OUT_DIR)/%BaseListener.java \
-$(ANTLR_OUT_DIR)/%Listener.java \
-$(ANTLR_OUT_DIR)/%BaseVisitor.java \
-$(ANTLR_OUT_DIR)/%Visitor.java: $(ANTLR_IN_PRIMARY_DIR)/%.g4
-	@echo "copiling grammar from:" $<
-	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-
-#--------------------
-# For separate `<mame>Lexer.g4` and `<name>Parser.g4` files.
-# `make` prefers shorter pattern matches, so this should work.
-#
-
-$(ANTLR_OUT_DIR)/LexerAdaptor.java: $(ANTLR_IN_PRIMARY_DIR)/LexerAdaptor.java
-	cp $(ANTLR_IN_PRIMARY_DIR)/LexerAdaptor.java $(ANTLR_OUT_DIR)
-
-$(ANTLR_OUT_DIR)/%Lexer.java: $(ANTLR_IN_PRIMARY_DIR)/%Lexer.g4 $(ANTLR_OUT_DIR)/LexerAdaptor.java
-	@echo "making lexer grammar from:" $<
-	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -o $(ANTLR_OUT_DIR_PARENT) $<
-
-# Rule for all generated files from Parser.g4
-$(ANTLR_OUT_DIR)/%Parser.java \
-$(ANTLR_OUT_DIR)/%BaseListener.java \
-$(ANTLR_OUT_DIR)/%Listener.java \
-$(ANTLR_OUT_DIR)/%BaseVisitor.java \
-$(ANTLR_OUT_DIR)/%Visitor.java: $(ANTLR_IN_PRIMARY_DIR)/%Parser.g4
-	@echo "making other grammar files from:" $<
-	$(JAVA_INTERP) -jar $(ANTLR_JAR) -Dlanguage=Java -visitor -lib $(ANTLR_OUT_DIR) -o $(ANTLR_OUT_DIR_PARENT) $<
-
-#---------------------
-
-# make .class file from .java file
-$(JAVA_COMP_OUT_DIR)/%.class: $(JAVA_COMP_IN_PRIMARY_DIR)/%.java
-	@echo "Compiling $<..."
-	$(JAVA_COMP) -d $(JAVA_COMP_OUT_DIR) -sourcepath $(JAVA_COMP_IN_DL) $<
-	@echo "Created $@"
-
-# Without this, `make` sees .jar files as intermediate and deletes them.
-.PRECIOUS: $(JAVA_COMP_OUT_DIR)/%.jar
-
-# make .jar from .class file
-$(JAVA_COMP_OUT_DIR)/%.class: $(JAVA_COMP_IN_PRIMARY_DIR)/%.java
-$(JAVA_COMP_OUT_DIR)/%.jar: $(JAVA_COMP_OUT_DIR)/%.class
-	@echo "Building $*..."
-	$(JAVA_ARCHIVE) cf $@ -C $(JAVA_COMP_OUT_DIR) $*.class
-	@echo "Created $@"
-
-#make the wrapper script from the .jar file
-$(EXECUTOR_IN_DIR)/%: $(JVM_IN_DIR)/%.jar
-	@echo "Creating program for $*..."
-	@echo "#!/usr/bin/env bash" > $(EXECUTOR_IN_DIR)/$*
-	@echo "$(JAVA_INTERP) -cp ${CLASSPATH}:${JVM_IN_DP}:$(JVM_IN_DP)/$*.jar $*" \$$\@ >> $(EXECUTOR_IN_DIR)/$*
-	chmod +x $(EXECUTOR_IN_DIR)/$*
-	@echo "Created program $(EXECUTOR_IN_DIR)/$*"
diff --git a/developer/Lethe/makefile-tool.mk b/developer/Lethe/makefile-tool.mk
deleted file mode 100644
index e43278b..0000000
--- a/developer/Lethe/makefile-tool.mk
+++ /dev/null
@@ -1,61 +0,0 @@
-#================================================================================
-# Build the tools that are needed for building the project.
-#
-# GNU makefile
-
-# turn off implicit rules, because they can do unexpected things.
-.SUFFIXES:
-MAKEFLAGS += -r
-
-# `make` considers that PHONY targets do not correspond to files (other
-# targets do and the files have their dates checked). This declaration renders
-# innocuous the "feature" where `make` always tries to make its own
-# makefiles. There is no command line switch to turn this "feature" off.
-.PHONY: $(MAKEFILE_LIST)
-
-# 'make' has a "feature" where it deletes what it determines to be intermediate
-# files. There is no command line switch to turn this "feature" off. Combine
-# this "feature" with implicit rules and have loads of fun.
-.PRECIOUS: $(MAKEFILE_LIST)
-
-#$(info makefile: $(MAKEFILE_LIST))
-#$(info project_MAKECMDGOALS: $(MAKECMDGOALS))
-
-# for recursive make without leaving this makefile
-REMAKE = $(MAKE) -$(MAKEFLAGS) -f $(MAKEFILE_LIST)
-
-#================================================================================
-# Custom make targets
-#
-.PHONY: all ANTLR_OUT_FL
-
-all: ANTLR_OUT_FL
-
-ANTLR_OUT_FL: $(EXECUTOR_IN_DIR)/ANTLR_OUT_FL
-
-#================================================================================
-# generic targets, aka recipes
-#
-
-# Without this, `make` sees .jar files as intermediate and deletes them.
-.PRECIOUS: $(JAVA_COMP_OUT_DIR)/%.jar
-
-# make .class file from .java file
-$(JAVA_COMP_OUT_DIR)/%.class: $(JAVA_COMP_IN_PRIMARY_DIR)/%.java
-	@echo "Compiling $<..."
-	$(JAVA_COMP) -d $(JAVA_COMP_OUT_DIR) -sourcepath $(JAVA_COMP_IN_DL) $<
-	@echo "Created $@"
-
-# make .jar from .class file
-$(JAVA_COMP_OUT_DIR)/%.jar: $(JAVA_COMP_OUT_DIR)/%.class
-	@echo "Building $*..."
-	$(JAVA_ARCHIVE) cf $@ -C $(JAVA_COMP_OUT_DIR) $*.class
-	@echo "Created $@"
-
-#make the wrapper script from the .jar file
-$(EXECUTOR_IN_DIR)/%: $(JVM_IN_DIR)/%.jar
-	@echo "Creating program for $*..."
-	@echo "#!/usr/bin/env bash" > $(EXECUTOR_IN_DIR)/$*
-	@echo "$(JAVA_INTERP) -cp ${CLASSPATH}:${JVM_IN_DP}:$(JVM_IN_DP)/$*.jar $*" \$$\@ >> $(EXECUTOR_IN_DIR)/$*
-	chmod +x $(EXECUTOR_IN_DIR)/$*
-	@echo "Created program $(EXECUTOR_IN_DIR)/$*"
diff --git a/developer/Lethe/makefile-top.mk b/developer/Lethe/makefile-top.mk
deleted file mode 100644
index 0642609..0000000
--- a/developer/Lethe/makefile-top.mk
+++ /dev/null
@@ -1,62 +0,0 @@
-#================================================================================
-# top level makefile calls makefile-tool and makefile-project
-#
-# GNU makefile
-
-# turn off implicit rules, because they can do unexpected things.
-.SUFFIXES:
-MAKEFLAGS += -r
-
-# `make` considers that PHONY targets do not correspond to files (other
-# targets do and the files have their dates checked). This declaration renders
-# innocuous the "feature" where `make` always tries to make its own
-# makefiles. There is no command line switch to turn this "feature" off.
-.PHONY: $(MAKEFILE_LIST)
-
-# 'make' has a "feature" where it deletes what it determines to be intermediate
-# files. There is no command line switch to turn this "feature" off. Combine
-# this "feature" with implicit rules and have loads of fun.
-.PRECIOUS: $(MAKEFILE_LIST)
-
-#$(info makefile: $(MAKEFILE_LIST))
-#$(info project_MAKECMDGOALS: $(MAKECMDGOALS))
-
-# for recursive make without leaving this makefile
-REMAKE = $(MAKE) -$(MAKEFLAGS) -f $(MAKEFILE_LIST)
-
-#================================================================================
-# Custom make targets
-#
-.PHONY: all nothing version clean setup
-
-all: project-all
-
-# useful for distinguishing between make syntax errors and build errors
-nothing:
-	@:
-
-version:
-	$(info ANTLR_JAR is '$(notdir $(ANTLR_JAR))')
-	@ $(JAVA_COMP) --version
-	@ $(JAVA_ARCHIVE) --version
-	@ make -v | head -n 1
-	@ echo "makefile 0.4"
-
-# `clean` is program independent of `make`
-clean:
-	@echo "Use the command `clean <option>` instead of make.`"
-
-setup:
-	mkdir -p $(ANTLR_IN_PRIMARY_DIR) $(JAVA_COMP_IN_PRIMARY_DIR) $(JVM_IN_DIR) $(EXECUTOR_IN_DIR) test deprecated experiment ologist temporary
-
-# Ensure tools are built before building the project programs
-tool-%: setup
-	$(BIN_MAKE) -f $(EXECUTOR_IN_DIR)/makefile-tool.mk -$(MAKEFLAGS) $*
-
-project-%: tool-all
-	$(BIN_MAKE) -f $(EXECUTOR_IN_DIR)/makefile-project.mk -$(MAKEFLAGS) $*
-
-# delegate other targets to the project
-%: project-%
-	@:
-
diff --git a/developer/executor/env_build b/developer/executor/env_build
deleted file mode 100755
index 036961a..0000000
--- a/developer/executor/env_build
+++ /dev/null
@@ -1,155 +0,0 @@
-#!/usr/bin/env bash
-
-# The build environment. 
-#
-# Hopefully no edits are required here to build this project's programs.
-#
-# The most common edit here is to add the name of a new program to the EXECUTOR_IN_FL.
-# That variable is found in the next section.
-#
-# The `env_dev` script should have been sourced already. (env_dev is analogous
-# to the Python virutal environment `activate`.)  `env_dev` will set `developer/executor/`
-# first in the search PATH.  In that directory there is a script called `make` which
-# is a wrapper to `/bin/make`.  That script sources this file.  Hence, this file
-# is the environment for make, aka the build environment.
-#
-# Note these suffixes found on variable names:
-# _FL  = File List
-# _FP  = File Path
-# _FPL = File Path List 
-# _DL  = Directory List
-# _DP  = Directory path
-# _DPL = Directory path list
-#
-# _PRIMARY = stuff not built
-# _IN  things input to some program
-# _OUT things output by some program
-#
-# Relative paths values are relative to the $REPO_HOME/developer directory, unless
-# for good reason which is obvious or stated in a comment adjacent to the variable.
-#
-# This has not yet been split into 'tools'  and 'project'. The redundant build targets
-# should discovered to have already been built.
-
-# Ensure the script is sourced rather than run directly
-if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
-  echo "This script must be sourced, not executed. Exiting."
-  return 1
-fi
-export ENV_BUILD_VERSION="0.2"
-
-#--------------------------------------------------------------------------------
-# programs to be built by make project-all (or more simply `make`)
-#
-
-export EXECUTOR_IN_FL="\
-  RuleNameListRegx\
-  RuleNameList\
-  Synthesize_SyntaxAnnotate_PrintVisitorMethod\
-  Synthesize_SyntaxAnnotate_PrintVisitor\
-  Synthesize_SyntaxAnnotate\
-  ANTLRv4_RuleNameList\
-  Arithmetic_Echo\
-  Arithmetic_Echo__Test\
-  Arithmetic_SyntaxAnnotate\
-  Arithmetic_SyntaxAnnotate__Test\
-  Arithmetic2_SyntaxAnnotate\
-  Arithmetic2_SyntaxAnnotate__Test\
-  ANTLRv4_SyntaxAnnotate\
-  Arithmetic_Swap\
-  "
-
-# where make will put the programs
-export EXECUTOR_IN_DIR="executor"
-
-# Generate the EXECUTOR_IN_FPL list
-export EXECUTOR_IN_FPL=$(for program in $EXECUTOR_IN_FL; do echo "${EXECUTOR_IN_DIR}/${program}"; done | tr '\n' ' ')
-
-#--------------------------------------------------------------------------------
-# developer build directories
-#
-
-# ANTLR directories
-export ANTLR_IN_PRIMARY_DIR="ANTLR"
-export ANTLR_OUT_DIR="javac/ANTLR"
-export ANTLR_OUT_DIR_PARENT="javac"
-
-# JAVA directories
-export JAVA_COMP_IN_DIR="javac"
-export JAVA_COMP_IN_PRIMARY_DIR="javac/primary"
-export JAVA_COMP_IN_ANTLR_DIR="${ANTLR_OUT_DIR}"
-export JAVA_COMP_IN_SYN_DIR="javac/synthesized"
-export JAVA_COMP_IN_DL="${JAVA_COMP_IN_PRIMARY_DIR}:${JAVA_COMP_IN_ANTLR_DIR}"
-export JAVA_COMP_OUT_DIR="jvm"
-
-# JVM
-export JVM_IN_DIR="${JAVA_COMP_OUT_DIR}"
-
-# The generated build scripts might need arguments that are fully specified paths.
-export DEVELOPER_HOME_DP="/var/user_data/Thomas-developer/GQL_to_Cypher/developer"
-export JVM_IN_DP="$DEVELOPER_HOME_DP/jvm"
-export EXECUTOR_IN_DP="$DEVELOPER_HOME_DP/executor"
-export CLASSPATH="${CLASSPATH}:${JVM_IN_DP}"
-
-#--------------------------------------------------------------------------------
-# tools used
-#
-#  set by project manager: JAVA_HOME, ANTLR_JAR, DEVELOPER_HOME
-#
-export BIN_MAKE=/bin/make
-export JAVA_COMP="${JAVA_HOME}/bin/javac"
-export JAVA_INTERP="${JAVA_HOME}/bin/java"
-export JAVA_ARCHIVE="${JAVA_HOME}/bin/jar"
-export CLASSPATH="${CLASSPATH}:$ANTLR_JAR"
-
-#--------------------------------------------------------------------------------
-# misc
-#
-export TEMP_DIR="$DEVELOPER_HOME"/Erebus
-
-#--------------------------------------------------------------------------------
-# ANTLR files
-#
-export ANTLR_IN_PRIMARY_FPL=$(ls ${ANTLR_IN_PRIMARY_DIR}/*.g4 2>/dev/null | tr '\n' ' ')
-export ANTLR_GRAMMAR_LIST=$(basename -s .g4 ${ANTLR_IN_PRIMARY_FPL})
-if [ -z "${ANTLR_IN_PRIMARY_FPL}" ]; then
-  echo "No ANTLR input grammar files found"
-fi
-
-#--------------------------------------------------------------------------------
-# Java files 
-#
-
-# JAVA input files
-export JAVA_COMP_IN_PRIMARY_FPL=$(ls ${JAVA_COMP_IN_PRIMARY_DIR}/*.java 2>/dev/null | tr '\n' ' ')
-export JAVA_COMP_IN_ANTLR_FPL=${ANTLR_OUT_FPL}
-export JAVA_COMP_IN_FPL="${JAVA_COMP_IN_PRIMARY_FPL} ${JAVA_COMP_IN_ANTLR_FPL}"
-
-# JAVA will produce these output files
-export JAVA_COMP_OUT_PRIMARY_FPL=$(echo ${JAVA_COMP_IN_PRIMARY_FPL} | sed "s|${JAVA_COMP_IN_PRIMARY_DIR}/|${JAVA_COMP_OUT_DIR}/|g" | sed "s|.java|.class|g")
-export JAVA_COMP_OUT_ANTLR_FPL=$(echo ${JAVA_COMP_IN_ANTLR_FPL} | sed "s|${JAVA_COMP_IN_ANTLR_DIR}/|${JAVA_COMP_OUT_DIR}/|g" | sed "s|.java|.class|g")
-export JAVA_COMP_OUT_FPL="${JAVA_COMP_OUT_PRIMARY_FPL} ${JAVA_COMP_OUT_ANTLR_FPL}"
-#--------------------------------------------------------------------------------
-# JAR files
-#
-
-# List of JAR files to be built
-JAR_OUT_FPL=""
-for program_path in ${EXECUTOR_IN_FPL}; do
-  program_name=$(basename ${program_path})
-  class_file="${JAVA_COMP_OUT_DIR}/${program_name}.class"
-  # Check if the .class file is in JAVA_COMP_OUT_FPL
-  for item in ${JAVA_COMP_OUT_FPL}; do
-    # if so add it to the JAR_OUT_FPL
-    if [[ "${item}" == "${class_file}" ]]; then
-      jar_file="${JAVA_COMP_OUT_DIR}/${program_name}.jar"
-      JAR_OUT_FPL="${JAR_OUT_FPL} ${jar_file}"
-      break
-    fi
-  done
-done
-export JAR_OUT_FPL
-
-
-#  LocalWords:  ANTLRv PrintRuleNameListRegx RuleNameListRegx RuleNameList
-#  LocalWords:  PrintVisitorMethod PrintVisitor SyntaxAnnotate
diff --git a/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate.java b/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate.java
deleted file mode 100644
index c4577ca..0000000
--- a/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/* This file generated by Synthesize_SyntaxAnnotate given the grammar
-   name: Arithmetic2.
-
-   SyntaxAnnotate programs accept a source file, then echo the source file with
-   syntax annotation. Synthesize_SyntaxAnnotate produces a SyntaxAnnotate program
-   for a specific grammar.
- */
-import org.antlr.v4.runtime.*;
-import org.antlr.v4.runtime.tree.*;
-import java.io.IOException;
-import java.nio.file.Files;
-import java.nio.file.Paths;
-import java.util.ArrayList;
-import java.util.List;
-
-public class Arithmetic2_SyntaxAnnotate {
-  // Constant for the usage message
-  private static final String USAGE_MESSAGE =
-    "Usage: Arithmetic2_SyntaxAnnotate [-version] [-pp] <source-file-path>";
-
-  public static void main(String[] args) throws IOException {
-    if (args.length == 0) {
-      System.err.println(USAGE_MESSAGE);
-      System.exit(1);
-    }
-    boolean error = false;
-    boolean version = false;
-    boolean pretty_print = false;
-    List<String> argList = new ArrayList<>();
-    for (int i = 0; i < args.length; i++) {
-      String arg = args[i];
-      if (arg.startsWith("-")) {
-        switch (arg) {
-        case "-version":
-          version = true;
-          break;
-        case "-pp":
-          pretty_print = true;
-          break;
-        default:
-          System.err.println("Unrecognized option: " + arg);
-          error = true;
-        }
-      } else {
-        argList.add(arg);
-      }
-    }
-    if(version){
-      System.out.println("version 0.1");
-      if(error){
-        System.exit(1);
-      }else{
-        System.exit(0);
-      }
-    }
-    if (argList.size() != 1) {
-      System.err.println("Expected exactly one non-option argument.");
-      error = true;
-    }
-    if(error){
-      System.err.println(USAGE_MESSAGE);
-      System.exit(1);
-    }
-
-    String input_file = argList.get(0);
-    String input = Files.readString(Paths.get(input_file));
-
-    try {
-      Arithmetic2Lexer lexer = new Arithmetic2Lexer(CharStreams.fromString(input));
-      CommonTokenStream tokens = new CommonTokenStream(lexer);
-      Arithmetic2Parser parser = new Arithmetic2Parser(tokens);
-      ParseTree tree = parser.program();
-
-      Arithmetic2_SyntaxAnnotate_PrintVisitor visitor = new Arithmetic2_SyntaxAnnotate_PrintVisitor(parser.getRuleNames(), pretty_print);
-      String output = visitor.visit(tree);
-      System.out.println(output);
-    } catch (Exception e) {
-      e.printStackTrace();
-    }
-  }
-}
diff --git a/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate_PrintVisitor.java b/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate_PrintVisitor.java
deleted file mode 100644
index 28a4866..0000000
--- a/developer/javac/synthesized/Arithmetic2_SyntaxAnnotate_PrintVisitor.java
+++ /dev/null
@@ -1,663 +0,0 @@
-/* This file synthesized by Synthesize_SyntaxAnnotate_PrintVisitor.
-*/
-import org.antlr.v4.runtime.tree.AbstractParseTreeVisitor;
-
-public class Arithmetic2_SyntaxAnnotate_PrintVisitor extends AbstractParseTreeVisitor<String> {
-  private final String[] ruleNames;
-
-  public Arithmetic2_SyntaxAnnotate_PrintVisitor(String[] ruleNames) {
-    this.ruleNames = ruleNames;
-  }
-
-    public String visitgrammarSpec (Arithmetic2Parser.grammarSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("grammarSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitgrammarDecl (Arithmetic2Parser.grammarDeclContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("grammarDecl(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitgrammarType (Arithmetic2Parser.grammarTypeContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("grammarType(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitprequelConstruct (Arithmetic2Parser.prequelConstructContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("prequelConstruct(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitoptionsSpec (Arithmetic2Parser.optionsSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("optionsSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitoption (Arithmetic2Parser.optionContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("option(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitoptionValue (Arithmetic2Parser.optionValueContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("optionValue(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitdelegateGrammars (Arithmetic2Parser.delegateGrammarsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("delegateGrammars(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitdelegateGrammar (Arithmetic2Parser.delegateGrammarContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("delegateGrammar(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visittokensSpec (Arithmetic2Parser.tokensSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("tokensSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitchannelsSpec (Arithmetic2Parser.channelsSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("channelsSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitidList (Arithmetic2Parser.idListContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("idList(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitaction_ (Arithmetic2Parser.action_Context ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("action_(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitactionScopeName (Arithmetic2Parser.actionScopeNameContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("actionScopeName(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitactionBlock (Arithmetic2Parser.actionBlockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("actionBlock(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitargActionBlock (Arithmetic2Parser.argActionBlockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("argActionBlock(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitmodeSpec (Arithmetic2Parser.modeSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("modeSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitrules (Arithmetic2Parser.rulesContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("rules(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleSpec (Arithmetic2Parser.ruleSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitparserRuleSpec (Arithmetic2Parser.parserRuleSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("parserRuleSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitexceptionGroup (Arithmetic2Parser.exceptionGroupContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("exceptionGroup(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitexceptionHandler (Arithmetic2Parser.exceptionHandlerContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("exceptionHandler(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitfinallyClause (Arithmetic2Parser.finallyClauseContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("finallyClause(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitrulePrequel (Arithmetic2Parser.rulePrequelContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("rulePrequel(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleReturns (Arithmetic2Parser.ruleReturnsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleReturns(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitthrowsSpec (Arithmetic2Parser.throwsSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("throwsSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlocalsSpec (Arithmetic2Parser.localsSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("localsSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleAction (Arithmetic2Parser.ruleActionContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleAction(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleModifiers (Arithmetic2Parser.ruleModifiersContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleModifiers(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleModifier (Arithmetic2Parser.ruleModifierContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleModifier(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleBlock (Arithmetic2Parser.ruleBlockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleBlock(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleAltList (Arithmetic2Parser.ruleAltListContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleAltList(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlabeledAlt (Arithmetic2Parser.labeledAltContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("labeledAlt(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerRuleSpec (Arithmetic2Parser.lexerRuleSpecContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerRuleSpec(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerRuleBlock (Arithmetic2Parser.lexerRuleBlockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerRuleBlock(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerAltList (Arithmetic2Parser.lexerAltListContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerAltList(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerAlt (Arithmetic2Parser.lexerAltContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerAlt(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerElements (Arithmetic2Parser.lexerElementsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerElements(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerElement (Arithmetic2Parser.lexerElementContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerElement(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerBlock (Arithmetic2Parser.lexerBlockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerBlock(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerCommands (Arithmetic2Parser.lexerCommandsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerCommands(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerCommand (Arithmetic2Parser.lexerCommandContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerCommand(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerCommandName (Arithmetic2Parser.lexerCommandNameContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerCommandName(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerCommandExpr (Arithmetic2Parser.lexerCommandExprContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerCommandExpr(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitaltList (Arithmetic2Parser.altListContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("altList(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitalternative (Arithmetic2Parser.alternativeContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("alternative(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitelement (Arithmetic2Parser.elementContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("element(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitpredicateOptions (Arithmetic2Parser.predicateOptionsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("predicateOptions(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitpredicateOption (Arithmetic2Parser.predicateOptionContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("predicateOption(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlabeledElement (Arithmetic2Parser.labeledElementContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("labeledElement(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitebnf (Arithmetic2Parser.ebnfContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ebnf(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitblockSuffix (Arithmetic2Parser.blockSuffixContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("blockSuffix(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitebnfSuffix (Arithmetic2Parser.ebnfSuffixContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ebnfSuffix(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitlexerAtom (Arithmetic2Parser.lexerAtomContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("lexerAtom(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitatom (Arithmetic2Parser.atomContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("atom(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitnotSet (Arithmetic2Parser.notSetContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("notSet(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitblockSet (Arithmetic2Parser.blockSetContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("blockSet(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitsetElement (Arithmetic2Parser.setElementContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("setElement(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitblock (Arithmetic2Parser.blockContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("block(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitruleref (Arithmetic2Parser.rulerefContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("ruleref(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitcharacterRange (Arithmetic2Parser.characterRangeContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("characterRange(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitterminalDef (Arithmetic2Parser.terminalDefContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("terminalDef(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitelementOptions (Arithmetic2Parser.elementOptionsContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("elementOptions(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitelementOption (Arithmetic2Parser.elementOptionContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("elementOption(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-  public String visitidentifier (Arithmetic2Parser.identifierContext ctx) {
-    StringBuilder result = new StringBuilder();
-    result.append("identifier(");
-    for (int i = 0; i < ctx.getChildCount(); i++) {
-      if (i > 0) result.append(", ");
-      result.append(visit(ctx.getChild(i)));
-    }
-    result.append(")");
-    return result.toString();
-  }
-
-}
diff --git a/developer/ologist/.githolder b/developer/ologist/.githolder
deleted file mode 100644
index e69de29..0000000
diff --git a/developer/ANTLR/ANTLRv4Lexer.g4 b/developers/ANTLR/ANTLRv4Lexer.g4
similarity index 100%
rename from developer/ANTLR/ANTLRv4Lexer.g4
rename to developers/ANTLR/ANTLRv4Lexer.g4
diff --git a/developer/ANTLR/ANTLRv4Parser.g4 b/developers/ANTLR/ANTLRv4Parser.g4
similarity index 100%
rename from developer/ANTLR/ANTLRv4Parser.g4
rename to developers/ANTLR/ANTLRv4Parser.g4
diff --git a/developer/ANTLR/Arithmetic.g4 b/developers/ANTLR/Arithmetic.g4
similarity index 100%
rename from developer/ANTLR/Arithmetic.g4
rename to developers/ANTLR/Arithmetic.g4
diff --git a/developer/ANTLR/Arithmetic2.g4 b/developers/ANTLR/Arithmetic2.g4
similarity index 100%
rename from developer/ANTLR/Arithmetic2.g4
rename to developers/ANTLR/Arithmetic2.g4
diff --git a/developer/ANTLR/GQL_20240412.g4 b/developers/ANTLR/GQL_20240412.g4
similarity index 100%
rename from developer/ANTLR/GQL_20240412.g4
rename to developers/ANTLR/GQL_20240412.g4
diff --git a/developer/ANTLR/GQL_20240412_rf1_literals.g4 b/developers/ANTLR/GQL_20240412_rf1_literals.g4
similarity index 100%
rename from developer/ANTLR/GQL_20240412_rf1_literals.g4
rename to developers/ANTLR/GQL_20240412_rf1_literals.g4
diff --git a/developer/ANTLR/GQL_20240412_substituted.g4 b/developers/ANTLR/GQL_20240412_substituted.g4
similarity index 100%
rename from developer/ANTLR/GQL_20240412_substituted.g4
rename to developers/ANTLR/GQL_20240412_substituted.g4
diff --git a/developer/ANTLR/LexBasic.g4 b/developers/ANTLR/LexBasic.g4
similarity index 100%
rename from developer/ANTLR/LexBasic.g4
rename to developers/ANTLR/LexBasic.g4
diff --git a/developer/ANTLR/LexerAdaptor.java b/developers/ANTLR/LexerAdaptor.java
similarity index 100%
rename from developer/ANTLR/LexerAdaptor.java
rename to developers/ANTLR/LexerAdaptor.java
diff --git a/developer/ANTLR/lexer_rules.g4 b/developers/ANTLR/lexer_rules.g4
similarity index 100%
rename from developer/ANTLR/lexer_rules.g4
rename to developers/ANTLR/lexer_rules.g4
diff --git a/developer/Erebus/.gitignore b/developers/Somnus/.gitignore
similarity index 100%
rename from developer/Erebus/.gitignore
rename to developers/Somnus/.gitignore
diff --git a/developers/build.gradle b/developers/build.gradle
new file mode 100644
index 0000000..47348ce
--- /dev/null
+++ b/developers/build.gradle
@@ -0,0 +1,13 @@
+
+
+
+
+
+// start of node_label recognizer functions list
+
+
+// end of DAG definition
+
+
+
+
diff --git a/developers/dependency_graph_definition.groovy b/developers/dependency_graph_definition.groovy
new file mode 100644
index 0000000..ec9028b
--- /dev/null
+++ b/developers/dependency_graph_definition.groovy
@@ -0,0 +1,387 @@
+/*
+ Here the developer describes the build environment and the graph of
+ dependencies between files to be built.
+
+ Each file is given a 'node'.  The node label is a path
+ to the file, existing or not. Node's can also be 'symbolic'
+ in that the label does not correspond to a file.
+
+ File paths are relative to the developer's directory.  Also
+ known as $DEVELOPER_HOME.
+
+ The program that processes this file is
+ `executor/build_from_dependency_graph.groovy`.  There are more notes and
+ definitions there.
+*/
+
+
+/*--------------------------------------------------------------------------------
+ The build environment
+
+ Each tool has its '_IN' and '_OUT' directories that are referenced in
+ their build scripts. This keeps references in the build script local.
+ (Flow of files between tools can be seen in the overlapping definitions
+ among the various _IN and _OUT directories.)
+
+ These suffixes are sometimes used to eliminate ambiguity:
+
+ _FN  = File Name
+ _FP  = File Path (last element of the FP is the FN)
+ _DN  = Directory Name
+ _DP  = Directory path (last element of the DP is the DN)
+
+ _FNL = File Name list
+ _FPL = File Path List 
+ _DNL = Directory path list
+ _DPL = Directory path list
+
+ Files in a _LEAF directory can not be built, and should never be deleted by the tools.
+
+*/
+
+def env = [:]
+
+// Required shell environment variables
+def varName_List = [
+  'REPO_HOME'
+  ,'PROJECT'
+  ,'ENV_BUILD_VERSION'
+  ,'DEVELOPER_HOME'
+]
+varName_List.each { varName ->
+  env[varName] = System.getenv(varName) ?: ""
+}
+
+// Optional shell environment variables
+def varNameOptional_List = [
+  'CLASSPATH'
+]
+varNameOptional_List.each { varName ->
+  env[varName] = System.getenv(varName) ?: ""
+}
+
+env.CLASSPATH += ":${env.ANTLR_JAR}"
+
+// tools used in build scripts
+def JAVA_COMP_FP = "${env.JAVA_HOME}/bin/javac"   // Java compiler path
+def JAVA_INTERP_FP = "${env.JAVA_HOME}/bin/java"  // Java interpreter path
+def JAVA_ARCHIVE_FP = "${env.JAVA_HOME}/bin/jar"  // Java archive tool path
+
+def dir_map = [
+  'ANTLR_IN_LEAF'       : 'ANTLR/'
+  ,'ANTLR_OUT'           : 'javac/ANTLR/'
+  ,'ANTLR_OUT_PARENT'    : 'javac/' // required by the antlr command to be a base for OUT
+  ,'EXECUTOR_IN'         : 'executor/'
+  ,'JAVA_COMP_IN'        : 'javac/'
+  ,'JAVA_COMP_IN_LEAF': 'javac/leaf/'
+  ,'JAVA_COMP_IN_ANTLR'  : 'javac/ANTLR/'
+  ,'JAVA_COMP_IN_SYN'    : 'javac/synthesized/'
+  ,'JAVA_COMP_OUT'       : 'jvm/'
+  ,'JVM_IN'              : 'jvm/'
+  ,'TEMP'                : 'Erebus/'
+]
+
+env.CLASSPATH += ":${dir_map.JVM_IN}"
+
+dir_map.JAVA_COMP_IN_LIST = 
+  "${dir_map.JAVA_COMP_IN_LEAF}" 
+  +":${dir_map.JAVA_COMP_IN_ANTLR}" 
+  +":${dir_map.JAVA_COMP_IN_SYN}"
+
+//--------------------------------------------------------------------------------
+// required environment variable check.  Will add additional preface checks here
+// should they become available.
+//
+
+// a helper function for `environment_check`
+def print_missing_var_list(missing_var_list){
+  if(missing_var_list.isEmpty()){
+    // Print nothing if the list is empty
+    return
+  } else if(missing_var_list.size() == 1){
+    println "This environment variable was not set: ${missing_var_list[0]}"
+  } else {
+    println "These environment variables were not set: ${missing_var_list.join(' ,')}"
+  }
+}
+
+task environment_check {
+  dependsOn ':installTools'
+  doFirst {
+
+    println "CLASSPATH: ${env.CLASSPATH}"
+    println "JAVA_COMP_IN_LIST: ${dir_map.JAVA_COMP_IN_LIST}"
+    
+    // did the required variables have definitions?
+    def error_missing = false
+    def error_project = false
+    def missing_var_list = [] // To collect missing environment variables
+    varName_List.each { varName ->
+      if(!env[varName]){
+        error_missing = true
+        missing_var_list << varName
+      }
+    }
+    print_missing_var_list(missing_var_list)
+    
+    // did the required variables have definitions?
+    if(env.PROJECT != "GQL_to_Cypher"){
+      error_project = true
+      println "Expected project 'GQL_to_Cypher' ,but found '${env.PROJECT}'."
+    }
+    if(error_missing || error_project){
+      throw new GradleException("Bailing due to missing environment variables.")
+    }
+  }
+  doLast {
+    println "================================================================================"
+    println "Building project .."
+  }
+}
+
+/*--------------------------------------------------------------------------------
+  Map keyed on label node definitions
+
+*/
+
+def node_map = [
+
+  "all" : [
+    ,type: "symbol"
+    ,neighbor: [
+      "ANTLR_OUT_FL"
+      ,"RuleNameList"
+      ,"RuleNameListRegx"
+      ,"Synthesize_SyntaxAnnotate"
+      ,"Synthesize_SyntaxAnnotate_PrintVisitor"
+      ,"Synthesize_SyntaxAnnotate_PrintVisitorMethod"
+    ]
+  ]
+
+  "ANTLR_OUT_FL" : [
+    ,type: "symbol"
+    ,neighbor: ["${dir_map.EXECUTOR_IN}/ANTLR_OUT_FL"]
+  ]
+
+  ,"RuleNameList" : [
+    ,type: "symbol"
+    ,neighbor: ["${dir_map.EXECUTOR_IN}/RuleNameList"]
+  ]
+
+  ,"RuleNameListRegx" : [
+    ,type: "symbol"
+    ,neighbor: ["${dir_map.EXECUTOR_IN}/RuleNameListRegx"]
+  ]
+
+  ,"Synthesize_SyntaxAnnotate" : [
+    ,type: "symbol"
+    ,neighbor: [
+      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
+      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate"
+    ]
+  ]
+
+  "Synthesize_SyntaxAnnotate.class" : [
+    type: 'path' , // It's a path type node
+    ,neighbor: [
+      "${dir_map.JAVA_COMP_IN_LEAF}/Synthesize_SyntaxAnnotate.java" , // Dependency
+      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"  // Dependency
+    ]
+    ,build: { node ,neighbor ->
+      def javac_cmd = "${JAVA_COMP_FP} -d ${dir_map.JAVA_COMP_OUT} ${neighbor.join(' ')}"
+      javac_cmd.execute().waitFor()
+    }
+  ]
+
+  ,"Synthesize_SyntaxAnnotate_PrintVisitor" : [
+    ,type: "symbol"
+    ,neighbor: [
+      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
+      ,"${dir_map.JAVA_COMP_IN_LEAF}/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java"
+      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate_PrintVisitor"
+    ]
+  ]
+
+  ,"Synthesize_SyntaxAnnotate_PrintVisitorMethod" : [
+    ,type: "symbol"
+    ,neighbor: [
+      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
+      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate_PrintVisitorMethod"
+    ]
+  ]
+]
+
+
+
+//--------------------------------------------------------------------------------
+// node making functions
+//
+
+// javac/leaf/<x> returns leaf node for javac/leaf/<x>
+def node_leaf_f(node_label) {
+  def leafNodePattern = ~/${dir_map['JAVA_COMP_IN_LEAF']}(.*)/
+  def match = node_label =~ leafNodePattern
+  if (!match) {
+    return [status: "no_match"]
+  }
+  def baseName = match[0][1]
+
+  def leafFilePath = "${dir_map['JAVA_COMP_IN_LEAF']}${baseName}"
+  def leafFile = new File(leafFilePath)
+  if (!leafFile.exists()) {
+    return [status: "no_match"]
+  }
+
+  return [
+    status: "matched"
+    ,label: node_label
+    ,type: "leaf"
+    ,neighbor: []
+  ]
+}
+
+// given executor/<x> returns node to build script wrapping jvm/<x>.jar
+def node_executor_f(node) {
+
+  def match = node =~ /^(executor\/)(${base})$/
+  if (!match) {
+    return [status: "no_match"]
+  }
+  def baseName = match[0][2]
+
+  def jarFilePath = "${dir_map['JVM_IN']}${baseName}.jar"
+  def wrapperFilePath = "${dir_map['EXECUTOR_IN']}${baseName}"
+
+  def jarFile = new File(jarFilePath)
+  if (!jarFile.exists()) {
+    return [status: "no_match"]
+  }
+
+  return [
+    status: "matched"
+    ,label: node
+    ,type: "path"
+    ,neighbor: [jarFilePath]
+    ,must_have: [jarFilePath]
+    ,build: { node ,neighbor -> 
+
+      // The script for wrapping the jar file:
+      def wrapper =
+      """
+      #!/usr/bin/env bash
+      ${dir_map['JAVA_INTERP']} -cp \${CLASSPATH}:${dir_map['JVM_IN']}:${dir_map['JVM_IN']}/${baseName}.jar ${baseName} \\\$\\@
+      """
+      
+      new File(wrapperFilePath).withWriter('UTF-8') { writer ->
+        writer.write(wrapper)
+      }
+
+      println "Creating executable wrapper script for ${baseName} in executor directory."
+      "chmod +x ${wrapperFilePath}".execute().text
+    }
+  ]
+}
+
+// given javac/ANTLR/<x>.java, returns node to build grammar <x>.g4
+def node_grammar_f(node) {
+
+  def match = node =~ /^(${dir_map['ANTLR_OUT']})(${base})(Lexer|Parser|BaseListener|Listener|BaseVisitor|Visitor)\.java$/
+  if( !match ){
+    return [status: "no_match"]
+  }
+
+  def grammarName = match[0][2]
+  def outputType = match[0][3]
+
+  def grammarFilePath = "${dir_map['ANTLR_IN_LEAF']}${grammarName}.g4"
+  def grammarFile = new File(grammarFilePath)
+
+  if( !grammarFile.exists() ){
+    return [status: "no_match"]
+  }
+
+  return [
+    status: "matched"
+    ,label: node
+    ,type: "path"
+    ,neighbor: [grammarFilePath]
+  ]
+}
+
+// given <x>.class returns node to build <x>.class from <x>.java
+def node_class_f(node) {
+
+  def match = node =~ /^(${dir_map['JAVA_COMP_OUT']})(${base})\.class$/
+  if( !match ){
+    return [status: "no_match"]
+  }
+
+  def baseName = match[0][2]
+  def javaFilePath = "${dir_map['JAVA_COMP_IN_PRIMARY_DIR']}/${baseName}.java"
+  def javaFile = new File(javaFilePath)
+
+  if( !javaFile.exists() ){
+    return [status: "no_match"]
+  }
+
+  return [
+    status: "matched",
+    label: node,
+    type: "path",  // It's a path node since we're building the .class file
+    neighbor: [javaFilePath],  // The corresponding .java file
+    build: { node, neighbor ->
+        def javac_cmd = "${JAVA_COMP_FP} -d ${dir_map.JAVA_COMP_OUT} -sourcepath ${dir_map.JAVA_COMP_IN_DL} ${neighbor[0]}"
+        javac_cmd.execute().waitFor()
+    }
+  ]
+}
+
+// given <x>.jar returns node to build <x>.jar from <x>.class
+def node_jar_f(node) {
+
+  // Use the symbolic name and base patterns
+  def match = node =~ /^(${dir_map['JAVA_COMP_OUT']})(${base})\.jar$/
+
+  if( !match ){
+    return [status: "no_match"]
+  }
+
+  def baseName = match[0][2]
+  def classFilePath = "${dir_map['JAVA_COMP_OUT']}${baseName}.class"
+  def classFile = new File(classFilePath)
+
+  if( !classFile.exists() ){
+    return [status: "no_match"]
+  }
+
+  return [
+    status: "matched"
+    ,label: node
+    ,type: "path"
+    ,neighbor: [classFilePath]
+    ,build: { node ,neighbor ->
+      println "Building jar for ${baseName}"
+      def command = "${ext.javaHome}/bin/jar cf ${baseName}.jar -C ${dir_map['JAVA_COMP_OUT']} ${baseName}.class"
+      return command.execute().text;
+    }
+  ]
+}
+
+// list of the recognizer functions
+def node_f_list = [
+  node_leaf_f
+  ,node_executor_f
+  ,node_grammar_f
+  ,node_class_f
+  ,node_jar_f
+]
+
+// comprehensions to make regexprs more readable
+def base = "[a-zA-Z0-9_-]+"
+def ext = "[a-zA-Z0-9_-]+$"
+def name = "${base}\\.${ext}"
+def path = ".+/${name}"
+
+
+
+// LocalWords:  wellformed
diff --git a/developer/executor/ANTLR_OUT_FL b/developers/executor/ANTLR_OUT_FL
similarity index 100%
rename from developer/executor/ANTLR_OUT_FL
rename to developers/executor/ANTLR_OUT_FL
diff --git a/developer/build.gradle b/developers/executor/build_from_dependency_graph.groovy
similarity index 53%
rename from developer/build.gradle
rename to developers/executor/build_from_dependency_graph.groovy
index 1bdbd5d..5023600 100644
--- a/developer/build.gradle
+++ b/developers/executor/build_from_dependency_graph.groovy
@@ -1,134 +1,39 @@
-//---------------------------------------------------------------------------------
-// globals
-
-// string comprehension includes for regular expressions
-def base = "[a-zA-Z0-9_-]+"
-def ext = "[a-zA-Z0-9_-]+$"
-def name = "${base}\\.${ext}"
-def path = ".+/${name}"
-
-//--------------------------------------------------------------------------------
-// Import variables from the environment
-//
-
-def env = [:]
-
-// Required shell environment variables
-def varName_List = [
-  'REPO_HOME',
-  'PROJECT',
-  'ENV_BUILD_VERSION',
-  'DEVELOPER_HOME'
-]
-varName_List.each { varName ->
-  def value = System.getenv(varName) ?: ""
-  env[varName] = value
-}
-
-// Optional shell environment variables
-def varNameOptional_List = [
-  'CLASSPATH'
-]
-varNameOptional_List.each { varName ->
-  def value = System.getenv(varName) ?: ""
-  env[varName] = value
-}
-
-env.CLASSPATH += ":${env.ANTLR_JAR}"
-
-//--------------------------------------------------------------------------------
-// PM installed tools to be used
-//    these should be added to the project object by the installer ,and taken
-//    from the project object here.
-//
-// Tools used (set by project manager: JAVA_HOME ,ANTLR_JAR ,DEVELOPER_HOME)
-def JAVA_COMP_FP = "${env.JAVA_HOME}/bin/javac"   // Java compiler path
-def JAVA_INTERP_FP = "${env.JAVA_HOME}/bin/java"  // Java interpreter path
-def JAVA_ARCHIVE_FP = "${env.JAVA_HOME}/bin/jar"  // Java archive tool path
-
-
-//--------------------------------------------------------------------------------
-// Directory structure
-//
-
-def dir_map = [
-  ,'EXECUTOR_IN'         : 'executor/'
-  ,'ANTLR_IN_LEAF'       : 'ANTLR/'
-  ,'ANTLR_OUT'           : 'javac/ANTLR/'
-  ,'ANTLR_OUT_PARENT'    : 'javac/'
-  ,'JAVA_COMP_IN'        : 'javac/'
-  ,'JAVA_COMP_IN_LEAF': 'javac/leaf/'
-  ,'JAVA_COMP_IN_ANTLR'  : 'javac/ANTLR/'
-  ,'JAVA_COMP_IN_SYN'    : 'javac/synthesized/'
-  ,'JAVA_COMP_OUT'       : 'jvm/'
-  ,'JVM_IN'              : 'jvm/'
-  ,'TEMP'                : 'Erebus/'
-]
+/*
+ Some terms:
 
-// Update CLASSPATH
-env.CLASSPATH += ":${dir_map.JVM_IN}"
+ a node is either malformed or 'wellformed'.  A wellformed node meets
+ the criteria set forth by `well_formed_node_q`.
 
-// Construct JAVA_COMP_IN_LIST dynamically and add to dp map
-dir_map.JAVA_COMP_IN_LIST = 
-  "${dir_map.JAVA_COMP_IN_LEAF}" +
-  ":${dir_map.JAVA_COMP_IN_ANTLR}" +
-  ":${dir_map.JAVA_COMP_IN_SYN}"
+ 'node': a dictionary, hopefully a wellformed one
+ 'file node': a 'path' or 'leaf' type node.
+ 'node file': for 'path' or 'leaf' nodes, path relative to the developer's directory.
 
-println "CLASSPATH: ${env.CLASSPATH}"
-println "JAVA_COMP_IN_LIST: ${dir_map.JAVA_COMP_IN_LIST}"
+ This code makes use of the following node properties:
+ - label: Unique label string. Used to reference nodes.
+ - type: The type of the node: 'leaf' ,'symbol' ,or 'path'.
+ - neighbor: list of the neighbor nodes labels
+ - must_have: list of node labels
+ - build: Code that builds the node.
+ - mark: a set of 'mark' tokens optionally placed on a node
 
+ For 'path' and 'leaf' type nodes, the node label is a file path.  Relative paths
+ are relative to the developer's directory.
 
-// Subroutine to print missing environment variables list message
-def printMissingVars(missingVars) {
-  if (missingVars.isEmpty()) {
-    // Print nothing if the list is empty
-    return
-  } else if (missingVars.size() == 1) {
-    println "This environment variable was not set: ${missingVars[0]}"
-  } else {
-    println "These environment variables were not set: ${missingVars.join(' ,')}"
-  }
-}
+ The dependency graph is defined by the `lookup` function. `lookup` when given
+ a node label returns the node, if found, or null.
 
-task preface {
-  dependsOn ':installTools'
-  doFirst {
-    
-    // Environment variable checks
-    def error_missing = false
-    def error_project = false
-    def missingVars = [] // To collect missing environment variables
-    varName_List.each { varName ->
-      if (!env[varName]) {
-        error_missing = true
-        missingVars << varName
-      }
-    }
-    printMissingVars(missingVars)
-    if (env.PROJECT != "GQL_to_Cypher") {
-      error_project = true
-      println "Expected project 'GQL_to_Cypher' ,but found '${env.PROJECT}'."
-    }
-    if (error_missing || error_project) {
-      throw new GradleException("Bailing due to missing environment variables.")
-    }
-  }
-  doLast {
-    println "================================================================================"
-    println "Building project .."
-  }
-}
+*/
 
 /*--------------------------------------------------------------------------------
- Some dependency graph features
+  DAG adjectives
+
+  node undefined for undefined node?
 */
 
 def all_node_type_set = ['symbol' ,'path' ,'leaf'] as Set
-
 def persistent_node_mark_set = ['cycle_member' ,'wellformed' ,'build_failed'] as Set
-
-def leaf_q = { node -> node.type && node.type == 'leaf' }
-def marked_q = { node -> node.mark && !node.mark.isEmpty() }
+def leaf_q = { node -> node && node.type && node.type == 'leaf' }
+def marked_q = { node -> node && node.mark && !node.mark.isEmpty() }
 
 // 'wellformed' and `cycle_member` marks set by `well_formed_q` function
 // 'build_failed' set by `run_build_scripts_f`
@@ -158,7 +63,12 @@ def file_exists_q(node_label) {
 
 
 /*--------------------------------------------------------------------------------
- Well formed dependency graph node checker.
+ Wellformed Node Check
+
+ The developer defines the nodes, so their form needs to be checked.
+
+ early bail on node not defined
+ legal path in the build directory makedir -p ... not really a acquirement 
 
 */
 def all_form_error_set = [
@@ -205,6 +115,8 @@ def wellformed_q = { node ->
   )
     form_error_set << 'symbol_has_build_code'
 
+  // an empty symbol would not participate in building anything
+  // mightbe shouldbe a warning.
   if( 
     node.type == "symbol" 
     && ( !node.neighbor || node.neighbor.isEmpty() )
@@ -217,18 +129,14 @@ def wellformed_q = { node ->
   )
     form_error_set << 'missing_required_build_code'
 
+  // have to build the path from something, really?  what if the build
+  // code is a generator?
   if( 
     node.type == "path" 
     && ( !node.neighbor || node.neighbor.isEmpty() )
   )
     form_error_set << 'build_target_has_no_dependencies'
 
-  if( 
-    node.type == "symbol" 
-    && ( node.neighbor || node.neighbor.isEmpty() )
-  )
-    form_error_set << 'symbol_has_no_dependencies'
-
   if( 
     node.type == "leaf" 
     && node.neighbor
@@ -241,324 +149,13 @@ def wellformed_q = { node ->
   return form_error_set
 }
 
-
-/*--------------------------------------------------------------------------------
- Dependency DAG definition.
-
- Programmers will add new entries here when adding new programs to be built.
-
- 'node': a dictionary of properties.
- 'file node': a path or leaf type node.
- 'node file': the label of a path or leaf type node ,relative to the developer's directory.
-
- Node Properties:
- - type: The type of the node: 'leaf' ,'symbol' ,or 'path'.
- - label: Unique label. AKA ,the 'node file'.
- - neighbor: List of labels for the node's dependencies.
- - must_have: Files that should not be removed if the given node file is not removed.
- - build: For path type nodes ,code that builds the node.
- - mark: a set of 'mark' tokens optionally placed on a node
-
- DAG is defined through the 'lookup' function ,which when given a label ,returns
- a dictionary. Lookup uses a combination of a map keyed on the label ,and a list
- of label recognizer functions that each return a dictionary when a match is
- found. 
-
-*/
-
-def node_map = [
-
-  "all" : [
-    ,type: "symbol"
-    ,neighbor: [
-      "ANTLR_OUT_FL"
-      ,"RuleNameList"
-      ,"RuleNameListRegx"
-      ,"Synthesize_SyntaxAnnotate"
-      ,"Synthesize_SyntaxAnnotate_PrintVisitor"
-      ,"Synthesize_SyntaxAnnotate_PrintVisitorMethod"
-    ]
-  ]
-
-  "ANTLR_OUT_FL" : [
-    ,type: "symbol"
-    ,neighbor: ["${dir_map.EXECUTOR_IN}/ANTLR_OUT_FL"]
-  ]
-
-  ,"RuleNameList" : [
-    ,type: "symbol"
-    ,neighbor: ["${dir_map.EXECUTOR_IN}/RuleNameList"]
-  ]
-
-  ,"RuleNameListRegx" : [
-    ,type: "symbol"
-    ,neighbor: ["${dir_map.EXECUTOR_IN}/RuleNameListRegx"]
-  ]
-
-  ,"Synthesize_SyntaxAnnotate" : [
-    ,type: "symbol"
-    ,neighbor: [
-      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
-      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate"
-    ]
-  ]
-
-  "Synthesize_SyntaxAnnotate.class" : [
-    type: 'path',  // It's a path type node
-    neighbor: [
-      "${dir_map.JAVA_COMP_IN_LEAF}/Synthesize_SyntaxAnnotate.java",  // Dependency
-      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"  // Dependency
-    ],
-    build: { node, neighbor ->
-      def javac_cmd = "${JAVA_COMP_FP} -d ${dir_map.JAVA_COMP_OUT} ${neighbor.join(' ')}"
-      javac_cmd.execute().waitFor()
-    }
-  ]
-
-
-  "Synthesize_SyntaxAnnotate.class" : [
-    type: "path",
-    neighbor: [
-      "${dir_map.JAVA_COMP_IN_SYN}/Synthesize_SyntaxAnnotate.java"
-    ],
-    build: { node ->
-      def src = "${dir_map.JAVA_COMP_IN_SYN}/Synthesize_SyntaxAnnotate.java"
-      def dest = "${dir_map.JAVA_COMP_IN_SYN}/Synthesize_SyntaxAnnotate.class"
-      exec {
-        commandLine = [JAVA_COMP_FP, '-d', dir_map.JAVA_COMP_OUT, src]
-      }
-      if (!file_exists_q(dest)) {
-        throw new GradleException("Failed to compile Synthesize_SyntaxAnnotate.java")
-      }
-    }
-  ]
-
-
-
-  ,"Synthesize_SyntaxAnnotate_PrintVisitor" : [
-    ,type: "symbol"
-    ,neighbor: [
-      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
-      ,"${dir_map.JAVA_COMP_IN_LEAF}/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java"
-      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate_PrintVisitor"
-    ]
-  ]
-
-  ,"Synthesize_SyntaxAnnotate_PrintVisitorMethod" : [
-    ,type: "symbol"
-    ,neighbor: [
-      "${dir_map.JAVA_COMP_IN_LEAF}/StringUtils.java"
-      ,"${dir_map.EXECUTOR_IN}/Synthesize_SyntaxAnnotate_PrintVisitorMethod"
-    ]
-  ]
-]
-
-// start of node_label recognizer functions list
-
-// recognizes any leaf node due to being located in javac/leaf
-def node_leaf_f(node_label) {
-  def leafNodePattern = ~/${dir_map['JAVA_COMP_IN_LEAF']}(.*)/
-  def match = node_label =~ leafNodePattern
-  if (!match) {
-    return [status: "no_match"]
-  }
-  def baseName = match[0][1]
-
-  def leafFilePath = "${dir_map['JAVA_COMP_IN_LEAF']}${baseName}"
-  def leafFile = new File(leafFilePath)
-  if (!leafFile.exists()) {
-    return [status: "no_match"]
-  }
-
-  return [
-    status: "matched"
-    ,label: node_label
-    ,type: "leaf"
-    ,neighbor: []
-  ]
-}
-
-// any shell wrapper (for wrapping a name corresponding .jar file)
-def node_executor_f(node) {
-
-  def match = node =~ /^(executor\/)(${base})$/
-  if (!match) {
-    return [status: "no_match"]
-  }
-  def baseName = match[0][2]
-
-  def jarFilePath = "${dir_map['JVM_IN']}${baseName}.jar"
-  def wrapperFilePath = "${dir_map['EXECUTOR_IN']}${baseName}"
-
-  def jarFile = new File(jarFilePath)
-  if (!jarFile.exists()) {
-    return [status: "no_match"]
-  }
-
-  return [
-    status: "matched"
-    ,label: node
-    ,type: "path"
-    ,neighbor: [jarFilePath]
-    ,must_have: [jarFilePath]
-    ,build: { node ,neighbor -> 
-
-      // The script for wrapping the jar file:
-      def wrapper =
-      """
-      #!/usr/bin/env bash
-      ${dir_map['JAVA_INTERP']} -cp \${CLASSPATH}:${dir_map['JVM_IN']}:${dir_map['JVM_IN']}/${baseName}.jar ${baseName} \\\$\\@
-      """
-      
-      new File(wrapperFilePath).withWriter('UTF-8') { writer ->
-        writer.write(wrapper)
-      }
-
-      println "Creating executable wrapper script for ${baseName} in executor directory."
-      "chmod +x ${wrapperFilePath}".execute().text
-    }
-  ]
-}
-
-// any antlr output java file
-def node_grammar_f(node) {
-
-  def match = node =~ /^(${dir_map['ANTLR_OUT']})(${base})(Lexer|Parser|BaseListener|Listener|BaseVisitor|Visitor)\.java$/
-  if( !match ){
-    return [status: "no_match"]
-  }
-
-  def grammarName = match[0][2]
-  def outputType = match[0][3]
-
-  def grammarFilePath = "${dir_map['ANTLR_IN_LEAF']}${grammarName}.g4"
-  def grammarFile = new File(grammarFilePath)
-
-  if( !grammarFile.exists() ){
-    return [status: "no_match"]
-  }
-
-  return [
-    status: "matched"
-    ,label: node
-    ,type: "path"
-    ,neighbor: [grammarFilePath]
-  ]
-}
-
-// Recognizes any class file (built from a corresponding .java file of the same name)
-def node_class_f(node) {
-
-  def match = node =~ /^(${dir_map['JAVA_COMP_OUT']})(${base})\.class$/
-  if( !match ){
-    return [status: "no_match"]
-  }
-
-  def baseName = match[0][2]
-  def javaFilePath = "${dir_map['JAVA_COMP_IN_PRIMARY_DIR']}/${baseName}.java"
-  def javaFile = new File(javaFilePath)
-
-  if( !javaFile.exists() ){
-    return [status: "no_match"]
-  }
-
-  return [
-    status: "matched",
-    label: node,
-    type: "path",  // It's a path node since we're building the .class file
-    neighbor: [javaFilePath],  // The corresponding .java file
-    build: { node, neighbor ->
-        def javac_cmd = "${JAVA_COMP_FP} -d ${dir_map.JAVA_COMP_OUT} -sourcepath ${dir_map.JAVA_COMP_IN_DL} ${neighbor[0]}"
-        javac_cmd.execute().waitFor()
-    }
-  ]
-}
-
-// any jar file (built from a corresponding class file)
-def node_jar_f(node) {
-
-  // Use the symbolic name and base patterns
-  def match = node =~ /^(${dir_map['JAVA_COMP_OUT']})(${base})\.jar$/
-
-  if( !match ){
-    return [status: "no_match"]
-  }
-
-  def baseName = match[0][2]
-  def classFilePath = "${dir_map['JAVA_COMP_OUT']}${baseName}.class"
-  def classFile = new File(classFilePath)
-
-  if( !classFile.exists() ){
-    return [status: "no_match"]
-  }
-
-  return [
-    status: "matched"
-    ,label: node
-    ,type: "path"
-    ,neighbor: [classFilePath]
-    ,build: { node ,neighbor ->
-      println "Building jar for ${baseName}"
-      def command = "${ext.javaHome}/bin/jar cf ${baseName}.jar -C ${dir_map['JAVA_COMP_OUT']} ${baseName}.class"
-      return command.execute().text;
-    }
-  ]
-}
-
-// list of the recognizer functions
-def node_f_list = [
-  node_leaf_f
-  ,node_executor_f
-  ,node_grammar_f
-  ,node_class_f
-  ,node_jar_f
-]
-
-// end of DAG definition
-
-/*--------------------------------------------------------------------------------
- Given a node_label ,returns the node or null.
-
-*/
-def lookup(node_label ,verbose = false){
-  def lookup_node = node_map[node_label]
-  if( lookup_node ){
-    lookup_node.label = node_label
-  } else {
-    def match_result
-    for(func in node_f_list){
-      match_result = func(node_label)
-      if(match_result.status == "matched"){
-        lookup_node = match_result
-        break
-      }
-    }
-  }
-  if( !lookup_node ){
-    if( verbose ) println "lookup:: Node ${node_label} could not be found."
-    return null
-  }
-  return lookup_node
-}
-
-// mark aware lookup function
-def lookup_marked_good(node_label ,verbose = false){
-  def node = lookup(node_label ,verbose)
-  if( node && marked_good_q(node) ) return node;
-  return null;
-}
-
 /*--------------------------------------------------------------------------------
  A well formed graph checker.  Traverses entire graph and marks nodes
  that are not well formed or that are part of a cycle.
 
- This must be run on the graph for `lookup_marked_good` to work.
 */
 
-/*
- Given a node label list. Applies well_formed_q to each node and marks the
- node accordingly. Returns 'all_wellformed' or 'exists_malformed'.
-*/
+// given a node label list, adds the 'wellformed' mark to wellformed nodes.
 def mark_the_wellformed_f(node_label_list ,boolean verbose = true){
   def all_wellformed = true
 
@@ -586,13 +183,8 @@ def mark_the_wellformed_f(node_label_list ,boolean verbose = true){
   return all_wellformed ? 'all_wellformed' : 'exists_malformed'
 }
 
-/*
- Given a path stack initialized with the path root ,descends to a leaf node
- while looking for cycles. Marks nodes as 'cycle_member' if a cycle is
- detected. Marks nodes as `wellformed` if `wellformed_q`.  Returns a set of
- tokens indicating the status: 'cycle_found' ,'defacto_leaf_node' ,and
- 'exists_malformed'.
-*/
+// descends un-visited leftmost path, while marking nodes as wellformed and if
+// they are put of a cycle.
 def markup_graph_f_descend(path_stack ,boolean verbose = true){
   def ret_value = [] as Set
   def local_path = path_stack.collect{ it[0] }
@@ -641,50 +233,45 @@ def markup_graph_f_descend(path_stack ,boolean verbose = true){
   }while(true)
 }
 
-/*
- Given root_node_labels ,marks up the graph and returns a set possibly
- containing 'all_wellformed' and 'cycles_exist'.
 
- Marks potentially added to each node include  'cycle_member' ,'wellformed'.
- Note that these marks are independent.
-*/
-def wellformed_graph_q(root_node_labels ,boolean verbose = true){
-  def ret_value = [] as Set
-  def exists_malformed = false;
 
-  // check the root nodes
-  def result = mark_the_wellformed_f(root_node_labels ,verbose)
-  if(result == 'exists_malformed'){
-    ret_value << 'exists_malformed'
-  }
+/*--------------------------------------------------------------------------------
+ This function defines the graph.
 
-  // Initialize the DFS tree iterator.
-  def path_stack = []
-  path_stack << root_node_labels.clone()
+ Lookup attempts to lookup a node label in the node_map, and failing that, it
+ tries each label pattern recognition function in order.
 
-  // iterate over left side tree descent ,not ideal as it starts at the
-  // root each time ,but avoids complexity in the cycle detection logic.
-  do{
-    def result = markup_graph_f_descend(path_stack ,verbose)
-    if('cycle_found' in result) ret_value << 'cycle_exists'
-    if('exists_malformed' in result) exists_malformed = true;
-
-    // increment the iterator to the next leftmost path
-    def top_list = path_stack[-1]
-    top_list.remove(0)
-    if(top_list.isEmpty()) path_stack.pop()
-
-  }while(!path_stack.isEmpty())
-
-  if(!exists_malformed) ret_value << 'all_wellformed'
-  if( verbose ){
-    if(exists_malformed) println("one or more malformed nodes were found")
-    def exists_cycle = 'cycle_found' in ret_value
-    if(exists_cycle) println("one or more cyclic dependency loop found")
-    if( exists_malformed || exists_cycle ) println("will attempt to build unaffected nodes")
+ lookup_marked_good can be run after `wellformed_graph_f` has marked up the
+ graph.  It will only return a node if a) found b) that is 'good'.
+ Note the `marked_good_q` adjective above.
+
+*/
+def lookup(node_label ,verbose = false){
+  def lookup_node = node_map[node_label]
+  if( lookup_node ){
+    lookup_node.label = node_label
+  } else {
+    def match_result
+    for(func in node_f_list){
+      match_result = func(node_label)
+      if(match_result.status == "matched"){
+        lookup_node = match_result
+        break
+      }
+    }
   }
+  if( !lookup_node ){
+    if( verbose ) println "lookup:: Node ${node_label} could not be found."
+    return null
+  }
+  return lookup_node
+}
 
-  return ret_value
+// mark aware lookup function
+def lookup_marked_good(node_label ,verbose = false){
+  def node = lookup(node_label ,verbose)
+  if( node && marked_good_q(node) ) return node;
+  return null;
 }
 
 
@@ -1009,3 +596,9 @@ def clean_nodes(root_node_labels ,boolean verbose = true){
 
 // LocalWords:  FN FPL DN DNL RuleNameListRegx RuleNameList PrintVisitorMethod
 // LocalWords:  PrintVisitor SyntaxAnnotate wellformed defacto acyclic
+g
+
+
+
+
+// LocalWords:  wellformed unvisited
diff --git a/developer/executor/cat_w_names b/developers/executor/cat_w_names
similarity index 100%
rename from developer/executor/cat_w_names
rename to developers/executor/cat_w_names
diff --git a/developer/executor/clean b/developers/executor/clean
similarity index 100%
rename from developer/executor/clean
rename to developers/executor/clean
diff --git a/developer/executor/clean_directory b/developers/executor/clean_directory
similarity index 100%
rename from developer/executor/clean_directory
rename to developers/executor/clean_directory
diff --git a/developer/executor/clean_file_list b/developers/executor/clean_file_list
similarity index 100%
rename from developer/executor/clean_file_list
rename to developers/executor/clean_file_list
diff --git a/developer/executor/clean_grammar b/developers/executor/clean_grammar
similarity index 100%
rename from developer/executor/clean_grammar
rename to developers/executor/clean_grammar
diff --git a/developer/executor/clean_program b/developers/executor/clean_program
similarity index 100%
rename from developer/executor/clean_program
rename to developers/executor/clean_program
diff --git a/developer/executor/gradle b/developers/executor/gradle
similarity index 100%
rename from developer/executor/gradle
rename to developers/executor/gradle
diff --git a/developer/Lethe/.githolder b/developers/experiment/.githolder
similarity index 100%
rename from developer/Lethe/.githolder
rename to developers/experiment/.githolder
diff --git a/developer/experiment/script2.sh b/developers/experiment/script2.sh
similarity index 100%
rename from developer/experiment/script2.sh
rename to developers/experiment/script2.sh
diff --git a/developer/javac/ANTLR/.gitignore b/developers/javac/ANTLR/.gitignore
similarity index 100%
rename from developer/javac/ANTLR/.gitignore
rename to developers/javac/ANTLR/.gitignore
diff --git a/developer/javac/leaf/ANTLR_OUT_FL.java b/developers/javac/leaf/ANTLR_OUT_FL.java
similarity index 100%
rename from developer/javac/leaf/ANTLR_OUT_FL.java
rename to developers/javac/leaf/ANTLR_OUT_FL.java
diff --git a/developer/javac/leaf/Arithmetic_Echo.java b/developers/javac/leaf/Arithmetic_Echo.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_Echo.java
rename to developers/javac/leaf/Arithmetic_Echo.java
diff --git a/developer/javac/leaf/Arithmetic_Echo_PrintVisitor.java b/developers/javac/leaf/Arithmetic_Echo_PrintVisitor.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_Echo_PrintVisitor.java
rename to developers/javac/leaf/Arithmetic_Echo_PrintVisitor.java
diff --git a/developer/javac/leaf/Arithmetic_Echo__Test.java b/developers/javac/leaf/Arithmetic_Echo__Test.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_Echo__Test.java
rename to developers/javac/leaf/Arithmetic_Echo__Test.java
diff --git a/developer/javac/leaf/Arithmetic_Swap.java b/developers/javac/leaf/Arithmetic_Swap.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_Swap.java
rename to developers/javac/leaf/Arithmetic_Swap.java
diff --git a/developer/javac/leaf/Arithmetic_SwapVisitor.java b/developers/javac/leaf/Arithmetic_SwapVisitor.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_SwapVisitor.java
rename to developers/javac/leaf/Arithmetic_SwapVisitor.java
diff --git a/developer/javac/leaf/Arithmetic_SyntaxAnnotate.java b/developers/javac/leaf/Arithmetic_SyntaxAnnotate.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_SyntaxAnnotate.java
rename to developers/javac/leaf/Arithmetic_SyntaxAnnotate.java
diff --git a/developer/javac/leaf/Arithmetic_SyntaxAnnotate_PrintVisitor.java b/developers/javac/leaf/Arithmetic_SyntaxAnnotate_PrintVisitor.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_SyntaxAnnotate_PrintVisitor.java
rename to developers/javac/leaf/Arithmetic_SyntaxAnnotate_PrintVisitor.java
diff --git a/developer/javac/leaf/Arithmetic_SyntaxAnnotate__Test.java b/developers/javac/leaf/Arithmetic_SyntaxAnnotate__Test.java
similarity index 100%
rename from developer/javac/leaf/Arithmetic_SyntaxAnnotate__Test.java
rename to developers/javac/leaf/Arithmetic_SyntaxAnnotate__Test.java
diff --git a/developer/javac/leaf/RuleNameList.java b/developers/javac/leaf/RuleNameList.java
similarity index 100%
rename from developer/javac/leaf/RuleNameList.java
rename to developers/javac/leaf/RuleNameList.java
diff --git a/developer/javac/leaf/RuleNameListRegx.java b/developers/javac/leaf/RuleNameListRegx.java
similarity index 100%
rename from developer/javac/leaf/RuleNameListRegx.java
rename to developers/javac/leaf/RuleNameListRegx.java
diff --git a/developer/javac/leaf/StringUtils.java b/developers/javac/leaf/StringUtils.java
similarity index 100%
rename from developer/javac/leaf/StringUtils.java
rename to developers/javac/leaf/StringUtils.java
diff --git a/developer/javac/leaf/Synthesize_SyntaxAnnotate.java b/developers/javac/leaf/Synthesize_SyntaxAnnotate.java
similarity index 100%
rename from developer/javac/leaf/Synthesize_SyntaxAnnotate.java
rename to developers/javac/leaf/Synthesize_SyntaxAnnotate.java
diff --git a/developer/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitor.java b/developers/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitor.java
similarity index 100%
rename from developer/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitor.java
rename to developers/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitor.java
diff --git a/developer/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java b/developers/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java
similarity index 100%
rename from developer/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java
rename to developers/javac/leaf/Synthesize_SyntaxAnnotate_PrintVisitorMethod.java
diff --git a/developer/javac/leaf/TestBench.java b/developers/javac/leaf/TestBench.java
similarity index 100%
rename from developer/javac/leaf/TestBench.java
rename to developers/javac/leaf/TestBench.java
diff --git a/developer/jvm/.gitignore b/developers/javac/synthesized/.gitignore
similarity index 100%
rename from developer/jvm/.gitignore
rename to developers/javac/synthesized/.gitignore
diff --git a/tool/.gitignore b/developers/jvm/.gitignore
similarity index 100%
rename from tool/.gitignore
rename to developers/jvm/.gitignore
diff --git a/developer/ologist/#rule_list.txt# b/developers/readers/#rule_list.txt#
similarity index 100%
rename from developer/ologist/#rule_list.txt#
rename to developers/readers/#rule_list.txt#
diff --git a/developer/experiment/.githolder b/developers/readers/.githolder
similarity index 100%
rename from developer/experiment/.githolder
rename to developers/readers/.githolder
diff --git a/developer/ologist/.ispell_antlr b/developers/readers/.ispell_antlr
similarity index 100%
rename from developer/ologist/.ispell_antlr
rename to developers/readers/.ispell_antlr
diff --git a/developer/ologist/Cypher_GQL_differences.txt b/developers/readers/Cypher_GQL_differences.txt
similarity index 100%
rename from developer/ologist/Cypher_GQL_differences.txt
rename to developers/readers/Cypher_GQL_differences.txt
diff --git a/developer/ologist/GQL_20240412_rule_list.txt b/developers/readers/GQL_20240412_rule_list.txt
similarity index 100%
rename from developer/ologist/GQL_20240412_rule_list.txt
rename to developers/readers/GQL_20240412_rule_list.txt
diff --git a/developer/ologist/antlr-mode.el b/developers/readers/antlr-mode.el
similarity index 100%
rename from developer/ologist/antlr-mode.el
rename to developers/readers/antlr-mode.el
diff --git a/developer/ologist/cycle_dection.html b/developers/readers/cycle_dection.html
similarity index 100%
rename from developer/ologist/cycle_dection.html
rename to developers/readers/cycle_dection.html
diff --git a/developer/ologist/dependency_graph.html b/developers/readers/dependency_graph.html
similarity index 100%
rename from developer/ologist/dependency_graph.html
rename to developers/readers/dependency_graph.html
diff --git a/developer/ologist/deps.gradle b/developers/readers/deps.gradle
similarity index 100%
rename from developer/ologist/deps.gradle
rename to developers/readers/deps.gradle
diff --git a/developer/ologist/emacs.txt b/developers/readers/emacs.txt
similarity index 100%
rename from developer/ologist/emacs.txt
rename to developers/readers/emacs.txt
diff --git a/developer/ologist/for_developers.md b/developers/readers/for_developers.md
similarity index 100%
rename from developer/ologist/for_developers.md
rename to developers/readers/for_developers.md
diff --git a/developer/ologist/grammar_source.txt b/developers/readers/grammar_source.txt
similarity index 100%
rename from developer/ologist/grammar_source.txt
rename to developers/readers/grammar_source.txt
diff --git a/developer/ologist/groovy.el b/developers/readers/groovy.el
similarity index 100%
rename from developer/ologist/groovy.el
rename to developers/readers/groovy.el
diff --git a/developer/ologist/node_labels_unique_q.txt b/developers/readers/node_labels_unique_q.txt
similarity index 100%
rename from developer/ologist/node_labels_unique_q.txt
rename to developers/readers/node_labels_unique_q.txt
diff --git a/developer/ologist/rule_list.txt b/developers/readers/rule_list.txt
similarity index 100%
rename from developer/ologist/rule_list.txt
rename to developers/readers/rule_list.txt
diff --git a/developer/ologist/rules_by_catebory.txt b/developers/readers/rules_by_catebory.txt
similarity index 100%
rename from developer/ologist/rules_by_catebory.txt
rename to developers/readers/rules_by_catebory.txt
diff --git a/developer/ologist/rules_by_category.html b/developers/readers/rules_by_category.html
similarity index 100%
rename from developer/ologist/rules_by_category.html
rename to developers/readers/rules_by_category.html
diff --git a/developer/ologist/terminal_symbol_list.txt b/developers/readers/terminal_symbol_list.txt
similarity index 100%
rename from developer/ologist/terminal_symbol_list.txt
rename to developers/readers/terminal_symbol_list.txt
diff --git a/developer/ologist/terminal_symbol_list_unsorted.txt b/developers/readers/terminal_symbol_list_unsorted.txt
similarity index 100%
rename from developer/ologist/terminal_symbol_list_unsorted.txt
rename to developers/readers/terminal_symbol_list_unsorted.txt
diff --git a/developers/tanuki/.gitignore b/developers/tanuki/.gitignore
new file mode 100644
index 0000000..2db43ed
--- /dev/null
+++ b/developers/tanuki/.gitignore
@@ -0,0 +1,4 @@
+
+*
+!/.gitignore
+
diff --git a/developer/test/Arithmetic_SyntaxAnnotate__Test_0.txt b/developers/test/Arithmetic_SyntaxAnnotate__Test_0.txt
similarity index 100%
rename from developer/test/Arithmetic_SyntaxAnnotate__Test_0.txt
rename to developers/test/Arithmetic_SyntaxAnnotate__Test_0.txt
diff --git a/developer/test/Arithmetic_SyntaxAnnotate__Test_1.txt b/developers/test/Arithmetic_SyntaxAnnotate__Test_1.txt
similarity index 100%
rename from developer/test/Arithmetic_SyntaxAnnotate__Test_1.txt
rename to developers/test/Arithmetic_SyntaxAnnotate__Test_1.txt
diff --git a/developer/test/Arithmetic_SyntaxAnnotate__Test_2.txt b/developers/test/Arithmetic_SyntaxAnnotate__Test_2.txt
similarity index 100%
rename from developer/test/Arithmetic_SyntaxAnnotate__Test_2.txt
rename to developers/test/Arithmetic_SyntaxAnnotate__Test_2.txt
diff --git a/developer/test/Arithmetic_SyntaxAnnotate__Test_3.txt b/developers/test/Arithmetic_SyntaxAnnotate__Test_3.txt
similarity index 100%
rename from developer/test/Arithmetic_SyntaxAnnotate__Test_3.txt
rename to developers/test/Arithmetic_SyntaxAnnotate__Test_3.txt
diff --git a/developer/test/Arithmetic_SyntaxAnnotate__Test_4.txt b/developers/test/Arithmetic_SyntaxAnnotate__Test_4.txt
similarity index 100%
rename from developer/test/Arithmetic_SyntaxAnnotate__Test_4.txt
rename to developers/test/Arithmetic_SyntaxAnnotate__Test_4.txt
diff --git a/developer/test/Neo4NBA/create_relationship_0.cypher b/developers/test/Neo4NBA/create_relationship_0.cypher
similarity index 100%
rename from developer/test/Neo4NBA/create_relationship_0.cypher
rename to developers/test/Neo4NBA/create_relationship_0.cypher
diff --git a/developer/test/Neo4NBA/create_team_0.cypher b/developers/test/Neo4NBA/create_team_0.cypher
similarity index 100%
rename from developer/test/Neo4NBA/create_team_0.cypher
rename to developers/test/Neo4NBA/create_team_0.cypher
diff --git a/developer/test/Neo4NBA/delete_player_and_relationship.cypher b/developers/test/Neo4NBA/delete_player_and_relationship.cypher
similarity index 100%
rename from developer/test/Neo4NBA/delete_player_and_relationship.cypher
rename to developers/test/Neo4NBA/delete_player_and_relationship.cypher
diff --git a/developer/test/Neo4NBA/notes.txt b/developers/test/Neo4NBA/notes.txt
similarity index 100%
rename from developer/test/Neo4NBA/notes.txt
rename to developers/test/Neo4NBA/notes.txt
diff --git a/developer/test/Neo4NBA/query_players_by_team_0.cypher b/developers/test/Neo4NBA/query_players_by_team_0.cypher
similarity index 100%
rename from developer/test/Neo4NBA/query_players_by_team_0.cypher
rename to developers/test/Neo4NBA/query_players_by_team_0.cypher
diff --git a/developer/test/Neo4NBA/updating_nodes_0.cypher b/developers/test/Neo4NBA/updating_nodes_0.cypher
similarity index 100%
rename from developer/test/Neo4NBA/updating_nodes_0.cypher
rename to developers/test/Neo4NBA/updating_nodes_0.cypher
diff --git a/developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(double_colon).gql b/developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(double_colon).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(double_colon).gql
rename to developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(double_colon).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(lexical).gql b/developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(lexical).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(lexical).gql
rename to developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_graph_type_(lexical).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_nested_graph_type_(double_colon).gql b/developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_nested_graph_type_(double_colon).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/create_closed_graph_from_nested_graph_type_(double_colon).gql
rename to developers/test/opengql_grammar_samples_20240801/create_closed_graph_from_nested_graph_type_(double_colon).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/create_graph.gql b/developers/test/opengql_grammar_samples_20240801/create_graph.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/create_graph.gql
rename to developers/test/opengql_grammar_samples_20240801/create_graph.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/create_schema.gql b/developers/test/opengql_grammar_samples_20240801/create_schema.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/create_schema.gql
rename to developers/test/opengql_grammar_samples_20240801/create_schema.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/insert_statement.gql b/developers/test/opengql_grammar_samples_20240801/insert_statement.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/insert_statement.gql
rename to developers/test/opengql_grammar_samples_20240801/insert_statement.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/match_and_insert_example.gql b/developers/test/opengql_grammar_samples_20240801/match_and_insert_example.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/match_and_insert_example.gql
rename to developers/test/opengql_grammar_samples_20240801/match_and_insert_example.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_braces).gql b/developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_braces).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_braces).gql
rename to developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_braces).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_parentheses).gql b/developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_parentheses).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_parentheses).gql
rename to developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(match_block_statement_in_parentheses).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(nested_match_statement).gql b/developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(nested_match_statement).gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(nested_match_statement).gql
rename to developers/test/opengql_grammar_samples_20240801/match_with_exists_predicate_(nested_match_statement).gql
diff --git a/developer/test/opengql_grammar_samples_20240801/session_set_graph_to_current_graph.gql b/developers/test/opengql_grammar_samples_20240801/session_set_graph_to_current_graph.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/session_set_graph_to_current_graph.gql
rename to developers/test/opengql_grammar_samples_20240801/session_set_graph_to_current_graph.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/session_set_graph_to_current_property_graph.gql b/developers/test/opengql_grammar_samples_20240801/session_set_graph_to_current_property_graph.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/session_set_graph_to_current_property_graph.gql
rename to developers/test/opengql_grammar_samples_20240801/session_set_graph_to_current_property_graph.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/session_set_property_as_value.gql b/developers/test/opengql_grammar_samples_20240801/session_set_property_as_value.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/session_set_property_as_value.gql
rename to developers/test/opengql_grammar_samples_20240801/session_set_property_as_value.gql
diff --git a/developer/test/opengql_grammar_samples_20240801/session_set_time_zone.gql b/developers/test/opengql_grammar_samples_20240801/session_set_time_zone.gql
similarity index 100%
rename from developer/test/opengql_grammar_samples_20240801/session_set_time_zone.gql
rename to developers/test/opengql_grammar_samples_20240801/session_set_time_zone.gql
diff --git a/developer/test/transcript_Arithmetic_Syntax__Test.sh b/developers/test/transcript_Arithmetic_Syntax__Test.sh
similarity index 100%
rename from developer/test/transcript_Arithmetic_Syntax__Test.sh
rename to developers/test/transcript_Arithmetic_Syntax__Test.sh
diff --git a/developer/test/transcript_RuleNameList.sh b/developers/test/transcript_RuleNameList.sh
similarity index 100%
rename from developer/test/transcript_RuleNameList.sh
rename to developers/test/transcript_RuleNameList.sh
diff --git a/developer/test/transcript_notes.txt b/developers/test/transcript_notes.txt
similarity index 100%
rename from developer/test/transcript_notes.txt
rename to developers/test/transcript_notes.txt
diff --git a/developer/test/transcript_test_Arithmetic_Echo.sh b/developers/test/transcript_test_Arithmetic_Echo.sh
similarity index 100%
rename from developer/test/transcript_test_Arithmetic_Echo.sh
rename to developers/test/transcript_test_Arithmetic_Echo.sh
diff --git a/developer/test/transcript_test_Arithmetic_Syntax.sh b/developers/test/transcript_test_Arithmetic_Syntax.sh
similarity index 100%
rename from developer/test/transcript_test_Arithmetic_Syntax.sh
rename to developers/test/transcript_test_Arithmetic_Syntax.sh
diff --git a/developer/test/transcript_test_PrintRuleNameListRegx.sh b/developers/test/transcript_test_PrintRuleNameListRegx.sh
similarity index 100%
rename from developer/test/transcript_test_PrintRuleNameListRegx.sh
rename to developers/test/transcript_test_PrintRuleNameListRegx.sh
diff --git a/executor/clean_ANTLR b/executor/clean_ANTLR
index 22d6736..6cf8a9c 100755
--- a/executor/clean_ANTLR
+++ b/executor/clean_ANTLR
@@ -13,7 +13,7 @@ handle_error() {
 }
 
 # Clean the ANTLR directory
-antlr_dir=$(find "$REPO_HOME/tool" -maxdepth 1 -type d -name "antlr4-*" | head -n 1)
+antlr_dir=$(find "$REPO_HOME/toolsmiths" -maxdepth 1 -type d -name "antlr4-*" | head -n 1)
 if [ -n "$antlr_dir" ]; then
   find "$antlr_dir" -mindepth 1 -maxdepth 1 -not -type l -exec rm -rf {} + || handle_error
   find "$antlr_dir" -maxdepth 1 -type l -exec rm -f {} + || handle_error
diff --git a/executor/clean_Java b/executor/clean_Java
index 8c7df26..92b870d 100755
--- a/executor/clean_Java
+++ b/executor/clean_Java
@@ -13,7 +13,7 @@ handle_error() {
 }
 
 # Clean the JDK directory
-jdk_dir=$(find "$REPO_HOME/tool" -maxdepth 1 -type d -name "jdk-*" | head -n 1)
+jdk_dir=$(find "$REPO_HOME/toolsmiths" -maxdepth 1 -type d -name "jdk-*" | head -n 1)
 if [ -n "$jdk_dir" ]; then
   find "$jdk_dir" -mindepth 1 -maxdepth 1 -not -type l -exec rm -rf {} + || handle_error
   find "$jdk_dir" -maxdepth 1 -type l -exec rm -f {} + || handle_error
diff --git a/executor/clean_upstream b/executor/clean_upstream
index 2fc57e3..00bf610 100755
--- a/executor/clean_upstream
+++ b/executor/clean_upstream
@@ -13,10 +13,10 @@ handle_error() {
 }
 
 # Check if the upstream directory exists
-if [ -d "$REPO_HOME/tool/upstream" ]; then
+if [ -d "$REPO_HOME/toolsmith/upstream" ]; then
   echo "Cleaning up upstream directory..."
-  find "$REPO_HOME/tool/upstream" -mindepth 1 -maxdepth 1 -not -type l -exec rm -rf {} + || handle_error
-  find "$REPO_HOME/tool/upstream" -maxdepth 1 -type l -exec rm -f {} + || handle_error
+  find "$REPO_HOME/toolsmiths/upstream" -mindepth 1 -maxdepth 1 -not -type l -exec rm -rf {} + || handle_error
+  find "$REPO_HOME/toolsmiths/upstream" -maxdepth 1 -type l -exec rm -f {} + || handle_error
 else
   echo "Upstream directory does not exist."
 fi
diff --git a/executor/env_dev b/executor/env_dev
index fa64f82..2bf6470 100644
--- a/executor/env_dev
+++ b/executor/env_dev
@@ -12,12 +12,12 @@ if [ -z "$REPO_HOME" ]; then
   source "${script_path}/env_base"
 fi
 
-export DEVELOPER_HOME="$REPO_HOME/developer"
-export GRADLE_HOME="$REPO_HOME/tool/gradle-8.10-rc-1"
+export DEVELOPER_HOME="$REPO_HOME/developers"
+export GRADLE_HOME="$REPO_HOME/toolsmiths/gradle-8.10-rc-1"
 
 export PATH=\
 "$DEVELOPER_HOME"/executor\
-:"$REPO_HOME"/tool/executor\
+:"$REPO_HOME"/toolsmiths/executor\
 :"$GRADLE_HOME"/bin\
 :"$PATH"
 
diff --git a/executor/env_pm b/executor/env_pm
index d784e3e..080c784 100644
--- a/executor/env_pm
+++ b/executor/env_pm
@@ -12,9 +12,18 @@ if [ -z "$REPO_HOME" ]; then
   source "${script_path}/env_base"
 fi
 
-PATH="$REPO_HOME/executor:$PATH"
 PROJECT="$PROJECT"_PM
 
+export GRADLE_HOME="$REPO_HOME/toolsmiths/gradle-8.10-rc-1"
+
+# includes tools for installing and testing
+export PATH=\
+"$REPO_HOME"/executor\
+:"$REPO_HOME"/toolsmiths/executor\
+:"$GRADLE_HOME"/bin\
+:"$PATH"
+
+# no sneaky hidden files
 alias ls="ls -a"
 
 echo "${BASH_SOURCE[0]}" "complete"
diff --git a/executor/install_tools.txt b/executor/install_tools.txt
new file mode 100644
index 0000000..c58b9d2
--- /dev/null
+++ b/executor/install_tools.txt
@@ -0,0 +1,36 @@
+
+1. install gradle
+
+  As of the date of this writing, `gradle` is not available in the typical
+  repos, so:
+
+    cd "$REPO_HOME/toolsmiths/upstream"
+    curl -O https://services.gradle.org/distributions/gradle-8.10-rc-1-all.zip
+
+    cd "REPO_HOME"
+    unzip toolsmiths/upstream/gradle-8.10-rc-1-all.zip -d toolsmiths/
+
+    place in user's environment:
+    export GRADLE_HOME="$REPO_HOME/toolsmiths/gradle-8.10-rc-1"
+    export PATH="$GRADLE_HOME/bin:$PATH"
+
+2. other tool install scripts have been integrated into `$REPO_HOME/build.gradle`.
+(There is a separate `developer/build.gradle` for building the project. the
+$REPO_HOME/build.gradle is for installing the tools.
+
+3. about Groovy ...
+
+  $REPO_HOME/build.gradle makes the 'groovy' interpreter is a shell script
+  wrapper around the gradle library groovy jar.  Admin privileges are not needed
+  for this. 
+
+  To install Groovy directly:
+
+  sudo apt-get install groovy
+  sudo dnf install groovy
+
+  curl -s "https://get.sdkman.io" | bash
+  source "$HOME/.sdkman/bin/sdkman-init.sh"
+  sdk install groovy
+
+  .. apparently sdk can also be used to install gradle
diff --git a/ologist/directory_structure.md b/ologist/directory_structure.md
deleted file mode 100644
index 36d4e9f..0000000
--- a/ologist/directory_structure.md
+++ /dev/null
@@ -1,159 +0,0 @@
-**directory_structure.txt**
-
-# Property-Based Directory Naming
-
-We think of a directory name as being the value of a property, where this
-property is shared by each and every file in said directory.
-
-When developing programs, we use a number of tools that process files. In this
-context, these are common property values to think of files having in common:
-
-* `processed_by`
-* `category_processed_by`
-
-The `processed_by` property is also known as `input`, which is often shortened
-to `in`. For example, C files to be compiled are processed by `cc`, so `cc` is a
-fine name for the directory. Other names could be `processed_by_cc`, `cc_input`,
-or `cc_in`.
-
-When input files destined to be processed by more than one related program are
-mixed in a directory, we generalize to the category. For example, a directory
-holding a collection of both Rust and C files could be called `compiler`, where
-`compiler` is the property that the related processing programs have. A mix of
-interpreted scripts destined to be processed by different interpreters could be
-`interpreter`.
-
-Files directly loaded and run by the machine are `processed_by` the architecture
-(e.g., `x86`) or `category_processed_by` a `machine`.
-
-An interpreter creates machine code on-the-fly. Calling an interpreter is the
-final step in a development chain, similar to calling the loader for a machine
-file. So, let us call the loader or the interpreter an `executor`. Thus, files
-in such a mixed directory are to be processed by an executor.
-
-The processing of files in a collection can be done by a person. Such is the
-case of the directory used by developers when they work, hence such a directory
-is called `developer`.
-
-We run into a bit of a problem when there is no word in English for the role a
-person plays when processing files in a directory. Such is the case for a
-directory full of documentation. The term `reader` comes close, but when you
-think about it, everything is a reader. For example, a compiler reads its input
-files. I thought to appeal to Latin and use `lector`, which indeed would refer
-to a person. However, the term is not intuitive, and people who cannot find this
-documentation will not be reading it so as to understand this term.
-
-In such a situation, we can move on to other property values shared by the files
-in the directory:
-
-* `purpose_is`
-* `is_a`
-* `is X`
-* `owned_by`
-
-Each file in a documentation directory shares the purpose of being
-documentation, hence such directories are called `documentation`.
-
-
-# Implicit Property Name
-
-The property used when naming a directory is implicit, so coming up with a
-directory name is essentially a mental exercise. The reader of the directory
-name is left to figure out the shared property value the person had in mind when
-naming the directory. 
-
-Adopting a convention makes the task of deriving the property name easier, but
-if this is still not sufficient, then integrate the property name into the the
-directory name along with the common value.  `is_a_red_car`, might be full of
-files that are describing read cars. This examples enters the gray area between
-file systems and databases.
-
-Sometimes a directory name will be held in a variable in a script, and we need
-to further distinguish the fact that the variable is referring to a
-directory. For example, a variable that holds the name of the directory that
-holds files to be processed by `javac` can be called `javac_input_directory`, or
-for those who want to be swank, `javac_in_dir`.
-
-# Why Directory Names Are Often Singular
-
-Each and every file in a directory has the same property value for a given
-property. Hence, this property value comes from the property of a file, 
-a single object.
-
-For example, if a directory is named `compiler`, it signifies that each file in
-the directory is `processed_by` a `compiler`.
-
-However, there can be cases where the property value, though it comes from an
-individual file, will be plural. For example, a directory could conceivably be
-named `insights`, where each file in the directory contains multiple
-insights. When we look at the property value for a single file, it is plural.
-
-# Hidden Files
-
-In my humble opinion, that git uses hidden files is unfortunate. In general, I
-find hidden files in shared projects to be a bad idea. The approach of using a
-symbolic link to give hidden files visible names creates a maintenance
-problem. The idea of setting explicit parameters for git can be used to force
-git to not create hidden files, but this approach does not expose other hidden
-files that might be placed into a project repository. There is also an issue of
-coordinating with other team members who want hidden files. Hence, a general
-solution that solves all these issues is to alias `ls` to `ls -a`, which is done
-in the environment initialization file for the project.
-
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
---------------------------------------------------------------------------------
-
-Each project has a virtual environment.  So, for the GQL project, gradle is
-installed under .../GQL_to_Cypher/tools.  `gradle` is found under
-`..GQL_to_Cypher/tool/gradle-8.10-rc-1/bin/` and the `env_dev` script sets the
-paths to make it accessible (analogous to Python virtual environment
-`activate`).
-
-`.git` is under the `.../GQL_to_Cypher` directory, so the 'project' directory is
-`.../GQL_to_Cypher`.
-
-All development is done under `.../GQL_to_Cypher/developer` directory.  There
-are no files under that directory, instead all files go into subdirectories.
-The current (being replaced) makefile is under
-`.../GQL_to_Cypher/devloper/executor` There is a bash script that is found first
-in the path that wraps the call to `make` and provides customizing options.
-
-Where does the `settings.gradle` file go?  Where does the `build.gradle` file
-go?  Perhaps `gradle` will also need a script that provides options to wrap the
-`gradle` call?
-
--->
-
-GQL_to_Cypher/
-├── settings.gradle
-├── build.gradle
-├── developer/
-│   ├── executor/
-│   │   ├── build.gradle
-│   │   └── other-subdirectories/
-│   └── other-subdirectories/
-├── tools/
-│   └── gradle-8.10-rc-1/
-│       └── bin/
-└── other-directories/
-
-
---->
-
-gradle-wrapper.sh
-
-#!/usr/bin/env bash
-
-# Source the environment setup script
-source .../GQL_to_Cypher/tools/env_dev  # this should probably be env_build
-
-# Call gradle with any additional options
-.../GQL_to_Cypher/tools/gradle-8.10-rc-1/bin/gradle "$@"
-
-./gradle-wrapper.sh build
-
-
-
-<!--  LocalWords:  lector
- -->
diff --git a/ologist/gradle_notes.txt b/ologist/gradle_notes.txt
deleted file mode 100644
index c09e2a2..0000000
--- a/ologist/gradle_notes.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-
-gradle
-
-1. This is risky software.
-
-  It searches for its files, thus traverses the directory tree.
-
-  It access the internet for data.
-
-  The installer downloads binaries from the site. It is not distributed as a repo
-  with Fedora, Debian, or .. anything else.
-
-  It has access to everyone's projects. Big honeypot.
-
-
-2. Java
-
-  Gradle is a Java program so it needs the JVM to run.  
-
-  Gradle is being used to install most of the tools. 
-
-    It does not install  Gradle of course.  There is a bash script for that.
-
-    We assume that Gradle is using a version of Java on the system. But it will
-    still install a specific version of Java required by the project build.
-    `gradle.parameters` sets the version number for the build Java.  The build
-    Java will be installed under the 'tools' directory.
-    
-
-
diff --git a/ologist/README.md b/readers/README.md
similarity index 100%
rename from ologist/README.md
rename to readers/README.md
diff --git a/readers/directory_naming.txt b/readers/directory_naming.txt
new file mode 100644
index 0000000..5a4cf3e
--- /dev/null
+++ b/readers/directory_naming.txt
@@ -0,0 +1,40 @@
+Generally, project directories are named after the agent the files are for.
+
+The top level directory is reserved for the project manager. The project
+manager's directory will hold the git repo, virtual environment tool installs,
+and one or more files to be sourced for initializing the environment.  The
+environment variable $REPO_HOME points to the top level directory.
+
+The developers' directory is $REPO_HOME/developer, which is the also
+$DEVELOPER_HOME.
+
+When 'make' or 'build.gradle' is found in the top level directory,
+i.e. $REPO_HOME, it is for building tools. The developer will have a separate
+build file under $DEVELOPER_HOME.
+
+When a project has files for the C compiler, cc, are put in a directory called "cc".
+Files for the java compiler, javac, are in the directory "javac". Etc.
+
+An `executor` is a generic name for a program that runs a file. Example
+executors include the OS loader for binary files, the JVM for .jar files,
+and bash for running shell scripts.  A directory that holds a mix of such
+files is called `executor`, as the files are for the `executor`.
+
+A directory full of documents is then for 'readers'.
+
+Some directories are more difficult to name after an agent that uses the
+files in them. Like our ancestors who personified nearly everything with
+spirits, we will do the same.
+
+When programs use a directory as a scratch pad, where files will disappear
+seemingly without reason we will call the directory "tanuki". This is a Japanese
+raccoon so famous for making things disappear that it has taken on mystical
+proportions.
+
+As a developer I often have files that I set aside just in case I want to look
+at them again, or later make new versions. So I give them to the God of sleep,
+Somnus. Maybe they will be woken up, maybe they won't. Unlike tanuki files,
+they are not deleted by any of the tools.
+
+Files in tanuki and Soumnus are not placed into the repo.
+
diff --git a/ologist/log.md b/readers/log.md
similarity index 91%
rename from ologist/log.md
rename to readers/log.md
index 2dc2a77..60cb41c 100644
--- a/ologist/log.md
+++ b/readers/log.md
@@ -44,6 +44,12 @@ a pretty good job of that already.)
   Make does not chain pattern rules, which is causing problems. Everyone in
   Javaland apparently is using Maven or Gradle, so switching over to Gradle.
   
+2024-10-01
+
+  Hve moved to gradle and have developed a bespoke dependency graph tool.
+  Breaking out the dependency graph tool as its own project, albeit a
+  small one.
+
 
 <!--  LocalWords:  Javaland Gradle
  -->
diff --git a/Erebus/.gitignore b/tanuki/.gitignore
similarity index 100%
rename from Erebus/.gitignore
rename to tanuki/.gitignore
diff --git a/toolsmiths/.gitignore b/toolsmiths/.gitignore
new file mode 100644
index 0000000..2db43ed
--- /dev/null
+++ b/toolsmiths/.gitignore
@@ -0,0 +1,4 @@
+
+*
+!/.gitignore
+
-- 
2.20.1