# HarperFast/harper — health index 88/100 (Excellent)

> Inspection of the public repository HarperFast/harper by inspect.software. It holds a health index of 88 out of 100, placing it in the Excellent band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/HarperFast/harper
- Report page: https://inspect.software/software/HarperFast/harper
- Full JSON report: https://inspect.software/api/repositories/HarperFast/harper/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/h/HarperFast/harper.svg
- Inspected: 2026-09-05
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 95/100 | Exceptional |
| Community & Adoption | 17% | 68/100 | Good |
| Sustainability & Governance | 23% | 64/100 | Moderate |
| Engineering Quality | 19% | 81/100 | Excellent |
| Security | 16% | 59/100 | Moderate |
| AI Readiness | 4% | 75/100 | Good |

The weighted overall 74 is calibrated to 88 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | Harper is an open-source Node.js performance platform that unifies database, cache, application, and messaging layers into one in-memory process. |
| Classification | library, cli, network-service |
| Homepage | https://harper.fast |
| Primary language | JavaScript |
| License | Apache-2.0 |
| Stars | 86 |
| Forks | 10 |
| Created | 2025-08-20 |
| Last push | 2026-09-05 |
| Latest release | v5.2.9 |
| Commits (last year) | 3,698 |
| Bus factor | 1 |
| Topics | cache, database, messaging, nodejs, performance |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| npm | harper | 5.2.9 | 109,400 |

## Vitality — 95/100 (Exceptional)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 99/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 0 days ago |
| Commit cadence | partial | 34.6 / 36 | 50/52 weeks with commits |
| Commit volume | met | 18 / 18 | 3698 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 24 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 87 releases published |
| Release recency | met | 36 / 36 | latest release 1 days ago |
| Release cadence | met | 27 / 27 | a release every ~3 days |
| OpenSSF Scorecard: Signed-Releases | not met | 0 / 10 | Project has not signed or included provenance with any releases. |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 1 days ago |

## Community & Adoption — 68/100 (Good)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 43/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | partial | 31.3 / 60 | 86 stars |
| Forks | partial | 8 / 25 | 10 forks |
| Watchers | partial | 3.9 / 15 | 6 watchers |

### Community health — 85/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (Apache-2.0) |
| CONTRIBUTING guide | met | 18 / 18 | — |
| Code of conduct | met | 13.5 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | not met | 0 / 6.3 | — |

### Ecosystem adoption (downloads) — 84/100 (Excellent)

Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Monthly downloads | partial | 67.2 / 80 | 109,400 downloads/month across npm |
| Registry dependents | excluded | 0 / 20 | not reported by this ecosystem |

## Sustainability & Governance — 64/100 (Moderate)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 40/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 9 / 54 | 1 contributor(s) cover half of all commits |
| Commit distribution | partial | 7.6 / 22.5 | top contributor authored 66% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 22 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 11 contributing companies or organizations |

### Issue & PR responsiveness — 59/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 14.3 / 42 | 34% of issues closed |
| PR acceptance | partial | 27.1 / 30 | 1139/1261 decided PRs merged |
| Newcomer PR acceptance | met | 13 / 13 | 1/1 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | partial | 4.5 / 15 | Found 11/28 approved changesets -- score normalized to 3 |

### Ownership & stewardship — 68/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 13.2 / 25 | 67 followers of HarperFast |
| Track record | met | 25 / 25 | 97 public repos, account ~9 yr old |

### Package maintenance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 1 package(s) on npm |
| Publish recency | met | 35 / 35 | latest publish 1 days ago |
| Version history | met | 20 / 20 | 85 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 81/100 (Excellent)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 68/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 25 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | not met | 0 / 16 | — |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | met | 20 / 20 | 28 out of 28 merged PRs checked by a CI test -- score normalized to 10 |

### Documentation — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://harper.fast |
| Repository description | met | 10 / 10 | — |
| Topics | met | 10 / 10 | 5 topics |
| Wiki | met | 10 / 10 | — |

## Security — 59/100 (Moderate)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 56/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 3.8 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | met | 2.5 / 2.5 | 28 out of 28 merged PRs checked by a CI test -- score normalized to 10 |
| CII-Best-Practices | not met | 0 / 2.5 | no effort to earn an OpenSSF best practices badge detected |
| Code-Review | partial | 2.2 / 7.5 | Found 11/28 approved changesets -- score normalized to 3 |
| Contributors | met | 2.5 / 2.5 | project has 11 contributing companies or organizations |
| Dangerous-Workflow | met | 10 / 10 | no dangerous workflow patterns detected |
| Dependency-Update-Tool | met | 7.5 / 7.5 | update tool detected |
| Fuzzing | not met | 0 / 5 | project is not fuzzed |
| License | met | 2.5 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 24 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | met | 5 / 5 | packaging workflow detected |
| Pinned-Dependencies | partial | 3 / 5 | dependency not pinned by hash detected -- score normalized to 6 |
| SAST | not met | 0 / 5 | SAST tool is not run on all commits -- score normalized to 0 |
| Security-Policy | met | 5 / 5 | security policy file detected |
| Signed-Releases | not met | 0 / 7.5 | Project has not signed or included provenance with any releases. |
| Token-Permissions | not met | 0 / 7.5 | detected GitHub workflow tokens with excessive permissions |
| Vulnerabilities | not met | 0 / 7.5 | 62 existing vulnerabilities detected |

### Dependency advisories — 69/100 (Good)

Matched the npm:harper@5.2.9 runtime dependency closure — what installing the published package pulls in — 503 packages. Reachability is not analyzed.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Direct dependencies free of known advisories | partial | 10.4 / 35 | 3 affected: @fastify/static 9.3.0 (high 7.5), validate.js 0.13.1 (high 7.5), stream-json 1.9.1 (moderate 6.2) |
| Indirect dependencies free of known advisories | met | 25 / 25 | no indirect dependency carries a known advisory |
| No advisories left outstanding | partial | 33.7 / 40 | 1 advisory-carrying package(s) unaddressed past 90 days; oldest published 678 days ago |

### Malicious dependencies — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| No dependency reported as a malicious package | met | 100 / 100 | no dependency is reported as a malicious package |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 75/100 (Good)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | AGENTS.md, CLAUDE.md |
| Machine-readable docs (llms.txt) | met | 15 / 15 | llms.txt served by the project website (https://harper.fast/llms.txt) |
| Legible commit history | met | 40 / 40 | 91 of 98 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 67/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | not met | 0 / 18 | — |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | not met | 0 / 11 | — |
| Static type checking | met | 11 / 11 | integrationTests/tsconfig.json, tsconfig.json, unitTests/types/tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | met | 10 / 10 | 74 of the last 100 commits agent-authored or agent-credited |
| Automated maintenance | met | 8 / 8 | 2 of the last 100 commits are automated dependency updates |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 6 / 10 | dependency not pinned by hash detected -- score normalized to 6 |

### Code legibility for models — 81/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | partial | 27 / 45 | JavaScript with type-check config (integrationTests/tsconfig.json, tsconfig.json, unitTests/types/tsconfig.json) |
| Manageable file sizes | partial | 53.9 / 55 | 28/1391 source files over 60KB |

### Machine-readable interfaces — 40/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | met | 40 / 40 | benchmarks/compression/app/schema.graphql, benchmarks/concurrent-rw/app/schema.graphql, benchmarks/indexed-write/app/schema.graphql, benchmarks/sql-engine/app/schema.graphql, benchmarks/ttl-churn/app/schema.graphql, benchmarks/ycsb/app/schema.graphql, integrationTests/components/fixtures/branched-database-gated/schema.graphql, integrationTests/database/aborted-update-index-migration/schema.graphql, integrationTests/database/append-only-unique-pk-durability/schema.graphql, integrationTests/database/audit-blob-reclaim/schema.graphql, integrationTests/database/audit-retention-lmdb/schema.graphql, integrationTests/database/auto-fields/schema.graphql, integrationTests/database/bigint-indexed-range/schema.graphql, integrationTests/database/blob-commit-over-time/schema.graphql, integrationTests/database/blob-delete-reclaim-audit-expiry/schema.graphql, integrationTests/database/blob-drop-crash-orphan-window/schema.graphql, integrationTests/database/blob-eav-type-drift/schema.graphql, integrationTests/database/blob-reclaim-removal-paths/schema.graphql, integrationTests/database/blob-restart-ttl-unlink/schema.graphql, integrationTests/database/bulk-conditional-mutation/schema.graphql, integrationTests/database/compound-index-conditions/schema.graphql, integrationTests/database/concurrent-patch-merge/schema.graphql, integrationTests/database/condition-mutation-integrity/schema.graphql, integrationTests/database/copy-db-blob-store/schema.graphql, integrationTests/database/crosstable-index-scan-blast-radius/schema.graphql, integrationTests/database/crosstable-index-scan-completeness/schema.graphql, integrationTests/database/date-queries/schema.graphql, integrationTests/database/delete-index-atomicity-rocksdb/schema.graphql, integrationTests/database/delete-update-race-consistency/schema.graphql, integrationTests/database/delete-update-race/schema.graphql, integrationTests/database/eviction-index-atomicity-lmdb/schema.graphql, integrationTests/database/eviction-index-null-reindex/schema.graphql, integrationTests/database/eviction-index-orphan-removal-paths/schema.graphql, integrationTests/database/eviction-index-phantom-null-keys/schema.graphql, integrationTests/database/eviction-phantom-null/schema.graphql, integrationTests/database/eviction-secondary-index/schema.graphql, integrationTests/database/heterogeneous-ingest/schema.graphql, integrationTests/database/hot-config-atomicity/schema.graphql, integrationTests/database/hot-record-read-snapshot/schema.graphql, integrationTests/database/indexed-numeric-range/schema.graphql, integrationTests/database/indexed-update-churn/schema.graphql, integrationTests/database/longtxn-index-orphan/schema.graphql, integrationTests/database/longtxn-secondary-index/schema.graphql, integrationTests/database/multi-condition-query/schema.graphql, integrationTests/database/patch-disjoint-field-merge/schema.graphql, integrationTests/database/planner-range-scan/schema.graphql, integrationTests/database/put-operation/schema.graphql, integrationTests/database/qa816-purge-blast-radius/schema.graphql, integrationTests/database/read-snapshot-consistency/schema.graphql, integrationTests/database/read-snapshot-contract/schema.graphql, integrationTests/database/record-caching-blob/schema.graphql, integrationTests/database/record-caching-coherence/schema.graphql, integrationTests/database/record-caching-invalidate/schema.graphql, integrationTests/database/record-caching-ttl-eviction/schema.graphql, integrationTests/database/record-caching/schema.graphql, integrationTests/database/scale/schema.graphql, integrationTests/database/sql-pk-range-fusion/schema.graphql, integrationTests/database/struct-cache-cap/schema.graphql, integrationTests/database/struct-cache-fidelity/schema.graphql, integrationTests/database/ttl-reset-on-write/schema.graphql, integrationTests/database/txnlog-purge-stale-read-blast/schema.graphql, integrationTests/database/unique-pk-append-durability/schema.graphql, integrationTests/deploy/deploy-dangling-symlink/fixture/schema.graphql, integrationTests/deploy/fixture/schema.graphql, integrationTests/deploy/qa701-deployment-payload-ops/schema.graphql, integrationTests/fixtures/allowread-fail-closed/schema.graphql, integrationTests/fixtures/app-mount-two/app-one/schema.graphql, integrationTests/fixtures/app-mount-two/app-two/schema.graphql, integrationTests/fixtures/app-root-mount/schema.graphql, integrationTests/fixtures/blob-advanced/schema.graphql, integrationTests/fixtures/bytes-scan-crash/schema.graphql, integrationTests/fixtures/custom-resources/schema.graphql, integrationTests/fixtures/graphql-schema-failure/control/schema.graphql, integrationTests/fixtures/graphql-schema-failure/fixture-broken-one/schema.graphql, integrationTests/fixtures/graphql-schema-failure/fixture-broken-two/schema.graphql, integrationTests/fixtures/mcp-custom-resources-authz/schema.graphql, integrationTests/fixtures/mcp-quota/schema.graphql, integrationTests/fixtures/mcp-row-authz/schema.graphql, integrationTests/fixtures/scale-test/schema.graphql, integrationTests/fixtures/scheduler-jobs/schema.graphql, integrationTests/fixtures/schema-types/schema.graphql, integrationTests/fixtures/static-after-rest/schema.graphql, integrationTests/fixtures/subscription-revocation/schema.graphql, integrationTests/fixtures/transaction-context-reads/schema.graphql, integrationTests/mqtt/qa649-mqtt-restart-wedge/schema.graphql, integrationTests/resources/audit-false-delete-rollback/schema.graphql, integrationTests/resources/cached-computed-attribute/schema.graphql, integrationTests/resources/computed-and-cyclic-serialization/schema.graphql, integrationTests/resources/custom-resource-contract/schema.graphql, integrationTests/resources/overtime-multi-write-atomicity/schema.graphql, integrationTests/resources/record-lock-concurrency/schema.graphql, integrationTests/resources/relationship-and-status-contract/schema.graphql, integrationTests/resources/relationship-graphql-snapshot-consistency/schema.graphql, integrationTests/resources/sourcedfrom-eav-cache-coherence/schema.graphql, integrationTests/resources/sourcedfrom-snapshot-scoping/schema.graphql, integrationTests/resources/sourcedfrom-write-through/schema.graphql, integrationTests/resources/subscription-delivery-completeness/schema.graphql, integrationTests/resources/ttl-rate-limiter-concurrent/schema.graphql, integrationTests/resources/txn-overtime-atomicity/schema.graphql, integrationTests/security/fixtures/deferred-credential-rejection/schema.graphql, integrationTests/security/fixtures/sql-unqualified-authz/schema.graphql, integrationTests/security/fixtures/subscription-row-allowread/schema.graphql, integrationTests/security/qa877-tls-cert-swap/schema.graphql, integrationTests/server/fixtures/http-cache-headers/schema.graphql, integrationTests/server/qa577-upgrade-builtins/schema.graphql, integrationTests/server/qa579-cli-exit-codes/schema.graphql, integrationTests/server/qa702-sse-event-data/schema.graphql, integrationTests/server/sse-finite-generator/schema.graphql, integrationTests/server/sse-throw-midstream/schema.graphql, integrationTests/server/stream-error-contract/schema.graphql, integrationTests/server/v1-gateway-mixed-app/schema.graphql, integrationTests/server/websocket-transport/schema.graphql, integrationTests/upgrade/cross-version-upgrade-residuals/schema.graphql, integrationTests/upgrade/cross-version-upgrade-visibility/schema.graphql, integrationTests/upgrade/qa606-upgrade-structgrowth/schema.graphql, integrationTests/upgrade/upgrade-boot-schema-change/schema.graphql, schema.graphql, unitTests/testApp/schema.graphql |
| MCP server | not met | 0 / 20 | — |
| Runnable examples | not met | 0 / 40 | — |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt