| mvn | runs the root pom's default goal, verify apache-rat:check. RAT is informational and currently reports violations, so a bare mvn ends red; run an explicit goal instead |
| mvn clean install | performs a full build including the unit tests (about 4 minutes with the forked, partitioned surefire run) |
| mvn clean install -DskipTests | performs a build, compiling the tests and building the test-jars but not running them. Faster; not for final checks |
| mvn clean install -Dmaven.test.skip | do not use: it also skips building wikantik-main's test-jar, which wikantik-admin-mcp, wikantik-tools, wikantik-knowledge and the IT modules depend on, so a full-reactor build fails |
| mvn clean install -T 1C -DskipITs | parallel unit-test build (what phase 1 of bin/run-tests.sh runs) |
| mvn clean test | compiles the source and executes the tests |
| mvn test -Dtest=MarkdownRendererTest | run just a single test class |
| mvn test -Dtest=MarkdownRendererTest#testMarkupSimpleMarkdown | run just a single test within a test class |
| mvn test -pl wikantik-main -Dtest=JDBCUserDatabaseTest | run one test class in one module (tests that touch a database start a pgvector container through Docker) |
| mvn test -Dtest=TestClassName#methodName -Dmaven.surefire.debug | debug a test in Eclipse or IDEA to see why it's failing (see http://www.jroller.com/gmazza/entry/jpa_and_junit#debugging) |
| mvn compile -pl wikantik-main -q | compile-check one module; after a signature change use test-compile instead, because compile skips the test sources |
| bin/agent-build.sh start unit -- mvn clean install -DskipITs | run a build that may exceed ~5 minutes detached from the shell; poll with bin/agent-build.sh status unit / wait unit 540 |
| bin/deploy-local.sh, bin/redeploy.sh | run Wikantik on a local Tomcat 11 as the ROOT context at http://localhost:8080/ (first time / after config changes, and the fast routine redeploy). The Cargo run goal is not wired into the war module; Cargo only launches Tomcat for the IT modules |
| bin/run-tests.sh --parallel 4 | the canonical pre-commit gate: all unit tests, then the five IT modules in one 4-wide reactor (needs Docker) |
| mvn clean install -Pintegration-tests | performs a build, enabling the integration tests under wikantik-it-tests. Do not add -T to a raw invocation; parallel ITs are supported only through bin/run-tests.sh --parallel N |
| mvn test -Dtest=MemoryProfiling | (from wikantik-main module) runs a memory profiling test |