Coming soon ChenAIle — agentic microservices: agents, AI tool calls, machine learning and a metrics-driven rules engine Learn more →
Source map

Every Chenile repository

23 public repositories. The framework itself is 11 repositories versioned together under chenile-parent, currently on v2.1.36. Around it sit the code generator, its catalog and Homebrew tap, the state-machine CLI, the AI plugin, the samples and the documentation sites.

The framework: 11 repositories, one release train

Released together in a fixed order, starting with chenile-parent, and published to Maven Central under org.chenile.

🏗️ chenile-parent Build baseline

Shared Maven super-parent and dependency-management BOM. Standardizes Java, Spring Boot, plugin and Chenile artifact versions for every sibling repo.

chenile-parent
⚙️ chenile-core Core runtime

The execution engine: ChenileExchange model, the interceptor pipeline, service/operation definitions, HTTP binding, the Chenile event model and its TriggerService, state-machine (STM) support and MCP support.

stmchenile-baseowizchenile-corechenile-triggerchenile-httpcucumber-utilsutilsjpa-utilsmulti-datasource-utilschenile-mcpchenile-admin-ui

13013 production · 7326 test lines of Java · 12 modules

🔀 chenile-query-workflow-blueprints Application blueprints

Reusable query and workflow patterns on top of core — metadata-driven queries (MyBatis) and workflow-enabled services built on Chenile STM.

query-apichenile-query-servicechenile-query-controllerquery-mcpworkflow-apiworkflow-serviceworkflow-infoworkflow-mcpcucumber-workflow-utilsworkflow-utilsstm-generate-puml

5936 production · 3784 test lines of Java · 13 modules

🧭 chenile-process-management Application blueprints

Orchestration for long-running parent and child processes: splitter/aggregator trees, pluggable worker starters, trigger ingress for schedules and files, a shared mandatory durable outbox, and an administrator API with a React dashboard.

process-apiprocess-serviceprocess-delegateinvm-process-starterq-based-process-starterjdbc-process-starterchenile-outboxtrigger-serviceprocess-admin-serverprocess-ui

5349 production · 4576 test lines of Java · 13 modules

📇 chenile-service-registry Integration

Registry of services and delegates that lets Chenile discover and resolve service interactions and their policy configuration.

service-registry-apiservice-registry-serviceservice-registry-delegate

1130 production · 721 test lines of Java · 4 modules

🔌 chenile-proxies Integration

Proxy framework for invoking Chenile services through interfaces rather than hand-written transport code — local and remote.

chenile-proxy

658 production · 528 test lines of Java · 2 modules

🔐 chenile-security Integration

Security support including the contract-first auth framework: auth-server, gateway and resource-server starters, plus the security interceptor.

chenile-securitychenile-security-apicucumber-sec-utilssecurity-interceptorauth-framework/coreauth-framework/auth-serverauth-framework/gatewayauth-framework/starters/*

2862 production · 1907 test lines of Java · 11 modules

📨 chenile-messaging Integration

Messaging and pub-sub integrations: MQTT, Kafka, Azure, in-JVM pub-sub and the cloud-edge switch.

chenile-pub-subcucumber-mqtt-utilschenile-mqttcloud-edge-switchchenile-kafkachenile-azurechenile-jvm-pub-sub

2736 production · 2347 test lines of Java · 8 modules

🧪 chenile-bdd Testing

Integration-test and BDD support — Cucumber utilities for services and security so behavior is verified end to end.

it-cucumber-utilsit-cucumber-sec-utils

561 production · 0 test lines of Java · 3 modules

🧰 chenile-others Auxiliary

Event sources and integrations: schedules (in JSON, code or the database) and file watch, both raising Chenile events, plus cache and the config maven plugin.

chenile-filewatchchenile-schedulerchenile-scheduler-dbchenile-cachechenile-config-maven-plugin

2020 production · 1326 test lines of Java · 5 modules

🎛️ cconfig Configuration

Modular runtime configuration storage and overrides that the rest of the stack can consume.

chenile-configcconfig-db

973 production · 622 test lines of Java · 4 modules

How they layer
chenile-parent defines versions → chenile-core provides the runtime → chenile-query-workflow-blueprints and chenile-process-management add application patterns → chenile-service-registry, chenile-proxies, chenile-security and chenile-messaging add integration → chenile-bdd and chenile-others add testing and operations → cconfig supplies runtime configuration. The cconfig source lives in the GitHub repository ajapros/config.

Code generation and command-line tools

Released on their own cadence and built only against released Chenile. JGen is on the 2.5.x line and stm-cli on 1.0.x; both install from the shared Homebrew tap or with JBang.

🛠️ chenile-gen Generator

JGen, the pure-Java, blueprint-driven code generator. Generates Chenile services, workflows, queries, mini-monoliths, process deployments and ecosystems, and anything else that is text. Ships the CLI, the template engine, the Pebble extension and the built-in blueprints.

jgen-clijgen-basejgen-ext-pebblejgen-portalbp-servicebp-headless-servicebp-wfservicebp-wfcustombp-mybatisQuerybp-minimonolithbp-ecosystembp-process-managementbp-process-workersbp-batchbp-interceptorbp-itbp-jgen-blueprint
brew install ajapros/jgen-tap/jgen
jbang app install jgen@rajakolluru/chenile-gen
📚 jgen-catalog Catalog

The official JGen blueprint catalog. A catalog.json mapping short names to GitHub-hosted blueprints, so anyone can generate from a blueprint by name. JGen trusts entries here without asking, so every addition is reviewed like code. A pull-request check validates the file.

catalog.jsonscripts/validate.py
jgen --search <term>
jgen -g <name>@<version> -o input.json
🍺 homebrew-jgen-tap Homebrew tap

The Homebrew tap for Chenile's command-line tools. Its formulas install the release zips from GitHub with OpenJDK 25, the man pages and shell completions. The tap holds two formulas, jgen and stm-cli.

Formula/jgen.rbFormula/stm-cli.rb
brew tap ajapros/jgen-tap
brew install jgen stm-cli
🧩 stm-cli CLI

Renders and inspects Chenile state-machine definitions (the states XML used by Chenile STM and Finito) without starting the machine: Mermaid and PlantUML diagrams, the events allowed in a state, and generated test cases that walk every transition. It replaces the CLI that used to live inside workflow-utils.

org.chenile.stmcli.StmCli
brew install ajapros/jgen-tap/stm-cli
jbang app install stm-cli@ajapros/stm-cli

AI assistants

Agent skills that teach Claude and Codex the Chenile contracts, house rules and JGen blueprints.

🤖 chenile-claude-plugins Plugin

The chenile plugin for Claude Code, Claude desktop and Codex, with one shared set of skills. Each release also attaches one zip per skill for uploading to claude.ai.

chenile-framework-knowledgechenile-jgenchenile-architecturechenile-process-managementchenile-query-workflow-blueprints
claude plugin marketplace add ajapros/chenile-claude-plugins
claude plugin install chenile@chenile-plugins
codex plugin marketplace add ajapros/chenile-claude-plugins
codex plugin add chenile@chenile-plugins

Samples

Runnable applications that show each Chenile feature in isolation. They track the latest Chenile release.

🎓 chenile-samples Samples

Sample services behind the tutorials: persistence, queries, workflows, Owiz orchestration, interceptors, security, the service registry, MQTT, the scheduler (JDBC and Kubernetes CronJob modes), bulk-upload processes and BDD tests.

service-with-persistenceorder-query-servicestudent-query-serviceowiz-tutfoo-interceptorfeed-orchestratorbulk-upload-process-samplescheduler-sampleservice-registry-samplesecurity-auth-samplesecservicesecmonolithmqtt-multi-client-samplemqtt-multi-client-workflow-samplechenile-bdd-samplehow_to_extend_chenile_servicehow_to_extend_chenile_service_multitenant_pubsub

Documentation and websites

Each site is a GitHub Pages repository and is rebuilt on every push.

🌐 cheniledocs.github.io Website

This site: concepts, architecture, developer docs, release notes, the repository map and the video series. A Jekyll site whose repository cards and figures come from the files in _data.

_concepts_episodespages/developerpages/release-notes_data
📘 jgen-microsite Website

The JGen documentation site: install and the CLI manual, configuration and versions, the blueprint catalogue, template conventions, the generation pipeline, writing, composing and publishing blueprints, input validation and catalogs. Its content is derived from chenile-gen.

installmanualblueprintstemplate-conventionspipelineauthoringcomposable-blueprintsaggregated-blueprintsremote-blueprintscatalogsextensionsscripting
🔁 state-flow-welcome-page Website

The single-page site for Finito, Chenile's finite-state-machine engine: XML, fluent or JSON flows, convention-based wiring to Spring, and automatic Mermaid and PlantUML diagrams.

index.html
📑 chenile-javadoc API reference

Builds one unified Javadoc for every Chenile module from the artifacts on Maven Central. Bumping its chenile-parent version and pushing to main republishes the site, so the Maven Central deploy has to come first.

pom.xmldeploy-javadoc.yml

Legacy repositories

Kept for history. New work happens in the repositories above.

🗄️ chenile Legacy

The original single-repository Chenile (the 1.x line, last at 1.4.2), before the framework was split into the 11 repositories that now move together under chenile-parent.

chenile-corechenile-httpchenile-proxychenile-securitychenile-mqttchenile-query-service
🗄️ chenile-samples (original) Legacy

The first home of the sample applications, last updated in November 2024. The maintained copy is ajapros/chenile-samples.

Chenile by the numbers →   Release notes →