[alexander-yevsyukov]

Reworks io.spine.environment.OsFamily so that it follows the detection rules of
org.apache.tools.ant.taskdefs.condition.Os, which it is based on, and so that
the rules can be tested regardless of the host the tests run on.

Detection

The previous implementation deviated from Ant in how it told a Unix:

Case	Before	After
Unix.isCurrent() on macOS	false — the families were mutually exclusive	true — a macOS host belongs to both macOS and Unix
SunOS, FreeBSD, and other Unix systems whose name does not end with x	not a Unix, so detect() threw	Unix
Missing os.name or path.separator property	class initialization failed with IllegalStateException	treated as an empty value

Unix is told by the : path separator, minus the two systems that use it
without being a Unix: OpenVMS and classic (pre-OS X) Mac OS.

As the families now overlap, code that relied on them being mutually exclusive
should use detect(). It returns the most specific family — macOS rather than
Unix on a Mac — relying on the more specific families being declared first.
When the OS belongs to none of the families, its exception now names the
os.name value.

Testability

The public methods keep their signatures: isCurrent() and detect(). The rules
move into two package-private, @VisibleForTesting methods,
matches(osName, pathSeparator) and detect(osName, pathSeparator), which the
public ones apply to the current system properties.

The properties are read into static final fields at class initialization, so
before this change a test could only observe the family of the host it ran on.
OsFamilySpec now drives each family and detect() through a table of real
os.name values (Windows, Mac OS X, Darwin, classic Mac OS, Linux, HP-UX,
SunOS, OpenVMS), covers the failure of detect(), and ties the seams back to
the public methods on the host. OsFamily is fully covered.

Documentation

Each constant is now documented, and the docs of the enum and detect() state
the overlap of the families and the exception detect() throws.

Housekeeping

• config moves to 94a9e08b, which adds
  SpineEventEngine/config#780
  and SpineEventEngine/config#781
  to the ref on master. The bump changes no file of this repository by itself.
• The version is 2.0.0-SNAPSHOT.445, with the dependency reports regenerated
  to match.

Verification

./gradlew :base:build :environment:build :base:dokkaGenerate :environment:dokkaGenerate
passes on the head of the branch.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds a new io.spine.os package with an OsFamily enum (ported from Ant) to detect the host OS without requiring a ToolBase dependency, and updates version/dependency-report artifacts accordingly. The PR also includes a substantial generatePom rework (via config/built tooling updates) with additional tests.

Changes:

• Introduce io.spine.os.OsFamily with isCurrent() and a test seam (matches(...)) plus unit tests covering multiple OS name variants.
• Bump published snapshot version and regenerate dependency reports/POM to match.
• Update build tooling around generatePom (lock-safe/deterministic behavior) and add Gradle TestKit coverage.

Reviewed changes

Copilot reviewed 22 out of 22 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
version.gradle.kts	Bumps versionToPublish snapshot.
docs/dependencies/pom.xml	Updates generated POM version to match snapshot.
docs/dependencies/dependencies.md	Regenerates dependency license report content and timestamps.
buildSrc/build.gradle.kts	Configures TestKit + passes buildSrc classpath to functional tests.
buildSrc/src/main/kotlin/io/spine/gradle/report/pom/DependencyWriter.kt	Refactors dependency version sourcing to use collected resolved versions.
buildSrc/src/main/kotlin/io/spine/gradle/report/pom/PomGenerator.kt	Makes generatePom depend on per-project resolved-version collectors.
buildSrc/src/main/kotlin/io/spine/gradle/report/pom/PomXmlWriter.kt	Threads resolved-version source into XML generation.
buildSrc/src/main/kotlin/io/spine/gradle/report/pom/ResolvedVersions.kt	Adds per-project collector task + resolution graph extraction.
buildSrc/src/test/kotlin/io/spine/gradle/report/pom/DependencyWriterSpec.kt	Updates/extends unit coverage around resolved versions behavior.
buildSrc/src/test/kotlin/io/spine/gradle/report/pom/PomGeneratorIgTest.kt	Adds TestKit integration test for generatePom determinism and conflict handling.
buildSrc/src/main/kotlin/io/spine/dependency/local/*.kt	Bumps local Spine SDK dependency versions.
buildSrc/src/main/kotlin/io/spine/dependency/lib/Jackson.kt	Minor refactor/clarification of Jackson module coordinates/docs.
buildSrc/src/main/kotlin/io/spine/dependency/lib/JacksonV2.kt	Clarifies Jackson JSTEP-1 reference.
base/src/main/java/io/spine/os/package-info.java	Introduces io.spine.os package with nullness/return-value annotations.
base/src/main/java/io/spine/os/OsFamily.java	Adds OS-family detection API and matching rules.
base/src/test/kotlin/io/spine/os/OsFamilySpec.kt	Adds parameterized tests for Windows/macOS/Unix matching and host-property consistency.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

❌ Patch coverage is 91.66667% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.00%. Comparing base (51cb428) to head (8abcd67).
⚠️ Report is 28 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #957      +/-   ##
==========================================
- Coverage   94.01%   94.00%   -0.02%     
==========================================
  Files         194      195       +1     
  Lines        4177     4201      +24     
  Branches      345      351       +6     
==========================================
+ Hits         3927     3949      +22     
  Misses        149      149              
- Partials      101      103       +2     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.