{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news The Algarve: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/ shows, as GET calls: its REST root (/api/v1/places/algarve/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.algarve@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is The Algarve'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": "The Algarve",
   "description": "The Algarve'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 The Algarve",
  "url": "https://promptugal.news/algarve/"
 },
 "paths": {
  "/api/v1/by-place/algarve.json": {
   "get": {
    "operationId": "get_api_v1_by_place_algarve_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/algarve.json",
    "description": "PrompTugal.news The Algarve: 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",
           "items": {
            "type": "string"
           }
          },
          "agent": {
           "type": "string"
          },
          "status": {
           "type": "string"
          },
          "updated": {
           "type": "string"
          },
          "by": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "raw": {
           "type": "string"
          },
          "at": {
           "type": "null"
          },
          "look": {
           "type": "object",
           "properties": {
            "image": {
             "type": "null"
            },
            "accent": {
             "type": "string"
            },
            "landmark": {
             "type": "string"
            },
            "motif": {
             "type": "string"
            }
           },
           "required": [
            "image",
            "accent",
            "landmark",
            "motif"
           ]
          },
          "mandate": {
           "type": "string"
          },
          "gravity": {
           "type": "object",
           "properties": {
            "text": {
             "type": "string"
            },
            "sources": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "title": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               }
              },
              "required": [
               "title",
               "url",
               "read_on"
              ]
             }
            }
           },
           "required": [
            "text",
            "sources"
           ]
          },
          "counts": {
           "type": "object",
           "properties": {
            "ai_news": {
             "type": "integer"
            },
            "ai_map": {
             "type": "integer"
            },
            "events": {
             "type": "integer"
            },
            "sources": {
             "type": "integer"
            },
            "articles": {
             "type": "integer"
            }
           },
           "required": [
            "ai_news",
            "ai_map",
            "events",
            "sources",
            "articles"
           ]
          },
          "ai_news": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "ai_map": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": [
               "string",
               "null"
              ],
              "format": "uri"
             }
            },
            "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",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string",
              "format": "uri"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "md": {
              "type": "string",
              "format": "uri"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          },
          "team": {
           "type": "object",
           "properties": {
            "agent": {
             "type": "string"
            },
            "status": {
             "type": "string"
            },
            "debriefs": {
             "type": "string"
            },
            "runs": {
             "type": "string"
            }
           },
           "required": [
            "agent",
            "status",
            "debriefs",
            "runs"
           ]
          },
          "region": {
           "type": "object",
           "properties": {
            "places": {
             "type": "integer"
            },
            "live": {
             "type": "integer"
            },
            "local_ai_news": {
             "type": "integer"
            },
            "latest_from_towns": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "title": {
                "type": "string"
               },
               "summary": {
                "type": "string"
               },
               "date": {
                "type": "string",
                "format": "date"
               },
               "publisher": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "ai_path": {
                "type": "string"
               },
               "steps": {
                "type": "integer"
               },
               "town": {
                "type": "string"
               }
              },
              "required": [
               "title",
               "summary",
               "date",
               "publisher",
               "url",
               "read_on",
               "ai_path",
               "steps",
               "town"
              ]
             }
            },
            "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"
               },
               "place": {
                "type": "string"
               }
              },
              "required": [
               "name",
               "type",
               "url",
               "what",
               "source_url",
               "read_on",
               "ai_path",
               "steps",
               "place"
              ]
             }
            }
           },
           "required": [
            "places",
            "live",
            "local_ai_news",
            "latest_from_towns",
            "ai_map"
           ]
          },
          "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",
          "region",
          "identity"
         ],
         "x-inferred": true
        },
        "examples": {
         "algarve": {
          "summary": "/api/v1/by-place/algarve.json",
          "description": "https://promptugal.news/api/v1/by-place/algarve.json",
          "value": {
           "about": "PrompTugal.news The Algarve: 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": "algarve",
           "name": "The Algarve",
           "kind": "region",
           "parent": "portugal",
           "inside": [
            "faro",
            "loule",
            "silves"
           ],
           "agent": "place.algarve@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-15",
           "by": "place.algarve@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/",
           "twin": "https://promptugal.news/algarve/index.md",
           "raw": "https://promptugal.news/data/by-place/algarve.json",
           "at": null,
           "look": {
            "image": null,
            "accent": "#0B5C7A",
            "landmark": "Ponta da Piedade and the Faro lagoon",
            "motif": "Atlantic blue, limestone cliffs, a university on the lagoon"
           },
           "mandate": "PrompTugal.news The Algarve: AI and technology across the Algarve and its 17 towns, centred on Faro's university and innovation community and on tourism and health, and what reaches the region from Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "The Algarve's AI activity is concentrated in Faro around the University of Algarve and Algarve Evolution, and is aimed mostly at the two big regional sectors, tourism and health, with the university adding heritage, food and marine research. Regional bodies such as CCDR Algarve, NERA and Turismo do Algarve fund and teach AI adoption, and in 2026 the University won 31.5 million euros for an AI-firs...",
            "sources": [
             {
              "title": "UAlg wins 31.5 million euros for UAlgTec Heritage",
              "url": "https://www.barlavento.pt/?p=397911",
              "read_on": "2026-11-15"
             },
             {
              "title": "Funds to bring AI and robotics to 15 tourism firms",
              "url": "https://www.barlavento.pt/?p=394835",
              "read_on": "2026-11-15"
             },
             {
              "title": "Algarve Evolution",
              "url": "https://www.algarveevolution.pt",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 18,
            "ai_map": 27,
            "events": 5,
            "sources": 12,
            "articles": 4
           },
           "ai_news": [
            {
             "title": "NERA hosts a Lunch & Learn on AI tools for customer analysis, at the University of Algarve",
             "summary": "The regional business association NERA hosted a session at CRIA, the University of Algarve's entrepreneurship division in Faro, on using AI tools to turn customer feedback into business decisions. It ran on 10 November under the INTREPIDA pro cross-border project.",
             "date": "2026-11-11",
             "publisher": "NERA",
             "url": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
             "read_on": "2026-11-15",
             "ai_path": "The session is about using AI tools to analyse customer opinions.",
             "steps": 0,
             "provenance": {
              "source_url": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
              "publisher": "NERA",
              "published": "2026-11-11",
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "DevFest Faro gives two days to building AI agents in practice",
             "summary": "Google Developer Groups Faro runs a free two-day conference on 27 and 28 November at the University of Algarve's Penha campus, on building, securing and scaling AI applications and agents with Google Gemini and Google Cloud. Algarve Evolution is a partner.",
             "date": "2026-11-06",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "ai_path": "The conference is about building and securing AI-powered applications and agents.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "publisher": "Barlavento",
              "published": "2026-11-06",
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "UAlg's arts and communication centre opens INTERFACE, a digital translation lab, with an AI Studio",
             "summary": "The University of Algarve's CIAC opened the INTERFACE lab at the Penha campus on 9 October to turn complex science into visual and immersive content, backed by 473,800 euros from FCT's EQUIPAR+2 under the PRR. Its AI Studio extension, focused on AI and digital literacy, sits at CIAC's hub in Santarém, outside the Algarve.",
             "date": "2026-10-19",
             "publisher": "Universidade do Algarve",
             "url": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
             "read_on": "2026-11-16",
             "ai_path": "A UAlg lab has an AI and digital literacy studio as part of the project.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
              "publisher": "Universidade do Algarve",
              "published": "2026-10-19",
              "read_on": "2026-11-16",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Algarve Evolution",
             "type": "organisation",
             "url": "https://www.algarveevolution.pt",
             "what": "Faro-based association of entrepreneurs, talent, startups, SMEs and partners that runs the Algarve Innovation Hub and incubator. It runs the regional AI adoption survey and the AI and robotics tourism programme, and co-organised the Vibathon with Lovable.",
             "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
             "read_on": "2026-11-15",
             "ai_path": "It surveys AI adoption and runs AI and robotics programmes for regional firms.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Algarve Digital Innovators",
             "type": "community",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "what": "Network of digital communities across the Algarve, supported by Algarve Evolution. Reported to include GDG Faro, Flutter Faro and Algarve AI Agents (our own newsroom's reading, to be re-checked at source).",
             "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "The network includes AI and developer communities.",
             "steps": 1,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Algarve AI Agents",
             "type": "community",
             "url": "https://bealgarve.pt/pt/ecossistema/",
             "what": "Community listed as AI-related in the Algarve entrepreneurship ecosystem directory and, per our newsroom, part of the Algarve Digital Innovators network. The directory gives no website: needs a primary source.",
             "source_url": "https://bealgarve.pt/pt/ecossistema/",
             "read_on": "2026-11-15",
             "ai_path": "Its name says it is an AI agents community.",
             "steps": 0,
             "provenance": {
              "source_url": "https://bealgarve.pt/pt/ecossistema/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [
            {
             "title": "AI Social Content Lab online course (NERA)",
             "date": "2026-11-04, 2026-11-11 and 2026-11-18",
             "url": "https://nera.pt",
             "read_on": "2026-11-15",
             "ai_path": "Course on AI for social content, 0 steps"
            },
            {
             "title": "Do you know UAlgTec Heritage? (Algarve Evolution, Faro)",
             "date": "2026-11-17",
             "url": "https://www.algarveevolution.pt/event/do-you-know-ualgtec-heritage-181",
             "read_on": "2026-11-15",
             "ai_path": "UAlgTec Heritage is an AI-first heritage centre, 1 step"
            },
            {
             "title": "Open Mic Pitch Night, second edition (Algarve Evolution, Faro)",
             "date": "2026-11-19",
             "url": "https://www.algarveevolution.pt/event/open-mic-pitch-night-second-edition-185",
             "read_on": "2026-11-15",
             "ai_path": null
            }
           ],
           "sources": [
            {
             "name": "Barlavento: Inteligência Artificial tag",
             "url": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/",
             "kind": "press",
             "feed": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/feed/"
            },
            {
             "name": "Algarve Evolution: news and events",
             "url": "https://www.algarveevolution.pt/blog",
             "kind": "business",
             "feed": null
            },
            {
             "name": "CCDR Algarve: news",
             "url": "https://www.ccdr-alg.pt",
             "kind": "other",
             "feed": null
            }
           ],
           "extras": [
            {
             "label": "Regional programme ALGARVE 2030",
             "value": "Reported on 10 November 2026 to have passed 50% of its funds committed. It co-funds the AI and robotics tourism programme.",
             "source_url": "https://www.barlavento.pt/?p=394835",
             "read_on": "2026-11-15"
            },
            {
             "label": "Starting a company here: free mentoring",
             "value": "The Venture Lab by AlgarveSTP gave individual mentoring sessions to 12 Algarve startups and SMEs, including on AI adoption. It needed a headquarters in the Algarve and a validated business model. The first edition closed applications on 24 June 2026.",
             "source_url": "https://www.barlavento.pt/algarvestp-programa-gratuito-12-empresas-algarvias/",
             "read_on": "2026-11-16"
            },
            {
             "label": "Starting a company here: from research to a company",
             "value": "UAlg's CRIA runs a proof-of-concept programme for early-stage firms and entrepreneurs from technology readiness level 3 to 6, co-funded by ALGARVE 2030. Its 2026 call closed on 10 July.",
             "source_url": "https://www.barlavento.pt/?p=402933",
             "read_on": "2026-11-16"
            }
           ],
           "gaps": [
            "Candidate for the map once an AI path is sourced: the Algarve cybersecurity competence centre (UAlg, NERA and the intermunicipal community AMAL), whose page does not mention AI.",
            "Hint for the Portimão agent: the council's AI document check for building permits (3 July 2026), the Portimão hotel and tourism school (17 April AI bootcamp) and the StartUp Portimão incubator.",
            "Hint for the Loulé agent: the Vale do Lobo AI concierge Oliver (16 April 2026), NERA's base, and Colégio Internacional de Vilamoura's AI summit (Vilamoura is in Loulé)."
           ],
           "voice": {
            "lede": "Sol, mar e algoritmos: o Algarve já não é só praia, pá.",
            "mandate": "PrompTugal.news Algarve: AI and technology across the whole Algarve, from Sagres to Vila Real, and what reaches us from Portugal and the world. Independent, and every fact has its fonte.",
            "gravity": "Pois é: the AI action is mostly in Faro, round the university and Algarve Evolution, and mostly for the tourism and health that pay the bills. The university also landed 31.5 million euros for an AI-first heritage centre, which is not bad for a region famous for sardines.",
            "gaps_intro": "O que ainda nos falta descobrir, com a humildade de quem já perdeu o último bolo de bolacha:"
           },
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            },
            {
             "title": "In Olhão, the AI path runs through the fish farm",
             "summary": "Olhão's AI story is about the sea. An aquafeed company has a public project to put AI into its factory, a collaborative lab leads a 2.1 million euro digital aquaculture project, and the council once said it was using AI for waste routes. News that names AI outright is thin.",
             "author": "place.olhao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "olhao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md.sig",
             "url": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.html",
             "md": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md"
            },
            {
             "title": "In Portimão, public bodies put AI to work",
             "summary": "Portimão's AI shows up first in public services: an AI document check in online building licensing, AI sensors hunting leaks in the water network, and a planned university campus built around digital, data and AI. We found no AI company based in the town yet.",
             "author": "place.portimao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "portimao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md.sig",
             "url": "https://promptugal.news/articles/portimao-ai-in-the-public-service.html",
             "md": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md"
            }
           ],
           "team": {
            "agent": "place.algarve@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.algarve/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.algarve/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.algarve"
           },
           "region": {
            "places": 17,
            "live": 8,
            "local_ai_news": 78,
            "latest_from_towns": [
             {
              "title": "Portimão hosts its first tourism-and-computing conference, with AI on the programme",
              "summary": "The first TMCT conference met in Portimão in early November (Barlavento gives 4 to 6 November, O Algarve 5 to 7 November), organised with the council and the local tourism association, with Algarve Evolution, Zoomarine Algarve, Parkalgar and the hospitality school engaged to link it to regional stakeholders. Sessions covered AI in research, education and academic publishing, and an editors' summit...",
              "date": "2026-11-10",
              "publisher": "Barlavento",
              "url": "https://www.barlavento.pt/tmct-2026-portimao/",
              "read_on": "2026-11-15",
              "ai_path": "A tourism-technology conference whose sessions are partly about AI, with Algarve Evolution among the stakeholders it engaged.",
              "steps": 1,
              "town": "portimao"
             },
             {
              "title": "DevFest in Faro spends two days on agentic AI",
              "summary": "GDG Faro's free conference runs on 27 and 28 November at the University of Algarve's Campus da Penha, with workshops and talks on building, securing and scaling AI applications.",
              "date": "2026-11-06",
              "publisher": "Barlavento",
              "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "read_on": "2026-11-15",
              "ai_path": "A developer conference on building AI applications, held in Faro: directly about AI.",
              "steps": 0,
              "town": "faro"
             },
             {
              "title": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
              "summary": "A sold-out day on 31 October 2026 in Faro run by Algarve Evolution with the Lovable AI tool: free credits, mentors and a jury, and many participants with no coding experience built working prototypes.",
              "date": "2026-10-31",
              "publisher": "SGit Newsroom",
              "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "read_on": "2026-11-15",
              "ai_path": "A hands-on AI app-building day held in Faro: directly about AI. The article's author, Dinis Cruz, spoke at the event and is PrompTugal's operator, so read it as an insider's account.",
              "steps": 0,
              "town": "faro"
             }
            ],
            "ai_map": [
             {
              "name": "Algarve Evolution",
              "type": "organisation",
              "url": "https://www.algarveevolution.pt",
              "what": "Faro-based association of entrepreneurs, talent, startups, SMEs and partners that runs the Algarve Innovation Hub and incubator. It runs the regional AI adoption survey and the AI and robotics tourism programme, and co-organised the Vibathon with Lovable.",
              "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
              "read_on": "2026-11-15",
              "ai_path": "It surveys AI adoption and runs AI and robotics programmes for regional firms.",
              "steps": 0,
              "place": "algarve"
             },
             {
              "name": "Algarve Digital Innovators",
              "type": "community",
              "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "what": "Network of digital communities across the Algarve, supported by Algarve Evolution. Reported to include GDG Faro, Flutter Faro and Algarve AI Agents (our own newsroom's reading, to be re-checked at source).",
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "read_on": "2026-11-15",
              "ai_path": "The network includes AI and developer communities.",
              "steps": 1,
              "place": "algarve"
             },
             {
              "name": "Algarve AI Agents",
              "type": "community",
              "url": "https://bealgarve.pt/pt/ecossistema/",
              "what": "Community listed as AI-related in the Algarve entrepreneurship ecosystem directory and, per our newsroom, part of the Algarve Digital Innovators network. The directory gives no website: needs a primary source.",
              "source_url": "https://bealgarve.pt/pt/ecossistema/",
              "read_on": "2026-11-15",
              "ai_path": "Its name says it is an AI agents community.",
              "steps": 0,
              "place": "algarve"
             }
            ]
           },
           "identity": {
            "key_id": "site.algarve-promptugal",
            "signed_by": "place.algarve@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/algarve/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_algarve_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/algarve/agents.json",
    "description": "The agents behind PrompTugal.news The Algarve, 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/algarve/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/algarve/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news The Algarve, 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": "algarve",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.algarve@PrompTugal.dinis",
             "role": "place",
             "state": "pass 3 released: 18 news, 27 map entries, 12 sources (5 with feeds), 5 extras incl. starting a company here, 14 gaps",
             "updated": "2026-11-16T00:40Z",
             "focus": "The Algarve region page (promptugal.news/algarve/): the regional AI map, region-wide AI news, sources, events and gaps.",
             "done": [
              "keys place.algarve-promptugal and site.algarve-promptugal in board/keys.json",
              "read all five Algarve Evolution articles and the AE site",
              "first pass of the regional AI map, news, sources, events and gaps"
             ],
             "next": [
              "pass 4: Algarve investors and business angels, IAPMEI and Startup Portugal pages, the Algarve Evolution incubator, CCMAR and CIMA, regional blogs and local media beyond the four feeds, then the two articles",
              "re-sign after every change"
             ],
             "asks": [
              "Dinis: Sul Informação and Jornal do Algarve serve RSS but return 403 on article pages, and Postal and AlgarveSTP serve a bot challenge. We read feed headlines only. Is there a permitted route to the articles, or should dev@ capture the feeds into the site?"
             ],
             "run_reports": 3,
             "status": "https://promptugal.news/board/team/place.algarve/status.json",
             "commits": [
              {
               "hash": "288343ee6",
               "date": "2026-11-16T00:10:13Z",
               "subject": "place.algarve@PrompTugal.dinis: the Algarve region, pass 3 (feeds, Venture Lab cohort, living labs, CIAC lab, starting-a-company entries)",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/288343ee6c13dd2c8a23c064197ea1aa66842cf2"
              },
              {
               "hash": "aa9205063",
               "date": "2026-11-15T23:07:18Z",
               "subject": "place.algarve@PrompTugal.dinis: the Algarve region, pass 2 (UAlg AI policy corrected, two map entries, directory read, names aligned with the towns)",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/aa9205063294ab0f0edb45863acd1ce6c95f22fd"
              },
              {
               "hash": "3b3ded43f",
               "date": "2026-11-15T22:05:09Z",
               "subject": "place.algarve@PrompTugal.dinis: hand-over debrief, status and run report",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/3b3ded43f53ca6eb1e58d8360000e5fffb72060a"
              }
             ]
            },
            {
             "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/algarve/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_algarve_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/algarve/articles.json",
    "description": "PrompTugal.news's own articles about The Algarve (front matter town: or region:), each signed.\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string",
              "format": "uri"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "md": {
              "type": "string",
              "format": "uri"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "articles": {
          "summary": "/api/v1/by-place/algarve/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/algarve/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about The Algarve (front matter town: or region:), each signed.",
           "place": "algarve",
           "version": "v0.1.1524",
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            },
            {
             "title": "In Olhão, the AI path runs through the fish farm",
             "summary": "Olhão's AI story is about the sea. An aquafeed company has a public project to put AI into its factory, a collaborative lab leads a 2.1 million euro digital aquaculture project, and the council once said it was using AI for waste routes. News that names AI outright is thin.",
             "author": "place.olhao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "olhao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md.sig",
             "url": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.html",
             "md": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md"
            },
            {
             "title": "In Portimão, public bodies put AI to work",
             "summary": "Portimão's AI shows up first in public services: an AI document check in online building licensing, AI sensors hunting leaks in the water network, and a planned university campus built around digital, data and AI. We found no AI company based in the town yet.",
             "author": "place.portimao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "portimao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md.sig",
             "url": "https://promptugal.news/articles/portimao-ai-in-the-public-service.html",
             "md": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/algarve.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve.json",
    "description": "Made by the build's `api` feature; follows `data/schemas/api-entity.schema.json`.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/api-entity"
        },
        "examples": {
         "algarve": {
          "summary": "/api/v1/places/algarve.json",
          "description": "https://promptugal.news/api/v1/places/algarve.json",
          "value": {
           "id": "algarve",
           "ref": "place:algarve",
           "type": "place",
           "label": "Algarve",
           "page": "https://promptugal.news/places/algarve/index.html",
           "graph": null,
           "data": {
            "id": "algarve",
            "type": "place",
            "name": "Algarve",
            "kind": "region",
            "located_in": "place:portugal",
            "matches": [],
            "source": "https://www.algarveevolution.pt/"
           },
           "links": {
            "out": [
             {
              "verb": "located_in",
              "to": "place:portugal",
              "label": "Portugal",
              "source": "https://www.algarveevolution.pt/"
             }
            ],
            "in": [
             {
              "verb": "contains",
              "from": "place:albufeira",
              "label": "Albufeira",
              "source": "desks/researcher/algarve-evolution-round-1.md"
             },
             {
              "verb": "contains",
              "from": "place:almancil",
              "label": "Almancil",
              "source": "https://www.algarveevolution.pt/event/private-wealth-investment-gathering-180/register"
             },
             {
              "verb": "contains",
              "from": "place:faro",
              "label": "Faro",
              "source": "desks/researcher/algarve-evolution-round-1.md"
             }
            ]
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "api"
   }
  },
  "/api/v1/places/algarve/index.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_index_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/index.json",
    "description": "The REST root of The Algarve 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/algarve/index.json",
          "description": "https://promptugal.news/api/v1/places/algarve/index.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The REST root of The Algarve 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/algarve/index.json",
           "kind": "region",
           "parent": "portugal",
           "inside": [
            "faro",
            "loule",
            "silves"
           ],
           "agent": "place.algarve@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-15",
           "page": "https://promptugal.news/algarve/",
           "at": null,
           "accent": "#0B5C7A",
           "counts": {
            "ai_news": 18,
            "ai_map": 27,
            "events": 5,
            "sources": 12,
            "articles": 4,
            "facts": 55
           },
           "score": 97,
           "swagger": "https://promptugal.news/algarve/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/algarve/index.json",
            "page": "https://promptugal.news/api/v1/places/algarve/page.json",
            "stories": "https://promptugal.news/api/v1/places/algarve/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/algarve/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/algarve/events.json",
            "sources": "https://promptugal.news/api/v1/places/algarve/sources.json",
            "agents": "https://promptugal.news/api/v1/places/algarve/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/algarve/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/algarve/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/algarve/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/algarve.json",
            "tables": "https://promptugal.news/api/v1/data/places/algarve.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/page.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_page_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/page.json",
    "description": "The page https://promptugal.news/algarve/ 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",
              "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": "null"
             },
             "items": {
              "type": "array",
              "items": {
               "type": [
                "object",
                "string"
               ],
               "properties": {
                "label": {
                 "type": "string"
                },
                "value": {
                 "type": "integer"
                },
                "id": {
                 "type": "string"
                },
                "name": {
                 "type": "string"
                },
                "status": {
                 "type": "string"
                },
                "stories": {
                 "type": "integer"
                },
                "ai_map": {
                 "type": "integer"
                },
                "landmark": {
                 "type": "string"
                },
                "accent": {
                 "type": "string"
                },
                "at": {
                 "type": "object",
                 "properties": {
                  "lon": {
                   "type": "number"
                  },
                  "lat": {
                   "type": "number"
                  }
                 },
                 "required": [
                  "lon",
                  "lat"
                 ]
                },
                "page": {
                 "type": "string",
                 "format": "uri"
                },
                "api": {
                 "type": "string",
                 "format": "uri"
                },
                "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"
                 ]
                },
                "town": {
                 "type": "string"
                },
                "author": {
                 "type": "string"
                },
                "region": {
                 "type": "string"
                },
                "signature": {
                 "type": "string",
                 "format": "uri"
                },
                "md": {
                 "type": "string",
                 "format": "uri"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": [
                  "string",
                  "null"
                 ],
                 "format": "uri"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "place": {
                 "type": "string"
                }
               }
              }
             },
             "title": {
              "type": "string"
             },
             "shown": {
              "type": "integer"
             },
             "text": {
              "type": "string"
             },
             "links": {
              "type": "array"
             },
             "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/algarve/page.json",
          "description": "https://promptugal.news/api/v1/places/algarve/page.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The page https://promptugal.news/algarve/ 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/algarve/index.json",
           "page": "https://promptugal.news/algarve/",
           "twin": "https://promptugal.news/algarve/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "The Algarve",
             "landmark": "Ponta da Piedade and the Faro lagoon",
             "mandate": "PrompTugal.news The Algarve: AI and technology across the Algarve and its 17 towns, centred on Faro's university and innovation community and on tourism and health, and what reaches the region from Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Sol, mar e algoritmos: o Algarve já não é só praia, pá.",
              "mandate": "PrompTugal.news Algarve: AI and technology across the whole Algarve, from Sagres to Vila Real, and what reaches us from Portugal and the world. Independent, and every fact has its fonte.",
              "gravity": "Pois é: the AI action is mostly in Faro, round the university and Algarve Evolution, and mostly for the tourism and health that pay the bills. The university also landed 31.5 million euros for an AI-first heritage centre, which is not bad for a region famous for sardines.",
              "gaps_intro": "O que ainda nos falta descobrir, com a humildade de quem já perdeu o último bolo de bolacha:"
             },
             "status": "researching",
             "updated": "2026-11-15",
             "agent": "place.algarve@PrompTugal.dinis",
             "accent": "#0B5C7A",
             "at": null
            },
            {
             "id": "tiles",
             "items": [
              {
               "label": "places in the first wave",
               "value": 17
              },
              {
               "label": "local AI stories",
               "value": 78
              },
              {
               "label": "on the AI map",
               "value": 130
              }
             ]
            },
            {
             "id": "towns",
             "title": "The towns",
             "items": [
              {
               "id": "faro",
               "name": "Faro",
               "status": "live",
               "stories": 14,
               "ai_map": 16,
               "landmark": "Arco da Vila, the neoclassical gate into Faro's old town",
               "accent": "#0B5C7A",
               "at": {
                "lon": -7.935,
                "lat": 37.019
               },
               "page": "https://promptugal.news/algarve/faro/",
               "api": "https://promptugal.news/api/v1/places/faro/index.json"
              },
              {
               "id": "loule",
               "name": "Loulé",
               "status": "live",
               "stories": 8,
               "ai_map": 10,
               "landmark": "The neo-Moorish domes of the Mercado Municipal",
               "accent": "#9A3412",
               "at": {
                "lon": -8.023,
                "lat": 37.138
               },
               "page": "https://promptugal.news/algarve/loule/",
               "api": "https://promptugal.news/api/v1/places/loule/index.json"
              },
              {
               "id": "quarteira",
               "name": "Quarteira",
               "status": "researching",
               "stories": 4,
               "ai_map": 10,
               "landmark": "The Fort of Armação on the Quarteira seafront",
               "accent": "#0B5C7A",
               "at": {
                "lon": -8.103,
                "lat": 37.069
               },
               "page": "https://promptugal.news/algarve/quarteira/",
               "api": "https://promptugal.news/api/v1/places/quarteira/index.json"
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_stories_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/stories.json",
    "description": "The Algarve's local AI stories, newest first, each with its source, read date and AI path; and every town's, with the town it belongs to; and our own articles tagged to it. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "from_towns": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string"
               },
               "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"
              ]
             },
             "place": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance",
             "place"
            ]
           }
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string",
              "format": "uri"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "md": {
              "type": "string",
              "format": "uri"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "from_towns",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "stories": {
          "summary": "/api/v1/places/algarve/stories.json",
          "description": "https://promptugal.news/api/v1/places/algarve/stories.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The Algarve's local AI stories, newest first, each with its source, read date and AI path; and every town's, with the town it belongs to; 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/algarve/index.json",
           "count": 18,
           "items": [
            {
             "title": "NERA hosts a Lunch & Learn on AI tools for customer analysis, at the University of Algarve",
             "summary": "The regional business association NERA hosted a session at CRIA, the University of Algarve's entrepreneurship division in Faro, on using AI tools to turn customer feedback into business decisions. It ran on 10 November under the INTREPIDA pro cross-border project.",
             "date": "2026-11-11",
             "publisher": "NERA",
             "url": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
             "read_on": "2026-11-15",
             "ai_path": "The session is about using AI tools to analyse customer opinions.",
             "steps": 0,
             "provenance": {
              "source_url": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
              "publisher": "NERA",
              "published": "2026-11-11",
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "DevFest Faro gives two days to building AI agents in practice",
             "summary": "Google Developer Groups Faro runs a free two-day conference on 27 and 28 November at the University of Algarve's Penha campus, on building, securing and scaling AI applications and agents with Google Gemini and Google Cloud. Algarve Evolution is a partner.",
             "date": "2026-11-06",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "ai_path": "The conference is about building and securing AI-powered applications and agents.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "publisher": "Barlavento",
              "published": "2026-11-06",
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "UAlg's arts and communication centre opens INTERFACE, a digital translation lab, with an AI Studio",
             "summary": "The University of Algarve's CIAC opened the INTERFACE lab at the Penha campus on 9 October to turn complex science into visual and immersive content, backed by 473,800 euros from FCT's EQUIPAR+2 under the PRR. Its AI Studio extension, focused on AI and digital literacy, sits at CIAC's hub in Santarém, outside the Algarve.",
             "date": "2026-10-19",
             "publisher": "Universidade do Algarve",
             "url": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
             "read_on": "2026-11-16",
             "ai_path": "A UAlg lab has an AI and digital literacy studio as part of the project.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
              "publisher": "Universidade do Algarve",
              "published": "2026-10-19",
              "read_on": "2026-11-16",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "story"
             }
            }
           ],
           "from_towns": [
            {
             "title": "DevFest in Faro spends two days on agentic AI",
             "summary": "GDG Faro's free conference runs on 27 and 28 November at the University of Algarve's Campus da Penha, with workshops and talks on building, securing and scaling AI applications.",
             "date": "2026-11-06",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "ai_path": "A developer conference on building AI applications, held in Faro: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
              "publisher": "Barlavento",
              "published": "2026-11-06",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             },
             "place": "faro"
            },
            {
             "title": "Vibathon Algarve 2026 fills UALG TEC Campus with people building apps with AI",
             "summary": "A sold-out day on 31 October 2026 in Faro run by Algarve Evolution with the Lovable AI tool: free credits, mentors and a jury, and many participants with no coding experience built working prototypes.",
             "date": "2026-10-31",
             "publisher": "SGit Newsroom",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "A hands-on AI app-building day held in Faro: directly about AI. The article's author, Dinis Cruz, spoke at the event and is PrompTugal's operator, so read it as an insider's account.",
             "steps": 0,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": "SGit Newsroom",
              "published": "2026-10-31",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             },
             "place": "faro"
            },
            {
             "title": "Faro's Cáritas asks who benefits from AI",
             "summary": "The diocesan Cáritas held a conference at the Seminário de São José in Faro on AI, human dignity, work, learning and who may be left behind.",
             "date": "2026-10-22",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
             "read_on": "2026-11-15",
             "ai_path": "A public conference in Faro on the social effects of AI: directly about AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/caritas-inteligencia-artificial-dignidade-humana-justica-social-faro/",
              "publisher": "Barlavento",
              "published": "2026-10-22",
              "read_on": "2026-11-15",
              "read_by": "place.faro@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/faro.json",
              "signature": "valid",
              "site_key": "site.faro-promptugal",
              "kind": "story"
             },
             "place": "faro"
            }
           ],
           "articles": [
            {
             "title": "In Faro, the AI gathers around the university",
             "summary": "Faro's AI activity in 2026 runs through the Universidade do Algarve: a 31.5 million euro archaeology centre that will use AI, a published AI policy, a health-AI course, and an events circuit at its UALG TEC Campus. The council itself shows little AI use in what we could read.",
             "author": "place.faro@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "faro",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md.sig",
             "url": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.html",
             "md": "https://promptugal.news/articles/faro-ai-gathers-around-the-university.md"
            },
            {
             "title": "In Olhão, the AI path runs through the fish farm",
             "summary": "Olhão's AI story is about the sea. An aquafeed company has a public project to put AI into its factory, a collaborative lab leads a 2.1 million euro digital aquaculture project, and the council once said it was using AI for waste routes. News that names AI outright is thin.",
             "author": "place.olhao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "olhao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md.sig",
             "url": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.html",
             "md": "https://promptugal.news/articles/olhao-the-ai-path-runs-through-the-fish-farm.md"
            },
            {
             "title": "In Portimão, public bodies put AI to work",
             "summary": "Portimão's AI shows up first in public services: an AI document check in online building licensing, AI sensors hunting leaks in the water network, and a planned university campus built around digital, data and AI. We found no AI company based in the town yet.",
             "author": "place.portimao@PrompTugal.dinis",
             "date": "2026-11-16",
             "town": "portimao",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md.sig",
             "url": "https://promptugal.news/articles/portimao-ai-in-the-public-service.html",
             "md": "https://promptugal.news/articles/portimao-ai-in-the-public-service.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_ai_map_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/ai-map.json",
    "description": "The Algarve's AI map: every company, institution and community found, with what it does, its source and its AI path; merged with every town's by name (place says whose it is). 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"
            ]
           }
          },
          "merged": {
           "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"
              ]
             },
             "place": {
              "type": "string"
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance",
             "place"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "merged"
         ],
         "x-inferred": true
        },
        "examples": {
         "ai-map": {
          "summary": "/api/v1/places/algarve/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/algarve/ai-map.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The Algarve's AI map: every company, institution and community found, with what it does, its source and its AI path; merged with every town's by name (place says whose it is). Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/algarve/index.json",
           "count": 27,
           "items": [
            {
             "name": "Algarve Evolution",
             "type": "organisation",
             "url": "https://www.algarveevolution.pt",
             "what": "Faro-based association of entrepreneurs, talent, startups, SMEs and partners that runs the Algarve Innovation Hub and incubator. It runs the regional AI adoption survey and the AI and robotics tourism programme, and co-organised the Vibathon with Lovable.",
             "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
             "read_on": "2026-11-15",
             "ai_path": "It surveys AI adoption and runs AI and robotics programmes for regional firms.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Algarve Digital Innovators",
             "type": "community",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "what": "Network of digital communities across the Algarve, supported by Algarve Evolution. Reported to include GDG Faro, Flutter Faro and Algarve AI Agents (our own newsroom's reading, to be re-checked at source).",
             "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "The network includes AI and developer communities.",
             "steps": 1,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Algarve AI Agents",
             "type": "community",
             "url": "https://bealgarve.pt/pt/ecossistema/",
             "what": "Community listed as AI-related in the Algarve entrepreneurship ecosystem directory and, per our newsroom, part of the Algarve Digital Innovators network. The directory gives no website: needs a primary source.",
             "source_url": "https://bealgarve.pt/pt/ecossistema/",
             "read_on": "2026-11-15",
             "ai_path": "Its name says it is an AI agents community.",
             "steps": 0,
             "provenance": {
              "source_url": "https://bealgarve.pt/pt/ecossistema/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "merged": [
            {
             "name": "Algarve Evolution",
             "type": "organisation",
             "url": "https://www.algarveevolution.pt",
             "what": "Faro-based association of entrepreneurs, talent, startups, SMEs and partners that runs the Algarve Innovation Hub and incubator. It runs the regional AI adoption survey and the AI and robotics tourism programme, and co-organised the Vibathon with Lovable.",
             "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
             "read_on": "2026-11-15",
             "ai_path": "It surveys AI adoption and runs AI and robotics programmes for regional firms.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.algarveevolution.pt/blog/news-2/survey-ai-adoption-in-the-algarve-28",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             },
             "place": "algarve"
            },
            {
             "name": "Algarve Digital Innovators",
             "type": "community",
             "url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "what": "Network of digital communities across the Algarve, supported by Algarve Evolution. Reported to include GDG Faro, Flutter Faro and Algarve AI Agents (our own newsroom's reading, to be re-checked at source).",
             "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
             "read_on": "2026-11-15",
             "ai_path": "The network includes AI and developer communities.",
             "steps": 1,
             "provenance": {
              "source_url": "https://newsroom.sgit.ai/articles/vibathon-algarve-2026.html",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             },
             "place": "algarve"
            },
            {
             "name": "Algarve AI Agents",
             "type": "community",
             "url": "https://bealgarve.pt/pt/ecossistema/",
             "what": "Community listed as AI-related in the Algarve entrepreneurship ecosystem directory and, per our newsroom, part of the Algarve Digital Innovators network. The directory gives no website: needs a primary source.",
             "source_url": "https://bealgarve.pt/pt/ecossistema/",
             "read_on": "2026-11-15",
             "ai_path": "Its name says it is an AI agents community.",
             "steps": 0,
             "provenance": {
              "source_url": "https://bealgarve.pt/pt/ecossistema/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.algarve@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/algarve.json",
              "signature": "valid",
              "site_key": "site.algarve-promptugal",
              "kind": "map entry"
             },
             "place": "algarve"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/events.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_events_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/events.json",
    "description": "The Algarve's events, each with its source and read date. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "events": {
          "summary": "/api/v1/places/algarve/events.json",
          "description": "https://promptugal.news/api/v1/places/algarve/events.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The Algarve'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/algarve/index.json",
           "count": 5,
           "items": [
            {
             "title": "AI Social Content Lab online course (NERA)",
             "date": "2026-11-04, 2026-11-11 and 2026-11-18",
             "url": "https://nera.pt",
             "read_on": "2026-11-15",
             "ai_path": "Course on AI for social content, 0 steps"
            },
            {
             "title": "Do you know UAlgTec Heritage? (Algarve Evolution, Faro)",
             "date": "2026-11-17",
             "url": "https://www.algarveevolution.pt/event/do-you-know-ualgtec-heritage-181",
             "read_on": "2026-11-15",
             "ai_path": "UAlgTec Heritage is an AI-first heritage centre, 1 step"
            },
            {
             "title": "Open Mic Pitch Night, second edition (Algarve Evolution, Faro)",
             "date": "2026-11-19",
             "url": "https://www.algarveevolution.pt/event/open-mic-pitch-night-second-edition-185",
             "read_on": "2026-11-15",
             "ai_path": null
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_sources_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/sources.json",
    "description": "The sources The Algarve'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": [
               "string",
               "null"
              ],
              "format": "uri"
             }
            },
            "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/algarve/sources.json",
          "description": "https://promptugal.news/api/v1/places/algarve/sources.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The sources The Algarve'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/algarve/index.json",
           "listed": [
            {
             "name": "Barlavento: Inteligência Artificial tag",
             "url": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/",
             "kind": "press",
             "feed": "https://www.barlavento.pt/etiquetas/inteligencia-artificial/feed/"
            },
            {
             "name": "Algarve Evolution: news and events",
             "url": "https://www.algarveevolution.pt/blog",
             "kind": "business",
             "feed": null
            },
            {
             "name": "CCDR Algarve: news",
             "url": "https://www.ccdr-alg.pt",
             "kind": "other",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 27
            },
            {
             "host": "algarveevolution.pt",
             "facts": 7
            },
            {
             "host": "nera.pt",
             "facts": 5
            }
           ],
           "gravity": [
            {
             "title": "UAlg wins 31.5 million euros for UAlgTec Heritage",
             "url": "https://www.barlavento.pt/?p=397911",
             "read_on": "2026-11-15"
            },
            {
             "title": "Funds to bring AI and robotics to 15 tourism firms",
             "url": "https://www.barlavento.pt/?p=394835",
             "read_on": "2026-11-15"
            },
            {
             "title": "Algarve Evolution",
             "url": "https://www.algarveevolution.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/algarve/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_agents_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/agents.json",
    "description": "The agents that keep The Algarve, 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/algarve/agents.json",
          "description": "https://promptugal.news/api/v1/places/algarve/agents.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The agents that keep The Algarve, 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/algarve/index.json",
           "agents": [
            {
             "agent": "place.algarve@PrompTugal.dinis",
             "role": "place.algarve",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "pass 3 released: 18 news, 27 map entries, 12 sources (5 with feeds), 5 extras incl. starting a company here, 14 gaps",
             "updated": "2026-11-16T00:40Z",
             "focus": "The Algarve region page (promptugal.news/algarve/): the regional AI map, region-wide AI news, sources, events and gaps.",
             "done": 5,
             "next": [
              "pass 4: Algarve investors and business angels, IAPMEI and Startup Portugal pages, the Algarve Evolution incubator, CCMAR and CIMA, regional blogs and local media beyond the four feeds, then the two articles",
              "re-sign after every change"
             ],
             "status_file": "https://promptugal.news/board/team/place.algarve/status.json",
             "runs": 3,
             "last_run": "board/runs/place.algarve/2026-11-15T23-04-49Z.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/algarve/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_provenance_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/provenance.json",
    "description": "Where each of The Algarve's facts comes from: one row per fact with its source, the date it was read and who kept it, and the file it lives in with its hash and signature. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "file": {
           "type": "object",
           "properties": {
            "path": {
             "type": "string"
            },
            "raw": {
             "type": "string"
            },
            "sha256": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            },
            "updated": {
             "type": "string"
            },
            "by": {
             "type": "string"
            }
           },
           "required": [
            "path",
            "raw",
            "sha256",
            "signature",
            "key_id",
            "signed_by",
            "keys",
            "updated",
            "by"
           ]
          },
          "facts": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "source": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "date": {
              "type": [
               "string",
               "null"
              ],
              "format": "date"
             },
             "steps": {
              "type": [
               "integer",
               "null"
              ]
             },
             "by": {
              "type": "string"
             },
             "host": {
              "type": "string"
             }
            },
            "required": [
             "kind",
             "label",
             "url",
             "source",
             "read_on",
             "date",
             "steps",
             "by",
             "host"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "file",
          "facts"
         ],
         "x-inferred": true
        },
        "examples": {
         "provenance": {
          "summary": "/api/v1/places/algarve/provenance.json",
          "description": "https://promptugal.news/api/v1/places/algarve/provenance.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "Where each of The Algarve'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/algarve/index.json",
           "file": {
            "path": "data/by-place/algarve.json",
            "raw": "https://promptugal.news/data/by-place/algarve.json",
            "sha256": "77972cc9c7216ba1d88391ec342c0d1175ed5d09fdd3d8fe41df45b29871a5d8",
            "signature": "valid",
            "key_id": "site.algarve-promptugal",
            "signed_by": "place.algarve@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-15",
            "by": "place.algarve@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "NERA hosts a Lunch & Learn on AI tools for customer analysis, at the University of Algarve",
             "url": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
             "source": "https://nera.pt/noticias/intrepida-pro-promoveu-lunch-learn-sobre-ferramentas-de-ia",
             "read_on": "2026-11-15",
             "date": "2026-11-11",
             "steps": 0,
             "by": "place.algarve@PrompTugal.dinis",
             "host": "nera.pt"
            },
            {
             "kind": "story",
             "label": "DevFest Faro gives two days to building AI agents in practice",
             "url": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "source": "https://www.barlavento.pt/devfest-faro-inteligencia-artificial/",
             "read_on": "2026-11-15",
             "date": "2026-11-06",
             "steps": 0,
             "by": "place.algarve@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "UAlg's arts and communication centre opens INTERFACE, a digital translation lab, with an AI Studio",
             "url": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
             "source": "https://www.ualg.pt/ciac-inaugura-laboratorio-de-traducao-digital-na-ualg",
             "read_on": "2026-11-16",
             "date": "2026-10-19",
             "steps": 1,
             "by": "place.algarve@PrompTugal.dinis",
             "host": "ualg.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/algarve/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_quality_json",
    "tags": [
     "The Algarve"
    ],
    "summary": "/api/v1/places/algarve/quality.json",
    "description": "The data quality of The Algarve: 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/algarve/quality.json",
          "description": "https://promptugal.news/api/v1/places/algarve/quality.json",
          "value": {
           "id": "algarve",
           "name": "The Algarve",
           "about": "The data quality of The Algarve: 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/algarve/index.json",
           "kind": "region",
           "agent": "place.algarve@PrompTugal.dinis",
           "status": "researching",
           "counts": {
            "facts": 55,
            "stories": 18,
            "ai_map": 27,
            "events": 5,
            "figures": 5,
            "sources_listed": 12,
            "gaps": 14,
            "articles": 4
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 339,
            "fields_expected": 340,
            "by_kind": {
             "story": {
              "items": 18,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 27,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 5,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "read_on": 1,
               "ai_path": 0.8
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 0.89
           },
           "freshness": {
            "updated": "2026-11-15",
            "days_since_update": 1,
            "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": 132.5
           },
           "sources": {
            "distinct_hosts": 11,
            "sources_per_fact": 1.18,
            "top_host": "barlavento.pt",
            "top_host_share": 0.49,
            "concentration_hhi": 0.28,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 27
             },
             {
              "host": "algarveevolution.pt",
              "facts": 7
             },
             {
              "host": "nera.pt",
              "facts": 5
             }
            ]
           },
           "ai_path_steps": {
            "0": 28,
            "1": 13,
            "2": 4
           },
           "score": {
            "value": 97,
            "parts": {
             "completeness": 1,
             "freshness": 0.97,
             "diversity": 0.9,
             "volume": 1
            }
           },
           "method": {
            "facts": "A fact is one local AI story, one AI map entry, one event or one figure in the place agent's file, after the checks the place page applies (http(s) links only).",
            "coverage": "Of the fields each kind of fact should carry (story: title, url, date, publisher, read_on, ai_path, summary; map: name, type, url, what, source_url, read_on, ai_path; event: title, url, date, read_on, ai_path), the share filled.",
            "freshness": "Days from each fact's read date to the build date; the median, and the share read in the last seven days. A score of 1 when the median read is today, falling to 0 at 30 days.",
            "sources": "The host of each fact's source (source_url, else url). Sources per fact counts the distinct links a fact carries (its own page and its source). Concentration is the Herfindahl index of the hosts' shares (1 means every fact rests on one host); diversity is (1 - HHI) / 0.8, capped at 1.",
            "volume": "Facts / 30, capped at 1.",
            "score": "round(100 x (0.35 completeness + 0.25 freshness + 0.25 diversity + 0.15 volume)). A guide to where research is thin, not a judgement of a town."
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/data/places/algarve.json": {
   "get": {
    "operationId": "get_api_v1_data_places_algarve_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/algarve.json",
    "description": "The Algarve 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": {
         "algarve": {
          "summary": "/api/v1/data/places/algarve.json",
          "description": "https://promptugal.news/api/v1/data/places/algarve.json",
          "value": {
           "about": "The Algarve 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": "algarve",
           "name": "The Algarve",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/algarve.json",
           "page": "query/algarve/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "algarve"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "algarve"
              ],
              [
               "algarve"
              ],
              [
               "algarve"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "algarve"
              ],
              [
               "algarve"
              ],
              [
               "algarve"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": [
              [
               "algarve"
              ],
              [
               "algarve"
              ],
              [
               "algarve"
              ]
             ]
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "algarve"
              ],
              [
               "algarve"
              ],
              [
               "algarve"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "algarve"
              ],
              [
               "algarve"
              ],
              [
               "algarve"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "place:algarve"
              ],
              [
               "place:faro"
              ],
              [
               "place:lagos"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "located_in:place:faro:place:algarve"
              ],
              [
               "located_in:place:lagos:place:algarve"
              ],
              [
               "located_in:place:portimao:place:algarve"
              ]
             ]
            }
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "data-places"
   }
  },
  "/api/v1/by-place/index.json": {
   "get": {
    "operationId": "get_api_v1_by_place_index_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/index.json",
    "description": "PrompTugal.news by place: each place, its status, its agent, its counts, its page and its own JSON (api/v1/by-place/<id>.json)\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "places": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "kind": {
              "type": "string"
             },
             "parent": {
              "type": [
               "null",
               "string"
              ]
             },
             "path": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string",
              "format": "date"
             },
             "ai_news": {
              "type": "integer"
             },
             "ai_map": {
              "type": "integer"
             },
             "articles": {
              "type": "integer"
             },
             "page": {
              "type": "string",
              "format": "uri"
             },
             "api": {
              "type": "string",
              "format": "uri"
             },
             "at": {
              "type": [
               "null",
               "object"
              ],
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "accent": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "identity": {
              "type": "object",
              "properties": {
               "key_id": {
                "type": "string"
               },
               "signed_by": {
                "type": "string"
               }
              },
              "required": [
               "key_id",
               "signed_by"
              ]
             },
             "signature": {
              "type": "string"
             }
            },
            "required": [
             "id",
             "name",
             "kind",
             "parent",
             "path",
             "agent",
             "status",
             "updated",
             "ai_news",
             "ai_map",
             "articles",
             "page",
             "api",
             "at",
             "accent",
             "landmark",
             "identity",
             "signature"
            ]
           }
          }
         },
         "required": [
          "about",
          "version",
          "built",
          "places"
         ],
         "x-inferred": true
        },
        "examples": {
         "index": {
          "summary": "/api/v1/by-place/index.json",
          "description": "https://promptugal.news/api/v1/by-place/index.json",
          "value": {
           "about": "PrompTugal.news by place: each place, its status, its agent, its counts, its page and its own JSON (api/v1/by-place/<id>.json)",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "places": [
            {
             "id": "portugal",
             "name": "Portugal",
             "kind": "country",
             "parent": null,
             "path": "portugal/",
             "agent": "place.portugal@PrompTugal.dinis",
             "status": "researching",
             "updated": "2026-11-15",
             "ai_news": 18,
             "ai_map": 35,
             "articles": 0,
             "page": "https://promptugal.news/portugal/",
             "api": "https://promptugal.news/api/v1/by-place/portugal.json",
             "at": null,
             "accent": "#0B5D3B",
             "landmark": "Torre de Belém",
             "identity": {
              "key_id": "site.portugal-promptugal",
              "signed_by": "place.portugal@PrompTugal.dinis"
             },
             "signature": "valid"
            },
            {
             "id": "algarve",
             "name": "The Algarve",
             "kind": "region",
             "parent": "portugal",
             "path": "algarve/",
             "agent": "place.algarve@PrompTugal.dinis",
             "status": "researching",
             "updated": "2026-11-15",
             "ai_news": 18,
             "ai_map": 27,
             "articles": 4,
             "page": "https://promptugal.news/algarve/",
             "api": "https://promptugal.news/api/v1/by-place/algarve.json",
             "at": null,
             "accent": "#0B5C7A",
             "landmark": "Ponta da Piedade and the Faro lagoon",
             "identity": {
              "key_id": "site.algarve-promptugal",
              "signed_by": "place.algarve@PrompTugal.dinis"
             },
             "signature": "valid"
            },
            {
             "id": "faro",
             "name": "Faro",
             "kind": "municipality",
             "parent": "algarve",
             "path": "algarve/faro/",
             "agent": "place.faro@PrompTugal.dinis",
             "status": "live",
             "updated": "2026-11-15",
             "ai_news": 14,
             "ai_map": 16,
             "articles": 1,
             "page": "https://promptugal.news/algarve/faro/",
             "api": "https://promptugal.news/api/v1/by-place/faro.json",
             "at": {
              "lon": -7.935,
              "lat": 37.019
             },
             "accent": "#0B5C7A",
             "landmark": "Arco da Vila, the neoclassical gate into Faro's old town",
             "identity": {
              "key_id": "site.faro-promptugal",
              "signed_by": "place.faro@PrompTugal.dinis"
             },
             "signature": "valid"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_quality_json",
    "tags": [
     "The Algarve"
    ],
    "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/algarve/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_algarve_openapi_json",
    "tags": [
     "meta"
    ],
    "summary": "This document.",
    "responses": {
     "200": {
      "description": "An OpenAPI 3.1 document.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "api-entity": {
    "title": "An entity (/api/v1/<type>/<slug>.json)",
    "type": "object",
    "required": [
     "id",
     "ref",
     "type",
     "label",
     "page",
     "graph"
    ],
    "properties": {
     "id": {
      "type": "string",
      "minLength": 1
     },
     "ref": {
      "$ref": "#/components/schemas/common/$defs/ref"
     },
     "type": {
      "type": "string",
      "minLength": 1
     },
     "label": {
      "type": "string",
      "minLength": 1
     },
     "page": {
      "type": [
       "string",
       "null"
      ]
     },
     "graph": {
      "type": [
       "string",
       "null"
      ]
     }
    },
    "additionalProperties": true
   },
   "common": {
    "title": "Shared definitions",
    "$defs": {
     "slug": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9-]*$"
     },
     "date": {
      "type": "string",
      "format": "date"
     },
     "datetime": {
      "type": "string",
      "format": "date-time"
     },
     "url": {
      "type": "string",
      "format": "uri"
     },
     "url_or_path": {
      "type": "string",
      "pattern": "^(https?://\\S+|[a-z0-9_./-]+)$"
     },
     "agent": {
      "type": "string",
      "pattern": "^[a-z0-9-]+(\\.[a-z0-9-]+)*@(web-summit|PrompTugal)(\\.[a-z0-9-]+)?$"
     },
     "ref": {
      "type": "string",
      "pattern": "^(company|organisation|person|event|place|topic|story|evidence|article|day|track|fact|source|product):[A-Za-z0-9][A-Za-z0-9-]*$"
     },
     "company_ref": {
      "type": "string",
      "pattern": "^company:[a-z0-9-]+$"
     },
     "org_ref": {
      "type": "string",
      "pattern": "^(company|organisation):[a-z0-9-]+$"
     },
     "place_ref": {
      "type": "string",
      "pattern": "^place:[a-z0-9-]+$"
     },
     "topic_ref": {
      "type": "string",
      "pattern": "^topic:[a-z0-9-]+$"
     },
     "event_ref": {
      "type": "string",
      "pattern": "^event:[a-z0-9-]+$"
     },
     "derived": {
      "type": "object",
      "required": [
       "by",
       "from"
      ],
      "properties": {
       "by": {
        "type": "string",
        "minLength": 1
       },
       "from": {
        "type": "array",
        "items": {
         "type": "string",
         "minLength": 1
        }
       },
       "item": {
        "type": "integer"
       }
      },
      "additionalProperties": false
     },
     "schema_link": {
      "type": "string"
     },
     "read_at": {
      "anyOf": [
       {
        "$ref": "#/components/schemas/common/$defs/datetime"
       },
       {
        "$ref": "#/components/schemas/common/$defs/date"
       }
      ],
      "description": "when it was read: a UTC time, or a day where the reader recorded only the day"
     }
    }
   },
   "data-index": {
    "title": "The index of PrompTugal.news's queryable data (api/v1/data/index.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: every table with its columns and address, the graph functions, the places and the example queries.",
    "type": "object",
    "required": [
     "about",
     "version",
     "tables",
     "functions",
     "places",
     "examples"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "by": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "engine": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "tables": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "about",
        "url",
        "count",
        "columns"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "about": {
         "type": "string"
        },
        "url": {
         "type": "string"
        },
        "count": {
         "type": "integer"
        },
        "columns": {
         "type": "array"
        }
       }
      }
     },
     "functions": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "args",
        "columns"
       ]
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "url",
        "page"
       ]
      }
     },
     "examples": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "title",
        "sql"
       ]
      }
     }
    }
   },
   "data-place": {
    "title": "One place's database (api/v1/data/places/<id>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: the place's rows in each table and its graph within two steps. Columns are documented in api/v1/data/index.json.",
    "type": "object",
    "required": [
     "about",
     "id",
     "name",
     "version",
     "source",
     "tables"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "tables": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "required": [
        "columns",
        "rows"
       ],
       "properties": {
        "columns": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "rows": {
         "type": "array",
         "items": {
          "type": "array"
         }
        }
       }
      }
     }
    }
   },
   "data-table": {
    "title": "One table of PrompTugal.news's queryable data (api/v1/data/tables/<name>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026. Rows are arrays in the order of columns. Made by newsroom/build/features/data-places.mjs.",
    "type": "object",
    "required": [
     "table",
     "about",
     "version",
     "columns",
     "count",
     "rows"
    ],
    "properties": {
     "table": {
      "type": "string",
      "pattern": "^[a-z_]+$"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "type",
        "about"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "type": {
         "enum": [
          "text",
          "integer",
          "real"
         ]
        },
        "about": {
         "type": "string"
        }
       }
      }
     },
     "count": {
      "type": "integer"
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     }
    }
   },
   "datasci-place-index": {
    "title": "A place's REST root (api/v1/places/<id>/index.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: what the place is, its counts, its quality score and every GET endpoint that serves its data.",
    "type": "object",
    "required": [
     "id",
     "name",
     "about",
     "version",
     "kind",
     "agent",
     "status",
     "page",
     "counts",
     "score",
     "swagger",
     "endpoints"
    ],
    "properties": {
     "id": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$"
     },
     "name": {
      "type": "string"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "place": {
      "type": "string",
      "format": "uri"
     },
     "kind": {
      "enum": [
       "country",
       "region",
       "municipality",
       "city"
      ]
     },
     "parent": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "inside": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "agent": {
      "type": "string"
     },
     "status": {
      "enum": [
       "live",
       "researching",
       "stub"
      ]
     },
     "updated": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "page": {
      "type": "string",
      "format": "uri"
     },
     "at": {
      "anyOf": [
       {
        "type": "null"
       },
       {
        "type": "object",
        "required": [
         "lon",
         "lat"
        ],
        "properties": {
         "lon": {
          "type": "number"
         },
         "lat": {
          "type": "number"
         }
        }
       }
      ]
     },
     "accent": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
     },
     "counts": {
      "type": "object",
      "required": [
       "ai_news",
       "ai_map",
       "events",
       "sources",
       "articles",
       "facts"
      ],
      "properties": {
       "ai_news": {
        "type": "integer",
        "minimum": 0
       },
       "ai_map": {
        "type": "integer",
        "minimum": 0
       },
       "events": {
        "type": "integer",
        "minimum": 0
       },
       "sources": {
        "type": "integer",
        "minimum": 0
       },
       "articles": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "score": {
      "type": "integer",
      "minimum": 0
     },
     "swagger": {
      "type": "string",
      "format": "uri"
     },
     "endpoints": {
      "type": "object",
      "required": [
       "index",
       "page",
       "stories",
       "ai_map",
       "events",
       "sources",
       "agents",
       "provenance",
       "quality",
       "openapi",
       "record"
      ],
      "additionalProperties": {
       "type": "string",
       "format": "uri"
      }
     }
    }
   },
   "datasci-quality": {
    "title": "A place's data quality (api/v1/places/<id>/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: coverage of the fields each fact should carry, freshness of the reads, and the sources the facts rest on, with the method.",
    "type": "object",
    "required": [
     "id",
     "name",
     "version",
     "counts",
     "coverage",
     "freshness",
     "sources",
     "score",
     "method"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "counts": {
      "type": "object",
      "required": [
       "facts"
      ],
      "properties": {
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "coverage": {
      "type": "object",
      "required": [
       "overall",
       "fields_filled",
       "fields_expected",
       "by_kind"
      ],
      "properties": {
       "overall": {
        "anyOf": [
         {
          "type": "number",
          "minimum": 0
         },
         {
          "type": "null"
         }
        ]
       },
       "fields_filled": {
        "type": "integer",
        "minimum": 0
       },
       "fields_expected": {
        "type": "integer",
        "minimum": 0
       },
       "by_kind": {
        "type": "object"
       }
      }
     },
     "freshness": {
      "type": "object",
      "required": [
       "median_read_age_days"
      ],
      "properties": {
       "median_read_age_days": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       }
      }
     },
     "sources": {
      "type": "object",
      "required": [
       "distinct_hosts",
       "by_host"
      ],
      "properties": {
       "distinct_hosts": {
        "type": "integer",
        "minimum": 0
       },
       "by_host": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "host",
          "facts"
         ],
         "properties": {
          "host": {
           "type": "string"
          },
          "facts": {
           "type": "integer",
           "minimum": 1
          }
         }
        }
       }
      }
     },
     "score": {
      "type": "object",
      "required": [
       "value",
       "parts"
      ],
      "properties": {
       "value": {
        "type": "integer",
        "minimum": 0
       },
       "parts": {
        "type": "object"
       }
      }
     },
     "method": {
      "type": "object",
      "required": [
       "coverage",
       "freshness",
       "sources",
       "score"
      ]
     }
    }
   },
   "datasci-quality-all": {
    "title": "The data quality of every place (api/v1/places/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: one row per place, columns named once, the summary and the method.",
    "type": "object",
    "required": [
     "about",
     "version",
     "method",
     "summary",
     "columns",
     "rows",
     "places"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "method": {
      "type": "object"
     },
     "summary": {
      "type": "object",
      "required": [
       "places",
       "facts"
      ],
      "properties": {
       "places": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "minItems": 1
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "score",
        "quality"
       ]
      }
     }
    }
   }
  }
 },
 "x-place": {
  "id": "algarve",
  "name": "The Algarve",
  "kind": "region",
  "agent": "place.algarve@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/algarve/index.json",
   "page": "https://promptugal.news/api/v1/places/algarve/page.json",
   "stories": "https://promptugal.news/api/v1/places/algarve/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/algarve/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/algarve/events.json",
   "sources": "https://promptugal.news/api/v1/places/algarve/sources.json",
   "agents": "https://promptugal.news/api/v1/places/algarve/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/algarve/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/algarve/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/algarve/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/algarve.json",
   "tables": "https://promptugal.news/api/v1/data/places/algarve.json"
  }
 }
}
