name	maven-build
description	Maven build configuration for the crypto-scout multi-module Java 25 project
license	MIT
compatibility	opencode
metadata	{"tool":"maven","language":"java","version":"25"}

What I Do

Provide guidance for building, testing, and packaging the crypto-scout multi-module Maven project.

Project Structure

crypto-scout/
├── pom.xml                      # Root aggregator POM (version 0.0.1)
│   └── modules:
│       ├── jcryptolib (0.0.4)   # Library JAR
│       ├── crypto-scout-test (0.0.1)    # Test library JAR
│       ├── crypto-scout-client (0.0.1)  # Fat JAR service
│       ├── crypto-scout-collector (0.0.1) # Fat JAR service
│       └── crypto-scout-analyst (0.0.1)   # Fat JAR service

Note: crypto-scout-mq is infrastructure-only and not a Java/Maven module.

Build Commands

Full Build

# Clean and build all modules
mvn clean install

# Build without tests (faster)
mvn -q -DskipTests install

Module-Specific Builds

# Build specific module
cd crypto-scout-client
mvn clean package

# Build with dependency resolution from root
cd crypto-scout-collector
mvn clean package -DskipTests

Testing

# Run all tests
mvn test

# Run tests for specific module
cd crypto-scout-test && mvn test

# Run single test class
mvn test -Dtest=AmqpPublisherTest

# Run single test method
mvn test -Dtest=AmqpPublisherTest#shouldPublishPayloadToStream

# Run with extended timeout (slow environments)
mvn -q -Dpodman.compose.up.timeout.min=5 test

# Custom database URL for tests
mvn -q -Dtest.db.jdbc.url=jdbc:postgresql://localhost:5432/crypto_scout test

Clean Build

# Clean all modules
mvn clean

# Clean and rebuild single module
cd crypto-scout-client && mvn clean package -DskipTests

POM Configuration

Root POM (Aggregator)

<project>
    <groupId>com.github.akarazhev.cryptoscout</groupId>
    <artifactId>crypto-scout</artifactId>
    <version>0.0.1</version>
    <packaging>pom</packaging>

    <modules>
        <module>jcryptolib</module>
        <module>crypto-scout-test</module>
        <module>crypto-scout-client</module>
        <module>crypto-scout-collector</module>
        <module>crypto-scout-analyst</module>
    </modules>
</project>

Library POM (jcryptolib, crypto-scout-test)

<project>
    <parent>
        <groupId>com.github.akarazhev.cryptoscout</groupId>
        <artifactId>crypto-scout</artifactId>
        <version>0.0.1</version>
    </parent>

    <artifactId>jcryptolib</artifactId>
    <version>0.0.4</version>
    <packaging>jar</packaging>

    <properties>
        <java.version>25</java.version>
        <maven.compiler.release>25</maven.compiler.release>
        <activej.version>6.0-rc2</activej.version>
        <dsl-json.version>2.0.2</dsl-json.version>
        <ta4j-core.version>0.22.1</ta4j-core.version>
        <junit-jupiter.version>6.1.0-M1</junit-jupiter.version>
    </properties>

    <build>
        <plugins>
            <!-- Compiler plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.14.0</version>
                <configuration>
                    <release>25</release>
                </configuration>
            </plugin>

            <!-- Jar plugin for libraries -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.4.2</version>
            </plugin>
        </plugins>
    </build>
</project>

Service POM (client, collector, analyst)

<project>
    <parent>
        <groupId>com.github.akarazhev.cryptoscout</groupId>
        <artifactId>crypto-scout</artifactId>
        <version>0.0.1</version>
    </parent>

    <artifactId>crypto-scout-client</artifactId>
    <packaging>jar</packaging>

    <properties>
        <java.version>25</java.version>
        <maven.compiler.release>25</maven.compiler.release>
        <maven.shade.plugin.version>3.6.1</maven.shade.plugin.version>
        <activej.version>6.0-rc2</activej.version>
        <jcryptolib.version>0.0.4</jcryptolib.version>
    </properties>

    <build>
        <plugins>
            <!-- Compiler plugin -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.14.1</version>
                <configuration>
                    <release>25</release>
                </configuration>
            </plugin>

            <!-- Shade plugin for fat JAR -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.6.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>com.github.akarazhev.cryptoscout.Client</mainClass>
                                </transformer>
                            </transformers>
                            <createDependencyReducedPom>true</createDependencyReducedPom>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

Key Dependencies by Module

jcryptolib (0.0.4)

Dependency	Version	Purpose
activej-datastream	6.0-rc2	Async data streams
activej-http	6.0-rc2	HTTP client/server
dsl-json	2.0.2	JSON serialization
ta4j-core	0.22.1	Technical analysis
slf4j-api	2.1.0-alpha1	Logging API
logback-classic	1.5.27	Logging backend
junit-jupiter	6.1.0-M1	Testing
mockito	5.21.0	Mocking

crypto-scout-test (0.0.1)

Dependency	Version	Purpose
jcryptolib	0.0.4	JSON utilities
junit-jupiter	6.1.0-M1	JUnit 6 testing
stream-client	1.4.0	RabbitMQ Streams
amqp-client	5.28.0	RabbitMQ AMQP
postgresql	42.7.9	PostgreSQL driver

crypto-scout-client (0.0.1)

Dependency	Version	Purpose
jcryptolib	0.0.4	JSON utilities, clients
activej-servicegraph	6.0-rc2	DI and lifecycle
activej-jmx	6.0-rc2	JMX monitoring
stream-client	1.4.0	RabbitMQ Streams

crypto-scout-collector (0.0.1)

Dependency	Version	Purpose
jcryptolib	0.0.4	JSON utilities
activej-servicegraph	6.0-rc2	DI and lifecycle
activej-jmx	6.0-rc2	JMX monitoring
activej-datastream	6.0-rc2	Data streaming
stream-client	1.4.0	RabbitMQ Streams
amqp-client	5.28.0	RabbitMQ AMQP
postgresql	42.7.9	PostgreSQL driver
HikariCP	7.0.2	Connection pooling
crypto-scout-test	0.0.1	Test utilities

crypto-scout-analyst (0.0.1)

Dependency	Version	Purpose
Same as crypto-scout-collector

Build Artifacts

Output Locations

Module	Artifact	Type	Location
jcryptolib	JAR library	Library	`target/jcryptolib-0.0.4.jar`
crypto-scout-test	JAR library	Library	`target/crypto-scout-test-0.0.1.jar`
crypto-scout-client	Fat JAR	Service	`target/crypto-scout-client-0.0.1.jar`
crypto-scout-collector	Fat JAR	Service	`target/crypto-scout-collector-0.0.1.jar`
crypto-scout-analyst	Fat JAR	Service	`target/crypto-scout-analyst-0.0.1.jar`

Running Fat JARs

# crypto-scout-client
java -jar crypto-scout-client/target/crypto-scout-client-0.0.1.jar

# crypto-scout-collector
java -jar crypto-scout-collector/target/crypto-scout-collector-0.0.1.jar

# crypto-scout-analyst
java -jar crypto-scout-analyst/target/crypto-scout-analyst-0.0.1.jar

Troubleshooting

Build Failures

# Clear local repo and rebuild
rm -rf ~/.m2/repository/com/github/akarazhev
mvn clean install

# Debug dependency tree
mvn dependency:tree

# Check for updates
mvn versions:display-dependency-updates

Test Failures

# Run with verbose output
mvn test -X

# Skip tests temporarily
mvn install -DskipTests

# Run specific test with debug
mvn test -Dtest=ClassName -Dmaven.surefire.debug

When to Use Me

Use this skill when:

Building the project for the first time
Running tests across modules
Creating new module POMs
Troubleshooting build failures
Configuring Maven plugins
Understanding dependency management
Packaging services for deployment
Managing version updates