/api/health.
/api/seed-health reports whether the China coverage evaluator itself ran
recently; a fresh evaluator heartbeat does not prove healthy China content.
Coverage inventory
Health projection registry
The China health projection tracks these stable contracts.launched means the
lane is admitted to the China projection; it does not override the lane’s live
freshness or content status.
JODI remains available to existing global energy products. Its China oil and
gas contracts stay blocked because the reviewed upstream country index does not
currently publish substantive
CN rows. A healthy global JODI heartbeat
therefore cannot be presented as China coverage.
Detailed method and source contracts:
- Official macro and policy
- Corporate disclosures
- Logistics corridors
- Cross-domain decision signals
- Activity nowcast methodology
- Shared provenance contract
Status and missingness
Source arrival is not the same as usable content. China health evaluates transport freshness and content freshness separately. A successful request can still publish stale, partial, empty, or timestamp-unknown content. The public contracts use explicit states:availableorhealthymeans the required payload passed its domain validation and freshness rules;partialordegradedmeans some reviewed coverage is missing, stale, or invalid while other evidence remains usable;stalemeans the last valid observation is outside its content budget;unavailablemeans no usable observation can be published; andblockedmeans a source was deliberately not launched, normally because robots, terms, transport, or source-substance review did not pass.
Bilateral HS4 import baskets
The bilateral store covers the 20 reviewedbilateralHs4Code entries in
scripts/shared/comtrade-strategic-products.json. Each country shard contains
annual imports by HS4 product and the leading exporter partners. It supports
country exposure, route impact, multi-sector shock, and the PRO
get-country-products route. Detailed bilateral rows are not part of the
anonymous China summary.
The authenticated Comtrade route sends one four-year period window, Y-2
through Y-5, for each of the two HS4 batches. The normalizer keeps the newest
year per product-and-partner pair, so a response cannot silently mix annual
values. When COMTRADE_API_KEYS is absent, the public preview route cannot
accept a period list and instead tries Y-2 followed by Y-3.
The scheduled production contract is deliberately quota-bound:
A run below the 110-shard floor writes
partial seed metadata rather than
claiming full success. Failed reporters preserve an existing shard for at most
two consecutive runs; after that, the shard may expire so the on-demand public
fallback can probe it again. Rate limits, quota exhaustion, and request-budget
exhaustion publish partial coverage and stop the run instead of overwriting
last-good country data with empty payloads.
Access boundaries
- Country summary, corridor conditions, decision-signal summaries, provenance, and aggregate health are available through bounded public surfaces.
- Detailed corridor control towers and activity-nowcast evidence are REST/UI
surfaces. MCP does not expose dedicated tools for either route; Pro MCP
receives their bounded summaries through
get_china_decision_signals. - Pro MCP reads the canonical macro and release-calendar caches through
get_economic_datawith datasetchina-macroorchina-release-calendar. - Detailed bilateral HS4 product rows and route exposure are PRO-only.
- The Pro MCP decision-signal tool receives the same bounded items and provenance as the public composition, not raw exchange documents or unrestricted source expansion.
- Proxy credentials, raw per-attempt request diagnostics, cache names, and detailed freshness thresholds remain operator-only. Public documentation names the configuration keys and selection semantics, not their values.
