feat: implement CLI entrypoints and minimize docker image size by simonmysun · Pull Request #1 · HTW-ALADIN/ALADIN-Services

simonmysun · 2026-04-10T03:51:46Z

This PR includes following changes:

implemented CLI entrypoints for the 4 services
reduced Docker image size by introducing bundler, using multi-stage build and removing unused files
fixed minor dependency and documentation
BREAKING: separated neo4j into its own service and remove supervisord. graph-rewriting-service is now a stateless service and neo4j has to be additionally deployed

Additional tests are recommended as I don't fully know all their functionalities.

Following errors are observed and not fixed:

missing "test pages" in sql-assessment-service

…ng dev dependencies and add instructions for usage inside Docker

Copilot

Pull request overview

This PR adds command-line entrypoints for multiple services and refactors container/build packaging to ship smaller runtime images by bundling (esbuild) and using multi-stage Docker builds. It also introduces a breaking operational change by separating Neo4j into its own service for graph-rewriting-service (removing supervisord and the embedded DB from that image).

Changes:

Add CLIs and corresponding tests (SQL assessment, JSONPath mapper, graph rewriting).
Introduce esbuild-based bundling/build scripts and update package scripts accordingly.
Rework Dockerfiles (multi-stage builds, slimmer runtime images) and adjust graph rewriting deployment to use a separate Neo4j service.

Reviewed changes

Copilot reviewed 33 out of 36 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
services/sql-assessment-service/test/cli/express-cli-adapter.test.ts	Adds unit tests for extracting/invoking Express routes via CLI adapter.
services/sql-assessment-service/test/cli/cli-route-table.test.ts	Adds integration test building a full CLI route table from controllers.
services/sql-assessment-service/src/index.ts	Refactors service entrypoint to use a shared bootstrap controller factory.
services/sql-assessment-service/src/cli/index.ts	Adds SQL assessment CLI entrypoint (route discovery + request body input).
services/sql-assessment-service/src/cli/express-cli-adapter.ts	Implements router introspection and in-process handler invocation for CLI.
services/sql-assessment-service/src/bootstrap.ts	Introduces shared dependency wiring via `createControllers()`.
services/sql-assessment-service/package.json	Switches build to esbuild bundling; adds CLI script and build:tsc.
services/sql-assessment-service/package-lock.json	Updates lockfile for new build tooling deps (esbuild, ts-node).
services/sql-assessment-service/Makefile	Adds `cli` target and updates `.PHONY` list.
services/sql-assessment-service/import-meta-url.js	Adds an esbuild inject shim for `import.meta.url`.
services/sql-assessment-service/Dockerfile	Converts to multi-stage build with bundled JS runtime.
services/sql-assessment-service/.dockerignore	Ignores `build/` in Docker context.
services/jsonpath-mapper-service/tests/cli.tests.mjs	Adds CLI integration tests (stdin/files/output flag/help/errors).
services/jsonpath-mapper-service/src/cli.ts	Adds a Node CLI for mapping JSON via template files.
services/jsonpath-mapper-service/src/api/server.ts	Changes API metadata to use env-based version and a constant description.
services/jsonpath-mapper-service/scripts/build-api.mjs	Adds esbuild bundling script for API + CLI artifacts.
services/jsonpath-mapper-service/rollup.config.mjs	Adds rollup build output for CLI (`dist/cli.mjs`) with shebang banner.
services/jsonpath-mapper-service/package.json	Adds `bin` entry, build/test scripts for CLI, and esbuild dev dependency.
services/jsonpath-mapper-service/import-meta-url.js	Adds an esbuild inject shim for `import.meta.url`.
services/jsonpath-mapper-service/Dockerfile	Switches runtime to a single bundled API file + copied Swagger UI static assets.
services/jsonpath-mapper-service/.dockerignore	Restricts Docker build context to minimal build inputs (source/scripts/metadata).
services/graph-rewriting-service/supervisord.conf	Removes supervisord configuration (no longer used).
services/graph-rewriting-service/src/cli.ts	Adds graph rewriting CLI (transform/find/import + node/edge CRUD) backed by Neo4j.
services/graph-rewriting-service/src/cli.test.ts	Adds vitest coverage for CLI parsing, IO helpers, and command handlers.
services/graph-rewriting-service/scripts/entrypoint.sh	Removes entrypoint that previously booted Neo4j + supervisord in one container.
services/graph-rewriting-service/scripts/build.mjs	Adds esbuild bundling for API+CLI and copies static assets into dist.
services/graph-rewriting-service/README.md	Updates docs for dev/prod setups with external Neo4j and new build pipeline.
services/graph-rewriting-service/package.json	Switches build to esbuild script, adds `bin` entry + `typecheck` + `cli` script.
services/graph-rewriting-service/package-lock.json	Updates lockfile for esbuild addition and bin metadata.
services/graph-rewriting-service/Dockerfile	Replaces Neo4j-based image with slim Node runtime; adds healthcheck and env defaults.
services/graph-rewriting-service/docker-compose.prod.yml	Adds standalone Neo4j service and wires app service to depend on it.
services/graph-rewriting-service/.env.example	Updates env defaults for external Neo4j configuration.
services/fermentaladin-service/README.md	Documents Docker usage changes (no `uv` in runtime; use `python` directly).
services/fermentaladin-service/Dockerfile	Converts to multi-stage build: build venv with `uv`, run with venv on PATH.
services/fermentaladin-service/.dockerignore	Adds dockerignore to reduce build context contents.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-10T03:57:54Z

+	it('database:analyze-database returns 500 for completely missing body', async () => {
+		const route = routes.find(
+			(r) => r.command === 'database:analyze-database',
+		)!;
+		const result = await invokeHandler(route.handler, {});
+		// Controller crashes (validateConnectionInfo gets undefined) → caught as 500
+		expect(result.statusCode).toBe(500);
+		expect(result.data).toHaveProperty('message');
+	});


This test currently asserts a 500 when the request body is missing, and notes that the controller crashes. Given the OpenAPI for /api/database/analyze-database declares a required request body, missing/invalid bodies should ideally return a 400 instead of throwing. Recommend fixing the controller validation and updating this assertion so the CLI integration test doesn't lock in a server-side bug.

The CLI script only adapts the original controller code and follows its implementation.

Possibly fix in services/sql-assessment-service/src/database/database-controller.ts @plc-dev if you agree with the review.

… serving

… from package.json

Co-authored-by: Copilot <[email protected]>

simonmysun · 2026-04-10T10:38:29Z

TODO: integrate embedded databases and make external databases optional

integrate https://github.com/electric-sql/pglite
integrate https://github.com/GrafeoDB/grafeo

…ith PGlite integration

…nt routes - inject /api/database execution into generation, grading, description, query - reduce duplicated setup logic across endpoints - add integration tests for API chaining - document updated API workflow in README

codecov · 2026-04-22T11:40:18Z

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

…iting-service

… timout limit

Copilot

Pull request overview

Copilot reviewed 73 out of 78 changed files in this pull request and generated 2 comments.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…ute handler Co-authored-by: Copilot <[email protected]>

…ssing edges Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Copilot reviewed 75 out of 80 changed files in this pull request and generated 2 comments.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…t absent Replace `if (!sqlContent)` with `if (sqlContent == null)` so only a truly absent value (undefined/null) triggers the skip/init-SQL fallback path. An explicitly supplied empty string now falls through to analyzePGlite, which already validates it and returns 400. Also removes the now-redundant inner `if (!sqlContent)` guard. Adds two regression tests covering sqlContent: '' for both required=false and required=true. Co-authored-by: Copilot <[email protected]>

…432/northwind format Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Copilot reviewed 75 out of 80 changed files in this pull request and generated 2 comments.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…nd assert HTTP mapping Co-authored-by: Copilot <[email protected]>

…-file without path Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Copilot reviewed 76 out of 81 changed files in this pull request and generated 3 comments.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…ePositionalBody test

… deployment Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Copilot reviewed 76 out of 81 changed files in this pull request and generated 1 comment.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <[email protected]>

Copilot

Pull request overview

Copilot reviewed 76 out of 81 changed files in this pull request and generated no new comments.

Files not reviewed (3)

services/graph-rewriting-service/package-lock.json: Language not supported
services/jsonpath-mapper-service/package-lock.json: Language not supported
services/sql-assessment-service/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

simonmysun added 12 commits April 1, 2026 00:05

feat: add smoke test script for sql-assessment-service

486dc48

docs: update README

e92ced8

feat: implement CLI functionality for sql-assessment-service

cbec7f1

feat: implement CLI functionality for josnpath-mapper-service

061094f

feat: reduce Docker image size by using multi-stage build and excludi…

8243d8b

…ng dev dependencies and add instructions for usage inside Docker

chore: switch to esbuild and minimize docker image size

bcf5fe6

fix: update exposed port in Dockerfile from 3333 to 3000

1b3bd40

fix: add missing dev dependency ts-node

54c5f8d

chore: switch to esbuild and minimize docker image size

7caba67

refactor: separate neo4j into its own service and remove supervisord

c8aeb97

feat: implement CLI for graph rewriting service

976c22c

chore: switch to esbuild for faster builds and smaller runtime image

c68d7d2

Copilot AI review requested due to automatic review settings April 10, 2026 03:51

Copilot started reviewing on behalf of simonmysun April 10, 2026 03:52 View session

Copilot AI reviewed Apr 10, 2026

View reviewed changes

simonmysun and others added 3 commits April 10, 2026 06:25

fix: use esbuild to copy @fastify/swagger-ui static files for runtime…

ef98e83

… serving

feat: enhance build process to inject package version and description…

a0b1fca

… from package.json

Apply suggestions from code review

bb475b2

Co-authored-by: Copilot <[email protected]>

simonmysun added 3 commits April 15, 2026 23:12

feat: add tests for DatabaseController and QueryExecutionController w…

193292b

…ith PGlite integration

feat: integrate PGlite support for database analysis and query execution

d80fb5a

feat: add in-memory graph database backend

40d89e2

simonmysun force-pushed the master branch from 84548e8 to 40d89e2 Compare April 20, 2026 06:47

simonmysun added 4 commits April 20, 2026 14:01

feat: add smoke test script and update Makefile and README

13a177e

feat(cli): add CLI tests for Neo4j backend functionality

43f841d

feat(cli): include cli tests in smoke test

d2e84f6

simonmysun added 2 commits April 22, 2026 14:50

fix: fixes linting and formatting issues in cli.test.ts in graph-rewr…

ab44151

…iting-service

fix(tests): warm up PGlite WASM to reduce cold-start costs and extend…

b1ced22

… timout limit

simonmysun requested a review from Copilot April 24, 2026 17:15

Copilot started reviewing on behalf of simonmysun April 24, 2026 17:15 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread services/sql-assessment-service/src/query/query-execution-controller.ts Outdated

Comment thread services/graph-rewriting-service/src/service/db/memory/graph.service.ts Outdated

simonmysun and others added 3 commits April 24, 2026 19:29

fix(query): forward unhandled executeQuery rejections to next() in ro…

c65af06

…ute handler Co-authored-by: Copilot <[email protected]>

refactor(query-execution-controller): format code for better readability

3a0c098

feat(graph-service): add deleteEdge method to return undefined for mi…

fb00df9

…ssing edges Co-authored-by: Copilot <[email protected]>

simonmysun requested a review from Copilot April 24, 2026 17:32

Copilot started reviewing on behalf of simonmysun April 24, 2026 17:33 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread services/sql-assessment-service/src/database/database-service.ts

Comment thread services/sql-assessment-service/test/query/query-execution-controller.test.ts

simonmysun and others added 2 commits April 25, 2026 00:39

fix(test): derive DB_KEY via generateDatabaseKey to match localhost:5…

ac7a14f

…432/northwind format Co-authored-by: Copilot <[email protected]>

simonmysun requested a review from Copilot April 24, 2026 22:50

Copilot started reviewing on behalf of simonmysun April 24, 2026 22:51 View session

Copilot AI reviewed Apr 24, 2026

View reviewed changes

Comment thread services/sql-assessment-service/test/query/query-execution-controller.test.ts

Comment thread services/sql-assessment-service/src/cli/index.ts

simonmysun and others added 2 commits April 25, 2026 16:21

test(query): fix EMPTY_QUERY test to actually invoke the controller a…

9d24ef1

…nd assert HTTP mapping Co-authored-by: Copilot <[email protected]>

fix(cli): scan past flags to find positional JSON body; error on -f/-…

d150f44

…-file without path Co-authored-by: Copilot <[email protected]>

simonmysun requested a review from Copilot April 25, 2026 14:34

Copilot started reviewing on behalf of simonmysun April 25, 2026 14:34 View session

Copilot AI reviewed Apr 25, 2026

View reviewed changes

Comment thread services/sql-assessment-service/src/query/query-execution-controller.ts

Comment thread services/graph-rewriting-service/Dockerfile Outdated

Comment thread services/graph-rewriting-service/src/plugins/memory/index.ts Outdated

simonmysun and others added 3 commits April 26, 2026 01:41

refactor(test): simplify assertion for flags-only arguments in resolv…

c4c410a

…ePositionalBody test

fix(docker): remove default NEO4J_PASSWORD to prevent weak-credential…

ec9d74a

… deployment Co-authored-by: Copilot <[email protected]>

fix(memory): update onRequest hook to ignore unused reply parameter

4dced91

simonmysun requested a review from Copilot April 26, 2026 00:20

Copilot started reviewing on behalf of simonmysun April 26, 2026 00:20 View session

Copilot AI reviewed Apr 26, 2026

View reviewed changes

Comment thread services/sql-assessment-service/src/database/internal-memory.ts Outdated

simonmysun and others added 2 commits April 26, 2026 05:04

refactor(database): type pgliteInstances as Map<string, PGlite>

042edaf

Co-authored-by: Copilot <[email protected]>

refactor(database): change sqlContent variable declaration to const

a7952fc

simonmysun requested a review from Copilot April 26, 2026 11:07

Copilot started reviewing on behalf of simonmysun April 26, 2026 11:08 View session

Copilot AI reviewed Apr 26, 2026

View reviewed changes

Conversation

simonmysun commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

simonmysun Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

simonmysun commented Apr 10, 2026 • edited by plc-dev Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov Bot commented Apr 22, 2026

Welcome to Codecov 🎉

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

simonmysun commented Apr 10, 2026 •

edited

Loading

simonmysun commented Apr 10, 2026 •

edited by plc-dev

Loading