Skip to content

feat: convert to Spring AI Community parent and version-agnostic starter - #7

Merged
dashaun merged 2 commits into
mainfrom
feat/spring-ai-community-onboarding
Sep 24, 2026
Merged

dashaun merged 2 commits into
mainfrom
feat/spring-ai-community-onboarding

Conversation

@dashaun

@dashaun dashaun commented Sep 24, 2026

Copy link
Copy Markdown
Owner

Summary

Prepares the repository for onboarding to the spring-ai-community GitHub organization and makes the starter version-agnostic across Spring Boot 4.1.x and Spring AI 2.0.x.

Changes

  • Parent POM: inherit from org.springaicommunity:spring-ai-community-parent:1.0.0 instead of spring-boot-starter-parent
  • Coordinates: switch the Maven groupId to org.springaicommunity; rename example packages to org.springaicommunity.agentsmd
  • Version flexibility: spring-boot.version / spring-ai.version are overridable properties (defaults 4.1.0 / 2.0.0); flatten-maven-plugin (oss mode) strips parent/dependencyManagement/properties from published POMs and framework dependencies are optional, so consuming applications' versions win
  • CI: matrix over the supported Spring Boot (4.1.0, 4.1.1) × Spring AI (2.0.0, 2.0.1) combinations via the community reusable ci-build.yml
  • Releases: add publish-snapshot.yml and release.yml using spring-ai-community/community-workflows; add .github/project.yml
  • Docs: document version compatibility in the README

Verification

  • ./mvnw clean verify -Pwiremock-integration green on the merged base
  • All four (Boot × Spring AI) matrix combinations pass: (4.1.0/2.0.0), (4.1.0/2.0.1), (4.1.1/2.0.0), (4.1.1/2.0.1)
  • Published POMs carry no pinned dependencyManagement (confirmed in flattened POMs)

Notes

  • Boot 4.0.x is intentionally out of scope: Spring AI 2.0.x is compiled against Boot 4.1.x
  • Library packages remain under org.springframework.ai.autoconfigure.agents (Spring AI convention), only examples were renamed
  • The snapshot/release workflows require org-level MAVEN_USERNAME, MAVEN_PASSWORD, GPG_SECRET_KEY, GPG_PASSPHRASE secrets before they become active

- Inherit from org.springaicommunity:spring-ai-community-parent:1.0.0
  instead of spring-boot-starter-parent
- Switch the Maven groupId to org.springaicommunity and rename the example
  packages to org.springaicommunity.agentsmd
- Decouple the starter from pinned Spring Boot and Spring AI versions with
  overridable spring-boot.version / spring-ai.version properties; publish
  flattened POMs without dependencyManagement and with optional framework
  dependencies so consuming applications' versions win
- Add a CI matrix over the supported Spring Boot (4.1.x) and Spring AI
  (2.0.x) combinations
- Adopt spring-ai-community reusable workflows for CI, snapshot publishing,
  and Maven Central releases; add .github/project.yml
- Document version compatibility in the README
@dashaun
dashaun force-pushed the feat/spring-ai-community-onboarding branch from 7a059c0 to 0089c0d Compare September 24, 2026 04:44
The matrix job reports per-combination check contexts such as
"build (boot 4.1.0, spring-ai 2.0.0) / build", so the "Protect main"
ruleset's required status check (context "build") never reported and
blocked merges. Add a non-matrix build job that depends on the matrix to
publish the top-level "build" check the ruleset expects.
@dashaun
dashaun merged commit 794613c into main Sep 24, 2026
5 checks passed
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