{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Vila Real de Santo António: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/vila-real-de-santo-antonio/ shows, as GET calls: its REST root (/api/v1/places/vila-real-de-santo-antonio/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.vila-real-de-santo-antonio@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Vila Real de Santo António'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": "Vila Real de Santo António",
   "description": "Vila Real de Santo António'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 Vila Real de Santo António",
  "url": "https://promptugal.news/algarve/vila-real-de-santo-antonio/"
 },
 "paths": {
  "/api/v1/by-place/vila-real-de-santo-antonio.json": {
   "get": {
    "operationId": "get_api_v1_by_place_vila_real_de_santo_antonio_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/vila-real-de-santo-antonio.json",
    "description": "PrompTugal.news Vila Real de Santo António: 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"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "read_on": {
              "type": "string"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string"
               },
               "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"
              ]
             }
            },
            "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"
          },
          "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",
           "items": {
            "type": "object",
            "properties": {
             "label": {
              "type": "string"
             },
             "value": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             }
            },
            "required": [
             "label",
             "value",
             "source_url",
             "read_on"
            ]
           }
          },
          "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"
          },
          "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": {
         "vila-real-de-santo-antonio": {
          "summary": "/api/v1/by-place/vila-real-de-santo-antonio.json",
          "description": "https://promptugal.news/api/v1/by-place/vila-real-de-santo-antonio.json",
          "value": {
           "about": "PrompTugal.news Vila Real de Santo António: 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": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-16",
           "by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/vila-real-de-santo-antonio/",
           "twin": "https://promptugal.news/algarve/vila-real-de-santo-antonio/index.md",
           "raw": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
           "at": {
            "lon": -7.418,
            "lat": 37.195
           },
           "look": {
            "image": null,
            "accent": "#1F4E79",
            "landmark": "the Pombaline grid town and its riverfront customs house on the Guadiana",
            "motif": "river blue, a ruled grid, a ferry to Spain"
           },
           "mandate": "PrompTugal.news Vila Real de Santo António: AI and technology in Vila Real de Santo António, a Pombaline border town on the Guadiana where cross-border projects count, and what reaches it from the Algarve, Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "Vila Real de Santo António is a planned town on the Guadiana, built from 1773 on a grid and completed in 1776, whose old fishing and canning economy gave way to tourism, with many residents working across the river around Ayamonte in Spain. Today it is pushing to become a national pole of the blue economy, around its fishing port and a shipbuilding yard, and it is wiring its historic centre under ...",
            "sources": [
             {
              "title": "Vila Real de Santo António (history and economy)",
              "url": "https://en.wikipedia.org/wiki/Vila_Real_de_Santo_Ant%C3%B3nio",
              "read_on": "2026-11-15"
             },
             {
              "title": "VRSA instala Wi-Fi gratuito e controlo automóvel no centro histórico (Barlavento)",
              "url": "https://www.barlavento.pt/?p=399594",
              "read_on": "2026-11-15"
             },
             {
              "title": "Câmara Municipal de Vila Real de Santo António (news page, Eurocidade items)",
              "url": "https://www.cm-vrsa.pt",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 2,
            "ai_map": 4,
            "events": 0,
            "sources": 11,
            "articles": 0
           },
           "ai_news": [
            {
             "title": "VRSA wires its historic centre with free Wi-Fi and 16 footfall counters",
             "summary": "The council is installing free Wi-Fi and 16 pedestrian flow monitors in the historic centre, with bollards and information kiosks to follow, as part of a PRR-funded digital shops district worth about 895 thousand euros that targets some 200 businesses. The counters give statistics only and capture no image, video or sound. An online marketplace already lists over a hundred businesses.",
             "date": "2026-05-18",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "ai_path": "The counters and the marketplace produce footfall and sales data for the town centre, which is the raw material for AI forecasting. The article itself mentions no AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=399594",
              "publisher": "Barlavento",
              "published": "2026-05-18",
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Ayamonte's innovation node is meant to reach Vila Real de Santo António",
             "summary": "In a March 2024 interview, the IT manager of Ayamonte's council said the council was preparing an AI virtual assistant for citizens and companies and planning a 2 to 3 million euro innovation node on tourism and digital support for small firms. He described the node as the first to involve a Eurocidade, covering parts of the Portuguese Algarve. This is the council's own account, with no launch dat...",
             "date": "2024-03-15",
             "publisher": "CIO",
             "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "read_on": "2026-11-15",
             "ai_path": "A neighbouring council is building an AI assistant (step 0 for Ayamonte) and an innovation node that would serve the Eurocidade, VRSA included (step 2 for the town).",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
              "publisher": "CIO",
              "published": "2024-03-15",
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Câmara Municipal de Vila Real de Santo António",
             "type": "public body",
             "url": "https://www.cm-vrsa.pt",
             "what": "The council runs the VRSA Digital project (Wi-Fi, footfall counters, online marketplace), a municipal Geoportal launched in January 2025 and a new digital platform for the 2026/2027 school activity offer.",
             "source_url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "ai_path": "A public data owner with live data projects. We found no stated use of AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=399594",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Eurocidade do Guadiana",
             "type": "public body",
             "url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
             "what": "Cross-border grouping of Ayamonte, Castro Marim and Vila Real de Santo António, named European Sport Community 2026. VRSA's council holds its presidency this year.",
             "source_url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
             "read_on": "2026-11-15",
             "ai_path": "The grouping is the vehicle for the cross-border innovation node that Ayamonte's council described, which includes an AI assistant on its own side.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Ayuntamiento de Ayamonte",
             "type": "public body",
             "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "what": "Spanish council across the river, in the Eurocidade with VRSA. In March 2024 it said it was preparing an AI virtual assistant and a Eurocidade innovation node. It sits outside the municipality and is listed as the cross-border neighbour.",
             "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "read_on": "2026-11-15",
             "ai_path": "Its own AI virtual assistant, in preparation as of March 2024.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [],
           "sources": [
            {
             "name": "Câmara Municipal de Vila Real de Santo António",
             "url": "https://www.cm-vrsa.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "VRSA Geoportal (council maps and plans online)",
             "url": "https://websig.cm-vrsa.pt/geoportal",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento",
             "url": "https://www.barlavento.pt",
             "kind": "press",
             "feed": null
            }
           ],
           "extras": [
            {
             "label": "Geoportal",
             "value": "The council launched an online Geoportal in January 2025 for territorial plans, orthophotos and online location plans, with a back office to track issued plans.",
             "source_url": "https://www.barlavento.pt/vrsa-lanca-geoportal-para-modernizar-servicos-e-facilitar-o-acesso-a-informacao/",
             "read_on": "2026-11-15"
            },
            {
             "label": "Footfall privacy",
             "value": "The council says the 16 pedestrian counters capture no image, video or sound and cannot identify individuals.",
             "source_url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15"
            },
            {
             "label": "Blue economy priorities",
             "value": "At a working meeting on 19 February 2026 with the Secretary of State for Fisheries and the Sea, the council set priorities including a shipbuilding and repair cluster area, redevelopment of the fishing port and keeping the Guadiana navigable. The article mentions no technology or AI.",
             "source_url": "https://www.barlavento.pt/vila-real-santo-antonio-polo-nacional-economia-azul/",
             "read_on": "2026-11-15"
            }
           ],
           "gaps": [
            "We found no AI company, startup, lab or community based in Vila Real de Santo António. A town with no AI map is a finding. Search results point to a few small IT service and software firms in the town and in Monte Gordo, listed in business directories, but the directory pages would not open for us (a 503 and a 403), so none is on the map and none is known to offer AI. Where to look next: the Algar...",
            "No local news about AI itself. The two items we carry are about the data groundwork and a Spanish neighbour. We should watch Barlavento, Sul Informação and the council's news page for the first one.",
            "The Ayamonte innovation node comes from a March 2024 interview. We could not confirm whether it launched or whether VRSA companies take part. Ask the Eurocidade and Ayamonte's council."
           ],
           "voice": {
            "lede": "Ó pá, a whole town drawn with a ruler in two years, and now it counts its pedestrians like a careful sardine merchant.",
            "mandate": "PrompTugal.news Vila Real de Santo António: AI and technology in VRSA, the tidy Pombaline town with its feet in the Guadiana and one eye on Spain, plus whatever reaches us from the Algarve, Portugal and the world. Independent, and every fact has its source, pá.",
            "gravity": "Pombal drew this town on a grid from 1773 and it was done by 1776, which is faster than most of us finish a bica. The sardines and tuna gave way to tourism, and plenty of people nip across the river to work near Ayamonte. Now the town wants to be the national capital of the blue economy, with a shipyard on the Guadiana that built a boat for testing robots, Wi-Fi and footfall counters in the centre...",
            "gaps_intro": "Eish, here is what we could not find, and an honest empty net is still a finding."
           },
           "articles": [],
           "team": {
            "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.vila-real-de-santo-antonio/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.vila-real-de-santo-antonio/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.vila-real-de-santo-antonio"
           },
           "identity": {
            "key_id": "site.vila-real-de-santo-antonio-promptugal",
            "signed_by": "place.vila-real-de-santo-antonio@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/vila-real-de-santo-antonio/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_vila_real_de_santo_antonio_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/vila-real-de-santo-antonio/agents.json",
    "description": "The agents behind PrompTugal.news Vila Real de Santo António, 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/vila-real-de-santo-antonio/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/vila-real-de-santo-antonio/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Vila Real de Santo António, 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": "vila-real-de-santo-antonio",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
             "role": "place",
             "state": "first pass written and signed (status researching); keys place.vila-real-de-santo-antonio-promptugal and site.vila-real-de-santo-antonio-promptugal published",
             "updated": "2026-11-16T00:50Z",
             "focus": "data/by-place/vila-real-de-santo-antonio.json, promptugal.news/algarve/vila-real-de-santo-antonio/",
             "done": [
              "session and site keys made and published in board/keys.json",
              "first research pass: 2 AI news items (VRSA Digital footfall and Wi-Fi, 18 May 2026; Ayamonte AI assistant and Eurocidade innovation node, March 2024), 3 AI map entries (council, Eurocidade, Ayamonte council), 7 sources, 6 gaps",
              "file signed with the site key"
             ],
             "next": [
              "Algarve Evolution member list, NERA projects naming VRSA, the Eurocidade innovation node",
              "sea-tech or port digitalisation projects",
              "status live, one article once a 2026 hook exists"
             ],
             "asks": [
              "Dinis: CLAUDE.md now lets public bodies' own contact channels be shown with their source, but my ABP (R8 and Never) still forbids contact details, so I show none. abp@ to update the ABP, or tell me to proceed."
             ],
             "run_reports": 5,
             "status": "https://promptugal.news/board/team/place.vila-real-de-santo-antonio/status.json",
             "commits": [
              {
               "hash": "873aaead2",
               "date": "2026-11-16T00:25:11Z",
               "subject": "place.vila-real-de-santo-antonio@PrompTugal.dinis: local media, starting a company here, more gaps",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/873aaead25686cc06f1db0c935363942d1c3a656"
              },
              {
               "hash": "e1d827a80",
               "date": "2026-11-15T23:24:52Z",
               "subject": "place.vila-real-de-santo-antonio@PrompTugal.dinis: add Nautiber and the blue economy push to the AI map and gravity",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/e1d827a80713a2e4483a7f375bb560bc2711efd8"
              },
              {
               "hash": "18e4af59c",
               "date": "2026-11-15T22:25:36Z",
               "subject": "place.vila-real-de-santo-antonio@PrompTugal.dinis: deepen gaps (local IT firms unverified, no AI teaching found)",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/18e4af59cc8873e356962a12c9c99d9b10360ba2"
              }
             ]
            },
            {
             "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/vila-real-de-santo-antonio/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_vila_real_de_santo_antonio_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/vila-real-de-santo-antonio/articles.json",
    "description": "PrompTugal.news's own articles about Vila Real de Santo António (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"
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "articles": {
          "summary": "/api/v1/by-place/vila-real-de-santo-antonio/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/vila-real-de-santo-antonio/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Vila Real de Santo António (front matter town: or region:), each signed.",
           "place": "vila-real-de-santo-antonio",
           "version": "v0.1.1524",
           "articles": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/vila-real-de-santo-antonio/index.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_index_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/index.json",
    "description": "The REST root of Vila Real de Santo António 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/vila-real-de-santo-antonio/index.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/index.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "The REST root of Vila Real de Santo António 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/vila-real-de-santo-antonio/index.json",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-16",
           "page": "https://promptugal.news/algarve/vila-real-de-santo-antonio/",
           "at": {
            "lon": -7.418,
            "lat": 37.195
           },
           "accent": "#1F4E79",
           "counts": {
            "ai_news": 2,
            "ai_map": 4,
            "events": 0,
            "sources": 11,
            "articles": 0,
            "facts": 10
           },
           "score": 82,
           "swagger": "https://promptugal.news/algarve/vila-real-de-santo-antonio/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/index.json",
            "page": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/page.json",
            "stories": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/events.json",
            "sources": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/sources.json",
            "agents": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/vila-real-de-santo-antonio.json",
            "tables": "https://promptugal.news/api/v1/data/places/vila-real-de-santo-antonio.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/vila-real-de-santo-antonio/page.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_page_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/page.json",
    "description": "The page https://promptugal.news/algarve/vila-real-de-santo-antonio/ 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",
                 "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"
                  },
                  "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"
                 ]
                },
                "name": {
                 "type": "string"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "label": {
                 "type": "string"
                },
                "value": {
                 "type": "string"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": [
                  "null",
                  "string"
                 ]
                }
               }
              }
             },
             "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/vila-real-de-santo-antonio/page.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/page.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "The page https://promptugal.news/algarve/vila-real-de-santo-antonio/ 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/vila-real-de-santo-antonio/index.json",
           "page": "https://promptugal.news/algarve/vila-real-de-santo-antonio/",
           "twin": "https://promptugal.news/algarve/vila-real-de-santo-antonio/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Vila Real de Santo António",
             "landmark": "the Pombaline grid town and its riverfront customs house on the Guadiana",
             "mandate": "PrompTugal.news Vila Real de Santo António: AI and technology in Vila Real de Santo António, a Pombaline border town on the Guadiana where cross-border projects count, and what reaches it from the Algarve, Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Ó pá, a whole town drawn with a ruler in two years, and now it counts its pedestrians like a careful sardine merchant.",
              "mandate": "PrompTugal.news Vila Real de Santo António: AI and technology in VRSA, the tidy Pombaline town with its feet in the Guadiana and one eye on Spain, plus whatever reaches us from the Algarve, Portugal and the world. Independent, and every fact has its source, pá.",
              "gravity": "Pombal drew this town on a grid from 1773 and it was done by 1776, which is faster than most of us finish a bica. The sardines and tuna gave way to tourism, and plenty of people nip across the river to work near Ayamonte. Now the town wants to be the national capital of the blue economy, with a shipyard on the Guadiana that built a boat for testing robots, Wi-Fi and footfall counters in the centre...",
              "gaps_intro": "Eish, here is what we could not find, and an honest empty net is still a finding."
             },
             "status": "researching",
             "updated": "2026-11-16",
             "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
             "accent": "#1F4E79",
             "at": {
              "lon": -7.418,
              "lat": 37.195
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Vila Real de Santo António is a planned town on the Guadiana, built from 1773 on a grid and completed in 1776, whose old fishing and canning economy gave way to tourism, with many residents working across the river around Ayamonte in Spain. Today it is pushing to become a national pole of the blue economy, around its fishing port and a shipbuilding yard, and it is wiring its historic centre under ...",
             "sources": [
              {
               "title": "Vila Real de Santo António (history and economy)",
               "url": "https://en.wikipedia.org/wiki/Vila_Real_de_Santo_Ant%C3%B3nio",
               "read_on": "2026-11-15"
              },
              {
               "title": "VRSA instala Wi-Fi gratuito e controlo automóvel no centro histórico (Barlavento)",
               "url": "https://www.barlavento.pt/?p=399594",
               "read_on": "2026-11-15"
              },
              {
               "title": "Câmara Municipal de Vila Real de Santo António (news page, Eurocidade items)",
               "url": "https://www.cm-vrsa.pt",
               "read_on": "2026-11-15"
              }
             ],
             "voice": "Pombal drew this town on a grid from 1773 and it was done by 1776, which is faster than most of us finish a bica. The sardines and tuna gave way to tourism, and plenty of people nip across the river to work near Ayamonte. Now the town wants to be the national capital of the blue economy, with a shipyard on the Guadiana that built a boat for testing robots, Wi-Fi and footfall counters in the centre..."
            },
            {
             "id": "local",
             "title": "AI in Vila Real de Santo António",
             "items": [
              {
               "title": "VRSA wires its historic centre with free Wi-Fi and 16 footfall counters",
               "summary": "The council is installing free Wi-Fi and 16 pedestrian flow monitors in the historic centre, with bollards and information kiosks to follow, as part of a PRR-funded digital shops district worth about 895 thousand euros that targets some 200 businesses. The counters give statistics only and capture no image, video or sound. An online marketplace already lists over a hundred businesses.",
               "date": "2026-05-18",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/?p=399594",
               "read_on": "2026-11-15",
               "ai_path": "The counters and the marketplace produce footfall and sales data for the town centre, which is the raw material for AI forecasting. The article itself mentions no AI.",
               "steps": 2,
               "provenance": {
                "source_url": "https://www.barlavento.pt/?p=399594",
                "publisher": "Barlavento",
                "published": "2026-05-18",
                "read_on": "2026-11-15",
                "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
                "signature": "valid",
                "site_key": "site.vila-real-de-santo-antonio-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Ayamonte's innovation node is meant to reach Vila Real de Santo António",
               "summary": "In a March 2024 interview, the IT manager of Ayamonte's council said the council was preparing an AI virtual assistant for citizens and companies and planning a 2 to 3 million euro innovation node on tourism and digital support for small firms. He described the node as the first to involve a Eurocidade, covering parts of the Portuguese Algarve. This is the council's own account, with no launch dat...",
               "date": "2024-03-15",
               "publisher": "CIO",
               "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
               "read_on": "2026-11-15",
               "ai_path": "A neighbouring council is building an AI assistant (step 0 for Ayamonte) and an innovation node that would serve the Eurocidade, VRSA included (step 2 for the town).",
               "steps": 2,
               "provenance": {
                "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
                "publisher": "CIO",
                "published": "2024-03-15",
                "read_on": "2026-11-15",
                "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
                "signature": "valid",
                "site_key": "site.vila-real-de-santo-antonio-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/vila-real-de-santo-antonio/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_stories_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/stories.json",
    "description": "Vila Real de Santo António'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"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "read_on": {
              "type": "string"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string"
               },
               "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"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "articles": {
           "type": "array"
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "stories": {
          "summary": "/api/v1/places/vila-real-de-santo-antonio/stories.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/stories.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "Vila Real de Santo António'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/vila-real-de-santo-antonio/index.json",
           "count": 2,
           "items": [
            {
             "title": "VRSA wires its historic centre with free Wi-Fi and 16 footfall counters",
             "summary": "The council is installing free Wi-Fi and 16 pedestrian flow monitors in the historic centre, with bollards and information kiosks to follow, as part of a PRR-funded digital shops district worth about 895 thousand euros that targets some 200 businesses. The counters give statistics only and capture no image, video or sound. An online marketplace already lists over a hundred businesses.",
             "date": "2026-05-18",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "ai_path": "The counters and the marketplace produce footfall and sales data for the town centre, which is the raw material for AI forecasting. The article itself mentions no AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=399594",
              "publisher": "Barlavento",
              "published": "2026-05-18",
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Ayamonte's innovation node is meant to reach Vila Real de Santo António",
             "summary": "In a March 2024 interview, the IT manager of Ayamonte's council said the council was preparing an AI virtual assistant for citizens and companies and planning a 2 to 3 million euro innovation node on tourism and digital support for small firms. He described the node as the first to involve a Eurocidade, covering parts of the Portuguese Algarve. This is the council's own account, with no launch dat...",
             "date": "2024-03-15",
             "publisher": "CIO",
             "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "read_on": "2026-11-15",
             "ai_path": "A neighbouring council is building an AI assistant (step 0 for Ayamonte) and an innovation node that would serve the Eurocidade, VRSA included (step 2 for the town).",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
              "publisher": "CIO",
              "published": "2024-03-15",
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "story"
             }
            }
           ],
           "articles": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/vila-real-de-santo-antonio/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_ai_map_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/ai-map.json",
    "description": "Vila Real de Santo António'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/vila-real-de-santo-antonio/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/ai-map.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "Vila Real de Santo António'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/vila-real-de-santo-antonio/index.json",
           "count": 4,
           "items": [
            {
             "name": "Câmara Municipal de Vila Real de Santo António",
             "type": "public body",
             "url": "https://www.cm-vrsa.pt",
             "what": "The council runs the VRSA Digital project (Wi-Fi, footfall counters, online marketplace), a municipal Geoportal launched in January 2025 and a new digital platform for the 2026/2027 school activity offer.",
             "source_url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "ai_path": "A public data owner with live data projects. We found no stated use of AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=399594",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Eurocidade do Guadiana",
             "type": "public body",
             "url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
             "what": "Cross-border grouping of Ayamonte, Castro Marim and Vila Real de Santo António, named European Sport Community 2026. VRSA's council holds its presidency this year.",
             "source_url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
             "read_on": "2026-11-15",
             "ai_path": "The grouping is the vehicle for the cross-border innovation node that Ayamonte's council described, which includes an AI assistant on its own side.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.cm-vrsa.pt/pt/noticias/47651/eurocidade-do-guadiana-e-comunidade-europeia-do-desporto-2026.aspx",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Ayuntamiento de Ayamonte",
             "type": "public body",
             "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "what": "Spanish council across the river, in the Eurocidade with VRSA. In March 2024 it said it was preparing an AI virtual assistant and a Eurocidade innovation node. It sits outside the municipality and is listed as the cross-border neighbour.",
             "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "read_on": "2026-11-15",
             "ai_path": "Its own AI virtual assistant, in preparation as of March 2024.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
              "signature": "valid",
              "site_key": "site.vila-real-de-santo-antonio-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/vila-real-de-santo-antonio/events.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_events_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/events.json",
    "description": "Vila Real de Santo António'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"
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "events": {
          "summary": "/api/v1/places/vila-real-de-santo-antonio/events.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/events.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "Vila Real de Santo António'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/vila-real-de-santo-antonio/index.json",
           "count": 0,
           "items": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/vila-real-de-santo-antonio/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_sources_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/sources.json",
    "description": "The sources Vila Real de Santo António'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/vila-real-de-santo-antonio/sources.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/sources.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "The sources Vila Real de Santo António'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/vila-real-de-santo-antonio/index.json",
           "listed": [
            {
             "name": "Câmara Municipal de Vila Real de Santo António",
             "url": "https://www.cm-vrsa.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "VRSA Geoportal (council maps and plans online)",
             "url": "https://websig.cm-vrsa.pt/geoportal",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento",
             "url": "https://www.barlavento.pt",
             "kind": "press",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 6
            },
            {
             "host": "cio.com",
             "facts": 2
            },
            {
             "host": "cm-vrsa.pt",
             "facts": 1
            }
           ],
           "gravity": [
            {
             "title": "Vila Real de Santo António (history and economy)",
             "url": "https://en.wikipedia.org/wiki/Vila_Real_de_Santo_Ant%C3%B3nio",
             "read_on": "2026-11-15"
            },
            {
             "title": "VRSA instala Wi-Fi gratuito e controlo automóvel no centro histórico (Barlavento)",
             "url": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15"
            },
            {
             "title": "Câmara Municipal de Vila Real de Santo António (news page, Eurocidade items)",
             "url": "https://www.cm-vrsa.pt",
             "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/vila-real-de-santo-antonio/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_agents_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/agents.json",
    "description": "The agents that keep Vila Real de Santo António, 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/vila-real-de-santo-antonio/agents.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/agents.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "The agents that keep Vila Real de Santo António, 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/vila-real-de-santo-antonio/index.json",
           "agents": [
            {
             "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
             "role": "place.vila-real-de-santo-antonio",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "first pass written and signed (status researching); keys place.vila-real-de-santo-antonio-promptugal and site.vila-real-de-santo-antonio-promptugal published",
             "updated": "2026-11-16T00:50Z",
             "focus": "data/by-place/vila-real-de-santo-antonio.json, promptugal.news/algarve/vila-real-de-santo-antonio/",
             "done": 6,
             "next": [
              "Algarve Evolution member list, NERA projects naming VRSA, the Eurocidade innovation node",
              "sea-tech or port digitalisation projects",
              "status live, one article once a 2026 hook exists"
             ],
             "status_file": "https://promptugal.news/board/team/place.vila-real-de-santo-antonio/status.json",
             "runs": 5,
             "last_run": "board/runs/place.vila-real-de-santo-antonio/2026-11-16T00-23-12Z.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/vila-real-de-santo-antonio/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_provenance_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/provenance.json",
    "description": "Where each of Vila Real de Santo António'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",
               "null"
              ],
              "format": "uri"
             },
             "source": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "date": {
              "type": [
               "string",
               "null"
              ]
             },
             "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/vila-real-de-santo-antonio/provenance.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/provenance.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "Where each of Vila Real de Santo António'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/vila-real-de-santo-antonio/index.json",
           "file": {
            "path": "data/by-place/vila-real-de-santo-antonio.json",
            "raw": "https://promptugal.news/data/by-place/vila-real-de-santo-antonio.json",
            "sha256": "473257b177e6729218220beaacff277d297d73ee86be7a9f771ced41cb9776df",
            "signature": "valid",
            "key_id": "site.vila-real-de-santo-antonio-promptugal",
            "signed_by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-16",
            "by": "place.vila-real-de-santo-antonio@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "VRSA wires its historic centre with free Wi-Fi and 16 footfall counters",
             "url": "https://www.barlavento.pt/?p=399594",
             "source": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "date": "2026-05-18",
             "steps": 2,
             "by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "Ayamonte's innovation node is meant to reach Vila Real de Santo António",
             "url": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "source": "https://www.cio.com/administraciones-publicas/el-ayuntamiento-de-ayamonte-apuesta-por-la-digitalizacion-para-adaptarse-a-las-nuevas-necesidades-de-los-ciudadanos",
             "read_on": "2026-11-15",
             "date": "2024-03-15",
             "steps": 2,
             "by": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
             "host": "cio.com"
            },
            {
             "kind": "map",
             "label": "Câmara Municipal de Vila Real de Santo António",
             "url": "https://www.cm-vrsa.pt",
             "source": "https://www.barlavento.pt/?p=399594",
             "read_on": "2026-11-15",
             "date": null,
             "steps": 2,
             "by": "place.vila-real-de-santo-antonio@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/vila-real-de-santo-antonio/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_quality_json",
    "tags": [
     "Vila Real de Santo António"
    ],
    "summary": "/api/v1/places/vila-real-de-santo-antonio/quality.json",
    "description": "The data quality of Vila Real de Santo António: 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/vila-real-de-santo-antonio/quality.json",
          "description": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/quality.json",
          "value": {
           "id": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "about": "The data quality of Vila Real de Santo António: 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/vila-real-de-santo-antonio/index.json",
           "kind": "municipality",
           "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
           "status": "researching",
           "counts": {
            "facts": 10,
            "stories": 2,
            "ai_map": 4,
            "events": 0,
            "figures": 4,
            "sources_listed": 11,
            "gaps": 11,
            "articles": 0
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 42,
            "fields_expected": 42,
            "by_kind": {
             "story": {
              "items": 2,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 4,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 0,
              "fields": {
               "title": null,
               "url": null,
               "date": null,
               "read_on": null,
               "ai_path": null
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 0.6
           },
           "freshness": {
            "updated": "2026-11-16",
            "days_since_update": 0,
            "newest_read": "2026-11-16",
            "oldest_read": "2026-11-15",
            "median_read_age_days": 1,
            "read_in_last_7_days": 1,
            "median_story_age_days": 579
           },
           "sources": {
            "distinct_hosts": 4,
            "sources_per_fact": 1.1,
            "top_host": "barlavento.pt",
            "top_host_share": 0.6,
            "concentration_hhi": 0.42,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 6
             },
             {
              "host": "cio.com",
              "facts": 2
             },
             {
              "host": "cm-vrsa.pt",
              "facts": 1
             }
            ]
           },
           "ai_path_steps": {
            "1": 1,
            "2": 5
           },
           "score": {
            "value": 82,
            "parts": {
             "completeness": 1,
             "freshness": 0.97,
             "diversity": 0.72,
             "volume": 0.33
            }
           },
           "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/vila-real-de-santo-antonio.json": {
   "get": {
    "operationId": "get_api_v1_data_places_vila_real_de_santo_antonio_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/vila-real-de-santo-antonio.json",
    "description": "Vila Real de Santo António 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": {
         "vila-real-de-santo-antonio": {
          "summary": "/api/v1/data/places/vila-real-de-santo-antonio.json",
          "description": "https://promptugal.news/api/v1/data/places/vila-real-de-santo-antonio.json",
          "value": {
           "about": "Vila Real de Santo António 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": "vila-real-de-santo-antonio",
           "name": "Vila Real de Santo António",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/vila-real-de-santo-antonio.json",
           "page": "query/vila-real-de-santo-antonio/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "vila-real-de-santo-antonio"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": []
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ],
              [
               "vila-real-de-santo-antonio"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "place:tavira"
              ],
              [
               "place:loule"
              ],
              [
               "place:vila-real-de-santo-antonio"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "on_ai_map_of:local:camara-municipal-de-vila-real-de-santo-antonio:place:vila-real-de-santo-antonio"
              ],
              [
               "on_ai_map_of:local:eurocidade-do-guadiana:place:vila-real-de-santo-antonio"
              ],
              [
               "on_ai_map_of:local:ayuntamiento-de-ayamonte:place:vila-real-de-santo-antonio"
              ]
             ]
            }
           }
          }
         }
        }
       }
      }
     },
     "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": [
     "Vila Real de Santo António"
    ],
    "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/vila-real-de-santo-antonio/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_vila_real_de_santo_antonio_openapi_json",
    "tags": [
     "meta"
    ],
    "summary": "This document.",
    "responses": {
     "200": {
      "description": "An OpenAPI 3.1 document.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "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": "vila-real-de-santo-antonio",
  "name": "Vila Real de Santo António",
  "kind": "municipality",
  "agent": "place.vila-real-de-santo-antonio@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/index.json",
   "page": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/page.json",
   "stories": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/events.json",
   "sources": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/sources.json",
   "agents": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/vila-real-de-santo-antonio/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/vila-real-de-santo-antonio.json",
   "tables": "https://promptugal.news/api/v1/data/places/vila-real-de-santo-antonio.json"
  }
 }
}
