@lystran/pi-mvn-compact

Compact Maven output for Pi coding agent

Packages

Package details

extension

Install @lystran/pi-mvn-compact from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@lystran/pi-mvn-compact
Package
@lystran/pi-mvn-compact
Version
0.2.0
Published
Aug 23, 2026
Downloads
271/mo · 6/wk
Author
lystran
License
MIT
Types
extension
Size
40.4 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@lystran/pi-mvn-compact

给 Pi coding agent 提供 Maven 工具,压缩 Maven 的高噪声命令输出

使用边界

这个工具只适用于 Maven 项目。它优先执行当前工作目录的 ./mvnw,不存在时执行 PATH 中的 mvn

AI 调用工具时只传 Maven 参数数组:

{
  "args": ["clean", "test"]
}

不要在 args 中传入 mvn./mvnw、管道、重定向或其他 shell 语法

默认使用 compact 模式:成功时返回短摘要,失败时返回分类诊断、测试报告目录和完整日志路径。完整日志保存到项目下的 .agent-logs/maven/,失败日志保留,成功日志默认保留在当前运行期间但不会返回全部内容

mode: "full" 用于需要查看 Maven 原始输出的调试场景

工具还会识别影响结果可信度的常见参数:

  • -DskipTests-Dmaven.test.skip-DskipITs 会返回 NOT_RUN
  • -DtestFailureIgnore-Dmaven.test.failure.ignore-fn 不会让被忽略的测试/构建失败伪装成 PASS
  • -Dtest-Dit.testfailIfNoSpecifiedTests 会标记空测试选择
  • -q-l、自定义日志配置导致测试证据缺失时会返回 UNKNOWN
  • 重试成功的测试会返回 PASS_WITH_FLAKES
  • -pl-am-amd-N-rf-T 和 Reactor 失败策略会在摘要中显示构建范围提示

结果状态包括 PASSFAILNOT_RUNPASS_WITH_FLAKESINCOMPLETEUNKNOWNMaven exit code: 0 只代表 Maven 进程返回成功,不代表测试一定完整通过