eolang 0.35.1 → 0.36.0

package/Formula/eolang.rb

@@ -7,9 +7,9 @@ require "language/node"
 class Eolang < Formula
   desc "Command-line Tool-Kit"
   homepage "https://github.com/objectionary/eoc"
-  url "https://github.com/objectionary/eoc/archive/refs/tags/0.34.1.tar.gz"
-  version "0.34.1"
-  sha256 "ecf7f19115086fadbe1785b789378928d81dc8f0e3aa154b268f3a747c80fd01"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.35.2.tar.gz"
+  version "0.35.2"
+  sha256 "436b27218fb5acc48bbc56ecd8d6c5c9b4592fa19735e75515e21297938dc7de"
   license "MIT"
 
   depends_on "node"

package/Formula/eolang@0.34.1.rb

@@ -0,0 +1,25 @@
+#
+# SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+#
+
+require "language/node"
+class EolangAT0351 < Formula
+  desc "Command-line Tool-Kit"
+  homepage "https://github.com/objectionary/eoc"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.34.1.tar.gz"
+  version "0.34.1"
+  sha256 "ecf7f19115086fadbe1785b789378928d81dc8f0e3aa154b268f3a747c80fd01"
+  license "MIT"
+
+  depends_on "node"
+
+  def install
+    system "npm", "install", *std_npm_args
+    bin.install_symlink Dir["#{libexec}/bin/*"]
+  end
+
+  test do
+    system "#{bin}/eoc", "--version"
+  end
+end

package/Formula/eolang@0.35.1.rb

@@ -0,0 +1,25 @@
+#
+# SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
+# SPDX-License-Identifier: MIT
+#
+
+require "language/node"
+class EolangAT0352 < Formula
+  desc "Command-line Tool-Kit"
+  homepage "https://github.com/objectionary/eoc"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.35.1.tar.gz"
+  version "0.35.1"
+  sha256 "694218ea2ab13179be731ab7d671ba5f7ebe9a8aa9fc6b5d695d699180879466"
+  license "MIT"
+
+  depends_on "node"
+
+  def install
+    system "npm", "install", *std_npm_args
+    bin.install_symlink Dir["#{libexec}/bin/*"]
+  end
+
+  test do
+    system "#{bin}/eoc", "--version"
+  end
+end

package/README.md

@@ -20,14 +20,14 @@ First, you install [npm][npm-install] and [Java SE][java-se].
 Then, you install [eolang][npm] package, using [npm][npm-install]:
 
 ```bash
-npm install -g eolang@0.35.0
+npm install -g eolang@0.35.2
 ```
 
 You can also use [Homebrew] (on macOS):
 
 ```bash
 brew tap objectionary/eoc https://github.com/objectionary/eoc
-brew install objectionary/eoc/eolang@0.35.0
+brew install objectionary/eoc/eolang@0.35.2
 ```
 
 Or install it via [Nix flakes](https://nixos.wiki/wiki/Flakes):
@@ -115,41 +115,29 @@ That's it.
 You can also do many other things with `eoc` commands
 (the flow is explained in [this blog post][blog]):
 
-* `register` finds necessary `.eo` files and registers them in a JSON catalog
-* `assemble` parses `.eo` files into `.xmir`, optimizes them,
-  and pulls foreign EO objects
-* `transpile` converts `.xmir` files to the target programming
-language (Java by default)
-* `compile` converts target language sources (e.g., `.java`)
-to binaries (e.g., `.class`)
-* `link` puts all binaries together into a single executable binary
-* `dataize` dataizes a single object from the executable binary
-* `test` dataizes all visible unit tests
-* `lint` finds style-related errors in EO and XMIR files
-* `jeo:disassemble` converts Java `.class` files to `.xmir`
-(via [jeo](https://github.com/objectionary/jeo-maven-plugin))
-* `jeo:assemble` converts `.xmir` files to Java `.class` files
-(via [jeo](https://github.com/objectionary/jeo-maven-plugin))
-
-There are also commands that help manipulate with XMIR and EO sources
-(the list is not completed, while some of them are not implemented as of yet):
-
-* `audit` inspects all required packages and reports their status
-* `foreign` inspects all objects found in the program after the `assemble` step
-* `print` generates `.eo` files from `.xmir` files
-* `generate_comments` generates `.json` files with LLM-generated
-  documentation for `.eo` structures
-* `docs` generates HTML documentation from `.xmir` files
-* `latex` generates `.tex` files from `.eo` sources
-* `fmt` formats `.eo` files in the source directory
-* `normalize` normalizes `.eo` files via phi-calculus rewriting using
-  [phino](https://github.com/objectionary/phino) (must be installed separately);
-  original files are saved to `.eoc/before-normalize/` for debugging
-* ~~`translate` converts Java/C++/Python/etc. program to EO program~~
-* ~~`demu` removes `cage` and `memory` objects~~
-* ~~`dejump` removes `goto` objects~~
-* ~~`infer` suggests object names where it's possible to infer them~~
-* ~~`flatten` moves inner objects to upper level~~
+<!-- BEGIN COMMANDS SECTION -->
+* `audit` Inspect all packages and report their status
+* `foreign` Inspect and print the list of foreign objects
+* `clean` Delete all temporary files
+* `register` Register all visible EO source files
+* `parse` Parse EO files into XMIR
+* `assemble` Parse EO files into XMIR and join them with required dependencies
+* `print` Generate EO files from XMIR files
+* `lint` Lint XMIR files and fail if any issues inside
+* `resolve` Resolve all the dependencies required for compilation
+* `transpile` Convert EO files into target language
+* `compile` Compile target language sources into binaries
+* `link` Link together all binaries into a single executable binary
+* `dataize` Run the single executable binary and dataize an object
+* `test` Run all visible unit tests
+* `docs` Generate documentation from XMIR files
+* `generate_comments` Generate documentation with LLM
+* `jeo:disassemble` Disassemble .class files to .xmir files
+* `jeo:assemble` Assemble .xmir files to .class files
+* `latex` Generate LaTeX files from EO sources
+* `normalize` Normalize EO files using phi-calculus normalization via phino
+* `fmt` Format EO files in the source directory
+<!-- END COMMANDS SECTION -->
 
 This command line toolkit simply integrates other tools available in
 the [@objectionary](https://github.com/objectionary) GitHub organization.

package/eo-version.txt

@@ -1 +1 @@
-0.61.0
+0.61.3

package/eslint.config.js

@@ -5,6 +5,7 @@
 
 const { configs } = require('@eslint/js');
 const promise = require('eslint-plugin-promise');
+const jsdoc = require('eslint-plugin-jsdoc');
 const noEmptyLinesInMethod = require('./eslintPlugin/rules/noEmptyLinesInMethod');
 
 const localPlugin = {
@@ -25,6 +26,7 @@ module.exports = [
     },
     plugins: {
       promise,
+      jsdoc,
       local: localPlugin
     },
     rules: {
@@ -68,6 +70,7 @@ module.exports = [
       'sort-keys': 'off',
       'sort-vars': 'off',
       'promise/prefer-await-to-then': 'error',
+      'jsdoc/check-alignment': 'error',
       'local/no-empty-lines-in-method': 'error'
     }
   },

package/home-tag.txt

@@ -1 +1 @@
-0.59.7
+0.61.3

package/mvnw/.mvn/wrapper/maven-wrapper.properties

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
 # SPDX-License-Identifier: MIT
 
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.14/apache-maven-3.9.14-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.16/apache-maven-3.9.16-bin.zip

package/mvnw/dependency-reduced-pom.xml

@@ -13,7 +13,7 @@
     <plugins>
       <plugin>
         <artifactId>maven-enforcer-plugin</artifactId>
-        <version>3.6.2</version>
+        <version>3.6.3</version>
         <executions>
           <execution>
             <goals>
@@ -77,7 +77,7 @@
       </plugin>
       <plugin>
         <artifactId>maven-surefire-plugin</artifactId>
-        <version>3.5.5</version>
+        <version>3.5.6</version>
         <configuration>
           <skipTests>true</skipTests>
         </configuration>
@@ -120,7 +120,7 @@
           </plugin>
           <plugin>
             <artifactId>maven-surefire-plugin</artifactId>
-            <version>3.5.5</version>
+            <version>3.5.6</version>
             <configuration>
               <skipTests>false</skipTests>
               <failIfNoTests>true</failIfNoTests>
@@ -158,7 +158,7 @@
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
-      <version>6.0.3</version>
+      <version>6.1.0</version>
       <scope>test</scope>
       <exclusions>
         <exclusion>
@@ -182,7 +182,7 @@
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
-      <version>6.0.3</version>
+      <version>6.1.0</version>
       <scope>test</scope>
       <exclusions>
         <exclusion>
@@ -206,7 +206,7 @@
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <heap-size>undefined</heap-size>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <junit.version>6.0.3</junit.version>
-    <jeo.version>0.15.0</jeo.version>
+    <junit.version>6.1.0</junit.version>
+    <jeo.version>0.15.3</jeo.version>
   </properties>
 </project>

package/mvnw/pom.xml

@@ -10,13 +10,13 @@
   <version>0.0.0</version>
   <packaging>jar</packaging>
   <properties>
-    <jeo.version>0.15.0</jeo.version>
+    <jeo.version>0.15.3</jeo.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <eo.version>undefined</eo.version>
     <heap-size>undefined</heap-size>
     <stack-size>undefined</stack-size>
-    <junit.version>6.0.3</junit.version>
+    <junit.version>6.1.0</junit.version>
   </properties>
   <dependencies>
     <dependency>
@@ -34,7 +34,7 @@
     <plugins>
       <plugin>
         <artifactId>maven-enforcer-plugin</artifactId>
-        <version>3.6.2</version>
+        <version>3.6.3</version>
         <executions>
           <execution>
             <goals>
@@ -98,7 +98,7 @@
       </plugin>
       <plugin>
         <artifactId>maven-surefire-plugin</artifactId>
-        <version>3.5.5</version>
+        <version>3.5.6</version>
         <configuration>
           <skipTests>true</skipTests>
         </configuration>
@@ -160,7 +160,7 @@
           </plugin>
           <plugin>
             <artifactId>maven-surefire-plugin</artifactId>
-            <version>3.5.5</version>
+            <version>3.5.6</version>
             <configuration>
               <skipTests>false</skipTests>
               <failIfNoTests>true</failIfNoTests>

package/package.json

@@ -4,8 +4,8 @@
     "eoc": "./src/eoc.js"
   },
   "dependencies": {
-    "@langchain/core": "^0.3.55",
-    "@langchain/openai": "^0.6.0",
+    "@langchain/core": "^1.0.0",
+    "@langchain/openai": "^1.0.0",
     "colors": "^1.4.0",
     "commander": "^12.1.0",
     "eo2js": "^0.0.8",
@@ -21,15 +21,15 @@
     "@eslint/js": "^9.27.0",
     "eslint": "^9.28.0",
     "eslint-config-google": "^0.14.0",
+    "eslint-plugin-jsdoc": "^63.0.12",
     "eslint-plugin-promise": "^7.2.1",
     "grunt": "^1.6.1",
     "grunt-contrib-clean": "^2.0.1",
     "grunt-eslint": "^26.0.0",
     "grunt-mocha-test": "^0.13.3",
     "istanbul": "^0.4.5",
-    "mocha": "^11.7.5",
-    "nyc": "^18.0.0",
-    "patch-package": "^8.0.0"
+    "mocha": "^11.7.6",
+    "nyc": "^18.0.0"
   },
   "engines": {
     "node": ">6.0",
@@ -71,8 +71,7 @@
   "repository": "objectionary/eoc",
   "scripts": {
     "coverage": "nyc --reporter=lcov --reporter=text-summary mocha test/**/*.js --timeout 1200000",
-    "postinstall": "node scripts/postinstall.js",
     "test": "mocha 'test/**/*.js' --timeout 1200000"
   },
-  "version": "0.35.1"
+  "version": "0.36.0"
 }

package/scripts/readme_automation.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+
+const assert = require('assert');
+const { commandsDescription } = require("../src/eoc");
+
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function updateSection(sectionName, newContent, readMeContent) {
+  const start = `<!-- BEGIN ${sectionName.toUpperCase()} SECTION -->`;
+  const end = `<!-- END ${sectionName.toUpperCase()} SECTION -->`;
+  const regex = new RegExp(
+    `(${escapeRegex(start)})([\\s\\S]*?)(${escapeRegex(end)})`,
+    "g"
+  );
+  return readMeContent.replace(regex, `$1\n${newContent}$3`);
+}
+
+function bulletListTemplate(rows) {
+  return `${rows.map(([cmd, desc]) => `* \`${cmd}\` ${desc}`).join("\n")  }\n`;
+}
+
+function modifyReadme(commands,fs) {
+  assert.ok(commands.length > 0,'Commands should have rows')
+  const commandsMarkdown = bulletListTemplate(commands);
+  assert.ok(commandsMarkdown.length > 0,"commandsMarkdown result should have text")
+  let readMeContent = fs.readFileSync('README.md', "utf8");
+  assert.ok(readMeContent.length > 0,"readMeContent should have text")
+  readMeContent = updateSection('commands', commandsMarkdown, readMeContent);
+  assert.ok(readMeContent.length > 0,"readMeContent should sill have text after modification")
+  fs.writeFileSync('README.md',readMeContent);
+}
+
+function syncCommandsToReadme(fs)
+{
+  modifyReadme(commandsDescription(),fs);
+}
+
+module.exports = {
+  bulletListTemplate, updateSection, modifyReadme, syncCommandsToReadme
+};
+
+if (require.main === module) {
+  syncCommandsToReadme(require("fs"));
+};

package/src/commands/docs.js

@@ -10,6 +10,17 @@ const { marked } = require('marked');
 const {elapsed} = require('../elapsed');
 const {findFiles} = require('../files');
 
+/**
+ * Escape special XML characters.
+ * @param {String} str - Raw string
+ * @return {String} XML-safe string
+ */
+function xmlEscape(str) {
+  return str.replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
 
 /**
  * Applies XSLT to XMIR
@@ -108,6 +119,7 @@ function wrapHtml(name, html, css) {
 /**
  * Command to generate documentation.
  * @param {Hash} opts - All options
+ * @return {Promise<String>} Resolves to the message reporting the summary path
  */
 module.exports = function(opts) {
   return elapsed(async (tracked) => {
@@ -132,10 +144,12 @@ module.exports = function(opts) {
         if (!(packages in packages_info)) {
           packages_info[packages] = {
             xmir_htmls : [],
+            names: [],
             path: html_package
           };
         }
         packages_info[packages].xmir_htmls.push(xmir_html);
+        packages_info[packages].names.push(name);
         all_xmir_htmls.push(xmir_html);
       }
       for (const package_name of Object.keys(packages_info)) {
@@ -145,7 +159,24 @@ module.exports = function(opts) {
       }
       const packages = path.join(output, 'packages.html');
       fs.writeFileSync(packages, generatePackageHtml('overall package', all_xmir_htmls, css));
+      const summary = path.join(output, 'summary.xml');
+      const pkgNames = Object.keys(packages_info);
+      const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        `<eodoc packages="${pkgNames.length}" objects="${xmirs.length}">`
+      ];
+      for (const pkg of pkgNames) {
+        lines.push(`  <package name="${xmlEscape(pkg)}">`);
+        for (const obj of packages_info[pkg].names) {
+          lines.push(`    <object name="${xmlEscape(obj)}"/>`);
+        }
+        lines.push('  </package>');
+      }
+      lines.push('</eodoc>');
+      fs.writeFileSync(summary, lines.join('\n'));
+      const located = tracked.print(`Summary XML generated at ${path.relative(process.cwd(), summary)}`);
       tracked.print(`Documentation generation completed in the ${output} directory`);
+      return located;
     } catch (error) {
       console.error('Error generating documentation:', error);
       throw error;

package/src/commands/foreign.js

@@ -7,15 +7,57 @@ const rel = require('relative');
 const path = require('path');
 const fs = require('fs');
 
+/**
+ * Extract the first balanced JSON array from a string, ignoring any trailing
+ * bytes that may have been left over by a non-atomic writer (observed on
+ * Windows CI, see issue #782).
+ * @param {String} text - Raw file contents
+ * @return {String} Substring spanning the first complete `[...]` array
+ */
+function firstJsonArray(text) {
+  const body = text.charCodeAt(0) === 0xFEFF ? text.slice(1) : text;
+  let depth = 0;
+  let start = -1;
+  let inString = false;
+  let escape = false;
+  for (let i = 0; i < body.length; i += 1) {
+    const ch = body[i];
+    if (inString) {
+      if (escape) {
+        escape = false;
+      } else if (ch === '\\') {
+        escape = true;
+      } else if (ch === '"') {
+        inString = false;
+      }
+    } else if (ch === '"') {
+      inString = true;
+    } else if (ch === '[') {
+      if (depth === 0) {
+        start = i;
+      }
+      depth += 1;
+    } else if (ch === ']') {
+      depth -= 1;
+      if (depth === 0 && start >= 0) {
+        return body.slice(start, i + 1);
+      }
+    }
+  }
+  throw new SyntaxError('No complete JSON array found in foreign catalog');
+}
+
 /**
  * Inspects and prints the list of foreign objects.
  * @param {Hash} opts - All options
  */
 module.exports = function(opts) {
-  const file = path.resolve(opts.target, 'eo-foreign.json'),
-    all = JSON.parse(fs.readFileSync(file, 'utf8'));
+  const file = path.resolve(opts.target, 'eo-foreign.json');
+  const all = JSON.parse(firstJsonArray(fs.readFileSync(file, 'utf8')));
   console.info('There are %d objects in %s:', all.length, rel(file));
   all.forEach((obj) => {
     console.info('  %s', obj.id);
   });
 };
+
+module.exports.firstJsonArray = firstJsonArray;

package/src/commands/java/compile.js

@@ -5,6 +5,7 @@
 const rel = require('relative');
 const {mvnw, flags} = require('../../mvnw');
 const {elapsed} = require('../../elapsed');
+const {verifyJavac} = require('../../jdk');
 const path = require('path');
 
 /**
@@ -13,6 +14,7 @@ const path = require('path');
  * @return {Promise} of compile task
  */
 module.exports = function(opts) {
+  verifyJavac();
   const target = path.resolve(opts.target);
   return elapsed(async (tracked) => {
     const r = await mvnw(goals().concat(flags(opts)), opts.target, opts.batch);

package/src/commands/java/link.js

@@ -6,6 +6,7 @@
 const rel = require('relative');
 const {mvnw, flags} = require('../../mvnw');
 const {elapsed} = require('../../elapsed');
+const {verifyJavac} = require('../../jdk');
 const path = require('path');
 
 /**
@@ -14,6 +15,7 @@ const path = require('path');
  * @return {Promise} of link task
  */
 module.exports = function(opts) {
+  verifyJavac();
   const jar = path.resolve(opts.target, 'eoc.jar');
   return elapsed(async (tracked) => {
     const r = await mvnw(goals().concat(flags(opts)), opts.target, opts.batch);

package/src/commands/java/pipeline.js

@@ -5,6 +5,16 @@
 
 const {mvnw, flags} = require('../../mvnw');
 const {elapsed} = require('../../elapsed');
+const {verifyJavac} = require('../../jdk');
+
+/**
+ * Commands whose Maven goals require `javac` to be on the PATH.
+ * Anything that triggers the maven-compiler-plugin (or surefire test
+ * compilation) must be listed here so we can fail fast with a clear
+ * diagnostic instead of letting Maven die with `release version 11
+ * not supported`.
+ */
+const JAVAC_COMMANDS = ['compile', 'link', 'test'];
 
 /**
  * Runs multiple Maven goals in a single Maven invocation.
@@ -14,6 +24,9 @@ const {elapsed} = require('../../elapsed');
  * @return {Promise} of pipeline task
  */
 module.exports = function(coms, commands, opts, maven = mvnw) {
+  if (commands.some((cmd) => JAVAC_COMMANDS.includes(cmd))) {
+    verifyJavac();
+  }
   return elapsed(async (tracked) => {
     const {goals, extras} = collect(coms, commands, opts);
     const result = await maven(goals.concat(flags(opts)).concat(extras), opts.target, opts.batch);

package/src/commands/java/test.js

@@ -4,18 +4,28 @@
  */
 
 const {mvnw, flags} = require('../../mvnw');
+const {verifyJavac} = require('../../jdk');
 
 /**
  * Command to run all available unit tests.
  * @param {Object} opts - All options
+ * @param {Function} maven - Maven runner, defaults to mvnw
  * @return {Promise} of compile task
  */
-module.exports = function(opts) {
-  return mvnw(
-    [
-      'surefire:test',
-      `-Dstack-size=${opts.stack}`,
-      `-Dheap-size=${opts.heap}`,
-    ].concat(flags(opts))
-  );
+module.exports = function(opts, maven = mvnw) {
+  verifyJavac();
+  const args = [
+    'surefire:test',
+    `-Dstack-size=${opts.stack}`,
+    `-Dheap-size=${opts.heap}`,
+  ];
+  if (opts.object) {
+    const parts = opts.object.split('.');
+    const method = parts.pop().replace(/-/g, '_');
+    const obj = parts.pop().replace(/-/g, '_');
+    const pkg = parts.map((p) => `EO${p.replace(/-/g, '_')}`).join('.');
+    const cls = `EO${obj}*Test`;
+    args.push(`-Dtest=${pkg ? `org.eolang.${pkg}.${cls}` : `org.eolang.${cls}`}#${method}`);
+  }
+  return maven(args.concat(flags(opts)));
 };

package/src/commands/lint.js

@@ -55,9 +55,9 @@ module.exports = function(opts) {
 module.exports.goals = goals;
 
 /**
-* Command to get extra Maven flags for lint command.
-* @return {Array.<String>} of extra Maven flags to run for lint command
-*/
+ * Command to get extra Maven flags for lint command.
+ * @return {Array.<String>} of extra Maven flags to run for lint command
+ */
 module.exports.extras = extras;
 
 function goals(opts) {

package/src/commands/normalize.js

@@ -4,7 +4,7 @@
  */
 
 const path = require('path');
-const {execSync} = require('child_process');
+const {execSync, execFileSync} = require('child_process');
 const {mvnw, flags} = require('../mvnw');
 const {elapsed} = require('../elapsed');
 const {findFiles, saveFile, copyDir} = require('../files');
@@ -42,8 +42,9 @@ module.exports = function(opts) {
       const rel = path.relative(parsed, xmir);
       console.debug('Normalizing %s', rel);
       const ts = Date.now();
-      const out = execSync(
-        `phino rewrite --input=xmir --output=xmir --normalize ${xmir}`,
+      const out = execFileSync(
+        'phino',
+        ['rewrite', '--input=xmir', '--output=xmir', '--normalize', xmir],
         {stdio: ['pipe', 'pipe', 'pipe']}
       );
       console.debug('Normalized in %dms', Date.now() - ts);

package/src/elapsed.js

@@ -29,7 +29,7 @@ module.exports.elapsed = function elapsed(task) {
       } else if (duration < 60 * 1000) {
         extended = `${Math.ceil(duration / 1000)}s`;
       } else {
-        extended = `${Math.ceil(duration / 3600000)}min`;
+        extended = `${Math.ceil(duration / (60 * 1000))}min`;
       }
       const msg = `${message} in ${extended}`;
       console.info(msg);

package/src/eo2jsw.js

@@ -7,11 +7,11 @@ const path = require('path');
 const {execSync} = require('child_process'),
 
   /**
- * Convert eoc arguments to appropriate eo2js flags
- * @param {Object} args - eoc arguments
- * @param {String} lib - Path to eo2js lib
- * @return {Array.<String>} - Flags for eo2js
- */
+   * Convert eoc arguments to appropriate eo2js flags
+   * @param {Object} args - eoc arguments
+   * @param {String} lib - Path to eo2js lib
+   * @return {Array.<String>} - Flags for eo2js
+   */
   flags = function(args, lib) {
     return [
       '--target', args.target,
@@ -24,11 +24,11 @@ const {execSync} = require('child_process'),
   },
 
   /**
- * Wrapper for eo2js.
- * @param {String} command - Command to execute
- * @param {Object} args - Command arguments
- * @return {Promise<Array.<String>>}
- */
+   * Wrapper for eo2js.
+   * @param {String} command - Command to execute
+   * @param {Object} args - Command arguments
+   * @return {Promise<Array.<String>>}
+   */
   eo2jsw = function(command, args) {
     const lib = path.resolve(__dirname, '../node_modules/eo2js/src'),
       bin = path.resolve(lib, 'eo2js.js');

package/src/eoc.js

@@ -5,63 +5,79 @@
  */
 
 const tinted = require('./tinted-console');
-const {program} = require('commander'),
+const {program} = require('commander');
 
-  /**
+/**
  * Target language option.
  */
-  language = {
-    java: 'Java',
-    js: 'JavaScript',
-  },
+const language = {
+  java: 'Java',
+  js: 'JavaScript',
+};
 
-  /**
+/**
  * Platform dependent commands.
  */
-  common = {
-    assemble: require('./commands/assemble'),
-    audit: require('./commands/audit'),
-    clean: require('./commands/clean'),
-    foreign: require('./commands/foreign'),
-    parse: require('./commands/parse'),
-    print: require('./commands/print'),
-    register: require('./commands/register'),
-    lint: require('./commands/lint'),
-    docs: require('./commands/docs'),
-    generate_comments: require('./commands/generate_comments'),
-    jeo_disassemble: require('./commands/jeo/disassemble'),
-    jeo_assemble: require('./commands/jeo/assemble'),
-    latex: require('./commands/latex'),
-    normalize: require('./commands/normalize'),
-  },
-  commands = {
-    [language.java]: {
-      ...common,
-      ...{
-        resolve: require('./commands/java/resolve'),
-        transpile: require('./commands/java/transpile'),
-        link: require('./commands/java/link'),
-        compile: require('./commands/java/compile'),
-        dataize: require('./commands/java/dataize'),
-        test: require('./commands/java/test'),
-      }
-    },
-    [language.js]: {
-      ...common,
-      ...{
-        resolve: require('./commands/js/resolve'),
-        transpile: require('./commands/js/transpile'),
-        link: require('./commands/js/link'),
-        compile: require('./commands/js/compile'),
-        dataize: require('./commands/js/dataize'),
-        test: require('./commands/js/test'),
-      }
+const common = {
+  assemble: require('./commands/assemble'),
+  audit: require('./commands/audit'),
+  clean: require('./commands/clean'),
+  foreign: require('./commands/foreign'),
+  parse: require('./commands/parse'),
+  print: require('./commands/print'),
+  register: require('./commands/register'),
+  lint: require('./commands/lint'),
+  docs: require('./commands/docs'),
+  generate_comments: require('./commands/generate_comments'),
+  jeo_disassemble: require('./commands/jeo/disassemble'),
+  jeo_assemble: require('./commands/jeo/assemble'),
+  latex: require('./commands/latex'),
+  normalize: require('./commands/normalize'),
+};
+
+const commands = {
+  [language.java]: {
+    ...common,
+    ...{
+      resolve: require('./commands/java/resolve'),
+      transpile: require('./commands/java/transpile'),
+      link: require('./commands/java/link'),
+      compile: require('./commands/java/compile'),
+      dataize: require('./commands/java/dataize'),
+      test: require('./commands/java/test'),
     }
   },
-  pipelines = {
-    [language.java]: require('./commands/java/pipeline'),
-    [language.js]: require('./commands/js/pipeline'),
-  };
+  [language.js]: {
+    ...common,
+    ...{
+      resolve: require('./commands/js/resolve'),
+      transpile: require('./commands/js/transpile'),
+      link: require('./commands/js/link'),
+      compile: require('./commands/js/compile'),
+      dataize: require('./commands/js/dataize'),
+      test: require('./commands/js/test'),
+    }
+  }
+};
+
+const pipelines = {
+  [language.java]: require('./commands/java/pipeline'),
+  [language.js]: require('./commands/js/pipeline'),
+};
+
+/**
+ * Every language name a user may type, mapped (in lower case) to its
+ * canonical platform key. Derived from `language` so the accepted names
+ * and the platforms can never drift apart. For each `[alias, canonical]`
+ * pair we accept the short alias (e.g. `js`) and the canonical name
+ * lower-cased (e.g. `javascript`); `select()` lower-cases the input, so
+ * mixed-case spellings such as `JavaScript` are matched too.
+ */
+const platforms = {};
+for (const [alias, canonical] of Object.entries(language)) {
+  platforms[alias] = canonical;
+  platforms[canonical.toLowerCase()] = canonical;
+}
 
 if (process.argv.includes('--verbose')) {
   tinted.enable('debug');
@@ -103,7 +119,7 @@ program
   .option('--parser <version>', 'Set the version of EO parser to use', parser)
   .option('--latest', 'Use the latest parser version from Maven Central')
   .option('--alone', 'Just run a single command without dependencies')
-  .option('-l, --language <name>', 'Language of target execution platform', language.java)
+  .option('-l, --language <name>', 'Language of target execution platform (Java or JavaScript, case-insensitive)', language.java)
   .option('-b, --batch', 'Run in batch mode, suppress interactive messages')
   .option('--no-color', 'Disable colorization of console messages')
   .option('--track-transformation-steps', 'Save intermediate XMIR files')
@@ -234,6 +250,7 @@ program.command('compile')
 program.command('link')
   .description('Link together all binaries into a single executable binary')
   .action(async (str, opts) => {
+    pin(program.opts());
     clear(str);
     if (program.opts().alone === undefined) {
       await pipe()(coms(), ['register', 'assemble', 'lint', 'resolve', 'transpile', 'compile', 'link'], program.opts());
@@ -265,6 +282,7 @@ program.command('test')
   .description('Run all visible unit tests')
   .option('--stack <size>', 'Set stack size for the virtual machine', '64M')
   .option('--heap <size>', 'Set the heap size for the VM', '256M')
+  .option('--object <name>', 'Run a single test object by its full EO name, e.g. foo.app.works-fine')
   .action(async (str, opts) => {
     pin(program.opts());
     clear(str);
@@ -340,6 +358,7 @@ program.command('jeo:assemble')
     'classes'
   )
   .action((str, opts) => {
+    pin(program.opts());
     coms().jeo_assemble({...program.opts(), ...str});
   });
 
@@ -369,17 +388,18 @@ program.command('fmt')
     await pipe()(coms(), ['register', 'parse'], program.opts());
     await coms().print({
       printInput: '1-parse',
-      printOutput: program.opts().sources,
+      printOutput: path.resolve(program.opts().sources),
       ...program.opts()
     });
   });
 
-try {
-  program.parse(process.argv);
-} catch (e) {
-  console.error(e.message);
-  console.debug(e.stack);
-  process.exit(1);
+if (require.main === module) {
+  program.parseAsync(process.argv);
+}
+
+module.exports.commandsDescription = function commandsDescription() {
+  return program.commands
+    .map(c => [c.name(),c.description()]);
 }
 
 /**
@@ -408,12 +428,7 @@ function pin(opts) {
  * @return {Object} - commands
  */
 function coms() {
-  const lang = program.opts().language,
-    hash = commands[lang];
-  if (hash === undefined) {
-    throw new Error(`Unknown platform ${lang}`);
-  }
-  return hash;
+  return select(commands, program.opts().language);
 }
 
 /**
@@ -421,10 +436,24 @@ function coms() {
  * @return {Function} - pipeline function
  */
 function pipe() {
-  const lang = program.opts().language;
-  const pipeline = pipelines[lang];
-  if (pipeline === undefined) {
+  return select(pipelines, program.opts().language);
+}
+
+/**
+ * Resolve the entry registered for the requested language, matching the
+ * name case-insensitively and accepting aliases (e.g. `js`, `java`). The
+ * lookup and its validation live here, so callers never repeat the
+ * "unknown platform" check.
+ *
+ * @param {Object} registry - Map keyed by canonical platform name
+ * @param {String} lang - Language name as provided on the command line
+ * @return {*} The entry registered for the resolved platform
+ * @throws {Error} If the language does not resolve to a known platform
+ */
+function select(registry, lang) {
+  const found = registry[platforms[String(lang).toLowerCase()]];
+  if (found === undefined) {
     throw new Error(`Unknown platform ${lang}`);
   }
-  return pipeline;
+  return found;
 }

package/src/jdk.js

@@ -0,0 +1,65 @@
+/*
+ * SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
+ * SPDX-License-Identifier: MIT
+ */
+
+const {execSync} = require('child_process');
+
+/**
+ * Default executor used when no override is supplied. Runs the command
+ * synchronously, captures its output, and returns it as a Buffer.
+ * Stderr is captured (javac prints its version to stderr) so we can
+ * surface it back if anything goes wrong.
+ *
+ * @param {String} cmd - The command to execute.
+ * @return {Buffer} The combined stdout/stderr output.
+ */
+function defaultExec(cmd) {
+  return execSync(cmd, {stdio: ['ignore', 'pipe', 'pipe']});
+}
+
+/**
+ * Build the user-facing error message that we want to print when
+ * `javac` cannot be located or executed. The message lists the
+ * common ways to install a full JDK on each platform, since the
+ * most common cause of this error is that the user has installed
+ * a JRE (or none at all) instead of a JDK.
+ *
+ * @param {Error} cause - The underlying error from the exec attempt.
+ * @return {String} The user-facing diagnostic.
+ */
+function missingJavacMessage(cause) {
+  const lines = [
+    '`javac` was not found on your PATH.',
+    'EO needs a full JDK (not just a JRE) to compile Java sources.',
+    'Please install OpenJDK 11 or newer and make sure `javac` is on your PATH.',
+    '  Debian/Ubuntu: sudo apt-get install openjdk-21-jdk',
+    '  macOS:         brew install --cask temurin',
+    '  Windows:       https://adoptium.net/'
+  ];
+  if (cause && cause.message) {
+    lines.push(`Underlying error: ${cause.message.toString().trim()}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * Verify that `javac` is available on the current PATH. Throws an
+ * Error with a clear, actionable message when it is not, and is a
+ * no-op otherwise. The actual command runner is injectable so that
+ * tests can stub it out without spawning a real subprocess.
+ *
+ * @param {Function} [exec] - Optional command runner (mainly for tests).
+ *                            Should accept a single string command and
+ *                            either return the captured output or throw
+ *                            on non-zero exit.
+ * @return {void}
+ */
+module.exports.verifyJavac = function(exec) {
+  const run = exec || defaultExec;
+  try {
+    run('javac -version');
+  } catch (cause) {
+    throw new Error(missingJavacMessage(cause), {cause});
+  }
+};

package/src/mvnw.js

@@ -11,6 +11,17 @@ const {spawn} = require('child_process');
 const colors = require('colors');
 const parserVersion = require('./parser-version');
 
+/**
+ * Short label for the Maven goals being executed, collapsing a list
+ * into a count and leaving a lone goal under its own name.
+ * @param {Array} args The arguments passed to Maven
+ * @return {String} Either the single goal or a count like "5 steps"
+ */
+module.exports.summary = function(args) {
+  const steps = args.filter((a) => !a.startsWith('-'));
+  return steps.length > 1 ? `${steps.length} steps` : steps.join('');
+};
+
 /**
  * The shell to use (depending on operating system).
  * @return {String} Path to shell or "undefined" if default one should be used
@@ -42,7 +53,7 @@ module.exports.flags = function(opts) {
   console.debug('Sources in %s', rel(sources));
   const target = path.resolve(opts.target);
   console.debug('Target in %s', rel(target));
-  if (opts.parser && !parserVersion.exists(opts.parser)) {
+  if (opts.parser && !opts.parser.endsWith('-SNAPSHOT') && !parserVersion.exists(opts.parser)) {
     console.error(colors.red(
       `Parser version ${opts.parser} is not available in Maven Central.\n` +
       `Please check available versions at: https://repo.maven.apache.org/maven2/org/eolang/eo-maven-plugin/\n` +
@@ -65,6 +76,8 @@ module.exports.flags = function(opts) {
     `-Deo.placedFormat=csv`,
     `-Deo.skipLinting=${opts.blind ? 'true' : 'false'}`,
     opts.trackTransformationSteps ? '-Deo.trackTransformationSteps' : '',
+    '-Dorg.slf4j.simpleLogger.showDateTime=true',
+    '-Dorg.slf4j.simpleLogger.dateTimeFormat=yyyy-MM-dd HH:mm:ss',
   ].filter(flag => flag !== '');
 };
 
@@ -79,7 +92,7 @@ module.exports.mvnw = function(args, tgt, batch) {
   return new Promise((resolve, reject) => {
     console.debug(`Running mvnw with arguments: ${args.join(' ')}`);
     target = tgt;
-    phase = args.filter((a) => !a.startsWith('-')).join(' + ');
+    phase = module.exports.summary(args);
     const home = path.resolve(__dirname, '../mvnw');
     let bin = path.resolve(home, 'mvnw') + (process.platform === 'win32' ? '.cmd' : '');
     if (!fs.existsSync(bin)) {
@@ -108,20 +121,20 @@ module.exports.mvnw = function(args, tgt, batch) {
         start();
       }
       result.on('close', (code) => {
-        if (code !== 0) {
-          console.error(`The command "${cmd}" exited with #${code} code`);
-          process.exit(1);
-        }
         if (!batch) {
           stop();
         }
+        if (code !== 0) {
+          reject(new Error(`The command "${cmd}" exited with #${code} code`));
+          return;
+        }
         resolve(args);
       });
     } else {
       result.on('close', (code) => {
         if (code !== 0) {
-          console.error(`The command "${cmd}" exited with #${code} code`);
-          process.exit(1);
+          reject(new Error(`The command "${cmd}" exited with #${code} code`));
+          return;
         }
         resolve(args);
       });
@@ -200,7 +213,7 @@ function print() {
   } else if (duration < 60 * 1000) {
     elapsed = `${Math.ceil(duration / 1000)}s`;
   } else {
-    elapsed = `${Math.ceil(duration / 3600000)}min`;
+    elapsed = `${Math.ceil(duration / (60 * 1000))}min`;
   }
   process.stdout.write(
     colors.yellow(`[${phase}] ${elapsed}; ${count(target, 0)} files generated so far...`)

package/src/parser-version.js

@@ -4,12 +4,13 @@
  */
 
 const {XMLParser} = require('fast-xml-parser');
+const colors = require('colors');
 const request = require('sync-request'),
 
   /**
- * Load the latest version from GitHub releases.
- * @return {String} Latest version, for example '0.23.1'
- */
+   * Load the latest version from GitHub releases.
+   * @return {String} Latest version, for example '0.23.1'
+   */
   version = module.exports = {
     value: '',
     get() {
@@ -26,23 +27,33 @@ const request = require('sync-request'),
       }
       return version.value;
     },
+    /**
+     * Build the Maven Central URL of a parser version POM.
+     * @param {String} ver - Version to locate, for example '0.23.1'
+     * @return {String} Full URL of the eo-maven-plugin POM
+     */
+    url(ver) {
+      const repo = 'org/eolang/eo-maven-plugin',
+        artifactId = 'eo-maven-plugin';
+      return `https://repo.maven.apache.org/maven2/${repo}/${ver}/${artifactId}-${ver}.pom`;
+    },
     /**
      * Check if a specific parser version exists in Maven Central.
      * @param {String} ver - Version to check, for example '0.23.1'
-     * @return {Boolean} True if version exists, false otherwise
+     * @param {function} fetch - HTTP call, defaults to sync-request
+     * @return {Boolean} True if version exists or cannot be verified, false if confirmed absent
      */
-    exists(ver) {
+    exists(ver, fetch = request) {
       let result;
       if (ver && ver !== 'undefined') {
         try {
-          const repo = 'org/eolang/eo-maven-plugin',
-            artifactId = 'eo-maven-plugin',
-            url = `https://repo.maven.apache.org/maven2/${repo}/${ver}/${artifactId}-${ver}.pom`,
-            res = request('GET', url, {timeout: 10000, socketTimeout: 10000});
+          const res = fetch('GET', version.url(ver), {timeout: 10000, socketTimeout: 10000});
           result = res.statusCode === 200;
         } catch (e) {
-          console.debug('Unable to validate parser version (network error): %s', e.message);
-          result = false;
+          console.warn(colors.yellow(
+            `Cannot verify parser version ${ver} in Maven Central (${e.message}), proceeding anyway`
+          ));
+          result = true;
         }
       } else {
         result = false;

package/src/version.js

@@ -6,6 +6,6 @@
 // The values here are replaced automatically by the .rultor.yml script,
 // at the "release" pipeline:
 module.exports = {
-  what: '0.35.1',
-  when: '2026-04-23'
+  what: '0.36.0',
+  when: '2026-07-09'
 };

package/patches/grunt-mocha-cli+7.0.0.patch

@@ -1,25 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2025 Objectionary.com
-# SPDX-License-Identifier: MIT
-diff --git a/node_modules/grunt-mocha-cli/lib/index.js b/node_modules/grunt-mocha-cli/lib/index.js
-index 59f7a07..4cc7182 100644
---- a/node_modules/grunt-mocha-cli/lib/index.js
-+++ b/node_modules/grunt-mocha-cli/lib/index.js
-@@ -2,6 +2,7 @@
- const fs = require('fs')
- const path = require('path')
- const grunt = require('grunt')
-+const os = require('os')
-
- const BOOL_OPTIONS = [
-   'allow-uncaught',
-@@ -55,6 +56,10 @@ module.exports = function(options) {
-     spawnOptions.cmd = path.dirname(spawnOptions.cmd)
-     spawnOptions.cmd += '/../.bin/mocha'
-
-+    if (os.platform() === 'win32') {
-+      spawnOptions.opts.shell = true
-+    }
-+
-     if (process.platform === 'win32') {
-       spawnOptions.cmd += '.cmd'
-     }

package/scripts/postinstall.js

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-
-/*
- * SPDX-FileCopyrightText: Copyright (c) 2022-2026 Objectionary.com
- * SPDX-License-Identifier: MIT
- */
-
-/**
- * Conditional postinstall script that only runs patch-package in development.
- * This prevents patch-package from running during production installs where
- * devDependencies (like grunt-mocha-cli) are not available.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawn } = require('child_process');
-
-const gruntMochaCli = path.join(__dirname, '..', 'node_modules', 'grunt-mocha-cli');
-
-function findPatchPackage() {
-  const binDir = path.join(__dirname, '..', 'node_modules', '.bin');
-  if (process.platform === 'win32') {
-    const cmdFile = path.join(binDir, 'patch-package.cmd');
-    if (fs.existsSync(cmdFile)) {
-      return cmdFile;
-    }
-  }
-  const binFile = path.join(binDir, 'patch-package');
-  if (fs.existsSync(binFile)) {
-    return binFile;
-  }
-  return null;
-}
-
-const patchPackageBin = findPatchPackage();
-
-if (fs.existsSync(gruntMochaCli) && patchPackageBin) {
-  console.log('Development environment detected, running patch-package...');
-  const spawnOptions = {
-    stdio: 'inherit',
-    shell: process.platform === 'win32'
-  };
-  const child = spawn(patchPackageBin, [], spawnOptions);
-  child.on('exit', (code) => {
-    process.exit(code);
-  });
-  child.on('error', (err) => {
-    console.error('Failed to execute patch-package:', err);
-    process.exit(1);
-  });
-} else {
-  console.log('Production environment detected, skipping patch-package.');
-}