archiveheritagegroup/heratio
Grade a repo

85

/ 100

GradeB

Well engineered. The main gaps are issue and PR templates and dependency metadata. It just hasn't found an audience yet.

Top 22% of 5,156 graded repos

Open-source (AGPL-3.0) GLAM platform on Laravel 12: archival description, museum collections management, digital asset management, and records management in one self-hostable app. Records in Contexts (RiC) native. ISAD(G)/ISAAR/ISDIAH, Spectrum-capable, OAIS/OCFL preservation, IIIF. A modern AtoM/ArchivesSpace alternative.

Documentation89
Engineering81
Health86
PHP5AGPL-3.09d ago

Top fixes

Highest-impact changes first, ranked by point weight

12 to address
  1. 1
    CI/CD14pt

    Add a lint step to catch style issues automatically.

  2. 2
    CI/CD14pt

    Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.

  3. 3
    README12pt

    Add a GIF, screenshot, or logo image. It is the fastest way to show what your project does.

  4. 4
    Reproducibility6pt

    Add .github/dependabot.yml with at least one package-ecosystem entry, or a renovate.json, so dependencies are updated automatically.

Working through the fixes? Let every push regrade itself.

The free GitHub App rescans this repo on every push and posts the grade as a commit check, so the score climbs without coming back to rescan by hand.

Install the GitHub App

Scorecard

Every check, grouped by category and sorted worst-first

Documentation

89

README12pt80

README is present.

Contributing guide5pt80

Contributing guide is detailed and thorough.

Install and run instructions9pt100

README documents how to install the project.

License6pt100

Licensed under AGPL-3.0.

Engineering

81

Issue and PR templates6pt0

No issue or PR templates found (−100 pts).

→ Add .github/ISSUE_TEMPLATE/ with bug_report.md and feature_request.md to guide contributors. It dramatically improves issue quality.

Reproducibility6pt80

Lockfile present (composer.lock). Installs are reproducible.

CI/CD14pt85

CI is configured (.github/workflows/build-install-artifact.yml).

Tests18pt100

Test files detected (docs/benchmarks/qlever-vs-fuseki-2026-09/update_test.py).

Linting and formatting5pt100

Linter or formatter configured (.editorconfig).

Project health

86

Housekeeping3pt60

.gitignore present.

Dependency manifest6pt75

Dependency manifest found (composer.json).

Repository metadata5pt100

Repository has a description.

Activity5pt100

Actively maintained (pushed within the last month).

Repository health signals

Activity, community, and responsiveness at scan time

Activity

  • -
    Commits (30d / 90d)
  • 0
    Forks
  • 1000
    Releaseslatest 3mo ago

Community

  • 62% - Fair
    Community health
  • 1 bus factorlow
    author own >50% of commits
  • 5
    Watchers

Responsiveness

  • 4h
    Median issue response
  • 18h
    Median PR merge time
  • 31
    Open issues
Repository files65 root entries
  • .claude
  • .disabled-modules
  • .fix
  • .github
    Good: CI is configured (.github/workflows/build-install-artifact.yml).
  • app
  • audit_outputs
  • bin
  • bootstrap
  • config
  • data
  • database
  • deploy
  • docker
    Good: Environment pinned via docker/Dockerfile.
  • docs
    Good: Test files detected (docs/benchmarks/qlever-vs-fuseki-2026-09/update_test.py).
    Good: Security policy present.
  • fs-metadata-capture
  • hooks
  • lang
  • packages
  • public
  • resources
  • routes
  • scripts
  • site
  • storage
  • tests
  • tools
    Issue: Build artifacts or local files may be committed (tools/plyr-build/node_modules/.bin) (−40 pts).Fix: Remove them and add to .gitignore.
  • youtube
  • .ahg-ai.json
  • .dockerignore
  • .editorconfig
    Good: Linter or formatter configured (.editorconfig).
  • .env.example
  • .env.production.example
  • .env.testing.example
  • .gh-issue-1.md
  • .gh-issue-2.md
  • .gh-issue-3.md
  • .gh-issue-4.md
  • .gitattributes
  • .gitignore
    Good: .gitignore present.
  • .gitleaksignore
  • .km-ingest
  • .locked-paths
  • ACKNOWLEDGMENTS.md
  • artisan
  • audit_report.py
  • close_audit_async.py
  • close_audit_issues.py
  • composer.json
    Good: Dependency manifest found (composer.json).
  • composer.lock
    Good: Lockfile present (composer.lock). Installs are reproducible.
  • CONTRIBUTING.md
    Good: Contributing guide is detailed and thorough.
    Issue: Contributing guide lacks a setup section (−12 pts).Fix: Show new contributors how to get a local dev environment running.
    Issue: Contributing guide lacks a code style section (−8 pts).Fix: Describe your linting/formatting rules and how to run them.
    Good: Contributing guide explains how to run tests.
    Good: Contributing guide describes the PR/review workflow.
    Good: Contributing guide includes code examples.
  • grey_missing.png
  • LICENSE
    Good: Licensed under AGPL-3.0.
  • openric-stats.json
  • package-lock.json
  • package.json
  • phpunit.xml
  • playwright.config.js
  • playwright.config.ts
  • README.md
    Good: README is present.
    Good: README is well structured with multiple sections.
    Issue: No screenshots or images in the README (−20 pts).Fix: Add a GIF, screenshot, or logo image. It is the fastest way to show what your project does.
    Good: README has code examples.
    Good: README links to a live demo or deployed app.
    Good: README includes status badges.
    Good: README documents how to install the project.
    Good: README documents how to run the project.
  • Screenshot 2026-05-03 104802.png
  • The Research Operating System — Ultimate Edition.md
  • Trust-by-Design_Heratio_Show-and-Tell_20min_DRAFT.pptx
  • tsconfig.json
  • version.json
  • vite.config.js
RepoGrade badge preview

Add this badge to your README

It updates automatically each time the repo is re-graded.

[![RepoGrade](https://www.repo-grade.com/api/badge/archiveheritagegroup/heratio)](https://www.repo-grade.com/report/archiveheritagegroup/heratio)

More graded PHP repos