Skip to content

Build instructions for Maven Central; a fresh clone builds - #132

Merged
jcombs-pointblue merged 1 commit into
masterfrom
central-build-docs
Nov 11, 2026
Merged

jcombs-pointblue merged 1 commit into
masterfrom
central-build-docs

Conversation

@jcombs-pointblue

Copy link
Copy Markdown
Contributor

Fixed: on a machine without the simulator in ~/.m2, mvn test stopped in the require-engine enforcer rule. The rule checked for dirxml-simulator-1.9.0.jar at validate, before Maven could fetch it from Maven Central, and bin/install-deps had just said "on Maven Central, nothing to install". The rule now checks only the engine jars.

Changed:

  • bin/install-deps fetches a pinned version that is on Central into ~/.m2 (mvn dependency:get), instead of skipping it. bin/idm puts the simulator on the class path from ~/.m2, so it has to be there before the first build. This also keeps every existing "run bin/install-deps" hint in bin/idm, idm.cmd and doctor correct. The --help text was cut short; it now prints the whole header.
  • Docs: install.md §1/§2.0/§2.0.1/§2.1/§2.2, README, agent-assisted-setup.md, howto-clone-vault.md, howto-fresh-designer-project.md. Using DirXMLDev now means: clone this repository, copy in the engine jars, bin/install-deps, mvn test. Building the simulator is only for changing it.

Verified with an empty home directory (empty ~/.m2):

  • mvn test: 1058 tests, 0 failures; the simulator came from Central.
  • bin/idm doctor: OK, simulator 1.9.0 found.
  • install-deps with an empty M2_REPO: fetched trace-core 1.12.0 and simulator 1.9.0; --list shows both installed.

DirXMLDevWeb carries the same install-deps; it gets the same change in a separate PR.

🤖 Generated with Claude Code

The require-engine enforcer rule checked for the simulator jar in ~/.m2 at validate, before Maven
could fetch it, so a fresh clone stopped there even though the simulator is on Maven Central. It
now checks the engine jars only. bin/install-deps fetches a pinned version that is on Central into
~/.m2 instead of skipping it, so bin/idm finds the simulator before the first build and every
"run bin/install-deps" hint stays right. The docs drop building the simulator first: clone
DirXMLDev, copy in the engine jars, run bin/install-deps, mvn test.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jcombs-pointblue
jcombs-pointblue merged commit be424c7 into master Nov 11, 2026
4 checks passed
@jcombs-pointblue
jcombs-pointblue deleted the central-build-docs branch November 11, 2026 22:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant