---

name: plan-marshall-plugin description: Java domain extension with Maven/Gradle build operations and workflow integration allowed-tools: [Read, Bash]

Plan Marshall Plugin - Java Domain

Domain extension providing Java development capabilities to plan-marshall workflows, including Maven and Gradle build execution with output parsing.

Purpose

• Domain identity and workflow extensions (outline, triage)
• Maven and Gradle build execution with parsed output
• Module detection and profile classification
• Profile-based skill organization

Extension API

Configuration in extension.py implements the Extension API contract:

---

Scripts Overview

---

Wrapper Detection

Both Maven and Gradle prefer project-local wrappers:

CopyMaven:  ./mvnw > mvn (on PATH)
Gradle: ./gradlew > gradle (on PATH)

The detect_wrapper(project_dir) function checks for wrapper scripts in the project root before falling back to system commands.

---

Timeout Learning

Command durations are recorded for adaptive timeouts:

Copy# Before execution
timeout = timeout_get("maven:verify", default=300, project_dir=".")
# Returns: learned * 1.25 or default

# After execution
timeout_set("maven:verify", duration=45, project_dir=".")
# Updates .plan/run-configuration.json

Minimum enforced: 120 seconds (prevents warm JVM timing issues from affecting cold starts).

---

Build Operations

Scripts for Maven and Gradle build execution.

Maven run (Primary API)

Unified command that executes build and returns parsed output on failure.

Copypython3 .plan/execute-script.py pm-dev-java:plan-marshall-plugin:maven run \
    --targets "<goals>" \
    [--module <module>] \
    [--profile <profile>] \
    [--timeout <seconds>] \
    [--mode <mode>]

Parameters:

• --targets - Maven goals to execute (required)
• --module - Target module for multi-module projects
• --profile - Maven profile to activate
• --timeout - Timeout in seconds (default from run-config)
• --mode - Output mode: actionable (default), structured, errors

Output Format (TOON) - tab-separated key-value pairs:

Success:

Copystatus	success
exit_code	0
duration_seconds	45
log_file	.plan/temp/build-output/default/maven-2026-01-04-143022.log
command	./mvnw -l .plan/temp/build-output/... clean test -pl core

Build Failed:

Copystatus	error
exit_code	1
duration_seconds	23
log_file	.plan/temp/build-output/default/maven-2026-01-04-143022.log
command	./mvnw -l .plan/temp/build-output/... clean test
error	build_failed

errors[2]{file,line,message,category}:
src/main/java/Foo.java    42    cannot find symbol       compile
src/main/java/Bar.java    15    null pointer             test

tests:
  passed: 40
  failed: 2
  skipped: 1

Gradle run

Copypython3 .plan/execute-script.py pm-dev-java:plan-marshall-plugin:gradle run \
    --targets "<tasks>" \
    [--module <module>] \
    [--format <toon|json>] \
    [--timeout <seconds>] \
    [--mode <mode>]

Low-level Operations

---

Output Modes

• actionable (default) - Errors + warnings NOT in acceptable_warnings
• structured - All errors + all warnings with [accepted] markers
• errors - Only errors, compact format

Error Categories

Error Codes

---

Warning Handling

Manage warnings via run-config:

Copy# Add accepted warning
python3 .plan/execute-script.py plan-marshall:manage-run-config:run_config warning add \
    --category transitive_dependency \
    --pattern "commons-logging via spring-core"

# List accepted warnings
python3 .plan/execute-script.py plan-marshall:manage-run-config:run_config warning list

---

Integration

This extension is discovered by:

• extension-api - Build system detection and command generation
• skill-domains - Domain configuration
• marshall-steward - Project setup wizard

References

• plan-marshall:extension-api - Extension API contract
• plan-marshall:extension-api/standards/build-execution-flow.md - Complete execution lifecycle
• standards/maven-impl.md - Maven execution details
• standards/gradle-impl.md - Gradle execution details