Resources metric catalog

Documentation index · Resources implementation · Enrichment plan · Stage 12 overview · Generated previews

This is the human-readable index to the checked cartofreako-resources-profile-v3 metric catalog. The JSON profile remains authoritative for exact units, reference periods, source IDs, coverage, output tags, palettes, and lifecycle status. The checked snapshot contains 59 metric definitions across six families; 14 are standard release passes and 45 remain exploration-only.

Pass classes

The public pass class describes build and release behavior. It is deliberately separate from whether an upstream source happens to require credentials.

Authorization and pass maturity are independent. NASA FIRMS, for example, has an optional credentialed acquisition boundary, but its data remains an unrendered exploration candidate until a separate review promotes a defined metric. Supplying a key does not turn an exploration entry into an optional or standard pass.

Catalog lifecycle mapping

The resource profile uses lifecycle values that map to the public pass classes as follows:

An optional pass is not a resource-profile lifecycle status. If a resource metric later becomes an implemented opt-in product, its pass class and authorization contract must be documented explicitly instead of overloading supplemental.

Standard resource passes

These 14 metrics have a nonempty output tag, normalized data or checked spatial input, a passing release gate, Make rules, six-projection outputs, and public v12 previews.

Exploration-only catalog

The entries below are visible so that a planned definition cannot be mistaken for a hidden release. None currently has a production output tag or public artifact.

Energy, food, fauna, and flora

Minerals

The following 23 USGS-oriented commodity definitions are all planned and exploration-only. A commodity name does not yet imply a released metric: mine production, refined production, processing capacity, reserves, resources, and trade must remain separate.

Human and policy metrics

The LGBTQIA-related design is intentionally narrower than an umbrella score. A reviewed implementation should preserve consensual same-sex criminalization, relationship recognition, expression restrictions, legal gender recognition, exceptions, and enforcement caveats as separate dated observations. The drug-policy design similarly requires jurisdiction- and substance-specific dimensions for possession, use, cultivation, quantity, sanction, and review date. Neither candidate currently has values, coverage, Make targets, artifacts, or v12 previews.

Promotion boundary

An exploration-only metric becomes a standard pass only after all of these are present and reviewed:

1. a pinned source release, retrieval date, digest, citation, and rights decision;
2. an exact metric definition, unit, reference period, geography, and missing value semantics;
3. normalized country records or a checked spatial input with a passing coverage gate;
4. a nonempty output tag and metric-specific Make rules;
5. successful generation and structural checks for all six projections;
6. deterministic SVG gzip, PDF, and PNG exports; and
7. release-manifest and public contact-sheet inclusion.

An optional pass must meet the same implementation and quality boundary. Its only difference is a deliberate, documented opt-in constraint such as source credentials or license acceptance.