# graphprotocol/graph-tooling — health index 73/100 (Good)

> Inspection of the public repository graphprotocol/graph-tooling by inspect.software. It holds a health index of 73 out of 100, placing it in the Good 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/graphprotocol/graph-tooling
- Report page: https://inspect.software/software/graphprotocol/graph-tooling
- Full JSON report: https://inspect.software/api/repositories/graphprotocol/graph-tooling/report
- Badge: https://inspect.software/badge/v1/graphprotocol/graph-tooling.svg
- Inspected: 2026-10-20
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 52/100 | Moderate |
| Community & Adoption | 17% | 68/100 | Good |
| Sustainability & Governance | 23% | 78/100 | Good |
| Engineering Quality | 19% | 72/100 | Good |
| Security | 16% | 40/100 | Weak |
| AI Readiness | 4% | 90/100 | Excellent |

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

## Repository facts

| Field | Value |
|---|---|
| Description | Monorepo for various tools used by subgraph developers. |
| Classification | cli, library, web-ui |
| Homepage | https://thegraph.com/docs |
| Primary language | TypeScript |
| License | Apache-2.0 |
| Stars | 424 |
| Forks | 234 |
| Created | 2018-06-15 |
| Last push | 2026-10-17 |
| Latest release | @graphprotocol/graph-cli@0.98.1 |
| Commits (last year) | 8 |
| Bus factor | 4 |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| npm | @graphprotocol/graph-ts | 0.38.2 | 108,166 |
| npm | @graphprotocol/graph-cli | 0.98.1 | 143,730 |

## Vitality — 52/100 (Moderate)

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

### Development activity — 46/100 (Weak)

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

### Release discipline — 61/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | partial | 7.2 / 36 | latest release 369 days ago |
| Release cadence | met | 27 / 27 | a release every ~30.6 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 154 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 — 71/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | partial | 42.6 / 60 | 424 stars |
| Forks | partial | 19.7 / 25 | 234 forks |
| Watchers | partial | 8.7 / 15 | 37 watchers |

### Community health — 50/100 (Moderate)

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

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

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

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

## Sustainability & Governance — 78/100 (Good)

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) — 85/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 43.2 / 54 | 4 contributor(s) cover half of all commits |
| Commit distribution | partial | 18.7 / 22.5 | top contributor authored 17% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 96 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 49 contributing companies or organizations |

### Issue & PR responsiveness — 68/100 (Good)

Excluded from scoring (no data or not applicable): Newcomer PR acceptance. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 32.8 / 42 | 78% of issues closed |
| PR acceptance | partial | 20 / 30 | 911/1364 decided PRs merged |
| Newcomer PR acceptance | excluded | 0 / 13 | no first-time contributor's PR decided in 30d |
| OpenSSF Scorecard: Code-Review | partial | 6 / 15 | Found 6/14 approved changesets -- score normalized to 4 |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 21.8 / 25 | 1,080 followers of graphprotocol |
| Track record | met | 25 / 25 | 183 public repos, account ~8 yr old |

### Package maintenance — 79/100 (Good)

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

## Engineering Quality — 72/100 (Good)

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

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 3 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | met | 16 / 16 | .eslintrc.cjs, eslint.config.js |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | partial | 12 / 20 | 12 out of 19 merged PRs checked by a CI test -- score normalized to 6 |

### Documentation — 65/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | not met | 0 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://thegraph.com/docs |
| Repository description | met | 10 / 10 | — |
| Topics | not met | 0 / 10 | — |
| Wiki | met | 10 / 10 | — |

## Security — 40/100 (Weak)

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 — 25/100 (At Risk)

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | partial | 6.8 / 7.5 | binaries present in source code |
| Branch-Protection | partial | 0.8 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | partial | 1.5 / 2.5 | 12 out of 19 merged PRs checked by a CI test -- score normalized to 6 |
| CII-Best-Practices | not met | 0 / 2.5 | no effort to earn an OpenSSF best practices badge detected |
| Code-Review | partial | 3 / 7.5 | Found 6/14 approved changesets -- score normalized to 4 |
| Contributors | met | 2.5 / 2.5 | project has 49 contributing companies or organizations |
| Dangerous-Workflow | not met | 0 / 10 | 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 | not met | 0 / 7.5 | 0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
| Packaging | excluded | 0 / 5 | packaging workflow not detected |
| Pinned-Dependencies | not met | 0 / 5 | dependency not pinned by hash detected -- score normalized to 0 |
| SAST | not met | 0 / 5 | SAST tool is not run on all commits -- score normalized to 0 |
| Security-Policy | not met | 0 / 5 | security policy file not 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 | 300 existing vulnerabilities detected |

### Dependency advisories — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the npm:@graphprotocol/graph-ts@0.38.2 runtime dependency closure — what installing the published package pulls in — 3 packages. Reachability is not analyzed.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Direct dependencies free of known advisories | met | 35 / 35 | no direct dependency carries a known advisory |
| Indirect dependencies free of known advisories | met | 25 / 25 | no indirect dependency carries a known advisory |
| No advisories left outstanding | excluded | 0 / 40 | no advisory carries a publication date |

### 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 — 90/100 (Excellent)

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 | .cursor/rules/@graph-tooling.mdc, .cursor/rules/mdc.mdc |
| Machine-readable docs (llms.txt) | met | 15 / 15 | llms.txt served by the project website (https://thegraph.com/llms.txt) |
| Legible commit history | met | 40 / 40 | 54 of 61 human commits state their intent (structured subject or explanatory body) |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | partial | 12.6 / 18 | examples/substreams-powered-subgraph/Cargo.toml (toolchain convention, no task runner) |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | .eslintrc.cjs, eslint.config.js |
| Static type checking | met | 11 / 11 | examples/cosmos-block-filtering/tsconfig.json, examples/cosmos-osmosis-token-swaps/tsconfig.json, examples/cosmos-validator-delegations/tsconfig.json, examples/cosmos-validator-rewards/tsconfig.json, examples/ethereum-basic-event-handlers/tsconfig.json, examples/matic-lens-protocol-posts-subgraph/tsconfig.json, examples/near-blocks/tsconfig.json, packages/cli/tsconfig.json, packages/ts/tsconfig.json, website/tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | not met | 0 / 10 | no agent-authored commits among the last 100 |
| Automated maintenance | met | 8 / 8 | 35 of the last 100 commits are automated dependency updates |
| OpenSSF Scorecard: Pinned-Dependencies | not met | 0 / 10 | dependency not pinned by hash detected -- score normalized to 0 |

### Code legibility for models — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | TypeScript (statically typed) |
| Manageable file sizes | partial | 54.5 / 55 | 2/233 source files over 60KB |

### Machine-readable interfaces — 100/100 (Exceptional)

Excluded from scoring (no data or not applicable): MCP server. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | met | 40 / 40 | examples/aggregations/schema.graphql, examples/arweave-blocks-transactions/schema.graphql, examples/cosmos-block-filtering/schema.graphql, examples/cosmos-osmosis-token-swaps/schema.graphql, examples/cosmos-validator-delegations/schema.graphql, examples/cosmos-validator-rewards/schema.graphql, examples/ethereum-basic-event-handlers/build/schema.graphql, examples/ethereum-basic-event-handlers/schema.graphql, examples/ethereum-gravatar/schema.graphql, examples/example-subgraph/dist/schema.graphql, examples/example-subgraph/schema.graphql, examples/matic-lens-protocol-posts-subgraph/schema.graphql, examples/near-blocks/schema.graphql, examples/near-receipts/schema.graphql, examples/substreams-powered-subgraph/proto/example.proto, examples/substreams-powered-subgraph/schema.graphql, packages/cli/src/protocols/arweave/manifest.graphql, packages/cli/src/protocols/cosmos/manifest.graphql, packages/cli/src/protocols/ethereum/manifest.graphql, packages/cli/src/protocols/near/manifest.graphql, packages/cli/src/protocols/subgraph/manifest.graphql, packages/cli/src/protocols/substreams/manifest.graphql, packages/cli/tests/cli/add/subgraph/schema.graphql, packages/cli/tests/cli/validation/2d-array-is-valid/schema.graphql, packages/cli/tests/cli/validation/3d-array-is-valid/schema.graphql, packages/cli/tests/cli/validation/abi-not-found/schema.graphql, packages/cli/tests/cli/validation/big-decimal-is-valid/schema.graphql, packages/cli/tests/cli/validation/block-handler-filters/schema.graphql, packages/cli/tests/cli/validation/call-function-not-found/schema.graphql, packages/cli/tests/cli/validation/call-handler-with-tuple/schema.graphql, packages/cli/tests/cli/validation/conflicting-network-names/schema.graphql, packages/cli/tests/cli/validation/conflicting-protocol-names/schema.graphql, packages/cli/tests/cli/validation/derived-from-target-type-missing/schema.graphql, packages/cli/tests/cli/validation/derived-from-with-interface/schema.graphql, packages/cli/tests/cli/validation/duplicate-data-source-name/schema.graphql, packages/cli/tests/cli/validation/duplicate-template-name/schema.graphql, packages/cli/tests/cli/validation/entity-field-args/schema.graphql, packages/cli/tests/cli/validation/ethereum-contract-without-handlers/schema.graphql, packages/cli/tests/cli/validation/event-not-found/schema.graphql, packages/cli/tests/cli/validation/example-values-found/schema.graphql, packages/cli/tests/cli/validation/indexer-hints/schema.graphql, packages/cli/tests/cli/validation/invalid-abis/schema.graphql, packages/cli/tests/cli/validation/invalid-contract-addresses/schema.graphql, packages/cli/tests/cli/validation/invalid-data-source-template/schema.graphql, packages/cli/tests/cli/validation/invalid-entity-field-types/schema.graphql, packages/cli/tests/cli/validation/invalid-fulltext-directive/schema.graphql, packages/cli/tests/cli/validation/invalid-graphql-schema/schema.graphql, packages/cli/tests/cli/validation/missing-entity-id/schema.graphql, packages/cli/tests/cli/validation/missing-or-invalid-derived-from-fields/schema.graphql, packages/cli/tests/cli/validation/near-is-valid/schema.graphql, packages/cli/tests/cli/validation/nested-template-nice-error/schema.graphql, packages/cli/tests/cli/validation/no-network-names/schema.graphql, packages/cli/tests/cli/validation/require-immutable-argument/schema.graphql, packages/cli/tests/cli/validation/source-without-address-is-valid/schema.graphql, packages/cli/tests/cli/validation/topic0-is-valid/schema.graphql |
| MCP server | excluded | 0 / 20 | not applicable to this kind of software |
| Runnable examples | met | 40 / 40 | examples |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

## 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