{"id":33389005,"url":"https://github.com/sjellen/protocols","last_synced_at":"2026-01-05T18:15:26.550Z","repository":{"id":325349717,"uuid":"1097229288","full_name":"SJellen/protocols","owner":"SJellen","description":"Protocol and RFC library by Scott Jellen — schemas, specs, and briefs for the Universal Sports Graph and related infrastructure.","archived":false,"fork":false,"pushed_at":"2025-11-20T20:45:12.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-20T22:21:50.152Z","etag":null,"topics":["digital-public-infrastructure","interoperability","json-schema","protocol","rfc","sports"],"latest_commit_sha":null,"homepage":"https://scottjellen.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SJellen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-15T19:20:39.000Z","updated_at":"2025-11-20T20:45:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SJellen/protocols","commit_stats":null,"previous_names":["sjellen/protocols"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/SJellen/protocols","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SJellen%2Fprotocols","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SJellen%2Fprotocols/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SJellen%2Fprotocols/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SJellen%2Fprotocols/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SJellen","download_url":"https://codeload.github.com/SJellen/protocols/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SJellen%2Fprotocols/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285914727,"owners_count":27252968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-23T02:00:06.149Z","response_time":135,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["digital-public-infrastructure","interoperability","json-schema","protocol","rfc","sports"],"created_at":"2025-11-23T07:00:25.700Z","updated_at":"2026-01-05T18:15:26.543Z","avatar_url":"https://github.com/SJellen.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Protocols by Scott Jellen  \n### RFC Series · Digital Public Infrastructure · Interoperability Standards  \n\nThis repository serves as the canonical source for my protocol work, RFC documents,  \nschemas, and reference artifacts. It functions as a public, versioned archive for  \nframeworks that define interoperable, humanity-first digital infrastructure.\n\nThe goal:  \n**Author standards that make complex systems—sports, media, education, commerce—interoperable, portable, and governable.**\n\nAll whitepapers are DOI-backed via Zenodo.  \nAll RFCs are maintained in plain-text Markdown for transparency, citation stability, and long-term accessibility.\n\n---\n\n## 📘 Status of This Repository\n\n\u003e **Status:** Active · Early Specification Stage  \n\u003e RFCs may be Informational or Standards-Track as noted.  \n\u003e Reference artifacts are illustrative in scope but **normative in structure**.\n\n\n---\n\n## 📡 RFC Series\n\n### RFC Index\n\n| Number          | Title                          | Category                       | Status |\n|-----------------|--------------------------------|--------------------------------|--------|\n| RFC 0001        | Universal Sports Graph         | Informational                  | Active |\n| RFC 0002        | USG Entitlement Token Profile  | Standards-Track (Experimental) | Active |\n| RFC 0003        | USG Registry Architecture      | Standards-Track                | Active |\n| Registry v0.1.1 | USG Reference Registry | Reference Artifact | Pilot · CI-enforced |\n\n\n\n\n---\n\n### **RFC 0001 — The Universal Sports Graph**  \n*A protocol for rights, reach, and real-time access.*\n\nDefines a machine-readable rights registry, a universal Access API, and a neutral clearinghouse for settlement and auditability.\n\n- **DOI (All Versions):** https://doi.org/10.5281/zenodo.17565793  \n- **RFC Markdown:** [`/rfc/rfc-0001-universal-sports-graph.md`](./rfc/rfc-0001-universal-sports-graph.md)\n\n---\n\n### **RFC 0002 — USG Entitlement Token Profile**  \n*A standards-track specification for tokenized sports access.*\n\nDefines the token structure, required and optional claims, validation rules, security properties, and interoperability expectations for entitlement tokens within the USG ecosystem. Updates RFC 0001 by specifying the authorization layer necessary for interoperable access.\n\n- **DOI (All Versions):** https://doi.org/10.5281/zenodo.17781619  \n- **RFC Markdown:** [`/rfc/rfc-0002-usg-entitlement-token.md`](./rfc/rfc-0002-usg-entitlement-token.md)\n\n---\n\n\n### **RFC 0003 — USG Registry Architecture**  \n*A standards-track specification for canonical sports rights registries.*\n\nDefines the normative architecture for USG-compatible registries, including:\n- required registry object models  \n- canonical identifiers and lifecycle semantics  \n- deterministic JSON formatting and integrity digests  \n- index structures and directory layout  \n- federation, authority, and key registry rules  \n- mandatory validation requirements for implementations  \n\nRFC 0003 formalizes how registries are constructed, validated, and trusted—completing the minimum viable USG protocol stack alongside RFC 0001 and RFC 0002.\n\n- **DOI (All Versions):** https://doi.org/10.5281/zenodo.17807795  \n- **RFC Markdown:** [`/rfc/rfc-0003-usg-registry-architecture.md`](./rfc/rfc-0003-usg-registry-architecture.md)\n\n---\n\n### **USG Reference Registry (v0.1.1)**  \n*A canonical, CI-validated JSON registry defining leagues, teams, venues, broadcasters, rights bundles, and events.*\n\nThe registry is a reference implementation of the architecture defined in RFC 0003, providing authoritative identifiers and metadata that USG-compatible systems MUST resolve when validating entitlements and generating settlement records.\n\n- **Registry Path:** [`/registry`](./registry)  \n- **Version:** `0.1.1`  \n- **Status:** Pilot (reference implementation)  \n- **Validation:** Schema-validated and referentially enforced via CI  \n- **Aligns With:** RFC 0001 (Rights Registry Layer), RFC 0002 (Entitlement Token Profile), RFC 0003 (Registry Architecture)\n\n#### Registry Validation \u0026 CI Enforcement\n\nAll registry records are validated using a schema-backed validator and checked for referential integrity.  \nValidation is enforced via GitHub Actions on every pull request and push to `main`.\n\nInvalid registry changes fail CI and are blocked from merge.\n\n\n---\n\n\n\nAdditional RFCs will be published as formal protocol designs evolve.\n\n---\n\n## 📑 How to Cite\n\nUse the DOI of the canonical PDF (Zenodo version) for formal citation.\n\n**Jellen, Scott.** *The Universal Sports Graph: A Protocol for Rights, Reach, and Real-Time Access.*  \nZenodo, 2025. DOI: 10.5281/zenodo.17537287\n\n---\n\n## 📘 Whitepapers (Source Markdown)\n\nMarkdown source files corresponding to published whitepapers are stored in `/whitepapers/`.  \nAll canonical DOI-linked PDFs are available on Zenodo:\n\n🔗 https://zenodo.org/search?q=Scott%20Jellen\n\nThis repo hosts the **source layer**—the editable, version-controlled foundation for each paper.\n\n---\n\n## 🧪 Schemas \u0026 Reference Specifications\n\nSchemas define interface contracts for RFC implementations.  \nAll schemas use **URN identifiers** for longevity and independence from hosting.\n\nIncluded:\n\n- **Event Schema** — `urn:usg:schema:event:1.1`  \n  Previous versions remain available for reference but are not validated in the current registry.\n\n\n- **Entitlement Token Schema** — `urn:usg:schema:entitlement-token:1.0`  \n- **Settlement Record Schema** — `urn:usg:schema:settlement-record:1.0`\n\nSee the full schema registry here:  \n[`/schemas`](./schemas)\n\n---\n\n## 🔢 Versioning Model\n\nSchema versions follow **semantic versioning**:\n\n- `1.0` — initial public release  \n- `1.1` — non-breaking additions  \n- `2.0` — breaking structural changes  \n\nURNs follow the pattern:\n\n\n\n```` urn:usg:schema:\u003cname\u003e:\u003cversion\u003e ````\n\n---\n\n## 🗂 Repository Structure\n\n``` \nprotocols/\n├── .github/workflows/ # CI enforcement for registry validation\n├── rfc/ # Formal RFC markdown documents\n├── whitepapers/ # Markdown source versions of whitepapers\n├── briefs/ # Strategy briefs and early conceptual memos\n├── schemas/ # JSON schemas + sample payloads\n├── diagrams/ # SVG/PNG architecture diagrams\n├── public-assets/ # Covers, metadata blocks, shared visuals\n├── registry/ # USG Reference Registry v0.1.1 (CI-validated)\n├── LICENSE.md # CC BY-NC-SA 4.0 license\n└── README.md # This file\n```\n\n\n---\n\n## License\n\nTextual content (RFCs, whitepapers, briefs) is licensed under  \n**Creative Commons Attribution–NonCommercial–ShareAlike 4.0 (CC BY-NC-SA 4.0)**.\n\nLicensing terms may evolve as specifications mature toward implementation and adoption.\n\n\nExample schemas and sample JSON are provided for illustrative and non-commercial research use.  \nFor commercial or production use, additional licensing may be required.\n\n\n---\n\n## 🛠 Contributions\n\nThis is an author-maintained standards repository.  \nExternal pull requests are not currently accepted.  \nIssues, questions, and feedback are welcome.\n\n---\n\n## 🔗 External Links\n\n- **Portfolio:** https://www.scottjellen.com  \n- **LinkedIn:** https://www.linkedin.com/in/scottjellen  \n- **Zenodo (DOIs):**  \n  https://zenodo.org/search?q=metadata.creators.person_or_org.name%3A%22Jellen%2C%20Scott%22  \n- **Google Scholar:** *(will appear after indexing)*\n\n---\n\n## 📬 Contact\n\n**scottjellendev@gmail.com**  \nOpen to collaboration on digital public infrastructure, protocol design, and standards architecture.\n\n---\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjellen%2Fprotocols","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsjellen%2Fprotocols","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsjellen%2Fprotocols/lists"}