Remove all Java code, de-mavenize, adapt to exist-core WebSocket by joewiz · Pull Request #367 · eXist-db/monex

joewiz · 2026-03-17T05:44:46Z

[This response was co-authored with Claude Code. -Joe]

Summary

The Java code that previously provided monex's own WebSocket endpoint (/exist/rconsole) is removed in favor of the WebSocket support added to eXist-db core in eXist-db/exist#6145. This enables all Java code to be removed from monex and replaces the Maven build system with Node.js/Gulp, following the pattern established in eXist-db/semver.xq#69. Monex becomes a pure XQuery/XAR application with fully automated releases.

Depends on: eXist-db/exist#6145 (Jetty 12, WebSocket module) — merged.

Java Removal

The entire src/main/java/ tree (6 files) is removed and replaced by the WebSocket support now in eXist-db core (#6145):

File	Now provided by
`RemoteConsoleEndpoint`	exist-core `WebSocketEndpoint` (`/exist/ws`)
`RemoteConsoleAdapter`	exist-core `WebSocketAdapter`
`ConsoleAdapter`	exist-core `ConsoleAdapter` interface
`ConsoleModule`	exist-core `ConsoleCompatModule`
`Log`	exist-core `ConsoleCompatFunctions`
`JMXToken`	Pure XQuery `monex:jmx-token()` (`modules/monex.xqm`)

Client-side adaptation: console.js (and console_spec.cy.js) connect to /exist/ws instead of the removed /exist/rconsole.

De-mavenization (modeled on semver.xq#69)

Build system: Maven → Node.js/Gulp

Removed	Added
`pom.xml`	`package.json` (version, metadata, scripts, deps)
`xar-assembly.xml`	`gulpfile.js` (template → copy → zip pipeline)
`xquery-license-style.xml`	`expath-pkg.xml.tmpl` + `repo.xml.tmpl`
Maven CI workflow	Node.js CI workflow

Automated releases: semantic-release

File	Purpose
`.releaserc`	Commit analyzer → changelog → git commit → GitHub release with XAR
`scripts/update-repo-changelog.js`	Parses conventional commits, inserts `<change>` into `repo.xml.tmpl`
`commitlint.config.js`	Enforces Conventional Commits spec
`.husky/commit-msg`	Git hook runs commitlint on commit
`.github/workflows/commitlint.yml`	CI checks PR commits

Build commands

npm run build    # Build XAR to dist/
npm run deploy   # Build + deploy to local eXist
npm run develop  # Build + deploy + watch
npm test         # Cypress tests

Test infrastructure

console_spec.cy.js is updated so the suite runs against whatever Cypress.config('baseUrl') is configured for (was hardcoded to localhost:8080), and the cy.request calls that trigger server-side console:log now include Basic auth (eXist 7.0+ rejects guest access to the console module via REST with 403).

Test Results

Latest run against existdb/existdb:latest (eXist 7.0-SNAPSHOT, with #6145 merged):

  ✔  console_spec.cy.js         00:01   3  3  -  -  -
  ✔  indexes_spec.cy.js         00:01   1  1  -  -  -
  ✔  login_spec.cy.js           …       2  2  -  -  -
  ✔  monitoring_spec.cy.js      00:01   1  1  -  -  -
  ✔  profiling_spec.cy.js       00:01   1  1  -  -  -
  ✔  remote_spec.cy.js          00:01   1  1  -  -  -

🤖 Generated with Claude Code

BREAKING CHANGE: monex is now a pure XQuery app. Requires eXist-db 7.0+ with WebSocket support (exist-core PR #6145). - Remove all Java code (6 files), replaced by exist-core WebSocket module - Replace Maven build with Node.js/Gulp (modeled on semver.xq#69) - Add automated releases via semantic-release Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…implify # Conflicts: # package-lock.json # package.json # pom.xml

Two issues prevented the console_spec from running outside of a default localhost:8080 setup or against eXist 7.0+: 1. Hardcoded localhost:8080 URLs in cy.request and new WebSocket(...) collided with whatever was on port 8080 on the dev machine, causing the tests to silently hit the wrong server. Fix: derive existRoot and wsRoot from Cypress.config('baseUrl') so the tests follow whatever port the spec is configured for. 2. cy.request to /exist/rest/db with the console:log _query had no auth, which works against older eXist where guest can call the console module via REST. eXist 7.0+ rejects this with 403. Fix: include Basic admin: auth on the REST requests that trigger server-side console:log. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Two CI fixes for the new test job: 1. npm ci --ignore-scripts (used to skip husky's prepare) also skips Cypress's postinstall step that downloads the binary, so `npx cypress run` fails with "Cypress binary is missing". Add an explicit `npx cypress install` step right after `npm ci`. 2. Drop `release` from the eXist version matrix. This PR (de-mavenize + WebSocket adaptation) requires eXist 7.0+ for the /exist/ws endpoint from eXist-db/exist#6145, so the `release` (6.x) matrix entry is guaranteed to fail. Keep `latest` only. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

The de-mavenize commit (aa11953) replaced the Java console:jmx-token() with an XQuery monex:jmx-token() function and loaded it via: util:import-module(..., "modules/monex.xqm") But app.xql itself lives in modules/, so the sibling import should be "monex.xqm", not "modules/monex.xqm". The wrong path threw a static-error which the try/catch wrapper swallowed → $app:jmx-token resolved to false() → the rendered page got `token: "false"` → silently broken JMX polling on the monitoring dashboard. The catch-all wrapper exists for the legitimate case where the monex module isn't loaded yet (during initial install). It also hides typos like this one; the next commit adds a regression test. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Two cypress tests covering the JMX token chain that broke silently in the previous commit: 1. app:instances-data renders a valid token for localhost — asserts window.JMX_INSTANCES[0].token matches a UUID format. Directly catches the "token serializes as 'false'" failure mode where app.xql's try/catch swallowed an error. 2. JMX endpoint accepts the rendered token — end-to-end check that the token in JMX_INSTANCES actually authorizes /exist/status. Catches subtler regressions (well-formed token, wrong endpoint or auth path). URLs derive from Cypress.config('baseUrl') so the spec is port-agnostic — same pattern as console_spec. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

dizzzz

failing test

joewiz · 2026-05-18T16:38:18Z

[This response was co-authored with Claude Code. -Joe]

@dizzzz Re-ran the failed Test (eXist latest) job and it's now green — full 11/11 across all 7 specs. The original failure was the stale monitoring_spec.cy.js InstanceId test from before your #6380 merged; with that fix in existdb/existdb:latest (rebuilt 2026-05-18 07:37 UTC), the re-run picked up the corrected JMX bean exposure and passed. Thanks for the catch (and the upstream fix)!

ok

The Java code that previously lived in monex (RemoteConsoleEndpoint, ConsoleModule, JMXToken, Log) was removed in #367. Those features are now provided by eXist-db core 7.x as the WebSocket endpoint and the ConsoleCompatModule. monex 7.x is therefore not installable against eXist-db 6.x or earlier. This commit exists to signal the breaking change to semantic-release, which interprets the previous merge as non-breaking (no `!` marker or BREAKING CHANGE footer on the squash/merge commit). BREAKING CHANGE: monex no longer ships its own Java code. The WebSocket endpoint and the `console` XQuery module are now provided by eXist-db core 7.x. Earlier eXist-db versions are unsupported.

github-actions · 2026-05-20T14:33:45Z

🎉 This PR is included in version 5.0.0 🎉

The release is available on:

v5.0.0
GitHub release

Your semantic-release bot 📦🚀

joewiz force-pushed the feature/websocket-simplify branch from 66688ef to dfff072 Compare March 17, 2026 06:11

joewiz changed the title ~~Remove all Java code — monex is now pure XQuery~~ Remove all Java code and de-mavenize — monex is now pure XQuery Mar 17, 2026

joewiz force-pushed the feature/websocket-simplify branch 3 times, most recently from 9c1c013 to bb50079 Compare March 22, 2026 15:28

joewiz force-pushed the feature/websocket-simplify branch from bb50079 to af9a5f1 Compare March 22, 2026 15:29

joewiz changed the title ~~Remove all Java code and de-mavenize — monex is now pure XQuery~~ Remove all Java code, de-mavenize, add query console with cursor pagination Mar 22, 2026

line-o added this to v7.0.0 Mar 23, 2026

duncdrum added this to App releases ahead of v7-beta May 13, 2026

github-project-automation Bot moved this to Todo in App releases ahead of v7-beta May 13, 2026

duncdrum added this to the v7-beta milestone May 13, 2026

joewiz force-pushed the feature/websocket-simplify branch from 3db8575 to 314974e Compare May 17, 2026 02:22

joewiz and others added 2 commits May 17, 2026 01:54

Merge remote-tracking branch 'origin/master' into feature/websocket-s…

5329057

…implify # Conflicts: # package-lock.json # package.json # pom.xml

joewiz force-pushed the feature/websocket-simplify branch from 57755c6 to 8c076ca Compare May 17, 2026 05:56

joewiz changed the title ~~Remove all Java code, de-mavenize, add query console with cursor pagination~~ Remove all Java code, de-mavenize, adapt to exist-core WebSocket May 17, 2026

joewiz and others added 3 commits May 17, 2026 02:06

joewiz mentioned this pull request May 17, 2026

Rename: lsp → langservice + cursor split, and project → existdb-openapi eXist-db/existdb-openapi#18

Merged

6 tasks

duncdrum moved this from Todo to In progress in App releases ahead of v7-beta May 18, 2026

dizzzz previously requested changes May 18, 2026

View reviewed changes

dizzzz requested review from a team, duncdrum, line-o and reinhapa May 18, 2026 15:57

dizzzz approved these changes May 18, 2026

View reviewed changes

line-o merged commit dedf303 into eXist-db:master May 18, 2026
6 of 7 checks passed

github-project-automation Bot moved this from In progress to Done in App releases ahead of v7-beta May 18, 2026

github-project-automation Bot moved this to Done in v7.0.0 May 18, 2026

line-o mentioned this pull request May 19, 2026

build: add extra property for docker image #335

Closed

github-actions Bot added the released label May 20, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Remove all Java code, de-mavenize, adapt to exist-core WebSocket#367

Remove all Java code, de-mavenize, adapt to exist-core WebSocket#367
line-o merged 6 commits into
eXist-db:masterfrom
joewiz:feature/websocket-simplify

joewiz commented Mar 17, 2026 •

edited

Loading

Uh oh!

dizzzz left a comment

Uh oh!

joewiz commented May 18, 2026

Uh oh!

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

joewiz commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Java Removal

De-mavenization (modeled on semver.xq#69)

Build system: Maven → Node.js/Gulp

Automated releases: semantic-release

Build commands

Test infrastructure

Test Results

Uh oh!

dizzzz left a comment

Choose a reason for hiding this comment

Uh oh!

joewiz commented May 18, 2026

Uh oh!

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

joewiz commented Mar 17, 2026 •

edited

Loading