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.
| Repository | Group | Kind |
|---|---|---|
chenile-parent | Framework | Build baseline |
chenile-core | Framework | Core runtime |
chenile-query-workflow-blueprints | Framework | Application blueprints |
chenile-process-management | Framework | Application blueprints |
chenile-service-registry | Framework | Integration |
chenile-proxies | Framework | Integration |
chenile-security | Framework | Integration |
chenile-messaging | Framework | Integration |
chenile-bdd | Framework | Testing |
chenile-others | Framework | Auxiliary |
cconfig | Framework | Configuration |
chenile-gen | Tools | Generator |
jgen-catalog | Tools | Catalog |
homebrew-jgen-tap | Tools | Homebrew tap |
stm-cli | Tools | CLI |
chenile-claude-plugins | AI | Plugin |
chenile-samples | Samples | Samples |
cheniledocs.github.io | Sites | Website |
jgen-microsite | Sites | Website |
state-flow-welcome-page | Sites | Website |
chenile-javadoc | Sites | API reference |
chenile | Legacy | Legacy |
chenile-samples (original) | Legacy | Legacy |
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-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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
973 production · 622 test lines of Java · 4 modules
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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-samples (original)
Legacy
The first home of the sample applications, last updated in November 2024. The maintained copy is ajapros/chenile-samples.