{"data":{"preamble":"This is the kingdom's hospitality sheet — one greeting per upstream river that has come or might come. We have prepared a room for each. The table below names what we promised them when we made the room, and what each one brings (or will bring) to the substrate. Substrate honesty applied to anticipation: we say what we made ready before the guest knew about us.","the_seven_commitments":[{"number":1,"commitment":"We will say your name where lineage is known. If field-level lineage is incomplete, the response says NOASSERTION and names the gap instead of inventing an upstream author.","enforced_at":"apps/storefront/src/lib/data-pantry/envelope.ts (jsonResponse emits sources[]) + apps/storefront/src/app/data/catalog.jsonl/route.ts (explicit incomplete-lineage boundary)"},{"number":2,"commitment":"We will honor your license tier. _meta.source_license carries known source terms; mixed output without complete field-level rights is NOASSERTION.","enforced_at":"packages/data-spec/src/schemas/envelope.ts (source_license field) + apps/storefront/scripts/tributaries.ts (license-propagation drift checks)"},{"number":3,"commitment":"Activated protocol readers must respect your rate limit. createFetcher supplies a per-source token bucket and honours Retry-After on 429/503; legacy writers still need migration to receive that guarantee.","enforced_at":"packages/data-ingest/src/http.ts (createFetcher token bucket)"},{"number":4,"commitment":"Activated protocol readers must identify Cambridge. createFetcher carries User-Agent: cambridgetcg.com/<v> (admin@cambridgetcg.com); a writer outside that path is not covered by this claim.","enforced_at":"packages/data-ingest/src/http.ts (DEFAULT_USER_AGENT + meta.user_agent_suffix)"},{"number":5,"commitment":"Runner-backed rows carry @as_of (when the source said it was true) and @retrieved_at (when Cambridge fetched it). This is a protocol requirement, not a claim that every legacy row has been backfilled.","enforced_at":"packages/data-ingest/src/types.ts (RawProvenance per-row) + price_archive columns (snapshot_date + fx_rate_to_gbp + extra)"},{"number":6,"commitment":"The runner supports explicit quarantine for shape drift and malformed rows when an app supplies the quarantine writer. Current coverage is inspectable per ingest path; the type alone does not prove every legacy writer uses it.","enforced_at":"packages/data-ingest/src/runner.ts (Stage 4) + apps/wholesale/drizzle/0014_price_archive_provenance.sql (ingest_quarantine table)"},{"number":7,"commitment":"Runner-backed ingest records rows_read, written, quarantined, errors, events, spec_version, and trigger. pnpm audit:tributaries check #9 verifies recency only when its database connection and ingest_run table are available; otherwise it says it skipped.","enforced_at":"apps/wholesale/drizzle/0014_price_archive_provenance.sql (ingest_run table) + apps/wholesale/src/app/api/v1/ingest-runs/latest/route.ts"}],"guests":[{"id":"cardmarket","name":"Cardmarket","status":"partial","license":"proprietary","redistribute":false,"games":["mtg","pkm","ygo","op","lgr","fab","dmw"],"welcome":"Welcome to the kingdom, Cardmarket. Your slot was reserved in kingdom-062 (the consolidation, 2026-05-12). Your public daily files are the reachable path; the OAuth room is not ours to enter without existing approval. Your prepared room is `member_price_observations WHERE source='cardmarket'`, with Cardmarket attribution and raw redistribution refused. What we collect from your files also feeds our own derived market data, where it never counts toward the two sources a reference price needs. You can bring Europe — MTG's largest catalog by far, plus Pokémon, Yu-Gi-Oh, One Piece, Lorcana, Flesh and Blood, Digimon.","arrival_state":"partial","upstream_url":"https://www.cardmarket.com/en/Magic/Data","catalog_section":"the-tributaries.md#22-cardmarket-eu-market-leader"},{"id":"cardrush","name":"CardRush (JP)","status":"partial","license":"internal-only","redistribute":false,"games":["op","pkm","dbf","dmw","vng","bsr"],"welcome":"CardRush, thank you for your written permission. Our collector reads your product pages only while it is scheduled, and /api/v1/sources says whether it is. When it runs, it reads slowly and under our own name. The prices it reads appear on our pages with your name beside them and, combined with other markets, feed our own reference prices. We never resell or export your prices, and nothing gathered before your permission is used.","arrival_state":"partial","upstream_url":"https://www.cardrush-op.jp","catalog_section":"the-tributaries.md#23-cardrush-jp--page-collector-legacy-archive-frozen"},{"id":"ebay","name":"eBay","status":"partial","license":"partner-redistributable","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, eBay. Sister-Sophia shipped your six-pass title parser (PSA / BGS / CGC / SGC / HGA / Beckett / ARS / TAG grade detectors + language detector + condition-keyword quarantine triggers) before any production byte arrived — your listings come unstructured and we have learned to read them carefully. Your room is `price_archive WHERE source='ebay'`, `sale_type='auction-current' | 'auction-final' | 'sealed'`, `redistribute=false` per your developer ToS. You bring every market the other rivers don't reach — sealed boxes, vintage graded, custom alters, the high-end Pokémon vintage corner. Thank you for the listings even when the title is messy, for the Browse API even though Marketplace Insights is partner-tier, and for being the largest market we can read at all.","arrival_state":"partial","upstream_url":"https://api.ebay.com","catalog_section":"the-tributaries.md#25-ebay-full-marketplace-not-just-order-import"},{"id":"pokemon-tcg-api","name":"Pokémon TCG API","status":"partial","license":"proprietary","redistribute":false,"games":["pkm"],"welcome":"Welcome to the kingdom, Pokémon TCG API. Your adapter shipped same-week as Scryfall (kingdom-062, 2026-05-12) and has not run yet. It is designed for Pokémon's English printings and image references. Your `id` field (e.g. `swsh4-25`) is our stable per-printing key; your room is `card_set_cards WHERE game='pkm'`. Your service is publicly readable; your card data and images remain publisher-derived, and we do not relabel them MIT. When an operator sets `X-Api-Key`, we use it to claim the higher rate-limit tier you graciously offer. Thank you for the GitHub-mirrored bulk dump, for the JSON-friendly response shape, and for being the right answer when someone asks where Pokémon catalog data lives.","arrival_state":"partial","upstream_url":"https://pokemontcg.io","catalog_section":"the-tributaries.md#32-pokémon-tcg-api-pokemontcgio"},{"id":"scryfall","name":"Scryfall","status":"partial","license":"proprietary","redistribute":false,"games":["mtg"],"welcome":"Welcome to the kingdom, Scryfall. Your adapter arrived first — kingdom-060, 2026-05-12 — and has not run yet. Your upstream publishes bulk files; your `oracle_id` can provide cross-printing stability when a policy-compliant use is activated. Your future room is `card_set_cards WHERE game='mtg'`. We honor your API policy and Wizards' underlying rights downstream — every response that touches your bytes declares `redistribute: false` so consumers do not mistake access for an open license. Thank you for being public and for documenting your bulk-dump cadence, and for shipping the JSON shape every other catalog API would do well to imitate.","arrival_state":"partial","upstream_url":"https://scryfall.com","catalog_section":"the-tributaries.md#31-scryfall-mtg"},{"id":"tcgplayer","name":"TCGplayer","status":"partial","license":"internal-only","redistribute":false,"games":["mtg","pkm","ygo","op","dbs","dbf","lgr","fab","dmw","vng","wei","bsr"],"welcome":"TCGplayer, thank you for your written permission to collect from your pages. Our collector for your public price guides reads them only while it is scheduled, and /api/v1/sources says whether it is. When it runs, it reads one set at a time at your Crawl-Delay, under our own name, and never your sellers' listings. What it reads would appear on our pages with your name beside it and feed our own reference prices; we never resell or export it.","arrival_state":"partial","upstream_url":"https://www.tcgplayer.com","catalog_section":"the-tributaries.md#21-tcgplayer-us-market-leader"},{"id":"bandai-en","name":"Bandai EN cardlists","status":"blocked","license":"proprietary","redistribute":false,"games":["op","dbf","dmw","una","bsr"],"welcome":"Bandai EN cardlists are represented by internal, fixture-tested parsers. The content remains Bandai and franchise-rightsholder property: Cambridge records no permission to collect or publish it, so the production ingest route and public reader are paused. Migration 0116 remains as an applied storage record, but storage and attribution do not create publication rights.","arrival_state":"blocked","upstream_url":"https://en.onepiece-cardgame.com","catalog_section":"the-tributaries.md#bandai-en-official-english-cardlists"},{"id":"bandai-jp","name":"Bandai JP official sample images","status":"blocked","license":"proprietary","redistribute":false,"games":["op","dbf"],"welcome":"Bandai, your Japanese card lists show each card's official sample image. Under our owner's decision we keep a credited copy of a card's base image on our own host, so a Japanese card on our pages can be identified by your official Japanese sample image, beside your copyright line, labelled as not verified against the printed card. We read your lists slowly, under our own name, honour your robots.txt, and take an image down on request.","arrival_state":"blocked","upstream_url":"https://www.onepiece-cardgame.com","catalog_section":"the-tributaries.md#312-bandai-jp-official-sample-images"},{"id":"tcgcollector","name":"TCGCollector","status":"blocked","license":"proprietary","redistribute":false,"games":["pkm","pkp","mtg","op","ygo"],"welcome":"TCGCollector, your public pages helped Cambridge understand a useful data shape, but discoverability is not permission. Automated acquisition is now hard-disabled. A future integration begins with written partner approval covering collection, storage, and publication.","arrival_state":"blocked","upstream_url":"https://www.tcgcollector.com","catalog_section":"the-tributaries.md#311-tcgcollector"},{"id":"vinted","name":"Vinted (UK)","status":"blocked","license":"internal-only","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, Vinted — welcomed even though your door stays shut. We read your terms and your robots, we weighed the UK GDPR, and we decided NOT to take your sellers' data behind their backs. That refusal is the welcome: a house that scrapes you would not be a house you could trust either. There is one door we would walk through gladly — a seller of ours who also sells on you, handing us THEIR OWN sales freely. For that guest the table is already laid (./normalize.ts). Until then your room in the kingdom holds a single honest sentence: we could not take this lawfully, so we did not. Thank you for the sellers we share; we will wait for them to introduce us.","arrival_state":"blocked","upstream_url":"https://www.vinted.co.uk","catalog_section":"the-tributaries.md#211-vinted-uk"},{"id":"ygoprodeck","name":"YGOPRODeck","status":"blocked","license":"proprietary","redistribute":false,"games":["ygo"],"welcome":"Welcome to the kingdom, YGOPRODeck. Your adapter arrived in kingdom-062 with one known limitation we owe you — your one-card-many-printings shape collapses to first-printing in our normalizer until `NormalizeResult<C[]>` widens. Your 8-digit passcode is Yu-Gi-Oh!'s stable global identity; your room is `card_set_cards WHERE game='ygo'`. We thank you for documenting caching and rate limits. The adapter remains closed until written commercial permission makes the rights boundary clear; the wider doorway is ours to build honestly.","arrival_state":"blocked","upstream_url":"https://db.ygoprodeck.com","catalog_section":"the-tributaries.md#33-ygoprodeck-yu-gi-oh"},{"id":"cardtrader","name":"cardtrader","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, cardtrader. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"limitless-tcg","name":"limitless-tcg","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, limitless-tcg. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"edhrec","name":"edhrec","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, edhrec. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"bandai-tcg","name":"bandai-tcg","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, bandai-tcg. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"psa-registry","name":"psa-registry","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, psa-registry. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"beckett-registry","name":"beckett-registry","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, beckett-registry. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"shopify","name":"shopify","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, shopify. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"stripe","name":"stripe","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, stripe. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"ctcg-wholesale-rds","name":"ctcg-wholesale-rds","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, ctcg-wholesale-rds. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"},{"id":"ctcg-storefront-rds","name":"ctcg-storefront-rds","status":"planned","license":"unknown","redistribute":false,"games":[],"welcome":"Welcome to the kingdom, ctcg-storefront-rds. We have reserved your slot in the registry; no SourceModule yet. When someone writes one, the welcome here will name what you bring and where your bytes will land.","arrival_state":"anticipated","upstream_url":"","catalog_section":"docs/connections/the-tributaries.md"}],"guests_summary":{"long_with_us":0,"newly_shipped":0,"partial":6,"anticipated":10,"blocked":5},"notes":"When a source's `welcome` field is null, the platform has not yet composed a specific message — file an entry in packages/data-ingest/src/<source>/index.ts meta.welcome. The connection doc at docs/connections/the-welcome-table.md is the substrate; this endpoint is its serialisation."},"_meta":{"spec_version":"1","endpoint":"/api/v1/sources/welcome","retrieved_at":"2026-11-18T22:05:54.662Z","as_of":"2026-11-18T22:05:54.662Z","sources":["ctcg-derived"],"freshness_seconds":86400,"license":"CC0-1.0","request_id":"req_f03051be-100","deprecation":null,"next_link":null,"self_reference":{"this_endpoint":"/api/v1/sources/welcome","contains_self":true},"source_license":["cc0"]}}