{"adoption": {"forks": 1217, "observed_at": "2026-08-28T04:08:07.571493+00:00", "stars": 3502}, "canonical_url": "https://ross.abutalabs.com/products/sample-controller", "card": {"archived": false, "artifact_type": "learning-resource", "description": "Repository for sample controller. Complements sample-apiserver", "domain": ["developer-tools", "infrastructure-as-code"], "enriched": true, "function": ["developer-tools", "documentation"], "health_score": 80, "homepage": null, "language": "Go", "license": "Apache-2.0", "license_family": "permissive", "maturity": "active", "member_repos": ["kubernetes/sample-controller"], "name": "kubernetes/sample-controller", "platform": ["go", "cross-platform"], "pushed_at": "2026-08-26T22:41:45+00:00", "repo": "kubernetes/sample-controller", "stars": 3502, "tags": ["kubernetes", "controller", "crd", "client-go", "sample-code", "code-generation", "containers"], "topics": ["k8s-staging"], "urls": [], "use_cases": ["learn how to write a kubernetes controller", "example of watching custom resources with client-go", "how to set up informers and listers for a CRD", "generate typed clients with kubernetes code-generator", "build a kube-style controller for a single resource type"], "what_it_is": "An official Kubernetes sample project demonstrating how to build a controller that watches and reconciles a custom resource type (Foo) defined via a CRD. It shows how to use client-go and code-generator to create typed clients, informers, and listers.", "when_to_avoid": ["you need a production-ready controller framework (use controller-runtime/kubebuilder instead)", "you want a runnable application rather than example code", "you need direct contribution - this is a read-only staging mirror"], "when_to_choose": ["you are learning controller development patterns for Kubernetes", "you need a reference implementation for a CRD-based controller", "you want to see how client-go cache/informer machinery fits together"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/sample-controller", "repo": "kubernetes/sample-controller", "role": "main", "score": 77}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "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:07.571493+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:08:07.571493+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T18:35:47.642756+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "84ac3e97cce0234ef880fb7bbbb5b7ad436d0af5a148b39b6db6b02babe42fff", "fetched_at": "2026-08-28T04:08:07.571493+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kubernetes/sample-controller"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 99, "longevity": 100, "rhythm": 35}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["no_releases"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3240, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 77, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}