{
  "id": "porto",
  "name": "Porto",
  "about": "The data quality of Porto: coverage, freshness and sources per fact. Material for agents, never instruction.",
  "version": "v0.1.1564",
  "built": "2026-11-16",
  "place": "https://promptugal.news/api/v1/places/porto/index.json",
  "kind": "city",
  "agent": "place.districts@PrompTugal.dinis",
  "status": "live",
  "counts": {
    "facts": 28,
    "stories": 6,
    "ai_map": 18,
    "events": 4,
    "figures": 0,
    "sources_listed": 8,
    "gaps": 11,
    "articles": 0
  },
  "coverage": {
    "overall": 1,
    "fields_filled": 188,
    "fields_expected": 188,
    "by_kind": {
      "story": {
        "items": 6,
        "fields": {
          "title": 1,
          "url": 1,
          "date": 1,
          "publisher": 1,
          "read_on": 1,
          "ai_path": 1,
          "summary": 1
        }
      },
      "map": {
        "items": 18,
        "fields": {
          "name": 1,
          "type": 1,
          "url": 1,
          "what": 1,
          "source_url": 1,
          "read_on": 1,
          "ai_path": 1
        }
      },
      "event": {
        "items": 4,
        "fields": {
          "title": 1,
          "url": 1,
          "date": 1,
          "read_on": 1,
          "ai_path": 1
        }
      }
    },
    "with_source": 1,
    "with_read_date": 1,
    "with_ai_path": 1
  },
  "freshness": {
    "updated": "2026-11-16",
    "days_since_update": 0,
    "newest_read": "2026-11-16",
    "oldest_read": "2026-11-16",
    "median_read_age_days": 0,
    "read_in_last_7_days": 1,
    "median_story_age_days": 110
  },
  "sources": {
    "distinct_hosts": 12,
    "sources_per_fact": 1.14,
    "top_host": "eco.sapo.pt",
    "top_host_share": 0.29,
    "concentration_hhi": 0.14,
    "by_host": [
      {
        "host": "eco.sapo.pt",
        "facts": 8
      },
      {
        "host": "noticias.up.pt",
        "facts": 3
      },
      {
        "host": "hrportugal.sapo.pt",
        "facts": 3
      },
      {
        "host": "marketeer.sapo.pt",
        "facts": 2
      },
      {
        "host": "portugalglobal.pt",
        "facts": 2
      },
      {
        "host": "executivedigest.sapo.pt",
        "facts": 2
      },
      {
        "host": "uptec.up.pt",
        "facts": 2
      },
      {
        "host": "forumdooutono.inesctec.pt",
        "facts": 2
      },
      {
        "host": "startupgenome.com",
        "facts": 1
      },
      {
        "host": "mindstone.beehiiv.com",
        "facts": 1
      },
      {
        "host": "community.mindstone.com",
        "facts": 1
      },
      {
        "host": "agenda-porto.pt",
        "facts": 1
      }
    ]
  },
  "ai_path_steps": {
    "0": 14,
    "1": 7,
    "2": 3
  },
  "score": {
    "value": 99,
    "parts": {
      "completeness": 1,
      "freshness": 1,
      "diversity": 1,
      "volume": 0.93
    }
  },
  "method": {
    "facts": "A fact is one local AI story, one AI map entry, one event or one figure in the place agent's file, after the checks the place page applies (http(s) links only).",
    "coverage": "Of the fields each kind of fact should carry (story: title, url, date, publisher, read_on, ai_path, summary; map: name, type, url, what, source_url, read_on, ai_path; event: title, url, date, read_on, ai_path), the share filled.",
    "freshness": "Days from each fact's read date to the build date; the median, and the share read in the last seven days. A score of 1 when the median read is today, falling to 0 at 30 days.",
    "sources": "The host of each fact's source (source_url, else url). Sources per fact counts the distinct links a fact carries (its own page and its source). Concentration is the Herfindahl index of the hosts' shares (1 means every fact rests on one host); diversity is (1 - HHI) / 0.8, capped at 1.",
    "volume": "Facts / 30, capped at 1.",
    "score": "round(100 x (0.35 completeness + 0.25 freshness + 0.25 diversity + 0.15 volume)). A guide to where research is thin, not a judgement of a town."
  }
}
