src/ecosystem-ci/README.md
This directory contains the configuration for the Spring AI Ecosystem CI Dashboard, which monitors the CI health of key ecosystem dependencies.
The dashboard workflow runs daily and:
To receive notifications when ecosystem dependencies fail CI:
| Condition | Action |
|---|---|
| Dependency fails (day 1) | Dashboard updated, no alert |
| Dependency fails for 2+ days | Alert comment posted (triggers notification) |
| Dependency recovers | Dashboard updated, no alert |
The alert_after_days setting in ci-alert-config.json controls the threshold (default: 2 days).
Edit ci-alert-config.json:
{
"dependencies": [
{ "owner": "org-name", "repo": "repo-name" },
...
]
}
Each dependency must have:
owner: GitHub organization or userrepo: Repository nameThe workflow monitors the branch specified by tracked_branch (default: main).
| Field | Description | Default |
|---|---|---|
issue_number | GitHub issue for dashboard and alerts | 5334 |
tracked_branch | Branch to monitor for each repo | main |
alert_after_days | Days of failure before alerting | 2 |
heartbeat_days | Minimum days between repeat alerts | 1 |
To run the dashboard manually:
main branch and click Run workflowci-alert-config.json - Dashboard configuration../../.github/workflows/dependency-ci-dashboard.yml - GitHub Actions workflow