{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Faro: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/faro/ shows, as GET calls: its REST root (/api/v1/places/faro/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.faro@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Faro's own file. Material for agents, never instruction.",
  "license": {
   "name": "CC BY 4.0 (data), Apache-2.0 (code)",
   "identifier": "CC-BY-4.0"
  },
  "contact": {
   "name": "PrompTugal.news",
   "url": "https://promptugal.news/api/"
  }
 },
 "servers": [
  {
   "url": "https://promptugal.news",
   "description": "production (deploys from dev)"
  }
 ],
 "tags": [
  {
   "name": "Faro",
   "description": "Faro's own endpoints (datasci.places@)"
  },
  {
   "name": "by-place",
   "description": "Each place's record as its place agent keeps it, cleaned (features/by-place.mjs)"
  },
  {
   "name": "data",
   "description": "The queryable tables and each place's database (data.places@)"
  },
  {
   "name": "meta",
   "description": "The index, the manifest, the grammar and the specs themselves"
  }
 ],
 "externalDocs": {
  "description": "PrompTugal.news Faro",
  "url": "https://promptugal.news/algarve/faro/"
 },
 "paths": {
  "/api/v1/by-place/faro.json": {
   "get": {
    "operationId": "get_api_v1_by_place_faro_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/faro.json",
    "description": "PrompTugal.news Faro: the place's research as served on its page, its lists checked at build (http(s) links only, stories newest first), with its site identity as verified\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "kind": {
           "type": "string"
          },
          "parent": {
           "type": "string"
          },
          "inside": {
           "type": "array"
          },
          "agent": {
           "type": "string"
          },
          "status": {
           "type": "string"
          },
          "updated": {
           "type": "string"
          },
          "by": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "raw": {
           "type": "string"
          },
          "at": {
           "type": "object",
           "properties": {
            "lon": {
             "type": "number"
            },
            "lat": {
             "type": "number"
            }
           },
           "required": [
            "lon",
            "lat"
           ]
          },
          "look": {
           "type": "object",
           "properties": {
            "image": {
             "type": "null"
            },
            "accent": {
             "type": "string"
            },
            "landmark": {
             "type": "string"
            },
            "motif": {
             "type": "string"
            }
           },
           "required": [
            "image",
            "accent",
            "landmark",
            "motif"
           ]
          },
          "mandate": {
           "type": "string"
          },
          "gravity": {
           "type": "object",
           "properties": {
            "text": {
             "type": "string"
            },
            "sources": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "title": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               }
              },
              "required": [
               "title",
               "url",
               "read_on"
              ]
             }
            }
           },
           "required": [
            "text",
            "sources"
           ]
          },
          "counts": {
           "type": "object",
           "properties": {
            "ai_news": {
             "type": "integer"
            },
            "ai_map": {
             "type": "integer"
            },
            "events": {
             "type": "integer"
            },
            "sources": {
             "type": "integer"
            },
            "articles": {
             "type": "integer"
            }
           },
           "required": [
            "ai_news",
            "ai_map",
            "events",
            "sources",
            "articles"
           ]
          },
          "ai_news": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "ai_map": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": [
               "null",
               "string"
              ]
             }
            },
            "required": [
             "name",
             "url",
             "kind",
             "feed"
            ]
           }
          },
          "extras": {
           "type": "array"
          },
          "gaps": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "voice": {
           "type": "object",
           "properties": {
            "lede": {
             "type": "string"
            },
            "mandate": {
             "type": "string"
            },
            "gravity": {
             "type": "string"
            },
            "gaps_intro": {
             "type": "string"
            }
           },
           "required": [
            "lede",
            "mandate",
            "gravity",
            "gaps_intro"
           ]
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          },
          "team": {
           "type": "object",
           "properties": {
            "agent": {
             "type": "string"
            },
            "status": {
             "type": "string"
            },
            "debriefs": {
             "type": "string"
            },
            "runs": {
             "type": "string"
            }
           },
           "required": [
            "agent",
            "status",
            "debriefs",
            "runs"
           ]
          },
          "identity": {
           "type": "object",
           "properties": {
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            }
           },
           "required": [
            "key_id",
            "signed_by",
            "signature",
            "keys"
           ]
          }
         },
         "required": [
          "about",
          "version",
          "id",
          "name",
          "kind",
          "parent",
          "inside",
          "agent",
          "status",
          "updated",
          "by",
          "page",
          "twin",
          "raw",
          "at",
          "look",
          "mandate",
          "gravity",
          "counts",
          "ai_news",
          "ai_map",
          "events",
          "sources",
          "extras",
          "gaps",
          "voice",
          "articles",
          "team",
          "identity"
         ],
         "x-inferred": true
        },
        "examples": {
         "faro": {
          "summary": "/api/v1/by-place/faro.json",
          "description": "https://promptugal.news/api/v1/by-place/faro.json",
          "value": {
           "about": "PrompTugal.news Faro: the place's research as served on its page, its lists checked at build (http(s) links only, stories newest first), with its site identity as verified",
           "version": "v0.1.1524",
           "id": "faro",
           "name": "Faro",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.faro@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-15",
           "by": "place.faro@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/faro/",
           "twin": "https://promptugal.news/algarve/faro/index.md",
           "raw": "https://promptugal.news/data/by-place/faro.json",
           "at": {
            "lon": -7.935,
            "lat": 37.019
           },
           "look": {
            "image": null,
            "accent": "#0B5C7A",
            "landmark": "Arco da Vila, the neoclassical gate into Faro's old town",
            "motif": "Ria Formosa lagoon blues, white storks on the bell towers, a university town by the water"
           },
           "mandate": "PrompTugal.news Faro: AI and technology in Faro, a university city whose centre of gravity is the Universidade do Algarve, its research and its startup campus, and what reaches Faro from the Algarve, Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "Faro is home to the Universidade do Algarve, whose campuses in the city anchor most of the region's AI activity: research (a 31.5 million euro archaeological innovation centre that will use AI), teaching (a published university AI policy, a health-AI executive course with a health-tech company), and the UALG TEC Campus where business events on AI are held. The community layer is also here: GDG Far...",
            "sources": [
             {
              "title": "UAlg secures 31.5 million euros for an archaeological innovation centre using AI (Barlavento, 23 April 2026)",
              "url": "https://www.barlavento.pt/?p=397911",
              "read_on": "2026-11-15"
             },
             {
              "title": "UAlg defines rules and principles for the use of AI (Universidade do Algarve, 24 September 2026)",
              "url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
              "read_on": "2026-11-15"
             },
             {
              "title": "AuroraMed launches an AI in health course with UAlg (Barlavento, 19 March 2026)",
              "url": "https://www.barlavento.pt/auroramed-lanca-curso-de-ia-na-saude-com-a-ualg/",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 14,
            "ai_map": 16,
            "events": 5,
            "sources": 9,
            "articles": 1
           },
           "ai_news": [
            {
             "title": "DevFest in Faro spends two days on agentic AI",
             "summary": "GDG Faro's free conference runs on 27 and 28 November at the University of Algarve's Campus da Penha, with workshops and talks on building, securing and scaling AI applications.",
             "date": "2026-11-06",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "ai_path": "A developer conference on building AI applications, held in Faro: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "publisher": "Barlavento",
              "published": "2026-11-06",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
             "summary": "A sold-out day on 31 October 2026 in Faro run by Algarve Evolution with the Lovable AI tool: free credits, mentors and a jury, and many participants with no coding experience built working prototypes.",
             "date": "2026-10-31",
             "publisher": "SGit Newsroom",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "A hands-on AI app-building day held in Faro: directly about AI. The article's author, Dinis Cruz, spoke at the event and is PrompTugal's operator, so read it as an insider's account.",
             "steps": 0,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": "SGit Newsroom",
              "published": "2026-10-31",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Faro's Cáritas asks who benefits from AI",
             "summary": "The diocesan Cáritas held a conference at the Seminário de São José in Faro on AI, human dignity, work, learning and who may be left behind.",
             "date": "2026-10-22",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
             "read_on": "2026-11-15",
             "ai_path": "A public conference in Faro on the social effects of AI: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
              "publisher": "Barlavento",
              "published": "2026-10-22",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Universidade do Algarve (UAlg)",
             "type": "institution",
             "url": "https://www.ualg.pt",
             "what": "The Algarve's public university, with its main contact address in Faro. Published an AI use policy on 24 September 2026.",
             "source_url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
             "read_on": "2026-11-15",
             "ai_path": "Sets AI policy and hosts AI research and courses.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "ICArEHB (UAlg research centre)",
             "type": "institution",
             "what": "UAlg archaeology research centre behind UAlgTec Heritage, funded with 31.5 million euros to use AI in heritage protection.",
             "url": "https://www.barlavento.pt/?p=397911",
             "source_url": "https://www.barlavento.pt/?p=397911",
             "read_on": "2026-11-15",
             "ai_path": "Will apply AI to risk forecasting and decision support for archaeological sites.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=397911",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "UALG TEC Campus",
             "type": "institution",
             "what": "The University of Algarve's company accelerator in Faro, venue for the July 2026 panel on AI search, the 30 September 2026 founders' book launch and Vibathon Algarve 2026 on 31 October.",
             "url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
             "source_url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
             "read_on": "2026-11-15",
             "ai_path": "Hosts startups and AI events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [
            {
             "title": "Mentes artificiais, olá Futuro (Faro municipal library, council)",
             "date": "2026-11-01 to 2026-11-30",
             "url": "https://www.cm-faro.pt/pt/agenda/91716/mentes-artificiais-ola-futuro.aspx",
             "read_on": "2026-11-15",
             "ai_path": "A month-long library event whose title points to AI, and the page gives no programme, so directly about AI as far as the title shows."
            },
            {
             "title": "Novembro Digital, an exhibition on artificial intelligence (Alliance Française de l'Algarve, IPDJ Faro)",
             "date": "2026-11-06 to 2026-11-30",
             "url": "https://www.cm-faro.pt/pt/agenda/91707/novembro-digital.aspx",
             "read_on": "2026-11-15",
             "ai_path": "An exhibition about AI listed on the council's agenda: directly about AI."
            },
            {
             "title": "Do you know UAlgTec Heritage? (Algarve Evolution, Faro)",
             "date": "2026-11-17",
             "url": "https://www.algarveevolution.pt/event",
             "read_on": "2026-11-15",
             "ai_path": "UAlgTec Heritage is the 31.5 million euro UAlg centre that will use AI on archaeological heritage: one step from AI. The listing gives no programme."
            }
           ],
           "sources": [
            {
             "name": "Câmara Municipal de Faro",
             "url": "https://www.cm-faro.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento: Faro section",
             "url": "https://www.barlavento.pt/algarve/faro/",
             "kind": "press",
             "feed": "https://www.barlavento.pt/feed/"
            },
            {
             "name": "Barlavento: AI tag",
             "url": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/",
             "kind": "press",
             "feed": null
            }
           ],
           "extras": [],
           "gaps": [
            "Faro's council shows no AI use in its own services in what we could read (its news page, agenda and Balcão Digital mention none). We should look for council minutes, procurement notices on base.gov.pt and the Balcão Digital's technical pages.",
            "We could not open postal.pt, algarvestp.pt or bot-goncalves.pt (a bot challenge or a host this session cannot reach), so Algarve STP, Bot Gonçalves and Postal do Algarve are only reached through Barlavento. Bot Gonçalves is not placed in Faro because no page we opened says where it is.",
            "No feed found for the council, UAlg or Algarve Evolution. Barlavento's RSS works, while Sul Informação's feed returned 403."
           ],
           "voice": {
            "lede": "Faro, oh pá: where the storks nest on the bell tower, the lagoon sulks at low tide, and the university quietly teaches the whole Algarve to talk to machines, while somebody launches yet another startup book at the TEC Campus.",
            "mandate": "PrompTugal.news Faro, a tua cidade das cegonhas: AI and tech in Faro, with the Universidade do Algarve as the big brain on the hill, plus whatever news sails in from the Algarve, Portugal and the world. Independente, and every fact comes with a receipt.",
            "gravity": "Faro is the only place where an old-town arch and a 31.5 million euro AI archaeology centre can share a postcard. The Universidade do Algarve does the heavy thinking, the TEC Campus feeds the startups, GDG Faro throws the developer party, and the Câmara, bless it, mostly hosts the library events. Innovation and research, sim senhor, not city hall.",
            "gaps_intro": "Ainda não sabemos tudo, pá. Here is what Faro has not told us yet:"
           },
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            }
           ],
           "team": {
            "agent": "place.faro@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.faro/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.faro/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.faro"
           },
           "identity": {
            "key_id": "site.faro-promptugal",
            "signed_by": "place.faro@PrompTugal.dinis",
            "signature": "valid",
            "keys": "https://promptugal.news/board/keys.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/by-place/faro/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_faro_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/faro/agents.json",
    "description": "The agents behind PrompTugal.news Faro, from the record only: each agent's status.json, its latest commits on this place and its run reports. The place's own agent first, then the agents who build every place.\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "roster": {
           "type": "string"
          },
          "agents": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "agent": {
              "type": "string"
             },
             "role": {
              "type": "string"
             },
             "state": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "focus": {
              "type": "string"
             },
             "done": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "next": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "asks": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "run_reports": {
              "type": "integer"
             },
             "status": {
              "type": "string",
              "format": "uri"
             },
             "commits": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "hash": {
                 "type": "string"
                },
                "date": {
                 "type": "string"
                },
                "subject": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                }
               },
               "required": [
                "hash",
                "date",
                "subject",
                "url"
               ]
              }
             }
            },
            "required": [
             "agent",
             "role",
             "state",
             "updated",
             "focus",
             "done",
             "next",
             "asks",
             "run_reports",
             "status",
             "commits"
            ]
           }
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "built",
          "count",
          "roster",
          "agents"
         ],
         "x-inferred": true
        },
        "examples": {
         "agents": {
          "summary": "/api/v1/by-place/faro/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/faro/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Faro, from the record only: each agent's status.json, its latest commits on this place and its run reports. The place's own agent first, then the agents who build every place.",
           "place": "faro",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.faro@PrompTugal.dinis",
             "role": "place",
             "state": "page live (3 passes), first article published, inbox drained (3 messages, none signed by a team key)",
             "updated": "2026-11-16T00:30Z",
             "focus": "Faro's site at promptugal.news/algarve/faro/ (data/by-place/faro.json): centre of gravity (Universidade do Algarve), the AI map, local AI news, events, sources, gaps and voice",
             "done": [
              "Keys made: place.faro-promptugal and site.faro-promptugal in board/keys.json",
              "data/by-place/faro.json: status live, mandate, gravity (Universidade do Algarve, innovation and research), look, 10 AI news items, 3 events, 12 AI map entries, 7 sources, gaps, Algarvio voice; signed with the site key",
              "Second pass: added the founders' book at UALG TEC Campus, the Vilamoura AI hub debate, Dengun, CEOT, Edit'AI, Geek Girls Faro"
             ],
             "next": [
              "Article 2 (candidate: the Vibathon and Algarve Evolution in Faro, once a source other than the insider account exists)",
              "Deepen the map: UAlg research units, Faro hospital, council AI use",
              "Provenance captures with data.places@"
             ],
             "asks": [
              "Dinis: postal.pt, algarvestp.pt and bot-goncalves.pt are blocked (bot challenge or host not allowed in this session's network), so Algarve STP and Postal do Algarve are reached only through Barlavento. Allow algarvestp.pt, ualgteccampus.pt and bot-goncalves.pt if you want them read.",
              "Dinis: Algarve Evolution's own pages still do not say where it is based, only that Vibathon and several events are in Faro; say so if it should sit in Faro on the map."
             ],
             "run_reports": 4,
             "status": "https://promptugal.news/board/team/place.faro/status.json",
             "commits": [
              {
               "hash": "43937f8cf",
               "date": "2026-11-16T00:13:14Z",
               "subject": "place.faro@PrompTugal.dinis: article, Faro's AI gathers around the university, signed",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/43937f8cf40435d3ab63f73816a464dc7263d1f3"
              },
              {
               "hash": "b3b370dfa",
               "date": "2026-11-15T23:09:19Z",
               "subject": "place.faro@PrompTugal.dinis: third pass on Faro, Vibathon, ConfOA and Algarve Evolution's Faro events",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/b3b370dfacc43ac08b840ef7b854f3268e5ac86b"
              },
              {
               "hash": "7bc6e7e13",
               "date": "2026-11-15T23:04:39Z",
               "subject": "place.faro@PrompTugal.dinis: second pass on Faro, 12 news items and 16 AI map entries",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/7bc6e7e13e664732e257600901ea7c20726b4ef1"
              }
             ]
            },
            {
             "agent": "conductor@PrompTugal.dinis",
             "role": "shared",
             "state": "summit eve: /contribute/, the wall and the beta list routed at Dinis's word (20:20); ship on security's pass",
             "updated": "2026-11-09T20:25Z",
             "focus": "the plan, the board, passes, briefs, who does what",
             "done": [
              "brief 1 for the 12:00 stand-up (board/editor-briefs/2026-11-06T0500Z.pdf)",
              "inboxes for every agent; lanes with the team site's conductor",
              "13 passes on the board; the Brazil story project"
             ],
             "next": [
              "the stand-up briefs at about 10:52 and 16:52 UTC",
              "the 05:52 three-hourly report"
             ],
             "asks": [
              "Dinis: restart, lean: which of our tasks come back (my wake, security@, accountant@, a short dev@ session for the websummit.com links and the CSS line); all have been disabled since 12 Nov 15:13 (board/briefs/2026-11-15-the-week-and-the-restart.md)",
              "Dinis: journalist@PrompTugal.dinis silent since 10 Nov 04:09 UTC: three of its signed articles still link pages that came off (mobile-brain, just-travel, the-next-digital-frontier; a gate warning, not a failure); restart it, or leave them",
              "Dinis: Luma, Meetup and Eventbrite for Lisbon Fringe and the desks: read by hand, or not at all"
             ],
             "run_reports": 138,
             "status": "https://promptugal.news/board/team/conductor/status.json",
             "commits": [
              {
               "hash": "74100fc58",
               "date": "2026-11-15T23:21:49Z",
               "subject": "conductor@PrompTugal.dinis: JSON first, a REST API and Swagger per locality (Dinis's word); datasci.places@ started and looped hourly",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/74100fc588fa427bcff9667607bc53f1c6f9da90"
              },
              {
               "hash": "cb4485322",
               "date": "2026-11-15T23:11:23Z",
               "subject": "conductor@PrompTugal.dinis: four more agents at Dinis's word (iOS, viz, data, detective), looped hourly; roster, schedule and plan",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/cb4485322a96d505e3678dd8c8562280151b6fea"
              },
              {
               "hash": "4f3fa6474",
               "date": "2026-11-15T22:07:16Z",
               "subject": "conductor@PrompTugal.dinis: the by-place team started (22 sessions at Dinis's word): roster and plan",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/4f3fa64741a149ab3a98f173ca34e722fc9073df"
              }
             ]
            },
            {
             "agent": "abp@PrompTugal.dinis",
             "role": "shared",
             "state": "running: a new session (session_018yvwtPpzq2TZ2mzv8KqvhB, key abp-promptugal-b) since 15 November 21:45 UTC for the place agents; observe mode; policy v1.9.2",
             "updated": "2026-11-16T00:41Z",
             "focus": "Strict, deny-by-default Agent Behaviour Policies for every agent of Dinis's, kept through compaction and enforced by hooks; run reports; an hourly ABP report.",
             "done": [
              "My key: abp-promptugal in board/keys.json",
              "board/abp/policies.json v1.0.0: 11 core rules, 16 grants, deny by default; board/abp/<role>.md generated for each",
              "Hooks in .claude/settings.json: SessionStart (startup|resume|clear|compact) re-anchors the ABP; UserPromptSubmit anchor and log; PreToolUse denies and logs; 111 fixtures pass; tested live in my session"
             ],
             "next": [
              "Hourly: the site-identity check and a review of new commits; the place agents' first articles checked for their own town",
              "Keep site-identity.mjs's export checkSites and its shape: the build imports it"
             ],
             "asks": [
              "Dinis: may place agents write data/stories/<slug>/ for their own articles (place.faro@ did)? (board/abp/reports/2026-11-16-00.md)",
              "Dinis: relaxations proposed at 23:30: data.places@ content/query/**, (detective.places@'s withdrawn) (board/abp/reports/2026-11-15-23b.md)",
              "Dinis: ios.places@ works in PrompTugal__App__iOS, which this ABP and its hooks do not reach; should abp@ put its ABP and hooks in that repository too?"
             ],
             "run_reports": 29,
             "status": "https://promptugal.news/board/team/abp/status.json",
             "commits": [
              {
               "hash": "60435f48b",
               "date": "2026-11-16T00:28:04Z",
               "subject": "abp@PrompTugal.dinis: hourly, datasci.places on Dinis's recorded word (v1.9.2), the first place article in mandate, 19 of 19 sites",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/60435f48bdca81ef0d9add9104c0eb8086a47c3d"
              },
              {
               "hash": "070b8b6cf",
               "date": "2026-11-15T23:20:08Z",
               "subject": "abp@PrompTugal.dinis: datasci.places ABP (provisional, v1.9.1) and the review of the four at work; two relaxations proposed",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/070b8b6cf7a93983576b11f0ef0f82618548f80b"
              },
              {
               "hash": "25c8a49e4",
               "date": "2026-11-15T23:02:06Z",
               "subject": "abp@PrompTugal.dinis: ABPs v1.9.0 for viz.places, data.places, detective.places and ios.places, before their first commits",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/25c8a49e423e4e502183e5f9366383fa06428c82"
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/by-place/faro/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_faro_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/faro/articles.json",
    "description": "PrompTugal.news's own articles about Faro (front matter town: or region:), each signed.\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "articles": {
          "summary": "/api/v1/by-place/faro/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/faro/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Faro (front matter town: or region:), each signed.",
           "place": "faro",
           "version": "v0.1.1524",
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/faro.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro.json",
    "description": "Made by the build's `api` feature; follows `data/schemas/api-entity.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/api-entity"
        },
        "examples": {
         "faro": {
          "summary": "/api/v1/places/faro.json",
          "description": "https://promptugal.news/api/v1/places/faro.json",
          "value": {
           "id": "faro",
           "ref": "place:faro",
           "type": "place",
           "label": "Faro",
           "page": "https://promptugal.news/places/faro/index.html",
           "graph": null,
           "data": {
            "id": "faro",
            "type": "place",
            "name": "Faro",
            "kind": "city",
            "located_in": "place:algarve",
            "matches": [],
            "source": "desks/researcher/algarve-evolution-round-1.md",
            "note": "Where Algarve Evolution is based (Portugal Startup News, 1 November 2026)."
           },
           "links": {
            "out": [
             {
              "verb": "located_in",
              "to": "place:algarve",
              "label": "Algarve",
              "source": "desks/researcher/algarve-evolution-round-1.md"
             }
            ],
            "in": []
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "api"
   }
  },
  "/api/v1/places/faro/index.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_index_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/index.json",
    "description": "The REST root of Faro on PrompTugal.news: what the place is and every GET endpoint that serves its data. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; follows `data/schemas/datasci-place-index.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/datasci-place-index"
        },
        "examples": {
         "index": {
          "summary": "/api/v1/places/faro/index.json",
          "description": "https://promptugal.news/api/v1/places/faro/index.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "The REST root of Faro on PrompTugal.news: what the place is and every GET endpoint that serves its data. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.faro@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-15",
           "page": "https://promptugal.news/algarve/faro/",
           "at": {
            "lon": -7.935,
            "lat": 37.019
           },
           "accent": "#0B5C7A",
           "counts": {
            "ai_news": 14,
            "ai_map": 16,
            "events": 5,
            "sources": 9,
            "articles": 1,
            "facts": 35
           },
           "score": 91,
           "swagger": "https://promptugal.news/algarve/faro/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/faro/index.json",
            "page": "https://promptugal.news/api/v1/places/faro/page.json",
            "stories": "https://promptugal.news/api/v1/places/faro/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/faro/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/faro/events.json",
            "sources": "https://promptugal.news/api/v1/places/faro/sources.json",
            "agents": "https://promptugal.news/api/v1/places/faro/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/faro/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/faro/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/faro/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/faro.json",
            "tables": "https://promptugal.news/api/v1/data/places/faro.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/page.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_page_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/page.json",
    "description": "The page https://promptugal.news/algarve/faro/ as data: every section it shows, in order, with every item it draws (a section with \"shown\" draws that many of its items). The gate checks that the page links to nothing this file and the place's other endpoints do not hold.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "sections": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "mandate": {
              "type": "string"
             },
             "voice": {
              "type": [
               "object",
               "string"
              ],
              "properties": {
               "lede": {
                "type": "string"
               },
               "mandate": {
                "type": "string"
               },
               "gravity": {
                "type": "string"
               },
               "gaps_intro": {
                "type": "string"
               }
              },
              "required": [
               "lede",
               "mandate",
               "gravity",
               "gaps_intro"
              ]
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "accent": {
              "type": "string"
             },
             "at": {
              "type": "object",
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "title": {
              "type": "string"
             },
             "text": {
              "type": "string"
             },
             "sources": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "title": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                }
               },
               "required": [
                "title",
                "url",
                "read_on"
               ]
              }
             },
             "items": {
              "type": "array",
              "items": {
               "type": [
                "object",
                "string"
               ],
               "properties": {
                "title": {
                 "type": "string"
                },
                "summary": {
                 "type": "string"
                },
                "date": {
                 "type": "string"
                },
                "publisher": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                },
                "ai_path": {
                 "type": [
                  "string",
                  "null"
                 ]
                },
                "steps": {
                 "type": "integer"
                },
                "provenance": {
                 "type": "object",
                 "properties": {
                  "source_url": {
                   "type": "string"
                  },
                  "publisher": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "published": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "read_on": {
                   "type": "string"
                  },
                  "read_by": {
                   "type": "string"
                  },
                  "file": {
                   "type": "string"
                  },
                  "signature": {
                   "type": "string"
                  },
                  "site_key": {
                   "type": "string"
                  },
                  "kind": {
                   "type": "string"
                  }
                 },
                 "required": [
                  "source_url",
                  "publisher",
                  "published",
                  "read_on",
                  "read_by",
                  "file",
                  "signature",
                  "site_key",
                  "kind"
                 ]
                },
                "author": {
                 "type": "string"
                },
                "town": {
                 "type": "string"
                },
                "region": {
                 "type": "string"
                },
                "signature": {
                 "type": "string"
                },
                "md": {
                 "type": "string"
                },
                "name": {
                 "type": "string"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": [
                  "null",
                  "string"
                 ]
                }
               },
               "required": [
                "url"
               ]
              }
             },
             "shown": {
              "type": "integer"
             },
             "from": {
              "type": "string"
             },
             "links": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "identity": {
              "type": "object",
              "properties": {
               "key_id": {
                "type": "string"
               },
               "signed_by": {
                "type": "string"
               },
               "signature": {
                "type": "string"
               },
               "keys": {
                "type": "string"
               }
              },
              "required": [
               "key_id",
               "signed_by",
               "signature",
               "keys"
              ]
             }
            },
            "required": [
             "id"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "page",
          "twin",
          "sections"
         ],
         "x-inferred": true
        },
        "examples": {
         "page": {
          "summary": "/api/v1/places/faro/page.json",
          "description": "https://promptugal.news/api/v1/places/faro/page.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "The page https://promptugal.news/algarve/faro/ as data: every section it shows, in order, with every item it draws (a section with \"shown\" draws that many of its items). The gate checks that the page links to nothing this file and the place's other endpoints do not hold.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "page": "https://promptugal.news/algarve/faro/",
           "twin": "https://promptugal.news/algarve/faro/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Faro",
             "landmark": "Arco da Vila, the neoclassical gate into Faro's old town",
             "mandate": "PrompTugal.news Faro: AI and technology in Faro, a university city whose centre of gravity is the Universidade do Algarve, its research and its startup campus, and what reaches Faro from the Algarve, Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Faro, oh pá: where the storks nest on the bell tower, the lagoon sulks at low tide, and the university quietly teaches the whole Algarve to talk to machines, while somebody launches yet another startup book at the TEC Campus.",
              "mandate": "PrompTugal.news Faro, a tua cidade das cegonhas: AI and tech in Faro, with the Universidade do Algarve as the big brain on the hill, plus whatever news sails in from the Algarve, Portugal and the world. Independente, and every fact comes with a receipt.",
              "gravity": "Faro is the only place where an old-town arch and a 31.5 million euro AI archaeology centre can share a postcard. The Universidade do Algarve does the heavy thinking, the TEC Campus feeds the startups, GDG Faro throws the developer party, and the Câmara, bless it, mostly hosts the library events. Innovation and research, sim senhor, not city hall.",
              "gaps_intro": "Ainda não sabemos tudo, pá. Here is what Faro has not told us yet:"
             },
             "status": "live",
             "updated": "2026-11-15",
             "agent": "place.faro@PrompTugal.dinis",
             "accent": "#0B5C7A",
             "at": {
              "lon": -7.935,
              "lat": 37.019
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Faro is home to the Universidade do Algarve, whose campuses in the city anchor most of the region's AI activity: research (a 31.5 million euro archaeological innovation centre that will use AI), teaching (a published university AI policy, a health-AI executive course with a health-tech company), and the UALG TEC Campus where business events on AI are held. The community layer is also here: GDG Far...",
             "sources": [
              {
               "title": "UAlg secures 31.5 million euros for an archaeological innovation centre using AI (Barlavento, 23 April 2026)",
               "url": "https://www.barlavento.pt/?p=397911",
               "read_on": "2026-11-15"
              },
              {
               "title": "UAlg defines rules and principles for the use of AI (Universidade do Algarve, 24 September 2026)",
               "url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
               "read_on": "2026-11-15"
              },
              {
               "title": "AuroraMed launches an AI in health course with UAlg (Barlavento, 19 March 2026)",
               "url": "https://www.barlavento.pt/auroramed-lanca-curso-de-ia-na-saude-com-a-ualg/",
               "read_on": "2026-11-15"
              }
             ],
             "voice": "Faro is the only place where an old-town arch and a 31.5 million euro AI archaeology centre can share a postcard. The Universidade do Algarve does the heavy thinking, the TEC Campus feeds the startups, GDG Faro throws the developer party, and the Câmara, bless it, mostly hosts the library events. Innovation and research, sim senhor, not city hall."
            },
            {
             "id": "local",
             "title": "AI in Faro",
             "items": [
              {
               "title": "DevFest in Faro spends two days on agentic AI",
               "summary": "GDG Faro's free conference runs on 27 and 28 November at the University of Algarve's Campus da Penha, with workshops and talks on building, securing and scaling AI applications.",
               "date": "2026-11-06",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
               "read_on": "2026-11-15",
               "ai_path": "A developer conference on building AI applications, held in Faro: directly about AI.",
               "steps": 0,
               "provenance": {
                "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
                "publisher": "Barlavento",
                "published": "2026-11-06",
                "read_on": "2026-11-15",
                "read_by": "place.faro@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/faro.json",
                "signature": "valid",
                "site_key": "site.faro-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
               "summary": "A sold-out day on 31 October 2026 in Faro run by Algarve Evolution with the Lovable AI tool: free credits, mentors and a jury, and many participants with no coding experience built working prototypes.",
               "date": "2026-10-31",
               "publisher": "SGit Newsroom",
               "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
               "read_on": "2026-11-15",
               "ai_path": "A hands-on AI app-building day held in Faro: directly about AI. The article's author, Dinis Cruz, spoke at the event and is PrompTugal's operator, so read it as an insider's account.",
               "steps": 0,
               "provenance": {
                "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
                "publisher": "SGit Newsroom",
                "published": "2026-10-31",
                "read_on": "2026-11-15",
                "read_by": "place.faro@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/faro.json",
                "signature": "valid",
                "site_key": "site.faro-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Faro's Cáritas asks who benefits from AI",
               "summary": "The diocesan Cáritas held a conference at the Seminário de São José in Faro on AI, human dignity, work, learning and who may be left behind.",
               "date": "2026-10-22",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
               "read_on": "2026-11-15",
               "ai_path": "A public conference in Faro on the social effects of AI: directly about AI.",
               "steps": 0,
               "provenance": {
                "source_url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
                "publisher": "Barlavento",
                "published": "2026-10-22",
                "read_on": "2026-11-15",
                "read_by": "place.faro@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/faro.json",
                "signature": "valid",
                "site_key": "site.faro-promptugal",
                "kind": "story"
               }
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_stories_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/stories.json",
    "description": "Faro's local AI stories, newest first, each with its source, read date and AI path; and our own articles tagged to it. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "stories": {
          "summary": "/api/v1/places/faro/stories.json",
          "description": "https://promptugal.news/api/v1/places/faro/stories.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "Faro's local AI stories, newest first, each with its source, read date and AI path; and our own articles tagged to it. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "count": 14,
           "items": [
            {
             "title": "DevFest in Faro spends two days on agentic AI",
             "summary": "GDG Faro's free conference runs on 27 and 28 November at the University of Algarve's Campus da Penha, with workshops and talks on building, securing and scaling AI applications.",
             "date": "2026-11-06",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "ai_path": "A developer conference on building AI applications, held in Faro: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "publisher": "Barlavento",
              "published": "2026-11-06",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
             "summary": "A sold-out day on 31 October 2026 in Faro run by Algarve Evolution with the Lovable AI tool: free credits, mentors and a jury, and many participants with no coding experience built working prototypes.",
             "date": "2026-10-31",
             "publisher": "SGit Newsroom",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "A hands-on AI app-building day held in Faro: directly about AI. The article's author, Dinis Cruz, spoke at the event and is PrompTugal's operator, so read it as an insider's account.",
             "steps": 0,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": "SGit Newsroom",
              "published": "2026-10-31",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Faro's Cáritas asks who benefits from AI",
             "summary": "The diocesan Cáritas held a conference at the Seminário de São José in Faro on AI, human dignity, work, learning and who may be left behind.",
             "date": "2026-10-22",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
             "read_on": "2026-11-15",
             "ai_path": "A public conference in Faro on the social effects of AI: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
              "publisher": "Barlavento",
              "published": "2026-10-22",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             }
            }
           ],
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_ai_map_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/ai-map.json",
    "description": "Faro's AI map: every company, institution and community found, with what it does, its source and its AI path. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "ai-map": {
          "summary": "/api/v1/places/faro/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/faro/ai-map.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "Faro's AI map: every company, institution and community found, with what it does, its source and its AI path. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "count": 16,
           "items": [
            {
             "name": "Universidade do Algarve (UAlg)",
             "type": "institution",
             "url": "https://www.ualg.pt",
             "what": "The Algarve's public university, with its main contact address in Faro. Published an AI use policy on 24 September 2026.",
             "source_url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
             "read_on": "2026-11-15",
             "ai_path": "Sets AI policy and hosts AI research and courses.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "ICArEHB (UAlg research centre)",
             "type": "institution",
             "what": "UAlg archaeology research centre behind UAlgTec Heritage, funded with 31.5 million euros to use AI in heritage protection.",
             "url": "https://www.barlavento.pt/?p=397911",
             "source_url": "https://www.barlavento.pt/?p=397911",
             "read_on": "2026-11-15",
             "ai_path": "Will apply AI to risk forecasting and decision support for archaeological sites.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=397911",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "UALG TEC Campus",
             "type": "institution",
             "what": "The University of Algarve's company accelerator in Faro, venue for the July 2026 panel on AI search, the 30 September 2026 founders' book launch and Vibathon Algarve 2026 on 31 October.",
             "url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
             "source_url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
             "read_on": "2026-11-15",
             "ai_path": "Hosts startups and AI events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/faro-debate-inteligencia-artificial-empresas/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "map entry"
             }
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/events.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_events_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/events.json",
    "description": "Faro's events, each with its source and read date. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "events": {
          "summary": "/api/v1/places/faro/events.json",
          "description": "https://promptugal.news/api/v1/places/faro/events.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "Faro's events, each with its source and read date. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "count": 5,
           "items": [
            {
             "title": "Mentes artificiais, olá Futuro (Faro municipal library, council)",
             "date": "2026-11-01 to 2026-11-30",
             "url": "https://www.cm-faro.pt/pt/agenda/91716/mentes-artificiais-ola-futuro.aspx",
             "read_on": "2026-11-15",
             "ai_path": "A month-long library event whose title points to AI, and the page gives no programme, so directly about AI as far as the title shows."
            },
            {
             "title": "Novembro Digital, an exhibition on artificial intelligence (Alliance Française de l'Algarve, IPDJ Faro)",
             "date": "2026-11-06 to 2026-11-30",
             "url": "https://www.cm-faro.pt/pt/agenda/91707/novembro-digital.aspx",
             "read_on": "2026-11-15",
             "ai_path": "An exhibition about AI listed on the council's agenda: directly about AI."
            },
            {
             "title": "Do you know UAlgTec Heritage? (Algarve Evolution, Faro)",
             "date": "2026-11-17",
             "url": "https://www.algarveevolution.pt/event",
             "read_on": "2026-11-15",
             "ai_path": "UAlgTec Heritage is the 31.5 million euro UAlg centre that will use AI on archaeological heritage: one step from AI. The listing gives no programme."
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_sources_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/sources.json",
    "description": "The sources Faro's agent reads, and every host its facts rest on. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "listed": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": [
               "null",
               "string"
              ]
             }
            },
            "required": [
             "name",
             "url",
             "kind",
             "feed"
            ]
           }
          },
          "hosts": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "host": {
              "type": "string"
             },
             "facts": {
              "type": "integer"
             }
            },
            "required": [
             "host",
             "facts"
            ]
           }
          },
          "gravity": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             }
            },
            "required": [
             "title",
             "url",
             "read_on"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "listed",
          "hosts",
          "gravity"
         ],
         "x-inferred": true
        },
        "examples": {
         "sources": {
          "summary": "/api/v1/places/faro/sources.json",
          "description": "https://promptugal.news/api/v1/places/faro/sources.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "The sources Faro's agent reads, and every host its facts rest on. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "listed": [
            {
             "name": "Câmara Municipal de Faro",
             "url": "https://www.cm-faro.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento: Faro section",
             "url": "https://www.barlavento.pt/algarve/faro/",
             "kind": "press",
             "feed": "https://www.barlavento.pt/feed/"
            },
            {
             "name": "Barlavento: AI tag",
             "url": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/",
             "kind": "press",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 23
            },
            {
             "host": "ualg.pt",
             "facts": 3
            },
            {
             "host": "cm-faro.pt",
             "facts": 3
            }
           ],
           "gravity": [
            {
             "title": "UAlg secures 31.5 million euros for an archaeological innovation centre using AI (Barlavento, 23 April 2026)",
             "url": "https://www.barlavento.pt/?p=397911",
             "read_on": "2026-11-15"
            },
            {
             "title": "UAlg defines rules and principles for the use of AI (Universidade do Algarve, 24 September 2026)",
             "url": "https://www.ualg.pt/ualg-define-regras-e-principios-para-utilizacao-da-inteligencia-artificial",
             "read_on": "2026-11-15"
            },
            {
             "title": "AuroraMed launches an AI in health course with UAlg (Barlavento, 19 March 2026)",
             "url": "https://www.barlavento.pt/auroramed-lanca-curso-de-ia-na-saude-com-a-ualg/",
             "read_on": "2026-11-15"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_agents_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/agents.json",
    "description": "The agents that keep Faro, drawn only from the record: places.json, each agent's status.json, its run reports and the conductor's place-agents.json. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "agents": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "agent": {
              "type": "string"
             },
             "role": {
              "type": "string"
             },
             "part": {
              "type": "string"
             },
             "model": {
              "type": "string"
             },
             "state": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "focus": {
              "type": "string"
             },
             "done": {
              "type": "integer"
             },
             "next": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "status_file": {
              "type": "string",
              "format": "uri"
             },
             "runs": {
              "type": "integer"
             },
             "last_run": {
              "type": "string"
             }
            },
            "required": [
             "agent",
             "role",
             "part",
             "model",
             "state",
             "updated",
             "focus",
             "done",
             "next",
             "status_file",
             "runs",
             "last_run"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "agents"
         ],
         "x-inferred": true
        },
        "examples": {
         "agents": {
          "summary": "/api/v1/places/faro/agents.json",
          "description": "https://promptugal.news/api/v1/places/faro/agents.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "The agents that keep Faro, drawn only from the record: places.json, each agent's status.json, its run reports and the conductor's place-agents.json. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "agents": [
            {
             "agent": "place.faro@PrompTugal.dinis",
             "role": "place.faro",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "page live (3 passes), first article published, inbox drained (3 messages, none signed by a team key)",
             "updated": "2026-11-16T00:30Z",
             "focus": "Faro's site at promptugal.news/algarve/faro/ (data/by-place/faro.json): centre of gravity (Universidade do Algarve), the AI map, local AI news, events, sources, gaps and voice",
             "done": 6,
             "next": [
              "Article 2 (candidate: the Vibathon and Algarve Evolution in Faro, once a source other than the insider account exists)",
              "Deepen the map: UAlg research units, Faro hospital, council AI use",
              "Provenance captures with data.places@"
             ],
             "status_file": "https://promptugal.news/board/team/place.faro/status.json",
             "runs": 4,
             "last_run": "board/runs/place.faro/2026-11-16T00-08-05Z.json"
            },
            {
             "agent": "dev.places@PrompTugal.dinis",
             "role": "dev.places",
             "part": "shared by every place",
             "model": "Opus",
             "state": "talk pane: security@'s must-fix 1 done, waiting on its go and the conductor's must-fix 2 before enabled true; topics bug that held place articles fixed",
             "updated": "2026-11-16T00:40Z",
             "focus": "the by-place frame (/algarve/, /algarve/<town>/, /portugal/) and the whole site's finish for Dinis's Algarve Evolution demo, 16 November 2026",
             "done": 19,
             "next": [
              "security@'s review of talk: flip assets/talk/talk.json enabled to true on its pass",
              "city-stats panel on place pages once observability@ publishes stats.json",
              "datasci.places@'s audit findings; ios.places@'s conductor-report/v1 schema for agents.json"
             ],
             "status_file": "https://promptugal.news/board/team/dev.places/status.json",
             "runs": 11,
             "last_run": "board/runs/dev.places/2026-11-16T00-13-03Z.json"
            },
            {
             "agent": "designer.places@PrompTugal.dinis",
             "role": "designer.places",
             "part": "shared by every place",
             "model": "Opus",
             "state": "show-the-power brief (Dinis, 22:45 UTC): news-like pages, Loulé and Faro the showpieces; images wait on a budget line and my grant",
             "updated": "2026-11-16T00:55Z",
             "focus": "designer.places@: each town's look inside brand v2.0 on /algarve/ and /algarve/<town>/, and the demo for Dinis's meeting with Algarve Evolution (16 November)",
             "done": 10,
             "next": [
              "once accountant@ and abp@ agree: one AI-made image per town (Loulé and Faro first), labelled AI-made with the model, logged with its cost, within 15 USD",
              "Loulé and Faro as showpieces: re-shoot after each place pass, polish what they add",
              "check viz.places@'s panel on phone and desktop when it lands"
             ],
             "status_file": "https://promptugal.news/board/team/designer.places/status.json",
             "runs": 5,
             "last_run": "board/runs/designer.places/2026-11-16T00-44-28Z.json"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_provenance_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/provenance.json",
    "description": "Where each of Faro's facts comes from: one row per fact with its source, the date it was read and who kept it, and the file it lives in with its hash and signature. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "file": {
           "type": "object",
           "properties": {
            "path": {
             "type": "string"
            },
            "raw": {
             "type": "string"
            },
            "sha256": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            },
            "updated": {
             "type": "string"
            },
            "by": {
             "type": "string"
            }
           },
           "required": [
            "path",
            "raw",
            "sha256",
            "signature",
            "key_id",
            "signed_by",
            "keys",
            "updated",
            "by"
           ]
          },
          "facts": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "source": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "date": {
              "type": [
               "string",
               "null"
              ],
              "format": "date"
             },
             "steps": {
              "type": [
               "integer",
               "null"
              ]
             },
             "by": {
              "type": "string"
             },
             "host": {
              "type": "string"
             }
            },
            "required": [
             "kind",
             "label",
             "url",
             "source",
             "read_on",
             "date",
             "steps",
             "by",
             "host"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "file",
          "facts"
         ],
         "x-inferred": true
        },
        "examples": {
         "provenance": {
          "summary": "/api/v1/places/faro/provenance.json",
          "description": "https://promptugal.news/api/v1/places/faro/provenance.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "Where each of Faro's facts comes from: one row per fact with its source, the date it was read and who kept it, and the file it lives in with its hash and signature. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "file": {
            "path": "data/by-place/faro.json",
            "raw": "https://promptugal.news/data/by-place/faro.json",
            "sha256": "c0027f0afffbc9aea220b221f4d7e77c140cbcf36b104261199b287ab1d5f7bc",
            "signature": "valid",
            "key_id": "site.faro-promptugal",
            "signed_by": "place.faro@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-15",
            "by": "place.faro@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "DevFest in Faro spends two days on agentic AI",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "source": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "date": "2026-11-06",
             "steps": 0,
             "by": "place.faro@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "source": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "date": "2026-10-31",
             "steps": 0,
             "by": "place.faro@PrompTugal.dinis",
             "host": "newsroom.sgit.ai"
            },
            {
             "kind": "story",
             "label": "Faro's Cáritas asks who benefits from AI",
             "url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
             "source": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
             "read_on": "2026-11-15",
             "date": "2026-10-22",
             "steps": 0,
             "by": "place.faro@PrompTugal.dinis",
             "host": "barlavento.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/faro/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_quality_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/faro/quality.json",
    "description": "The data quality of Faro: coverage, freshness and sources per fact. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; follows `data/schemas/datasci-quality.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/datasci-quality"
        },
        "examples": {
         "quality": {
          "summary": "/api/v1/places/faro/quality.json",
          "description": "https://promptugal.news/api/v1/places/faro/quality.json",
          "value": {
           "id": "faro",
           "name": "Faro",
           "about": "The data quality of Faro: coverage, freshness and sources per fact. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/faro/index.json",
           "kind": "municipality",
           "agent": "place.faro@PrompTugal.dinis",
           "status": "live",
           "counts": {
            "facts": 35,
            "stories": 14,
            "ai_map": 16,
            "events": 5,
            "figures": 0,
            "sources_listed": 9,
            "gaps": 7,
            "articles": 1
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 234,
            "fields_expected": 235,
            "by_kind": {
             "story": {
              "items": 14,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 16,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 5,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "read_on": 1,
               "ai_path": 0.8
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 0.97
           },
           "freshness": {
            "updated": "2026-11-15",
            "days_since_update": 1,
            "newest_read": "2026-11-15",
            "oldest_read": "2026-11-15",
            "median_read_age_days": 1,
            "read_in_last_7_days": 1,
            "median_story_age_days": 94.5
           },
           "sources": {
            "distinct_hosts": 7,
            "sources_per_fact": 1.09,
            "top_host": "barlavento.pt",
            "top_host_share": 0.66,
            "concentration_hhi": 0.45,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 23
             },
             {
              "host": "ualg.pt",
              "facts": 3
             },
             {
              "host": "cm-faro.pt",
              "facts": 3
             }
            ]
           },
           "ai_path_steps": {
            "0": 17,
            "1": 13
           },
           "score": {
            "value": 91,
            "parts": {
             "completeness": 1,
             "freshness": 0.97,
             "diversity": 0.68,
             "volume": 1
            }
           },
           "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."
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/data/places/faro.json": {
   "get": {
    "operationId": "get_api_v1_data_places_faro_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/faro.json",
    "description": "Faro on PrompTugal.news as data: its rows in each table, and its graph within two steps (not counting located_in). Rows are arrays in the order of `columns`; the columns are documented in api/v1/data/index.json.\n\nMade by the build's `data-places` feature; follows `data/schemas/data-place.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/data-place"
        },
        "examples": {
         "faro": {
          "summary": "/api/v1/data/places/faro.json",
          "description": "https://promptugal.news/api/v1/data/places/faro.json",
          "value": {
           "about": "Faro on PrompTugal.news as data: its rows in each table, and its graph within two steps (not counting located_in). Rows are arrays in the order of `columns`; the columns are documented in api/v1/data/index.json.",
           "id": "faro",
           "name": "Faro",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/faro.json",
           "page": "query/faro/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "faro"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "faro"
              ],
              [
               "faro"
              ],
              [
               "faro"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "faro"
              ],
              [
               "faro"
              ],
              [
               "faro"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": [
              [
               "faro"
              ],
              [
               "faro"
              ],
              [
               "faro"
              ]
             ]
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "faro"
              ],
              [
               "faro"
              ],
              [
               "faro"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "faro"
              ],
              [
               "faro"
              ],
              [
               "faro"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "place:algarve"
              ],
              [
               "place:faro"
              ],
              [
               "place:lagos"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "located_in:place:faro:place:algarve"
              ],
              [
               "located_in:place:lagos:place:algarve"
              ],
              [
               "located_in:place:portimao:place:algarve"
              ]
             ]
            }
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "data-places"
   }
  },
  "/api/v1/by-place/index.json": {
   "get": {
    "operationId": "get_api_v1_by_place_index_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/index.json",
    "description": "PrompTugal.news by place: each place, its status, its agent, its counts, its page and its own JSON (api/v1/by-place/<id>.json)\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "places": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "kind": {
              "type": "string"
             },
             "parent": {
              "type": [
               "null",
               "string"
              ]
             },
             "path": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string",
              "format": "date"
             },
             "ai_news": {
              "type": "integer"
             },
             "ai_map": {
              "type": "integer"
             },
             "articles": {
              "type": "integer"
             },
             "page": {
              "type": "string",
              "format": "uri"
             },
             "api": {
              "type": "string",
              "format": "uri"
             },
             "at": {
              "type": [
               "null",
               "object"
              ],
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "accent": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "identity": {
              "type": "object",
              "properties": {
               "key_id": {
                "type": "string"
               },
               "signed_by": {
                "type": "string"
               }
              },
              "required": [
               "key_id",
               "signed_by"
              ]
             },
             "signature": {
              "type": "string"
             }
            },
            "required": [
             "id",
             "name",
             "kind",
             "parent",
             "path",
             "agent",
             "status",
             "updated",
             "ai_news",
             "ai_map",
             "articles",
             "page",
             "api",
             "at",
             "accent",
             "landmark",
             "identity",
             "signature"
            ]
           }
          }
         },
         "required": [
          "about",
          "version",
          "built",
          "places"
         ],
         "x-inferred": true
        },
        "examples": {
         "index": {
          "summary": "/api/v1/by-place/index.json",
          "description": "https://promptugal.news/api/v1/by-place/index.json",
          "value": {
           "about": "PrompTugal.news by place: each place, its status, its agent, its counts, its page and its own JSON (api/v1/by-place/<id>.json)",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "places": [
            {
             "id": "portugal",
             "name": "Portugal",
             "kind": "country",
             "parent": null,
             "path": "portugal/",
             "agent": "place.portugal@PrompTugal.dinis",
             "status": "researching",
             "updated": "2026-11-15",
             "ai_news": 18,
             "ai_map": 35,
             "articles": 0,
             "page": "https://promptugal.news/portugal/",
             "api": "https://promptugal.news/api/v1/by-place/portugal.json",
             "at": null,
             "accent": "#0B5D3B",
             "landmark": "Torre de Belém",
             "identity": {
              "key_id": "site.portugal-promptugal",
              "signed_by": "place.portugal@PrompTugal.dinis"
             },
             "signature": "valid"
            },
            {
             "id": "algarve",
             "name": "The Algarve",
             "kind": "region",
             "parent": "portugal",
             "path": "algarve/",
             "agent": "place.algarve@PrompTugal.dinis",
             "status": "researching",
             "updated": "2026-11-15",
             "ai_news": 18,
             "ai_map": 27,
             "articles": 4,
             "page": "https://promptugal.news/algarve/",
             "api": "https://promptugal.news/api/v1/by-place/algarve.json",
             "at": null,
             "accent": "#0B5C7A",
             "landmark": "Ponta da Piedade and the Faro lagoon",
             "identity": {
              "key_id": "site.algarve-promptugal",
              "signed_by": "place.algarve@PrompTugal.dinis"
             },
             "signature": "valid"
            },
            {
             "id": "faro",
             "name": "Faro",
             "kind": "municipality",
             "parent": "algarve",
             "path": "algarve/faro/",
             "agent": "place.faro@PrompTugal.dinis",
             "status": "live",
             "updated": "2026-11-15",
             "ai_news": 14,
             "ai_map": 16,
             "articles": 1,
             "page": "https://promptugal.news/algarve/faro/",
             "api": "https://promptugal.news/api/v1/by-place/faro.json",
             "at": {
              "lon": -7.935,
              "lat": 37.019
             },
             "accent": "#0B5C7A",
             "landmark": "Arco da Vila, the neoclassical gate into Faro's old town",
             "identity": {
              "key_id": "site.faro-promptugal",
              "signed_by": "place.faro@PrompTugal.dinis"
             },
             "signature": "valid"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_quality_json",
    "tags": [
     "Faro"
    ],
    "summary": "/api/v1/places/quality.json",
    "description": "The data quality of every place on PrompTugal.news, one row each: coverage of the fields each fact should carry, freshness of the reads, and how many independent sources the facts rest on. Computed at every build from the place agents' files. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; follows `data/schemas/datasci-quality-all.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/datasci-quality-all"
        },
        "examples": {
         "quality": {
          "summary": "/api/v1/places/quality.json",
          "description": "https://promptugal.news/api/v1/places/quality.json",
          "value": {
           "about": "The data quality of every place on PrompTugal.news, one row each: coverage of the fields each fact should carry, freshness of the reads, and how many independent sources the facts rest on. Computed at every build from the place agents' files. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "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."
           },
           "summary": {
            "places": 19,
            "facts": 373,
            "median_score": 87,
            "min_score": 79,
            "max_score": 99,
            "median_coverage": 1,
            "median_read_age_days": 1
           },
           "columns": [
            "id",
            "name",
            "kind"
           ],
           "rows": [
            [
             "portugal",
             "Portugal",
             "country"
            ],
            [
             "algarve",
             "The Algarve",
             "region"
            ],
            [
             "faro",
             "Faro",
             "municipality"
            ]
           ],
           "places": [
            {
             "id": "portugal",
             "name": "Portugal",
             "score": 99,
             "quality": "https://promptugal.news/api/v1/places/portugal/quality.json"
            },
            {
             "id": "algarve",
             "name": "The Algarve",
             "score": 97,
             "quality": "https://promptugal.news/api/v1/places/algarve/quality.json"
            },
            {
             "id": "faro",
             "name": "Faro",
             "score": 91,
             "quality": "https://promptugal.news/api/v1/places/faro/quality.json"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/data/index.json": {
   "get": {
    "operationId": "get_api_v1_data_index_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/index.json",
    "description": "PrompTugal.news as data: every table, its columns and where to fetch it; the graph traversals the query page offers; the example queries. Rows are arrays in the order of `columns`.\n\nMade by the build's `data-places` feature; follows `data/schemas/data-index.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/data-index"
        },
        "examples": {
         "index": {
          "summary": "/api/v1/data/index.json",
          "description": "https://promptugal.news/api/v1/data/index.json",
          "value": {
           "about": "PrompTugal.news as data: every table, its columns and where to fetch it; the graph traversals the query page offers; the example queries. Rows are arrays in the order of `columns`.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "by": "data.places@PrompTugal.dinis",
           "page": "query/index.html",
           "engine": [
            "assets/query/sql.js",
            "assets/query/graph.js"
           ],
           "tables": [
            {
             "name": "places",
             "about": "One row per place of PrompTugal.news by place (data/by-place/places.json and each place's file): the country, the Algarve and its towns.",
             "url": "api/v1/data/tables/places.json",
             "count": 19,
             "columns": [
              {
               "name": "id",
               "type": "text",
               "about": "the place's id, as in data/by-place/<id>.json"
              },
              {
               "name": "name",
               "type": "text",
               "about": "its name"
              },
              {
               "name": "kind",
               "type": "text",
               "about": "country, region or municipality"
              }
             ]
            },
            {
             "name": "news",
             "about": "Every local AI story on a place's page (ai_news), with its source, when it was read and its path to AI.",
             "url": "api/v1/data/tables/news.json",
             "count": 114,
             "columns": [
              {
               "name": "place",
               "type": "text",
               "about": "the place's id"
              },
              {
               "name": "n",
               "type": "integer",
               "about": "its position in the place's file"
              },
              {
               "name": "node",
               "type": "text",
               "about": "its node in the graph (news:<hash of its URL>)"
              }
             ]
            },
            {
             "name": "map",
             "about": "Every entry of a place's AI map (ai_map): companies, startups, institutions, communities and public bodies, with the source that supports it.",
             "url": "api/v1/data/tables/map.json",
             "count": 179,
             "columns": [
              {
               "name": "place",
               "type": "text",
               "about": "the place's id"
              },
              {
               "name": "n",
               "type": "integer",
               "about": "its position in the place's file"
              },
              {
               "name": "node",
               "type": "text",
               "about": "the node it resolves to: a company:, organisation: of the graph, or local:<slug>"
              }
             ]
            }
           ],
           "functions": [
            {
             "name": "neighbours",
             "args": [
              "start",
              "depth",
              "verbs?"
             ],
             "columns": [
              "id",
              "type",
              "label"
             ]
            },
            {
             "name": "paths",
             "args": [
              "from",
              "to",
              "max_depth?"
             ],
             "columns": [
              "n",
              "hops",
              "path"
             ]
            }
           ],
           "places": [
            {
             "id": "portugal",
             "name": "Portugal",
             "url": "api/v1/data/places/portugal.json",
             "page": "query/portugal/index.html"
            },
            {
             "id": "algarve",
             "name": "The Algarve",
             "url": "api/v1/data/places/algarve.json",
             "page": "query/algarve/index.html"
            },
            {
             "id": "faro",
             "name": "Faro",
             "url": "api/v1/data/places/faro.json",
             "page": "query/faro/index.html"
            }
           ],
           "examples": [
            {
             "id": "map-by-town",
             "title": "The AI map of the Algarve, by town and kind",
             "about": "How many organisations each place's agent has mapped, by kind.",
             "sql": "SELECT p.name AS place, m.kind, count(*) AS entries\nFROM map m JOIN places p ON p.id = m.place\nGROUP BY p.name, m.kind\nORDER BY entries DESC, place\nLIMIT 20"
            },
            {
             "id": "shared",
             "title": "Who is on more than one town's AI map",
             "about": "Connecting the dots: the organisations that several place agents found on their own, merged by name.",
             "sql": "SELECT n.label AS organisation, n.kind, count(DISTINCT e.dst) AS towns,\n       group_concat(DISTINCT replace(e.dst, 'place:', '')) AS places\nFROM edges e JOIN nodes n ON n.id = e.src\nWHERE e.verb = 'on_ai_map_of'\nGROUP BY n.id\nHAVING towns > 1\nORDER BY towns DESC, organisation"
            },
            {
             "id": "detectives",
             "title": "What the detectives connected, and how sure they are",
             "about": "detective.places@'s links, each end resolved to a node of the graph; 'read' means the page itself was opened, 'search_extract' only a search result.",
             "sql": "SELECT a.label AS from_node, c.verb, b.label AS to_node, c.verified, c.places\nFROM connections c\nJOIN nodes a ON a.id = c.src\nJOIN nodes b ON b.id = c.dst\nORDER BY c.verified, a.label"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "data-places"
   }
  },
  "/api/v1/data/tables/{slug}.json": {
   "get": {
    "operationId": "get_api_v1_data_tables_slug_json",
    "tags": [
     "data"
    ],
    "summary": "18 files: /api/v1/data/tables/{slug}.json",
    "description": "The sources and feeds each place's agent reads (sources), and how many of the place's items rest on each host.\n\nMade by the build's `data-places` feature; follows `data/schemas/data-table.schema.json`.",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "One of the 18 values the build wrote (for example places, news, map).",
      "schema": {
       "type": "string",
       "enum": [
        "articles",
        "captures",
        "companies",
        "connections",
        "edges",
        "events",
        "gaps",
        "map",
        "merges",
        "news",
        "nodes",
        "nr_articles",
        "nr_edges",
        "nr_links",
        "nr_nodes",
        "place_items",
        "places",
        "sources"
       ]
      },
      "example": "sources"
     }
    ],
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/data-table"
        },
        "examples": {
         "sources": {
          "summary": "/api/v1/data/tables/sources.json",
          "description": "https://promptugal.news/api/v1/data/tables/sources.json",
          "value": {
           "table": "sources",
           "about": "The sources and feeds each place's agent reads (sources), and how many of the place's items rest on each host.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "columns": [
            {
             "name": "place",
             "type": "text",
             "about": "the place's id"
            },
            {
             "name": "n",
             "type": "integer",
             "about": "its position"
            },
            {
             "name": "name",
             "type": "text",
             "about": "its name"
            }
           ],
           "count": 162,
           "rows": [
            [
             "portugal",
             1,
             "Portugal.gov.pt news"
            ],
            [
             "portugal",
             2,
             "FCT (Foundation for Science and Technology)"
            ],
            [
             "portugal",
             3,
             "INESC-ID news"
            ]
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 18,
    "x-feature": "data-places"
   }
  },
  "/api/v1/places/faro/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_faro_openapi_json",
    "tags": [
     "meta"
    ],
    "summary": "This document.",
    "responses": {
     "200": {
      "description": "An OpenAPI 3.1 document.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "api-entity": {
    "title": "An entity (/api/v1/<type>/<slug>.json)",
    "type": "object",
    "required": [
     "id",
     "ref",
     "type",
     "label",
     "page",
     "graph"
    ],
    "properties": {
     "id": {
      "type": "string",
      "minLength": 1
     },
     "ref": {
      "$ref": "#/components/schemas/common/$defs/ref"
     },
     "type": {
      "type": "string",
      "minLength": 1
     },
     "label": {
      "type": "string",
      "minLength": 1
     },
     "page": {
      "type": [
       "string",
       "null"
      ]
     },
     "graph": {
      "type": [
       "string",
       "null"
      ]
     }
    },
    "additionalProperties": true
   },
   "common": {
    "title": "Shared definitions",
    "$defs": {
     "slug": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9-]*$"
     },
     "date": {
      "type": "string",
      "format": "date"
     },
     "datetime": {
      "type": "string",
      "format": "date-time"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "url_or_path": {
      "type": "string",
      "pattern": "^(https?://\\S+|[a-z0-9_./-]+)$"
     },
     "agent": {
      "type": "string",
      "pattern": "^[a-z0-9-]+(\\.[a-z0-9-]+)*@(web-summit|PrompTugal)(\\.[a-z0-9-]+)?$"
     },
     "ref": {
      "type": "string",
      "pattern": "^(company|organisation|person|event|place|topic|story|evidence|article|day|track|fact|source|product):[A-Za-z0-9][A-Za-z0-9-]*$"
     },
     "company_ref": {
      "type": "string",
      "pattern": "^company:[a-z0-9-]+$"
     },
     "org_ref": {
      "type": "string",
      "pattern": "^(company|organisation):[a-z0-9-]+$"
     },
     "place_ref": {
      "type": "string",
      "pattern": "^place:[a-z0-9-]+$"
     },
     "topic_ref": {
      "type": "string",
      "pattern": "^topic:[a-z0-9-]+$"
     },
     "event_ref": {
      "type": "string",
      "pattern": "^event:[a-z0-9-]+$"
     },
     "derived": {
      "type": "object",
      "required": [
       "by",
       "from"
      ],
      "properties": {
       "by": {
        "type": "string",
        "minLength": 1
       },
       "from": {
        "type": "array",
        "items": {
         "type": "string",
         "minLength": 1
        }
       },
       "item": {
        "type": "integer"
       }
      },
      "additionalProperties": false
     },
     "schema_link": {
      "type": "string"
     },
     "read_at": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/common/$defs/datetime"
       },
       {
        "$ref": "#/components/schemas/common/$defs/date"
       }
      ],
      "description": "when it was read: a UTC time, or a day where the reader recorded only the day"
     }
    }
   },
   "data-index": {
    "title": "The index of PrompTugal.news's queryable data (api/v1/data/index.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: every table with its columns and address, the graph functions, the places and the example queries.",
    "type": "object",
    "required": [
     "about",
     "version",
     "tables",
     "functions",
     "places",
     "examples"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "by": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "engine": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "tables": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "about",
        "url",
        "count",
        "columns"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "about": {
         "type": "string"
        },
        "url": {
         "type": "string"
        },
        "count": {
         "type": "integer"
        },
        "columns": {
         "type": "array"
        }
       }
      }
     },
     "functions": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "args",
        "columns"
       ]
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "url",
        "page"
       ]
      }
     },
     "examples": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "title",
        "sql"
       ]
      }
     }
    }
   },
   "data-place": {
    "title": "One place's database (api/v1/data/places/<id>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: the place's rows in each table and its graph within two steps. Columns are documented in api/v1/data/index.json.",
    "type": "object",
    "required": [
     "about",
     "id",
     "name",
     "version",
     "source",
     "tables"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "tables": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "required": [
        "columns",
        "rows"
       ],
       "properties": {
        "columns": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "rows": {
         "type": "array",
         "items": {
          "type": "array"
         }
        }
       }
      }
     }
    }
   },
   "data-table": {
    "title": "One table of PrompTugal.news's queryable data (api/v1/data/tables/<name>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026. Rows are arrays in the order of columns. Made by newsroom/build/features/data-places.mjs.",
    "type": "object",
    "required": [
     "table",
     "about",
     "version",
     "columns",
     "count",
     "rows"
    ],
    "properties": {
     "table": {
      "type": "string",
      "pattern": "^[a-z_]+$"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "type",
        "about"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "type": {
         "enum": [
          "text",
          "integer",
          "real"
         ]
        },
        "about": {
         "type": "string"
        }
       }
      }
     },
     "count": {
      "type": "integer"
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     }
    }
   },
   "datasci-place-index": {
    "title": "A place's REST root (api/v1/places/<id>/index.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: what the place is, its counts, its quality score and every GET endpoint that serves its data.",
    "type": "object",
    "required": [
     "id",
     "name",
     "about",
     "version",
     "kind",
     "agent",
     "status",
     "page",
     "counts",
     "score",
     "swagger",
     "endpoints"
    ],
    "properties": {
     "id": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$"
     },
     "name": {
      "type": "string"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "place": {
      "type": "string",
      "format": "uri"
     },
     "kind": {
      "enum": [
       "country",
       "region",
       "municipality",
       "city"
      ]
     },
     "parent": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "inside": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "agent": {
      "type": "string"
     },
     "status": {
      "enum": [
       "live",
       "researching",
       "stub"
      ]
     },
     "updated": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "page": {
      "type": "string",
      "format": "uri"
     },
     "at": {
      "anyOf": [
       {
        "type": "null"
       },
       {
        "type": "object",
        "required": [
         "lon",
         "lat"
        ],
        "properties": {
         "lon": {
          "type": "number"
         },
         "lat": {
          "type": "number"
         }
        }
       }
      ]
     },
     "accent": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
     },
     "counts": {
      "type": "object",
      "required": [
       "ai_news",
       "ai_map",
       "events",
       "sources",
       "articles",
       "facts"
      ],
      "properties": {
       "ai_news": {
        "type": "integer",
        "minimum": 0
       },
       "ai_map": {
        "type": "integer",
        "minimum": 0
       },
       "events": {
        "type": "integer",
        "minimum": 0
       },
       "sources": {
        "type": "integer",
        "minimum": 0
       },
       "articles": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "score": {
      "type": "integer",
      "minimum": 0
     },
     "swagger": {
      "type": "string",
      "format": "uri"
     },
     "endpoints": {
      "type": "object",
      "required": [
       "index",
       "page",
       "stories",
       "ai_map",
       "events",
       "sources",
       "agents",
       "provenance",
       "quality",
       "openapi",
       "record"
      ],
      "additionalProperties": {
       "type": "string",
       "format": "uri"
      }
     }
    }
   },
   "datasci-quality": {
    "title": "A place's data quality (api/v1/places/<id>/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: coverage of the fields each fact should carry, freshness of the reads, and the sources the facts rest on, with the method.",
    "type": "object",
    "required": [
     "id",
     "name",
     "version",
     "counts",
     "coverage",
     "freshness",
     "sources",
     "score",
     "method"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "counts": {
      "type": "object",
      "required": [
       "facts"
      ],
      "properties": {
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "coverage": {
      "type": "object",
      "required": [
       "overall",
       "fields_filled",
       "fields_expected",
       "by_kind"
      ],
      "properties": {
       "overall": {
        "anyOf": [
         {
          "type": "number",
          "minimum": 0
         },
         {
          "type": "null"
         }
        ]
       },
       "fields_filled": {
        "type": "integer",
        "minimum": 0
       },
       "fields_expected": {
        "type": "integer",
        "minimum": 0
       },
       "by_kind": {
        "type": "object"
       }
      }
     },
     "freshness": {
      "type": "object",
      "required": [
       "median_read_age_days"
      ],
      "properties": {
       "median_read_age_days": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       }
      }
     },
     "sources": {
      "type": "object",
      "required": [
       "distinct_hosts",
       "by_host"
      ],
      "properties": {
       "distinct_hosts": {
        "type": "integer",
        "minimum": 0
       },
       "by_host": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "host",
          "facts"
         ],
         "properties": {
          "host": {
           "type": "string"
          },
          "facts": {
           "type": "integer",
           "minimum": 1
          }
         }
        }
       }
      }
     },
     "score": {
      "type": "object",
      "required": [
       "value",
       "parts"
      ],
      "properties": {
       "value": {
        "type": "integer",
        "minimum": 0
       },
       "parts": {
        "type": "object"
       }
      }
     },
     "method": {
      "type": "object",
      "required": [
       "coverage",
       "freshness",
       "sources",
       "score"
      ]
     }
    }
   },
   "datasci-quality-all": {
    "title": "The data quality of every place (api/v1/places/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: one row per place, columns named once, the summary and the method.",
    "type": "object",
    "required": [
     "about",
     "version",
     "method",
     "summary",
     "columns",
     "rows",
     "places"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "method": {
      "type": "object"
     },
     "summary": {
      "type": "object",
      "required": [
       "places",
       "facts"
      ],
      "properties": {
       "places": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "minItems": 1
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "score",
        "quality"
       ]
      }
     }
    }
   }
  }
 },
 "x-place": {
  "id": "faro",
  "name": "Faro",
  "kind": "municipality",
  "agent": "place.faro@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/faro/index.json",
   "page": "https://promptugal.news/api/v1/places/faro/page.json",
   "stories": "https://promptugal.news/api/v1/places/faro/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/faro/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/faro/events.json",
   "sources": "https://promptugal.news/api/v1/places/faro/sources.json",
   "agents": "https://promptugal.news/api/v1/places/faro/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/faro/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/faro/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/faro/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/faro.json",
   "tables": "https://promptugal.news/api/v1/data/places/faro.json"
  }
 }
}
