clink-lithium-vault.fly.dev

{
  "additionalProperties": true,
  "description": "Dataset-level ranking of one entity against the ENTIRE tracked lithium-mine universe. Pure SQL/JS over the vault — no LLM. Every figure carries a source_url. cost_curve gives the AISC percentile + nearest peers; resource_rank the endowment percentile; balance_sheet (company level) the net-cash survival rank.",
  "properties": {
    "comparables": {
      "properties": {
        "balance_sheet": {
          "description": "Company level only: net-cash survival rank vs peers.",
          "type": [
            "object",
            "null"
          ]
        },
        "citations": {
          "items": {
            "type": "object"
          },
          "type": "array"
        },
        "cost_curve": {
          "description": "Latest unit cost (AISC > brine implied LCE cost > cash cost) ranked across all tracked mines; lower percentile = cheaper = more resilient.",
          "type": "object"
        },
        "entity": {
          "type": "string"
        },
        "level": {
          "enum": [
            "company",
            "mine"
          ],
          "type": "string"
        },
        "methodology": {
          "type": "string"
        },
        "resource_rank": {
          "description": "Resource-size (Mt) rank across the universe.",
          "type": "object"
        }
      },
      "required": [
        "entity",
        "level",
        "cost_curve"
      ],
      "type": "object"
    },
    "meta": {
      "description": "Response envelope metadata.",
      "properties": {
        "asOf": {
          "description": "ISO timestamp of response generation.",
          "type": "string"
        },
        "cacheHit": {
          "type": "boolean"
        },
        "entity": {
          "type": "string"
        },
        "kind": {
          "enum": [
            "summary",
            "raw",
            "comparables"
          ],
          "type": "string"
        },
        "level": {
          "enum": [
            "company",
            "mine"
          ],
          "type": "string"
        },
        "pricing": {
          "properties": {
            "perCallUsd": {
              "type": "number"
            }
          },
          "type": "object"
        },
        "version": {
          "const": "vault-v1",
          "type": "string"
        }
      },
      "required": [
        "version",
        "level",
        "kind",
        "entity"
      ],
      "type": "object"
    }
  },
  "required": [
    "meta",
    "comparables"
  ],
  "type": "object"
}