Maven Plugin

dev.kensa:kensa-maven-plugin provides one mojo: assemble-site. It does the same job as Gradle's assembleKensaSite task — collects every sources/<id>/ bundle that test executions wrote into a shared site root and produces the shell + manifest on top.

The Maven plugin does not wire system properties for you; you set them on each surefire/failsafe execution. This keeps the surface minimal and avoids interfering with existing surefire configurations.

Apply

The plugin resolves from Maven Central as dev.kensa:kensa-maven-plugin, from 0.9.16. Earlier versions listed in the compatibility table below were never published there; use 0.9.16 or later.

pom.xml
<plugin>
  <groupId>dev.kensa</groupId>
  <artifactId>kensa-maven-plugin</artifactId>
  <version>${kensa.plugin.version}</version>
  <executions>
    <execution>
      <id>assemble-site</id>
      <phase>post-integration-test</phase>
      <goals><goal>assemble-site</goal></goals>
      <configuration>
        <expectedSourceIds>
          <expectedSourceId>uiTest</expectedSourceId>
          <expectedSourceId>scenarioTest</expectedSourceId>
        </expectedSourceIds>
      </configuration>
    </execution>
  </executions>
</plugin>

You also need dev.kensa:kensa-core on the test classpath — the Kensa runtime emits the per-source bundles; the Maven plugin only assembles them.

kensa-core compatibility

Since plugin v0.9.0, the Maven plugin and kensa-core version independently.

Plugin	Default kensa-core	Min kensa-core	Notes
0.9.18	0.9.5	0.8.0	Site shell now copies `kensa-embed.js` and `favicon.png` from the core jar (build-plugins #8); cores older than 0.9.5 still assemble.
0.9.17	0.9.5	0.8.0	Default `kensaCoreVersion` bumped to 0.9.5 (report embed mode and `kensa-embed.js` #224; link unfurl pages; `withLinkBaseUrl` / `KENSA_LINK_BASE_URL` #224; sticky test name #223; badge filter #225). No Maven-side change.
0.9.16	0.9.4	0.8.0	Default `kensaCoreVersion` bumped to 0.9.4 (`suite_summary` MCP tool and compact listings #221; `#/issue/<key>` and `#/epic/<id>` report links #222; `SetupStep.setup(scope)` #210, `SetupSteps(list)` #213, one-line setup-step builders #212; polling-block wording, in-pane deep-link scrolling, `?theme=` on report URLs). No Maven-side change.
0.9.15	0.9.3	0.8.0	Default `kensaCoreVersion` bumped to 0.9.3 (user thread locals in polling checks via `withCoroutineContextProviders` #220, report deep-link anchors #219, MCP `captured_interactions` empty-group fix #218). No Maven-side change.
0.9.14	0.9.2	0.8.0	Default `kensaCoreVersion` bumped to 0.9.2 (`run.json` run marker with live counts, MCP run-state tools #217; CLI wrapper arch detection, pinning and checksums #216; issue-filter deep-link fix #215). No Maven-side change.
0.9.13	0.9.0	0.8.0	Default `kensaCoreVersion` bumped to 0.9.0 — the API freeze ahead of 1.0. Implementation packages are now `internal` and core must pair with same-version adapters, so move explicit adapter pins to 0.9.0 together. Also brings `@Epic` (#194), the report overview page (#195), replay links on issue badges and fixes #185, #189–#193. No Maven-side change.
0.9.12	0.8.16	0.8.0	Built with Kotlin 2.4.10; default `kensaCoreVersion` bumped to 0.8.16 (container chains, `by fixtures(fx)` delegate, qualified enum constants #180, diagram glyphs #179). No Maven-side change.
0.9.11	0.8.15	0.8.0	Default `kensaCoreVersion` bumped to 0.8.15 (`kensa mcp` CLI server, negative matcher assertions, #174/#176/#177). No Maven-side change.
0.9.10	0.8.14	0.8.0	Default `kensaCoreVersion` bumped to 0.8.14 (path-expression rendering sweep #168–#172, protected phrases #166, parameterised header hover #165; includes 0.8.13's #162/#163). No Maven-side change.
0.9.9	0.8.12	0.8.0	Default `kensaCoreVersion` bumped to 0.8.12, which fixes `@ExpandableSentence` / `@RenderedValue` with value class parameters and return types (#160) and array parameter types in parameterized tests (#161), and includes 0.8.11's multi-assertion `thenEventually` / `thenContinually` blocks. No Maven-side change.
0.9.8	0.8.10	0.8.0	Default `kensaCoreVersion` bumped to 0.8.10, which adds `@Fixture` factory functions and fixes two `@RenderedValue` rendering bugs. Note that factory functions need the Kensa Kotlin compiler plugin, which the Maven plugin does not apply — see Limitations. No Maven-side change.
0.9.7	0.8.8	0.8.0	Version bump only — paired Gradle-plugin site-mode resolution fix; no Maven-side change.
0.9.6	0.8.8	0.8.0	Default `kensaCoreVersion` bumped to 0.8.8.
0.9.5	0.8.7	0.8.0	Built against Kotlin 2.4.0 (affects the Gradle plugin's apply-time Kotlin check only — no Maven-side change). Default `kensaCoreVersion` bumped to 0.8.7.
0.9.4	0.8.5	0.8.0	Default `kensaCoreVersion` bumped to 0.8.5, whose listener short-circuits when no Kensa tests ran so a transitive kensa-core no longer writes empty reports or prints the banner. (The `outputSourceSets` split is Gradle-only.)
0.9.3	0.8.4	0.8.0	Multi-submodule site aggregation: apply the plugin at the rootProject of a multi-project build and contributor subprojects auto-register their source sets into a single aggregated site. Default `kensaCoreVersion` bumped to 0.8.4.
0.9.2	0.8.3	0.8.0	Default `kensaCoreVersion` bumped to 0.8.3 so site-mode aggregation picks up the parameterised test display, sidebar tree expand/collapse toolbar, and absolute-path console banner without each project having to override.
0.9.1	0.8.1	0.8.0	Site-mode: `<sourceTitles>` mojo parameter, per-source component diagrams.
0.9.0	0.8.0	0.8.0	First decoupled release — plugin and kensa-core versioned independently.
0.7.x	0.7.x	—	Same-version pairing (no override)

v0.8.0 was withdrawn — its POM declared an unpublished dev.kensa:site-common dep. Use 0.9.0 or later.

Override the default with <kensaCoreVersion> on the mojo configuration:

<configuration>
  <kensaCoreVersion>0.8.1</kensaCoreVersion>
</configuration>

No upper bound — newer kensa-core versions are assumed compatible until proven otherwise. A version below the minimum fails fast at execution time.

Mojo configuration

Parameter	Default	Effect
`siteRoot`	`${project.build.directory}/kensa-site`	Site root directory.
`expectedSourceIds`	(required)	List of source ids the manifest should include. Same set you pass via `kensa.source.id` to the per-execution test runs.
`kensaVersion`	`${plugin.version}`	Recorded in `manifest.json`.
`kensaCoreVersion`	bundled default	Version of `dev.kensa:kensa-core` to resolve for shell extraction. Defaults to the version this plugin release was tested against. See compatibility matrix.
`sourceTitles`	empty	`Map<String, String>` of per-source display labels for the aggregated site, keyed by source id. Entries override the `titleText` the test runtime wrote to each `configuration.json`. See Site-mode source titles. Added in 0.9.1.

Site-mode source titles

Set per-source display labels via <sourceTitles> on the mojo configuration. Entries here override the titleText the test runtime wrote to each source's configuration.json (and rewrite the file so the standalone per-source HTML page <title> matches the manifest sidebar label).

<configuration>
  <expectedSourceIds>
    <expectedSourceId>uiTest</expectedSourceId>
    <expectedSourceId>scenarioTest</expectedSourceId>
  </expectedSourceIds>
  <sourceTitles>
    <uiTest>UI Tests</uiTest>
    <scenarioTest>Scenario Tests</scenarioTest>
  </sourceTitles>
</configuration>

Precedence when more than one path declares a title for the same source id:

<sourceTitles> mojo parameter — build DSL, wins
Kensa.konfigure { titleText = "..." } in code — wins when no build entry
kensa.source.title via <systemPropertyVariables> on the surefire/failsafe execution — legacy, soft-deprecated since 0.9.1
"Index" / source id fallback when none of the above is set

Driving per-source bundles via surefire/failsafe

Each test execution that should produce its own source bundle sets kensa.output.root and kensa.source.id via systemPropertyVariables:

pom.xml — failsafe per-execution wiring
<plugin>
  <artifactId>maven-failsafe-plugin</artifactId>
  <executions>
    <execution>
      <id>uiTest</id>
      <goals><goal>integration-test</goal></goals>
      <configuration>
        <systemPropertyVariables>
          <kensa.output.root>${project.build.directory}/kensa-site</kensa.output.root>
          <kensa.source.id>uiTest</kensa.source.id>
        </systemPropertyVariables>
      </configuration>
    </execution>
    <execution>
      <id>scenarioTest</id>
      <goals><goal>integration-test</goal></goals>
      <configuration>
        <systemPropertyVariables>
          <kensa.output.root>${project.build.directory}/kensa-site</kensa.output.root>
          <kensa.source.id>scenarioTest</kensa.source.id>
        </systemPropertyVariables>
      </configuration>
    </execution>
  </executions>
</plugin>

When kensa.source.id is set, Kensa core writes its bundle to ${kensa.output.root}/sources/${kensa.source.id}/ instead of the default ${kensa.output.root}/kensa-output/. This is the same runtime contract that powers the Gradle plugin — see Site Mode for the disk layout.

Multi-module builds

Bind the assemble-site execution on the root pom.xml and set siteRoot to a shared location (e.g. ${session.executionRootDirectory}/target/kensa-site). Every submodule's surefire/failsafe execution writes into that shared root using its own kensa.source.id; the root-level assemble-site then aggregates.

Run

mvn verify

The assemble-site goal binds to post-integration-test, so it runs after all *-IT tests have written their per-source bundles. Open target/kensa-site/index.html afterwards.

Source IDs and titles

Same contract as Gradle:

Property	Effect
`kensa.source.id`	Per-source bundle directory name. Required to opt into site mode (otherwise Kensa core writes to the default `kensa-output/` location).
`kensa.source.title`	Overrides `Configuration.titleText` — the label shown for that source in the sidebar.

If kensa.source.title is not set, the source's sidebar label falls back to whatever Configuration.titleText was set to programmatically (or "Index" if untouched).

Limitations relative to the Gradle plugin

No Kensa Kotlin compiler plugin. The Gradle plugin wires the Kensa compiler plugin onto your Kotlin compilation; the Maven plugin does not. Compiler-plugin-dependent features — @RenderedValue / @ExpandableSentence value capture in Kotlin and @Fixture factory functions — are therefore unavailable in Kotlin Maven builds until compiler-plugin wiring is documented/supported for kotlin-maven-plugin. Java projects are unaffected (Java value capture goes through the runtime).
No automatic source-id collision detection — set unique ids per execution yourself.
A missing expected source logs a notice rather than failing the build (matching the Gradle behaviour).
The mojo is @DisableCachingByDefault equivalent — Maven has no build cache to participate in. Re-running rebuilds the manifest unconditionally.

Apply​

kensa-core compatibility​

Mojo configuration​

Site-mode source titles​

Driving per-source bundles via surefire/failsafe​

Multi-module builds​

Run​

Source IDs and titles​

Limitations relative to the Gradle plugin​