# microsoft/typespec — health index 86/100 (Excellent)

> Inspection of the public repository microsoft/typespec by inspect.software. It holds a health index of 86 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/microsoft/typespec
- Report page: https://inspect.software/software/microsoft/typespec
- Full JSON report: https://inspect.software/api/repositories/microsoft/typespec/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/m/microsoft/typespec.svg
- Inspected: 2026-07-17
- Methodology: metrics 1.13.0, report schema 0.11.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 22% | 100/100 | Excellent |
| Community & Adoption | 18% | 88/100 | Excellent |
| Sustainability & Governance | 24% | 82/100 | Good |
| Engineering Quality | 20% | 86/100 | Excellent |
| Security | 16% | 71/100 | Good |
| AI Readiness | not counted | 81/100 | Good |

## Repository facts

| Field | Value |
|---|---|
| Homepage | https://typespec.io/ |
| Primary language | Java |
| License | MIT |
| Stars | 5,795 |
| Forks | 375 |
| Created | 2021-06-30 |
| Last push | 2026-07-17 |
| Latest release | typespec-stable@1.14.0 |
| Commits (last year) | 1,600 |
| Bus factor | 4 |
| Topics | openapi3, json-schema, protobuf, typespec |

## Vitality — 100/100 (Excellent)

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

### Development activity — 100/100 (Excellent)

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

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

Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | met | 36 / 36 | latest release 2 days ago |
| Release cadence | met | 27 / 27 | a release every ~0 days |
| OpenSSF Scorecard: Signed-Releases | excluded | 0 / 10 | no releases found |

### Abandonment — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | maintenance record not established from the collected data |

## Community & Adoption — 88/100 (Excellent)

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

### Popularity & adoption — 91/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | met | 60 / 60 | 5,795 stars |
| Forks | partial | 21.4 / 25 | 375 forks |
| Watchers | partial | 9.2 / 15 | 46 watchers |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (MIT) |
| 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 | — |

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

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

### Maintainer resilience (bus factor) — 83/100 (Good)

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

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 36 / 46.8 | 77% of issues closed |
| PR acceptance | partial | 32.1 / 38.2 | 5374/6402 decided PRs merged |
| OpenSSF Scorecard: Code-Review | partial | 13.5 / 15 | Found 20/21 approved changesets -- score normalized to 9 |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | met | 25 / 25 | 125,264 followers of microsoft |
| Track record | met | 25 / 25 | 8202 public repos, account ~12 yr old |

## Engineering Quality — 86/100 (Excellent)

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

### Engineering practices — 90/100 (Excellent)

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

### Documentation — 80/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://typespec.io/ |
| Repository description | not met | 0 / 10 | — |
| Topics | met | 10 / 10 | 4 topics |
| Wiki | not met | 0 / 10 | — |

## Security — 71/100 (Good)

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 — 71/100 (Good)

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 6 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | met | 2.5 / 2.5 | 30 out of 30 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 | 6.8 / 7.5 | Found 20/21 approved changesets -- score normalized to 9 |
| Contributors | met | 2.5 / 2.5 | project has 24 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 10 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | excluded | 0 / 5 | packaging workflow not detected |
| Pinned-Dependencies | partial | 2.5 / 5 | dependency not pinned by hash detected -- score normalized to 5 |
| SAST | met | 5 / 5 | SAST tool is run on all commits |
| Security-Policy | met | 5 / 5 | security policy file detected |
| Signed-Releases | excluded | 0 / 7.5 | no releases found |
| Token-Permissions | not met | 0 / 7.5 | detected GitHub workflow tokens with excessive permissions |
| Vulnerabilities | not met | 0 / 7.5 | 15 existing vulnerabilities detected |

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

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 — 81/100 (Good)

How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.

### Agent context & guidance — 75/100 (Good)

Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | .github/copilot-instructions.md, .github/instructions/http-client-csharp.instructions.md, .github/instructions/http-client-java.instructions.md, AGENTS.md |
| Machine-readable docs (llms.txt) | not met | 0 / 15 | — |
| Legible commit history | excluded | 0 / 40 | no data |

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

Excluded from scoring (no data or not applicable): Demonstrated agent practice. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | not met | 0 / 18 | — |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | eslint.config.js, tox.ini |
| Static type checking | met | 11 / 11 | eng/tsconfig.json, packages/asset-emitter/tsconfig.json, packages/astro-utils/tsconfig.json, packages/best-practices/tsconfig.json, packages/bundle-uploader/tsconfig.json, packages/bundler/tsconfig.json, packages/compiler/templates/__snapshots__/emitter-ts/tsconfig.json, packages/compiler/templates/__snapshots__/library-ts/tsconfig.json, packages/compiler/templates/emitter-ts/tsconfig.json, packages/compiler/templates/library-ts/tsconfig.json, packages/compiler/tsconfig.json, packages/emitter-framework/tsconfig.json, packages/events/tsconfig.json, packages/html-program-viewer/tsconfig.json, packages/http-canonicalization/tsconfig.json, packages/http-client-csharp/emitter/tsconfig.json, packages/http-client-java/emitter/tsconfig.json, packages/http-client-js/tsconfig.json, packages/http-client-python/emitter/tsconfig.json, packages/http-client-python/eng/scripts/ci/config/mypy.ini, packages/http-client-python/eng/scripts/ci/config/pyrightconfig.json, packages/http-client/tsconfig.json, packages/http-server-csharp/tsconfig.json, packages/http-server-js/tsconfig.json, packages/http-specs/tsconfig.json, packages/http/tsconfig.json, packages/internal-build-utils/tsconfig.json, packages/json-schema/tsconfig.json, packages/library-linter/tsconfig.json, packages/monarch/tsconfig.json, packages/mutator-framework/tsconfig.json, packages/openapi/tsconfig.json, packages/openapi3/tsconfig.json, packages/pack/tsconfig.json, packages/playground-website/tsconfig.json, packages/playground/tsconfig.json, packages/protobuf/tsconfig.json, packages/react-components/tsconfig.json, packages/rest/tsconfig.json, packages/samples/tsconfig.json, packages/spec-api/tsconfig.json, packages/spec-coverage-sdk/tsconfig.json, packages/spec-dashboard/tsconfig.json, packages/spector/tsconfig.json, packages/sse/tsconfig.json, packages/standalone/tsconfig.json, packages/streams/tsconfig.json, packages/tmlanguage-generator/tsconfig.json, packages/tsp-integration/tsconfig.json, packages/tspd/tsconfig.json, packages/typespec-vscode/test/extension/tsconfig.json, packages/typespec-vscode/tsconfig.json, packages/versioning/tsconfig.json, packages/xml/tsconfig.json, tsconfig.json, website/tsconfig.json |
| Reproducible environment | met | 10 / 10 | devcontainer, Dockerfile, lockfile |
| Demonstrated agent practice | excluded | 0 / 10 | no data |
| Automated maintenance | partial | 5 / 8 | dependency automation configured, none observed in the sampled commits |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 5 / 10 | dependency not pinned by hash detected -- score normalized to 5 |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | Java (statically typed) |
| Manageable file sizes | partial | 54.7 / 55 | 54/10673 source files over 60KB |

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

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | met | 40 / 40 | packages/protobuf/test/include/foo/bar.proto, packages/protobuf/test/scenarios/addressbook/output/@typespec/protobuf/addressbook.proto, packages/protobuf/test/scenarios/addressbook/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/anonymous-package/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/array/output/@typespec/protobuf/com/azure/test.proto, packages/protobuf/test/scenarios/cross package references/output/@typespec/protobuf/A.proto, packages/protobuf/test/scenarios/cross package references/output/@typespec/protobuf/B.proto, packages/protobuf/test/scenarios/cross package references/output/@typespec/protobuf/C.proto, packages/protobuf/test/scenarios/derived-scalar/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/doc/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/empty/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/enum/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/extern/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/inferred-message-names/output/@typespec/protobuf/com/azure/test.proto, packages/protobuf/test/scenarios/intrinsics/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/map/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/name-collision/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/omit-off/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/omit/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/optional-lossy/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/optional/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/options/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/reserved fields/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/simple-no-service/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/simple/output/@typespec/protobuf/com/azure/Test.proto, packages/protobuf/test/scenarios/streams/output/@typespec/protobuf/main.proto, packages/protobuf/test/scenarios/templates/output/@typespec/protobuf/com/azure/Test.proto, packages/samples/specs/grpc-kiosk-example/kiosk.proto, packages/samples/specs/grpc-kiosk-example/openapi.json, packages/samples/specs/grpc-library-example/library.proto, packages/samples/specs/grpc-library-example/openapi.json, packages/samples/test/output/binary/@typespec/openapi3/openapi.yaml, packages/samples/test/output/documentation/@typespec/openapi3/openapi.yaml, packages/samples/test/output/encoded-names/@typespec/openapi3/openapi.yaml, packages/samples/test/output/encoding/@typespec/openapi3/openapi.yaml, packages/samples/test/output/grpc-kiosk-example/@typespec/openapi3/openapi.yaml, packages/samples/test/output/grpc-library-example/@typespec/openapi3/openapi.yaml, packages/samples/test/output/init/@typespec/openapi3/openapi.yaml, packages/samples/test/output/multipart/@typespec/openapi3/openapi.yaml, packages/samples/test/output/multiple-types-union/@typespec/openapi3/openapi.yaml, packages/samples/test/output/nested/@typespec/openapi3/openapi.yaml, packages/samples/test/output/nullable/@typespec/openapi3/openapi.yaml, packages/samples/test/output/openapi-extensions/@typespec/openapi3/openapi.yaml, packages/samples/test/output/optional/@typespec/openapi3/openapi.yaml, packages/samples/test/output/param-decorators/@typespec/openapi3/openapi.yaml, packages/samples/test/output/petstore/@typespec/openapi3/openapi.yaml, packages/samples/test/output/polymorphism/@typespec/openapi3/openapi.yaml, packages/samples/test/output/rest/petstore/@typespec/openapi3/openapi.yaml, packages/samples/test/output/signatures/@typespec/openapi3/openapi.yaml, packages/samples/test/output/simple/@typespec/openapi3/openapi.yaml, packages/samples/test/output/status-code-ranges/@typespec/openapi3/openapi.yaml, packages/samples/test/output/string-template/@typespec/openapi3/openapi.yaml, packages/samples/test/output/tags/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/body-boolean/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/body-complex/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/body-string/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/body-time/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/media-types/@typespec/openapi3/openapi.yaml, packages/samples/test/output/testserver/multiple-inheritance/@typespec/openapi3/openapi.yaml, packages/samples/test/output/todoApp/@typespec/openapi3/openapi.yaml, packages/samples/test/output/use-versioned-lib/@typespec/openapi3/openapi.yaml, packages/samples/test/output/visibility/@typespec/openapi3/openapi.yaml, website/src/assets/tsp-samples/homepage/hero/http/out/openapi.yaml, website/src/assets/tsp-samples/openapi3/hero/out/openapi.yaml, website/src/assets/tsp-samples/openapi3/interoperate/openapi.yaml, website/src/assets/tsp-samples/protobuf/hero/out/addressbook.proto |
| MCP server | met | 20 / 20 | — |
| Runnable examples | met | 40 / 40 | example, examples, samples |

## Collection warnings

- Resolved dependency list truncated to 2000 of 3110 packages (counts remain complete)

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