Skip to content

jbct

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

jbct

README.md

JBCT CLI and Maven Plugin

Code formatting, linting, and compliance scoring for Java Backend Coding Technology (JBCT).

Overview

Provides a CLI tool and Maven plugin for enforcing JBCT coding standards. Features include source code formatting with method chain alignment, a linter with 36 rules across 13 categories, compliance scoring (0-100), project scaffolding, slice project verification, and AI tooling integration.

Usage

CLI

jbct format src/main/java          # Format in-place
jbct format --check src/main/java  # Check formatting (CI)
jbct lint src/main/java            # Check JBCT compliance
jbct check src/main/java           # Combined format-check + lint
jbct score src/main/java           # Calculate compliance score (0-100)
jbct init my-project               # Create new JBCT project
jbct init --slice my-service       # Create Aether slice project
jbct upgrade                       # Self-update to latest version
jbct verify-slice                  # Validate slice configuration

Maven Plugin

<plugin>
    <groupId>org.pragmatica-lite</groupId>
    <artifactId>jbct-maven-plugin</artifactId>
    <version>0.6.1</version>
</plugin>

Goals: jbct:format, jbct:format-check, jbct:lint, jbct:check, jbct:score, jbct:collect-slice-deps, jbct:verify-slice.

Configuration

Uses jbct.toml for project configuration:

[format]
maxLineLength = 120
indentSize = 4
alignChainedCalls = true

[lint]
failOnWarning = false
# excludePackages = ["some.generated.**"]

Lint Rules (36 total)

Categories: Return Kinds, Value Objects, Exceptions, Naming, Lambda/Composition, Patterns, Style, Logging, Architecture, Static Imports, Utilities, Nesting, Zones, Sealed Types, Acronyms.

JBCT Specification

The full Java Backend Coding Technology specification — including structural patterns (Leaf, Sequencer, Fork-Join, Condition, Iteration), zone architecture, and BPMN integration guide — lives in the coding-technology repository.

Key references:

  • Structural patterns → BPMN correspondence: Leaf↔Task, Sequencer↔Sequence Flow, Fork-Join↔Parallel Gateway, Condition↔Exclusive Gateway, Iteration↔Multi-Instance Activity
  • BPMN Integration Guide → coding-technology/BPMN-INTEGRATION-GUIDE.md

Dependencies

  • Java 25+
  • Maven 3.9+ (for plugin)