# Mage-OS Dashboard

> Health dashboard for the Mage-OS GitHub organizations (mage-os, mage-os-lab): open issues and pull requests, priority-ranked action items, CI status per repository, and Magento repositories not yet mirrored. Rebuilt from the GitHub API about every 3 hours.

Prefer the Markdown or JSON versions below over scraping the HTML page. Requesting `/` with `Accept: text/markdown` also returns the Markdown version.

Notes for interpreting the data:

- "Age" / `ageDays` is days since the item was last updated, not since it was created (`createdAt` is in the JSON).
- `staleLevel` is `warning` after 30 days without updates and `critical` after 90.
- `priorityScore` (0-100) sums `priorityFactors`: age, reviewStatus (PRs only), labels (bug/security weigh most), repoActivity (stale item in a recently active repo).
- `actionItems` holds the top 20 items by priority score across all organizations.
- All timestamps are UTC ISO 8601.

## Current data

- [Markdown](/index.md): Full dashboard as Markdown: everything on the HTML page
- [JSON](/dashboard-data.json): Complete structured dashboard state: stats, per-repo issues and PRs, priority-scored action items, missing mirrors
- [Summary report](/report.md): Condensed health report: top action items, oldest stale PRs and issues
- [llms.txt](/llms.txt): Index of agent-friendly resources for this dashboard

## Historical data

Snapshots share the schema of `/dashboard-data.json`, so they can be compared to track trends over time.

- [latest.json](https://raw.githubusercontent.com/mage-os/dashboard/data/latest.json): Most recent snapshot (same schema as /dashboard-data.json)
- [latest-report.md](https://raw.githubusercontent.com/mage-os/dashboard/data/latest-report.md): Most recent summary report
- [snapshots/YYYY/MM/YYYY-MM-DD-HH.json](https://raw.githubusercontent.com/mage-os/dashboard/data/snapshots/YYYY/MM/YYYY-MM-DD-HH.json): Historical snapshots, archived roughly every 3 hours (UTC timestamp in the filename)
- [Snapshot index (GitHub API)](https://api.github.com/repos/mage-os/dashboard/contents/snapshots?ref=data): List snapshot years; append /YYYY or /YYYY/MM to the path to list deeper
- [data branch](https://github.com/mage-os/dashboard/tree/data): Browse the historical archive on GitHub

## Optional

- [Source code](https://github.com/mage-os/dashboard): generator source; schema is defined by `collectDashboardData()` in `src/data-processing.js`