# Project Health Dashboard

> Tracks key metrics for skills-tree health, growth, and sustainability.
> This document is manually updated on each release. Automate with the health workflow.

## 📆 Last Updated

**June 2026** — post-growth-phase implementation

---

## 📦 Releases

| Metric | Value |
|---|---|
| Current version | See [releases](https://github.com/SamoTech/skills-tree/releases) |
| Release cadence | Automated via semantic-release on push to `main` |
| PyPI package | [skills-tree on PyPI](https://pypi.org/project/skills-tree/) |
| OIDC publishing | ✅ Enabled (no stored secrets) |

---

## 📊 Downloads

| Metric | Where to Track |
|---|---|
| Monthly PyPI downloads | [pypistats.org/packages/skills-tree](https://pypistats.org/packages/skills-tree) |
| Download badge | [![Downloads](https://img.shields.io/pypi/dm/skills-tree)](https://pypi.org/project/skills-tree/) |
| Lifetime downloads | [pepy.tech/project/skills-tree](https://pepy.tech/project/skills-tree) |

---

## 🧪 Coverage

| Metric | Value |
|---|---|
| Current coverage | Tracked in CI — see [test-coverage.yml](../.github/workflows/test-coverage.yml) |
| Minimum threshold | 70% (CI gate) |
| Coverage report | Generated as artifact on every main push |
| Codecov integration | Enabled (see workflow) |
| Coverage strategy | [meta/COVERAGE_STRATEGY.md](COVERAGE_STRATEGY.md) |

---

## 🐛 Open Issues

| Metric | Link |
|---|---|
| Open issues | [![Issues](https://img.shields.io/github/issues/SamoTech/skills-tree)](https://github.com/SamoTech/skills-tree/issues) |
| Open PRs | [![PRs](https://img.shields.io/github/issues-pr/SamoTech/skills-tree)](https://github.com/SamoTech/skills-tree/pulls) |
| Good first issues | [Filtered view](https://github.com/SamoTech/skills-tree/issues?q=is%3Aopen+label%3A%22good+first+issue%22) |

---

## 👥 Contributors

| Metric | Link |
|---|---|
| Total contributors | [![Contributors](https://img.shields.io/github/contributors/SamoTech/skills-tree)](https://github.com/SamoTech/skills-tree/graphs/contributors) |
| Contributions graph | [GitHub Insights](https://github.com/SamoTech/skills-tree/graphs/contributors) |

---

## 📚 Documentation

| Metric | Status |
|---|---|
| MkDocs docs site | ✅ Deployed to GitHub Pages |
| Docs deploy workflow | [docs-deploy.yml](../.github/workflows/docs-deploy.yml) |
| Docs URL | [samotech.github.io/skills-tree](https://samotech.github.io/skills-tree) |
| API reference | ✅ [docs/api.md](../docs/api.md) |
| CLI reference | ✅ [docs/cli.md](../docs/cli.md) |
| Installation guide | ✅ [docs/installation.md](../docs/installation.md) |
| Quick start | ✅ [docs/quickstart.md](../docs/quickstart.md) |
| Architecture | ✅ [docs/architecture.md](../docs/architecture.md) |
| WHY doc | ✅ [docs/WHY_SKILLS_TREE.md](../docs/WHY_SKILLS_TREE.md) |
| USE_CASES doc | ✅ [docs/USE_CASES.md](../docs/USE_CASES.md) |
| 10-language i18n | ✅ [i18n/](../i18n/) |

---

## 🔒 Security

| Metric | Status |
|---|---|
| SECURITY.md | ✅ Present |
| Dependabot | ✅ Enabled (GitHub Actions + Python) |
| Dependabot auto-merge | ✅ patch + minor auto-merged after CI |
| Gitleaks secret scanning | ✅ `.gitleaks.toml` configured |
| OSV scanner | ✅ `osv-scanner.toml` configured |

---

## 🤝 Community Health

| File | Status |
|---|---|
| README.md | ✅ Optimized with PyPI/download/CI badges |
| CONTRIBUTING.md | ✅ Present and detailed |
| CODE_OF_CONDUCT.md | ✅ Contributor Covenant v2.1 |
| SECURITY.md | ✅ Present |
| Pull Request Template | ✅ `.github/pull_request_template.md` |
| Bug Report Template | ✅ `.github/ISSUE_TEMPLATE/bug_report.yml` |
| Feature Request Template | ✅ `.github/ISSUE_TEMPLATE/feature_request.yml` |
| Skill Stub Upgrade Template | ✅ `.github/ISSUE_TEMPLATE/skill_stub_upgrade.yml` |
| CODEOWNERS | ✅ `.github/CODEOWNERS` |

---

## 📈 Growth Targets

| Metric | Current | 3-Month Target | 12-Month Target |
|---|---|---|---|
| GitHub Stars | — | 500 | 2,000 |
| Monthly PyPI downloads | — | 1,000 | 10,000 |
| Contributors | — | 20 | 100 |
| Battle-tested skills (v3) | 50 | 100 | 300 |
| Test coverage | ~35% | 70% | 90% |
