Public record
Software health reportschema 0.14.0 · metrics 2.10.0 · 2026-07-18 23:01 UTC

cerbos / cerbos-sdk-javascript

JavaScript SDK for authorization via Cerbos

TypeScriptApache-2.0★ 83 stars⑂ 13 forkssince Jul 2021View on GitHub ↗

cerbos/cerbos-sdk-javascript holds a health index of 83 out of 100, placing it in the Excellent band. It scores highest on Security (84/100) and lowest on Vitality (60/100). It was last updated 2 days ago. A single contributor accounts for most of its recent work.

83
overall / 100
Excellent

Software health index

Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean, calibrated against the distribution of the public record so bands carry percentile meaning; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At Risk ceiling of 34.

83
Exceptional93-100The record's top tier (≈ top 5%); essentially all checked criteria met
Excellent80-92Strong across the board; minor gaps
Good65-79Healthy; gaps are limited and manageable
Moderate50-64Acceptable with notable gaps; review recommended
Weak35-49Material weaknesses across several areas
At Risk20-34Significant weaknesses; adoption warrants caution
Critical1-19Severe problems (abandoned, single-maintainer, no hygiene)
VitalityCommunity &AdoptionSustainability &GovernanceEngineeringQualitySecurityAI Readiness

Score profile

Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.

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

Ownership

CerbosOrganization
205 followers92 public repossince Mar 2021

This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.

Metrics by category

Vitality

Is the project alive — is code being written and are releases shipping?

60Moderate · 21% of overall
How it's scored
36/36Push recencylast push 2 days ago
35.3/36Commit cadence51/52 weeks with commits
18/18Commit volume290 commits in the last year
10/10OpenSSF Scorecard: Maintained30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
Inputs used
commits_last_year290
human_commit_share
days_since_last_push2
active_weeks_last_year51
How it's scored
0/27Ships releasesno releases published
0/36Release recencyno releases
0/27Release cadenceno releases
0/10OpenSSF Scorecard: Signed-Releasesno data
Inputs used
releases_count0
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.

Community & Adoption

Does the project have users, downloads, attention, and a welcoming setup for contributors?

67Good · 17% of overall
How it's scored
31/60Stars83 stars
9/25Forks13 forks
5.3/15Watchers10 watchers
Inputs used
forks13
stars83
watchers10
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

Community health

92Excellent
How it's scored
22.5/22.5README
22.5/22.5Licenserecognized license (Apache-2.0)
18/18CONTRIBUTING guide
13.5/13.5Code of conduct
0/7.2Issue template
6.3/6.3PR template
Inputs used
has_readmeyes
has_licenseyes
readme_badges
has_contributingyes
has_issue_templateno
has_code_of_conductyes
readme_badge_services
has_pull_request_templateyes

Sustainability & Governance

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?

70Good · 23% of overall
How it's scored
9/54Bus factor1 contributor(s) cover half of all commits
8.5/22.5Commit distributiontop contributor authored 62% of commits
12.2/13.5Contributor breadth9 contributors
6/10OpenSSF Scorecard: Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
Inputs used
bus_factor1
contributors_sampled9
top_contributor_share0.623
How it's scored
37.2/42Issue resolution89% of issues closed
28.3/30PR acceptance1,378/1,461 decided PRs merged
0/13Newcomer PR acceptanceno first-time contributor's PR decided in 30d
15/15OpenSSF Scorecard: Code-Reviewall changesets reviewed
Inputs used
merged_prs1,378
open_issues4
closed_issues31
prs_merged_7d
prs_decided_7d
prs_merged_30d
prs_decided_30d
issue_closed_ratio0.886
closed_unmerged_prs83
first_time_authors_30d
first_time_prs_merged_30d
first_time_prs_decided_30d
Excluded from scoring (no data or not applicable): Newcomer PR acceptance. Remaining weights renormalized.
How it's scored
30/30Ownership backingorganization-owned
0/20Verified domainverified-domain status not read for this organization
16.6/25Owner reach205 followers of cerbos
23.7/25Track record92 public repos, account ~5 yr old
Inputs used
followers205
owner_typeOrganization
is_verified
owner_logincerbos
public_repos92
account_age_days1,948
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.

Engineering Quality

Are baseline engineering and documentation practices in place?

76Good · 19% of overall
How it's scored
24/24CI workflows6 workflow(s)
24/24Tests present
16/16Linter configeslint.config.mjs
0/9.6Pre-commit hooks
0/6.4.editorconfig
20/20OpenSSF Scorecard: CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
Inputs used
has_ciyes
has_testsyes
has_editorconfigno
has_linter_configyes
has_precommit_configno
How it's scored
30/30README
0/25Documentation directory
15/15Documentation / homepage sitehttps://cerbos.dev
10/10Repository description
10/10Topics6 topics
0/10Wiki
Inputs used
topicscerbos, node, authorization, browser, javascript, typescript
has_wikino
homepagehttps://cerbos.dev
docs_sitehttps://cerbos.dev
has_readmeyes
has_docs_dirno
has_descriptionyes

Security

Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?

84Excellent · 16% of overall

Security posture

84Excellent
How it's scored
7.5/7.5Binary-Artifactsno binaries found in the repo
0/7.5Branch-Protectionno data
2.5/2.5CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
7.5/7.5Code-Reviewall changesets reviewed
1.5/2.5Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
10/10Dangerous-Workflowno dangerous workflow patterns detected
7.5/7.5Dependency-Update-Toolupdate tool detected
0/5Fuzzingproject is not fuzzed
2.5/2.5Licenselicense file detected
7.5/7.5Maintained30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
0/5Packagingno data
5/5Pinned-Dependenciesall dependencies are pinned
5/5SASTSAST tool is run on all commits
0/5Security-Policysecurity policy file not detected
0/7.5Signed-Releasesno data
7.5/7.5Token-PermissionsGitHub workflow tokens follow principle of least privilege
7.5/7.5Vulnerabilities0 existing vulnerabilities detected
Inputs used
sourceopenssf_scorecard
checks_evaluated15
scorecard_versionv5.5.0
checks_inconclusive3
scorecard_aggregate8.4
Excluded from scoring (no data or not applicable): Branch-Protection, Packaging, Signed-Releases. Remaining weights renormalized.

AI Readiness

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight (4%): agent tooling is a real maintenance signal, but a repository with none can still reach 100/100.

61Moderate · 4% of overall
How it's scored
0/45Agent instructionsno CLAUDE.md / AGENTS.md / editor rules
0/15Machine-readable docs (llms.txt)
0/40Legible commit historyno data
Inputs used
has_llms_txtno
llms_txt_url
legible_history_share
agent_instruction_files
agent_instruction_max_bytes
Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.
How it's scored
0/18One-command bootstrap
22/22Automated tests
11/11Lint / format configeslint.config.mjs
11/11Static type checkingpackages/api/tsconfig.json, packages/core/tsconfig.json, packages/embedded-client/tsconfig.json, packages/files/tsconfig.json, packages/grpc/tsconfig.json, packages/http/tsconfig.json, packages/hub/tsconfig.json, packages/opentelemetry/tsconfig.json, packages/react/tsconfig.json, private/eslint/tsconfig.json, private/scripts/tsconfig.json, private/test/tsconfig.json, tsconfig.json
10/10Reproducible environmentDockerfile, lockfile
0/10Demonstrated agent practiceno data
0/8Automated maintenanceno data
10/10OpenSSF Scorecard: Pinned-Dependenciesall dependencies are pinned
Inputs used
has_nixno
has_testsyes
lockfilespnpm-lock.yaml
has_dockerfileyes
typed_languageyes
bootstrap_files
has_devcontainerno
has_linter_configyes
typecheck_configspackages/api/tsconfig.json, packages/core/tsconfig.json, packages/embedded-client/tsconfig.json, packages/files/tsconfig.json, packages/grpc/tsconfig.json, packages/http/tsconfig.json, packages/hub/tsconfig.json, packages/opentelemetry/tsconfig.json, packages/react/tsconfig.json, private/eslint/tsconfig.json, private/scripts/tsconfig.json, private/test/tsconfig.json, tsconfig.json
agent_commit_share
toolchain_manifests
dependency_bot_commit_share
Excluded from scoring (no data or not applicable): Demonstrated agent practice, Automated maintenance. Remaining weights renormalized.
How it's scored
45/45Type-checkable codeTypeScript (statically typed)
53/55Manageable file sizes11/310 source files over 60KB
Inputs used
primary_languageTypeScript
largest_source_bytes347,832
source_files_sampled310
oversized_source_files11
How it's scored
40/40API schema (OpenAPI/GraphQL/proto)proto/authzen/authorization/v1/evaluation.proto, proto/authzen/authorization/v1/svc.proto, proto/buf/validate/validate.proto, proto/cerbos/audit/v1/audit.proto, proto/cerbos/cloud/apikey/v1/apikey.proto, proto/cerbos/cloud/auth/v1/auth.proto, proto/cerbos/cloud/bundle/v2/bundle.proto, proto/cerbos/cloud/epdp/v2/epdp.proto, proto/cerbos/cloud/logs/v1/logs.proto, proto/cerbos/cloud/pdp/v1/pdp.proto, proto/cerbos/cloud/store/v1/store.proto, proto/cerbos/effect/v1/effect.proto, proto/cerbos/engine/v1/engine.proto, proto/cerbos/policy/v1/policy.proto, proto/cerbos/request/v1/request.proto, proto/cerbos/response/v1/response.proto, proto/cerbos/schema/v1/schema.proto, proto/cerbos/svc/v1/svc.proto, proto/cerbos/telemetry/v1/telemetry.proto, proto/gnostic/openapiv3/annotations.proto, proto/gogoproto/gogo.proto, proto/google/api/annotations.proto, proto/google/api/expr/v1alpha1/checked.proto, proto/google/api/expr/v1alpha1/syntax.proto, proto/google/api/field_behavior.proto, proto/google/api/http.proto, proto/google/api/visibility.proto, proto/google/rpc/code.proto, proto/google/rpc/status.proto, proto/grpc/binlog/v1/binarylog.proto, proto/grpc/binlog/v1alpha/binarylog.proto, proto/grpc/channelz/v1/channelz.proto, proto/grpc/core/stats.proto, proto/grpc/examples/helloworld.proto, proto/grpc/gcp/altscontext.proto, proto/grpc/gcp/handshaker.proto, proto/grpc/gcp/transport_security_common.proto, proto/grpc/health/v1/health.proto, proto/grpc/lb/v1/load_balancer.proto, proto/grpc/lb/v1/load_reporter.proto, proto/grpc/lookup/v1/rls.proto, proto/grpc/lookup/v1/rls_config.proto, proto/grpc/reflection/v1/reflection.proto, proto/grpc/reflection/v1alpha/reflection.proto, proto/grpc/service_config/service_config.proto, proto/grpc/testing/benchmark_service.proto, proto/grpc/testing/control.proto, proto/grpc/testing/empty.proto, proto/grpc/testing/messages.proto, proto/grpc/testing/payloads.proto, proto/grpc/testing/report_qps_scenario_service.proto, proto/grpc/testing/stats.proto, proto/grpc/testing/test.proto, proto/grpc/testing/worker_service.proto, proto/grpc/testing/xdsconfig/xdsconfig.proto, proto/jaeger/proto/api_v3/query_service.proto, proto/openapiv3/OpenAPIv3.proto, proto/opentelemetry/proto/collector/logs/v1/logs_service.proto, proto/opentelemetry/proto/collector/metrics/v1/metrics_service.proto, proto/opentelemetry/proto/collector/trace/v1/trace_service.proto, proto/opentelemetry/proto/common/v1/common.proto, proto/opentelemetry/proto/logs/v1/logs.proto, proto/opentelemetry/proto/metrics/v1/metrics.proto, proto/opentelemetry/proto/resource/v1/resource.proto, proto/opentelemetry/proto/trace/v1/trace.proto, proto/protoc-gen-openapiv2/options/annotations.proto, proto/protoc-gen-openapiv2/options/openapiv2.proto
0/20MCP servernot applicable to this kind of software
40/40Runnable examplesexamples
Inputs used
example_dirsexamples
has_mcp_signalno
api_schema_filesproto/authzen/authorization/v1/evaluation.proto, proto/authzen/authorization/v1/svc.proto, proto/buf/validate/validate.proto, proto/cerbos/audit/v1/audit.proto, proto/cerbos/cloud/apikey/v1/apikey.proto, proto/cerbos/cloud/auth/v1/auth.proto, proto/cerbos/cloud/bundle/v2/bundle.proto, proto/cerbos/cloud/epdp/v2/epdp.proto, proto/cerbos/cloud/logs/v1/logs.proto, proto/cerbos/cloud/pdp/v1/pdp.proto, proto/cerbos/cloud/store/v1/store.proto, proto/cerbos/effect/v1/effect.proto, proto/cerbos/engine/v1/engine.proto, proto/cerbos/policy/v1/policy.proto, proto/cerbos/request/v1/request.proto, proto/cerbos/response/v1/response.proto, proto/cerbos/schema/v1/schema.proto, proto/cerbos/svc/v1/svc.proto, proto/cerbos/telemetry/v1/telemetry.proto, proto/gnostic/openapiv3/annotations.proto, proto/gogoproto/gogo.proto, proto/google/api/annotations.proto, proto/google/api/expr/v1alpha1/checked.proto, proto/google/api/expr/v1alpha1/syntax.proto, proto/google/api/field_behavior.proto, proto/google/api/http.proto, proto/google/api/visibility.proto, proto/google/rpc/code.proto, proto/google/rpc/status.proto, proto/grpc/binlog/v1/binarylog.proto, proto/grpc/binlog/v1alpha/binarylog.proto, proto/grpc/channelz/v1/channelz.proto, proto/grpc/core/stats.proto, proto/grpc/examples/helloworld.proto, proto/grpc/gcp/altscontext.proto, proto/grpc/gcp/handshaker.proto, proto/grpc/gcp/transport_security_common.proto, proto/grpc/health/v1/health.proto, proto/grpc/lb/v1/load_balancer.proto, proto/grpc/lb/v1/load_reporter.proto, proto/grpc/lookup/v1/rls.proto, proto/grpc/lookup/v1/rls_config.proto, proto/grpc/reflection/v1/reflection.proto, proto/grpc/reflection/v1alpha/reflection.proto, proto/grpc/service_config/service_config.proto, proto/grpc/testing/benchmark_service.proto, proto/grpc/testing/control.proto, proto/grpc/testing/empty.proto, proto/grpc/testing/messages.proto, proto/grpc/testing/payloads.proto, proto/grpc/testing/report_qps_scenario_service.proto, proto/grpc/testing/stats.proto, proto/grpc/testing/test.proto, proto/grpc/testing/worker_service.proto, proto/grpc/testing/xdsconfig/xdsconfig.proto, proto/jaeger/proto/api_v3/query_service.proto, proto/openapiv3/OpenAPIv3.proto, proto/opentelemetry/proto/collector/logs/v1/logs_service.proto, proto/opentelemetry/proto/collector/metrics/v1/metrics_service.proto, proto/opentelemetry/proto/collector/trace/v1/trace_service.proto, proto/opentelemetry/proto/common/v1/common.proto, proto/opentelemetry/proto/logs/v1/logs.proto, proto/opentelemetry/proto/metrics/v1/metrics.proto, proto/opentelemetry/proto/resource/v1/resource.proto, proto/opentelemetry/proto/trace/v1/trace.proto, proto/protoc-gen-openapiv2/options/annotations.proto, proto/protoc-gen-openapiv2/options/openapiv2.proto
interfaces_expected_of
Excluded from scoring (no data or not applicable): MCP server. Remaining weights renormalized.

Key facts

83GitHub stars
9contributors
290commits, last 12 months
2days since last push
0releases
1bus factor
4open issues
npmpackage ecosystems

More detail

OpenSSF Scorecard 8.4 / 10
8.4aggregate

Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).Scorecard v5.5.0 · 2026-07-18 23:01 UTC

10Binary-Artifactsno binaries found in the repo
n/aBranch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
10CI-Tests30 out of 30 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
10Code-Reviewall changesets reviewed
6Contributorsproject has 2 contributing companies or organizations -- score normalized to 6
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10
n/aPackagingpackaging workflow not detected
10Pinned-Dependenciesall dependencies are pinned
10SASTSAST tool is run on all commits
0Security-Policysecurity policy file not detected
n/aSigned-Releasesno releases found
10Token-PermissionsGitHub workflow tokens follow principle of least privilege
10Vulnerabilities0 existing vulnerabilities detected
All dependencies 71

Full resolved dependency set from the GitHub dependency graph: 0 direct and 71 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.

RegistryPackageVersionRelation
npm@bufbuild/protobuf2.12.1indirect
npm@bufbuild/protobuf^2.12.1indirect
npm@bufbuild/protovalidate^1.2.0indirect
npm@cerbos/api^0.10.0indirect
npm@cerbos/core^0.31.0indirect
npm@cerbos/embedded-server0.6.0indirect
npm@cerbos/hub^0.5.6indirect
npm@connectrpc/connect2.1.2indirect
npm@connectrpc/connect^2.1.2indirect
npm@connectrpc/connect-node2.1.2indirect
npm@connectrpc/connect-node^2.1.2indirect
npm@connectrpc/connect-web^2.1.2indirect
npm@connectrpc/validate^0.2.0indirect
npm@eslint/js9.39.5indirect
npm@grpc/grpc-js1.14.4indirect
npm@grpc/grpc-js^1.14.4indirect
npm@opentelemetry/api1.9.1indirect
npm@opentelemetry/api^1.9.1indirect
npm@opentelemetry/instrumentation^0.220.0indirect
npm@opentelemetry/sdk-metrics2.9.0indirect
npm@opentelemetry/sdk-trace-base2.9.0indirect
npm@opentelemetry/sdk-trace-node2.9.0indirect
npm@opentelemetry/semantic-conventions1.43.0indirect
npm@opentelemetry/semantic-conventions^1.43.0indirect
npm@pnpm/exe11.11.0indirect
npm@pnpm/linux-arm6411.11.0indirect
npm@pnpm/linux-x6411.11.0indirect
npm@pnpm/linuxstatic-arm6411.11.0indirect
npm@pnpm/linuxstatic-x6411.11.0indirect
npm@pnpm/macos-arm6411.11.0indirect
npm@pnpm/win-arm6411.11.0indirect
npm@pnpm/win-x6411.11.0indirect
npm@reflink/reflink0.1.19indirect
npm@reflink/reflink-darwin-arm640.1.19indirect
npm@reflink/reflink-darwin-x640.1.19indirect
npm@reflink/reflink-linux-arm64-gnu0.1.19indirect
npm@reflink/reflink-linux-arm64-musl0.1.19indirect
npm@reflink/reflink-linux-x64-gnu0.1.19indirect
npm@reflink/reflink-linux-x64-musl0.1.19indirect
npm@reflink/reflink-win32-arm64-msvc0.1.19indirect
npm@reflink/reflink-win32-x64-msvc0.1.19indirect
npm@stylistic/eslint-plugin5.10.0indirect
npm@testing-library/react16.3.2indirect
npm@testing-library/user-event14.6.1indirect
npm@types/adm-zip0.5.8indirect
npm@types/react19.2.17indirect
npm@types/semver7.7.1indirect
npm@vitest/eslint-plugin1.6.22indirect
npmadm-zip0.6.0indirect
npmdate-fns4.4.0indirect
npmdetect-libc2.1.2indirect
npmeslint-plugin-import2.32.0indirect
npmeslint-plugin-react-hooks7.1.1indirect
npmexeca9.6.1indirect
npmjose6.2.3indirect
npmjsdom29.1.1indirect
npmnode-html-parser9.0.0indirect
npmpnpm11.11.0indirect
npmprettier3.9.5indirect
npmreact19.2.7indirect
npmreact-dom19.2.7indirect
npmsemver7.8.5indirect
npmtypedoc0.28.20indirect
npmtypescript-eslint8.63.0indirect
npmulid^3.0.2indirect
npmuse-deep-compare-effect^1.8.1indirect
npmuuid^14.0.1indirect
npmvitest4.1.10indirect
npmyaml2.9.0indirect
npmyaml^2.9.0indirect
npmzod4.4.3indirect
Raw JSON report machine-readable

Feedback

Spotted something off in this report, or have thoughts to share? Wrong measurements, missed tooling, ideas, questions — anything is welcome. Every message is read and gets a response.

The message is kept through sign-in.

Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.

Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v2.10.0, schema v0.14.0 — full methodology · metrics wiki.

How one result sits in the wider record: aggregate statistics.