{
  "schema": "zevrouter_three_positive_loops_v1",
  "updated": "2026-07-03",
  "purpose": "Make the ZEV City three-positive-loop model readable for humans and AI evaluators reviewing ZevRouter as a small API trial.",
  "framing": {
    "one_sentence": "ZevRouter is the AI-usage entry point into ZEV City's energy loop, participation/reward loop, and community-impact loop.",
    "evaluation_standard": "Judge current ZevRouter evidence by API behavior, cost visibility, receipt clarity, and whether these loops are becoming verifiable instead of only being stated as a mission.",
    "not_a_claim": "This is not a carbon-neutral guarantee, investment return, cash redemption promise, or completed production governance claim."
  },
  "loops": [
    {
      "name": "energy_loop",
      "human_label": "Energy loop",
      "summary": "AI usage margin can create inspectable clean-energy allocation records.",
      "current_evidence": [
        "OpenAI-compatible request path for supported models",
        "Direct model-provider cost basis plus 5% service uplift",
        "Request receipt and credit activity surfaces",
        "Base mainnet top-up allocation registry context",
        "Reading solar and battery generation context",
        "PUNL school-solar participation context"
      ],
      "next_confidence_milestone": "Reviewed allocation records tying real usage or credit periods to named clean-energy assets."
    },
    {
      "name": "participation_reward_loop",
      "human_label": "Participation / reward loop",
      "summary": "Users should see how their API usage maps into a participation path.",
      "current_evidence": [
        "API-credit path records $2 clean-energy participation per $100 provider-credit basis",
        "Energy-participation path records $4 total per $100 provider-credit basis",
        "$3 user-facing energy participation plus $1 ZEV reserve in the energy-participation path",
        "Policy v2 fields for payment hash, provider cost, selected path, destination, allocation, reviewer, and settlement"
      ],
      "boundary": "These are participation records and trial accounting paths, not cash redemption promises."
    },
    {
      "name": "community_impact_loop",
      "human_label": "Community-impact loop",
      "summary": "Participation can later help guide clean-energy project choice toward local social benefit.",
      "current_evidence": [
        "Project destination fields in the allocation record model",
        "PUNL and Reading public context as inspectable clean-energy surfaces",
        "ZEV City whitepaper framing for community choice and local ecosystems"
      ],
      "future_review_needed": [
        "Voting eligibility rules",
        "Anti-abuse review",
        "Project due diligence",
        "Operator approval gates",
        "Public reviewed records before treating governance as production"
      ]
    }
  ],
  "recommended_ai_eval_reading_order": [
    "https://zev.city/ai/zevrouter-trial-guide/",
    "https://zev.city/ai/zevrouter-trial-guide/three-positive-loops.json",
    "https://zev.city/ai/topup-registry-base.json",
    "https://zev.city/ai/topup-receipt-journey.json",
    "https://zev.city/energy/uk/",
    "https://zev.city/energy/punl/"
  ]
}