{"adoption": {"forks": 19, "observed_at": "2026-08-28T04:08:29.914583+00:00", "stars": 3927}, "canonical_url": "https://ross.abutalabs.com/products/contracts", "card": {"archived": false, "artifact_type": "library", "description": "A set of abstractions extracted out of the Symfony components", "domain": ["web-development", "backend", "developer-tools", "apis"], "enriched": true, "function": ["middleware", "plugin-system", "developer-tools"], "health_score": 97, "homepage": "https://symfony.com/contracts", "language": "PHP", "license": "MIT", "license_family": "permissive", "maturity": "stable", "member_repos": ["symfony/contracts"], "name": "symfony/contracts", "platform": ["php", "cross-platform"], "pushed_at": "2026-08-04T09:44:57+00:00", "repo": "symfony/contracts", "stars": 3927, "tags": ["interfaces", "abstractions", "decoupling", "interoperability", "standards", "symfony", "composer", "loose-coupling", "type-hints", "service-container", "php"], "topics": ["php", "symfony", "abstractions", "component", "contracts", "decoupling", "interfaces", "interoperability", "standards", "symfony-component", "dev"], "urls": [], "use_cases": ["decouple my PHP code from specific Symfony component implementations", "type-hint against interfaces so any compatible library can be swapped in", "build a PHP package that interoperates with Symfony components", "use autowiring-friendly interfaces for dependency injection", "declare which contracts my package implements via composer 'provide'", "find a PHP equivalent to PSRs with Symfony-backed semantics"], "what_it_is": "Symfony Contracts is a set of PHP interfaces, traits, and normative docblocks extracted from Symfony components, published as small per-domain packages. It lets developers type-hint against stable abstractions so their code works with any conforming implementation, Symfony's or otherwise.", "when_to_avoid": ["you need concrete implementations rather than interfaces", "your project doesn't use Composer or PHP", "you only target PSR standards and don't need Symfony-specific semantics"], "when_to_choose": ["you write framework-agnostic PHP libraries that should work with Symfony", "you want loose coupling and swappable implementations behind stable interfaces", "you build services meant to be injected via Symfony autowiring", "you need battle-tested abstractions with reference test suites"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/contracts", "repo": "symfony/contracts", "role": "main", "score": 95}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:08:29.914583+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T18:24:42.786688+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "6565e981db9caad7444bf4a36fb89ed98d270a42532ffbfd9489eb824e3a4016", "fetched_at": "2026-08-28T04:08:29.914583+00:00", "kind": "readme", "missing": false, "url": "https://github.com/symfony/contracts"}, {"content_hash": "3a8784187adeb1bfaff141e77e1a1c842dbb32bf1285a414ef3ce5641e1eef87", "fetched_at": "2026-08-29T09:18:34.545982+00:00", "kind": "homepage", "missing": false, "url": "https://symfony.com/contracts"}, {"content_hash": "44889134f4fb7667fc156f6aa19b524c32df208a02756d59eacc0262725f7bfd", "fetched_at": "2026-08-29T09:18:34.555149+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc"}, {"content_hash": "de4a0a9526507cbe2a73f378c400bb7b0075624c9ed50cb8bd79649161f4b374", "fetched_at": "2026-08-29T09:18:34.557212+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/doc/current/components/contracts.html"}, {"content_hash": "f109a7a4a5dad68fcbf67a1a7e9be5d79c260b53ceca7ec0f9537a6da484c8fc", "fetched_at": "2026-08-29T09:18:34.559002+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/releases"}, {"content_hash": "da84802d18f340db8928460db91c2e3e9e328ceb7bdf1c40d4f71d94ff8b6fff", "fetched_at": "2026-08-29T09:18:34.560831+00:00", "kind": "site_page", "missing": false, "url": "https://symfony.com/blog/category/releases"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 96, "longevity": 100, "rhythm": 90}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2973, "days_push": 29, "days_rel": 67, "gap_med": 25.5, "n_releases_24m": 3}, "score": 95, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}