Utility scripts for local development and pre-release validation.

Runs a focused contract gate for stable/core behavior:

• builds core/default flavor (./mvnw -DskipTests package)
• executes tests tagged core-contract (command surface + core exit-code checks)

Usage:

./scripts/run-core-contract-check.sh

Optional override:

CORE_CONTRACT_TESTS="CoreContractCommandSurfaceTest,CommandExitCodeContractTest" \
./scripts/run-core-contract-check.sh

Optional tag override:

CORE_CONTRACT_GROUP=core-contract ./scripts/run-core-contract-check.sh

Runs a practical smoke suite for idempiere-cli, captures stdout/stderr for each step, and generates a report bundle.

• CLI startup and help
• doctor (text + json)
• setup-dev-env profile validation (--dry-run, docker+rest args)
• init (non-interactive, multi-module)
• info, validate, deps, plugin doctor
• optional add flow with AI prompt (RUN_AI_STEPS=1)
• optional add flow with AI prompt audit flags (--show-ai-prompt, --save-ai-debug)
• optional AI debug artifact validation (.idempiere-cli/ai-debug/*.log with prompt/result markers)
• plugin build (mvnw verify)
• build, package (zip and p2) and deploy from multi-module project root
• standalone plugin flow (init --standalone, add, validate, build, package zip, deploy)
• session log markers (ai-prompt, ai-response, parse diagnostics)
• full command/subcommand matrix via --help (dynamic discovery, executed after core flow)
• functional command matrix (config, skills source, skills which, generate-completion) in isolated HOME

Build/package validation runs before AI prompt steps, so compile/package gates stay deterministic. AI steps are opt-in (RUN_AI_STEPS=1) and non-blocking by default (AI_BLOCKING=0). In core/default build, AI steps fall back to deterministic templates (experimental generators are not loaded). Build/package/deploy steps run only when an iDempiere p2 repository is available at <smoke-root>/work/idempiere/org.idempiere.p2/target/repository (or when you run RUN_SETUP_DEV_ENV_FULL=1).

All artifacts are written under the smoke root (default: /tmp/idempiere-cli-smoke-<timestamp>):

• reports/summary.tsv: step, exit code, log path
• reports/summary.tsv: step, raw/effective exit code, outcome (PASS/XFAIL/FAIL), expected flag, log path
• reports/index.md: human-readable report index
• reports/*.log: one log file per step
• reports.tar.gz: compressed report package

From repository root:

./scripts/run-cli-prebuild-smoke.sh

Custom output root:

./scripts/run-cli-prebuild-smoke.sh /tmp/my-smoke-run

The script supports 3 CLI execution modes via CLI_MODE:

• jar (default): builds local jar and runs java -jar
• binary: runs installed CLI binary from PATH
• auto: prefers binary; falls back to jar mode

Examples:

CLI_MODE=jar ./scripts/run-cli-prebuild-smoke.sh
CLI_MODE=binary CLI_BIN=idempiere-cli ./scripts/run-cli-prebuild-smoke.sh
CLI_MODE=auto ./scripts/run-cli-prebuild-smoke.sh

• CLI_MODE default: jar
• CLI_BIN default: idempiere-cli
• JAR_PATH default: <repo>/target/quarkus-app/quarkus-run.jar
• MAVEN_WRAPPER default: <repo>/mvnw
• PLUGIN_ID default: org.smoke.demo
• PROJECT_NAME default: smoke-demo
• PROMPT_TEXT default: predefined callout prompt
• RUN_COMMAND_MATRIX default: 1 (validates all discovered command/subcommand combinations with --help)
• RUN_FUNCTIONAL_MATRIX default: 1 (runs safe functional checks for config/skills/completion using isolated HOME)
• RUN_STANDALONE_MATRIX default: 1 (runs standalone plugin flow checks)
• RUN_AI_STEPS default: 0 (AI phase disabled unless explicitly enabled)
• AI_BLOCKING default: 0 (AI step failures become XFAIL instead of FAIL)
• RUN_SETUP_DEV_ENV_DRY_RUN default: 1 (adds setup-dev-env --dry-run smoke step)
• RUN_SETUP_DEV_ENV_FULL default: 0 (runs real setup-dev-env, heavy and stateful)
• SETUP_DEV_ENV_ARGS default: --with-docker --include-rest
• SETUP_DB_PASS default: random per run (24 chars, alphanumeric)
• SETUP_DB_ADMIN_PASS default: random per run (24 chars, alphanumeric)
• SETUP_SOURCE_DIR default: <smoke-root>/work/idempiere
• SETUP_ECLIPSE_DIR default: <smoke-root>/work/eclipse
• SMOKE_MAVEN_REPO default: <smoke-root>/work/.m2-repo (isolates Maven cache/locks per run)
• DEPLOY_TARGET_HOME default: <smoke-root>/work/idempiere-home (fake target with plugins/ for deploy smoke)
• DEPLOY_TARGET_HOME_STANDALONE default: <smoke-root>/work/idempiere-home-standalone (fake target for standalone deploy smoke)
• STANDALONE_PLUGIN_ID default: org.smoke.standalone
• STANDALONE_PROJECT_NAME default: smoke-standalone
• EXPECTED_FAILURE_STEPS default: empty; semicolon-separated step names treated as expected failure (XFAIL)
• HELP_MATRIX_ACCEPT_EXIT2_PATHS default: fixed allowlist of command paths that may legitimately return exit 2 for --help
• SMOKE_FAIL_ON_REGRESSION default: 0; when 1, script exits non-zero if any unexpected failure (FAIL) occurs
• RUN_BUILD_PIPELINE default: 1; when 0, skips verify/dist/deploy steps even if p2 repository exists

Fail-fast behavior:

• if RUN_SETUP_DEV_ENV_FULL=1 and that step fails, the script aborts downstream deterministic/build/dist/deploy phases
• this keeps one root failure in the report instead of a cascade of derived failures

Dry-run only (default behavior):

CLI_MODE=jar ./scripts/run-cli-prebuild-smoke.sh

Run full setup-dev-env step too:

CLI_MODE=jar RUN_SETUP_DEV_ENV_FULL=1 ./scripts/run-cli-prebuild-smoke.sh

Run a faster smoke without command matrix:

CLI_MODE=jar RUN_COMMAND_MATRIX=0 ./scripts/run-cli-prebuild-smoke.sh

Run a faster smoke without functional matrix:

CLI_MODE=jar RUN_FUNCTIONAL_MATRIX=0 ./scripts/run-cli-prebuild-smoke.sh

Run a faster smoke without standalone matrix:

CLI_MODE=jar RUN_STANDALONE_MATRIX=0 ./scripts/run-cli-prebuild-smoke.sh

Enable AI phase (experimental):

CLI_MODE=jar RUN_AI_STEPS=1 ./scripts/run-cli-prebuild-smoke.sh

Make AI failures blocking:

CLI_MODE=jar RUN_AI_STEPS=1 AI_BLOCKING=1 ./scripts/run-cli-prebuild-smoke.sh

Mark known issues as expected failures (without hiding real regressions):

EXPECTED_FAILURE_STEPS="Build with plugin mvnw;Dist at project root;Deploy copy at project root" \
CLI_MODE=jar ./scripts/run-cli-prebuild-smoke.sh

Before publishing a release, run both gates (core-only default):

Fast gate:

CLI_MODE=jar SMOKE_FAIL_ON_REGRESSION=1 ./scripts/run-cli-prebuild-smoke.sh

Full gate (includes full setup-dev-env path):

CLI_MODE=jar RUN_SETUP_DEV_ENV_FULL=1 SMOKE_FAIL_ON_REGRESSION=1 ./scripts/run-cli-prebuild-smoke.sh

Optional experimental extension (not part of release gate):

CLI_MODE=jar RUN_AI_STEPS=1 ./scripts/run-cli-prebuild-smoke.sh

• This script is a developer smoke harness. It does not replace CI.
• The script executes in a natural developer order first, then runs the full command matrix as a coverage pass.
• Core flow is designed to be deterministic; failures should indicate an actionable regression or environment issue.
• If full setup is not enabled and p2 repository is missing, verify/dist/deploy steps are skipped by design.
• First run with isolated Maven repo may download dependencies again; expect longer runtime and required network access.
• Use reports/index.md + step logs for triage.
• The command matrix uses --help only (safe, no side effects). It does not run doctor --fix or doctor --fix-optional.
• In matrix mode, exit 2 is accepted only for paths in HELP_MATRIX_ACCEPT_EXIT2_PATHS and only when a valid Usage: idempiere-cli <command...> is resolved.