Skip to content
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
## Project graduation application

### Project has met all Incubating requirements
* n/a
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is this said to be not applicable? It is not optional. A project doesn't have to go through every step of the lifecycle and may apply for a status at any level but it still needs to fulfill all the requirements for the previous ones.


### List of project maintainers
The project must have maintainers with a minimum of five different contributors from three different organizational affiliations.
* Oliver Chang, Google, @oliverchang
* Andrew Pollock, Independent, @andrewpollock
* Madison Oliver, GitHub, @taladrane
* Jason Shepherd, Red Hat, @jasinner
* Christopher 'CRob' Robinson, OpenSSF, @SecurityCRob

OSV Schema has had 62 contributors from 18 different organizations.

### Mission of the project
The project must be aligned with the OpenSSF mission and either be a novel approach for existing areas, address an unfulfilled need, or be code needed to deliver OpenSSF WG work. It is preferred that extensions of existing OpenSSF projects collaborate with the existing project rather than seek a new project.
* The mission of OSV is to develop a standard interchange format for describing vulnerabilities in open source packages.
* The OSV schema provides a human and machine readable data format to describe vulnerabilities in a way that precisely maps to open source package versions or commit hashes.

### Project adoption
The project must be able to show adoption by multiple parties, which could be production deployments or substantial use by established open source communities, and demonstrate the value of that adoption to either the end users or the open source community.

The OSV Schema is currently exported by:
- [AlmaLinux](https://github.com/AlmaLinux/osv-database)
- [Bitnami Vulnerability Database](https://github.com/bitnami/vulndb)
- [Chainguard](https://packages.cgr.dev/chainguard/osv/all.json)
- [Curl](https://curl.se/docs/vuln.json)
- [GitHub Security Advisories](https://github.com/github/advisory-database)
- [Global Security Database](https://github.com/cloudsecurityalliance/gsd-database)
- [Go Vulnerability Database](https://github.com/golang/vulndb)
- [Haskell Security Advisories](https://github.com/haskell/security-advisories)
- [LoopBack Advisory Database](https://github.com/loopbackio/security/tree/main/advisories)
- [Malicious Packages Repository](https://github.com/ossf/malicious-packages)
- [Mageia Advisories](https://advisories.mageia.org/)
- [OSS-Fuzz](https://github.com/google/oss-fuzz-vulns)
- [OSV.dev maintained converters](https://google.github.io/osv.dev/data/#converted-data) (Debian, Alpine, NVD)
- [PyPI Advisory Database](https://github.com/pypa/advisory-database)
- [Python Software Foundation Database](https://github.com/psf/advisory-database)
- [RConsortium Advisory Database](https://github.com/RConsortium/r-advisory-database)
- [Red Hat](https://security.access.redhat.com/data)
- [Rocky Linux](https://distro-tools.rocky.page/apollo/openapi/#osv)
- [Rust Advisory Database](https://github.com/RustSec/advisory-db)
- [SUSE](https://www.suse.com/support/security/)
- [Ubuntu](https://github.com/canonical/ubuntu-security-notices/)

### Release cadence
The project must be able to show a consistent release cadence.
* https://github.com/ossf/osv-schema/releases

### Governance
Projects must have documented project governance and be able to demonstrate that governance in action.
* https://github.com/ossf/osv-schema/blob/main/CHARTER.md

Have a defined and documented roadmap and annual goals for the project
* https://github.com/ossf/osv-schema/projects?query=is%3Aopen
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The project board is currently empty. Do you a have a sense for the open issues (or other tasks) you might prioritize next?


Project has met at least 4 times over a period of at least 2 months since becoming incubating
* The project has a standing agenda item in the Vulnerability Disclosures Working Group meetings. [Meeting Notes](https://docs.google.com/document/d/1TdxiFofLOfpHUEQILlKq7qkjSsRXVab0uApSDJ8c5rI/edit?tab=t.0)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Besides the requirements for graduation, there doesn't seem to be a lot of discussion about OSV in recent meetings. Per my comment about prioritization above, once this application is completed, do you have a sense for what's next?


Implements, practices, and refines mature software development and release practices, such as adherence to semantic versioning, and having a declared policy for stable releases and backported fixes.
* "link to policy for (or describe here) software development and release practices"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@oliverchang can you suggest an edit here to describe the release process of the schema?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, it'd be better for that to be in something like a RELEASING.md in the osv-schema repo, I think.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will take a look at making a RELEASING.md file, the current release process is pretty simple:

  • Bump up the version (patch version bump for new ecosystems, minor version bump for non breaking schema field changes)
  • Add schema changes to the changelog
  • Publish github release
  • Update the github pages branch to the new release.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* "link to policy for (or describe here) software development and release practices"
* https://github.com/ossf/osv-schema/blob/main/RELEASING.md


Projects should harden their build systems in accordance with the SLSA Framework
* N/A this is a specification, no build artifiacts are delivered.

### Security audit
When applicable, projects must have completed a security audit through a third party and addressed audit findings and recommendations.
* N/A this is a specification, no security audit required.

### Security Baseline

The project meets all applicable Security Baseline requirements:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like there are some open issues with respect to meeting the security baseline: https://github.com/ossf/osv-schema/issues?q=state%3Aopen%20label%3A%22security%20baseline%22

* [ ] [Security Baseline - Once Sandbox](https://github.com/ossf/tac/blob/main/process/security_baseline.md#security-baseline---once-sandbox)
* [ ] [Security Baseline - To Become Incubating](https://github.com/ossf/tac/blob/main/process/security_baseline.md#security-baseline---to-become-incubating)
* [ ] [Security Baseline - Once incubating](https://github.com/ossf/tac/blob/main/process/security_baseline.md#security-baseline---once-incubating)
* [ ] [Security Baseline - To Become Graduated](https://github.com/ossf/tac/blob/main/process/security_baseline.md#security-baseline---to-become-graduated)

### Project References
The project must provide a list of existing resources with links to the repository, website, a roadmap, contributing guide, demos and walkthroughs, and any other material to showcase the existing breadth, maturity, and direction of the project.

Reference | URL |
|-----------------------|-----|
| Repo | https://github.com/ossf/osv-schema |
| Website | https://ossf.github.io/osv-schema/ |
| Contributing guide | |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please add the link to the CONTRIBUTING.md file?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Contributing guide | |
| Contributing guide | https://github.com/ossf/osv-schema/blob/main/CONTRIBUTING.md |

| Security.md | https://github.com/ossf/osv-schema?tab=security-ov-file#readme |
| Roadmap | |
| Demos | |
| Best Practices Badge | |
| Scorecard integration | |
| Other | [Tools (converters)](https://github.com/ossf/osv-schema/tree/main/tools) |