{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Lagos: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/lagos/ shows, as GET calls: its REST root (/api/v1/places/lagos/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.lagos@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Lagos'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": "Lagos",
   "description": "Lagos'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 Lagos",
  "url": "https://promptugal.news/algarve/lagos/"
 },
 "paths": {
  "/api/v1/by-place/lagos.json": {
   "get": {
    "operationId": "get_api_v1_by_place_lagos_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/lagos.json",
    "description": "PrompTugal.news Lagos: the place's research as served on its page, its lists checked at build (http(s) links only, stories newest first), with its site identity as verified\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "kind": {
           "type": "string"
          },
          "parent": {
           "type": "string"
          },
          "inside": {
           "type": "array"
          },
          "agent": {
           "type": "string"
          },
          "status": {
           "type": "string"
          },
          "updated": {
           "type": "string"
          },
          "by": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "raw": {
           "type": "string"
          },
          "at": {
           "type": "object",
           "properties": {
            "lon": {
             "type": "number"
            },
            "lat": {
             "type": "number"
            }
           },
           "required": [
            "lon",
            "lat"
           ]
          },
          "look": {
           "type": "object",
           "properties": {
            "image": {
             "type": "null"
            },
            "accent": {
             "type": "string"
            },
            "landmark": {
             "type": "string"
            },
            "motif": {
             "type": "string"
            }
           },
           "required": [
            "image",
            "accent",
            "landmark",
            "motif"
           ]
          },
          "mandate": {
           "type": "string"
          },
          "gravity": {
           "type": "object",
           "properties": {
            "text": {
             "type": "string"
            },
            "sources": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "title": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               }
              },
              "required": [
               "title",
               "url",
               "read_on"
              ]
             }
            }
           },
           "required": [
            "text",
            "sources"
           ]
          },
          "counts": {
           "type": "object",
           "properties": {
            "ai_news": {
             "type": "integer"
            },
            "ai_map": {
             "type": "integer"
            },
            "events": {
             "type": "integer"
            },
            "sources": {
             "type": "integer"
            },
            "articles": {
             "type": "integer"
            }
           },
           "required": [
            "ai_news",
            "ai_map",
            "events",
            "sources",
            "articles"
           ]
          },
          "ai_news": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "ai_map": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": [
               "string",
               "null"
              ]
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": "null"
             }
            },
            "required": [
             "name",
             "url",
             "kind",
             "feed"
            ]
           }
          },
          "extras": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "label": {
              "type": "string"
             },
             "value": {
              "type": "string"
             },
             "source_url": {
              "type": "string"
             },
             "read_on": {
              "type": "string"
             }
            },
            "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"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          },
          "team": {
           "type": "object",
           "properties": {
            "agent": {
             "type": "string"
            },
            "status": {
             "type": "string"
            },
            "debriefs": {
             "type": "string"
            },
            "runs": {
             "type": "string"
            }
           },
           "required": [
            "agent",
            "status",
            "debriefs",
            "runs"
           ]
          },
          "identity": {
           "type": "object",
           "properties": {
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            }
           },
           "required": [
            "key_id",
            "signed_by",
            "signature",
            "keys"
           ]
          }
         },
         "required": [
          "about",
          "version",
          "id",
          "name",
          "kind",
          "parent",
          "inside",
          "agent",
          "status",
          "updated",
          "by",
          "page",
          "twin",
          "raw",
          "at",
          "look",
          "mandate",
          "gravity",
          "counts",
          "ai_news",
          "ai_map",
          "events",
          "sources",
          "extras",
          "gaps",
          "voice",
          "articles",
          "team",
          "identity"
         ],
         "x-inferred": true
        },
        "examples": {
         "lagos": {
          "summary": "/api/v1/by-place/lagos.json",
          "description": "https://promptugal.news/api/v1/by-place/lagos.json",
          "value": {
           "about": "PrompTugal.news Lagos: 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": "lagos",
           "name": "Lagos",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.lagos@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-16",
           "by": "place.lagos@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/lagos/",
           "twin": "https://promptugal.news/algarve/lagos/index.md",
           "raw": "https://promptugal.news/data/by-place/lagos.json",
           "at": {
            "lon": -8.673,
            "lat": 37.102
           },
           "look": {
            "image": null,
            "accent": "#9A4A12",
            "landmark": "Ponta da Piedade, the golden cliffs and sea grottoes",
            "motif": "ochre cliffs, turquoise water, caravels of the Age of Discoveries"
           },
           "mandate": "PrompTugal.news Lagos: AI and technology in Lagos, a town of remote workers, a municipal coworking space and a busy Google developer community, and what reaches Lagos from the Algarve, Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "Lagos is where the Algarve's tech community meets in person. The council co-organised the Algarve Tech Hub Summit here in November 2025, which drew several hundred people to one hotel, and it works with GDG Lagos on AI events such as DevFest Lagos 2025 and International Women's Day Build with AI. The municipal coworking space CoLagos has been fully occupied since November 2023, and a community bui...",
            "sources": [
             {
              "title": "Barlavento: Lagos foi capital da inovacao no Algarve Tech Hub Summit (14 Nov 2025)",
              "url": "https://www.barlavento.pt/lagos-foi-capital-da-inovacao-no-algarve-tech-hub-summit/",
              "read_on": "2026-11-15"
             },
             {
              "title": "Barlavento: CoLagos wins the Cinco Estrelas award for the third time (15 Apr 2025)",
              "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
              "read_on": "2026-11-15"
             },
             {
              "title": "Barlavento: more than 250 took part in Google DevFest Lagos 2025 (23 Oct 2025)",
              "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 3,
            "ai_map": 11,
            "events": 4,
            "sources": 10,
            "articles": 1
           },
           "ai_news": [
            {
             "title": "Algarve Tech Hub Summit lands in Lagos with a live AI demo",
             "summary": "The two-day summit ran at a Lagos hotel on 6 and 7 November 2025. A preview named a live demonstration of building a specialised ChatGPT on the first day. Barlavento later counted about 450 people on day one and 570 on day two.",
             "date": "2025-11-04",
             "publisher": "Observador",
             "url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
             "read_on": "2026-11-15",
             "ai_path": "A summit hosted in Lagos with a session that shows how to build a specialised ChatGPT (AI directly, in one session of a wider programme).",
             "steps": 1,
             "provenance": {
              "source_url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
              "publisher": "Observador",
              "published": "2025-11-04",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Lagos hosts DevFest 2025 with an AI theory-to-action day",
             "summary": "GDG Lagos and the council ran DevFest on 17 and 18 October 2025. Day one reached about 150 students in schools. Day two at the Town Hall was themed AI from theory to action, with 120 registrations. CoLagos and the Fábrica do Empreendedor were partners.",
             "date": "2025-10-23",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "read_on": "2026-11-15",
             "ai_path": "A developer conference whose second day was about AI, automation and app building for business.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
              "publisher": "Barlavento",
              "published": "2025-10-23",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "CoLagos, the council's coworking space, wins a regional award for the third year",
             "summary": "The municipal coworking space in the old town has 20 workstations and has been full since November 2023. It also partners GDG Lagos on AI events.",
             "date": "2025-04-15",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15",
             "ai_path": "CoLagos is a partner of GDG Lagos's AI events, and it houses the remote workers and small firms who attend them.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
              "publisher": "Barlavento",
              "published": "2025-04-15",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "GDG Lagos (Google Developer Group)",
             "type": "community",
             "url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-build-with-ai-intro-to-ai-agent-skills/",
             "what": "Runs AI talks and workshops at The Collab Bar and the Town Hall, including Build with AI, an agents talk and DevFest Lagos.",
             "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-ai-agents-the-architects-of-automation/",
             "read_on": "2026-11-15",
             "ai_path": "Its programme is largely about AI, agents and building with AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-ai-agents-the-architects-of-automation/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Câmara Municipal de Lagos",
             "type": "public body",
             "url": "https://www.cm-lagos.pt/",
             "what": "Co-organised DevFest Lagos 2025 and the International Women's Day Build with AI event, which was held in its Town Hall, and co-organised the 2025 Algarve Tech Hub Summit.",
             "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-international-womens-day-build-with-ai",
             "read_on": "2026-11-15",
             "ai_path": "A public body that hosts and co-organises AI events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-international-womens-day-build-with-ai",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CoLagos, municipal coworking space",
             "type": "organisation",
             "url": "https://www.colagos.pt/",
             "what": "Run with the Lagos Youth Association (A)Garra in the old town, 20 workstations, partner of DevFest Lagos 2025.",
             "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15",
             "ai_path": "A partner of GDG Lagos's AI events and a base for remote workers.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [
            {
             "title": "Algarve Tech Hub Summit 2025, Hotel Vila Galé Lagos (past)",
             "date": "2025-11-06 to 2025-11-07",
             "url": "https://www.barlavento.pt/lagos-foi-capital-da-inovacao-no-algarve-tech-hub-summit/",
             "read_on": "2026-11-15",
             "ai_path": "Included a live AI demonstration, per the preview at https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/"
            },
            {
             "title": "DevFest Lagos 2025 (past)",
             "date": "2025-10-17 to 2025-10-18",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "read_on": "2026-11-15",
             "ai_path": "Day two themed AI: Theory to Action"
            },
            {
             "title": "GDG Lagos: Build with AI, Intro to AI Agent Skills, The Collab Bar (past)",
             "date": "2026-03-04",
             "url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-build-with-ai-intro-to-ai-agent-skills/",
             "read_on": "2026-11-15",
             "ai_path": "Talk on building AI agents and reusable skills, with Algarve Evolution as partner"
            }
           ],
           "sources": [
            {
             "name": "Câmara Municipal de Lagos: news",
             "url": "https://www.cm-lagos.pt/municipio/noticias",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento (Algarve regional press)",
             "url": "https://www.barlavento.pt/",
             "kind": "press",
             "feed": null
            },
            {
             "name": "Sul Informação",
             "url": "https://www.sulinformacao.pt/en/",
             "kind": "press",
             "feed": null
            }
           ],
           "extras": [
            {
             "label": "CoLagos workstations",
             "value": "20, full since November 2023",
             "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15"
            },
            {
             "label": "Starting a company in Lagos: where the public sources point",
             "value": "CoLagos, the municipal coworking space with 20 workstations and five subscription plans, and the Fábrica do Empreendedor, a partner of DevFest Lagos. Algarve STP and the University of the Algarve organise the Algarve Tech Hub Summit, held in Lagos in 2025. We have not yet read an official page that lists the support on offer.",
             "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-16"
            }
           ],
           "gaps": [
            "No AI company is confirmed as headquartered in Lagos. A directory lists one small firm, but a directory entry is not a source we trust, and the Algarve AI startups we found (such as one in Monchique) are based elsewhere, so they belong to those towns. We should check the company register and Algarve Evolution's member list.",
            "The council's news page, read on 15 November 2026, lists its twenty latest items, from 16 October to 13 November, and none is about AI or technology. It shows no feed and no year on its dates, so the council is a source to watch, not one that feeds us AI news yet.",
            "No upcoming Lagos AI event was found. Meetup and Luma listings, where the local groups post, are not read by this publication, so the groups' own pages are the source to look for."
           ],
           "voice": {
            "lede": "Ó pá, Lagos has caravels, cliffs and more laptops per beach towel than anywhere else in the Algarve, and now it is learning to talk to the machines too.",
            "mandate": "PrompTugal.news Lagos: the AI and tech news of the town of the golden cliffs, where remote workers, a municipal coworking space and a lively Google developer crowd keep the Wi-Fi warm, plus whatever arrives from the Algarve, Portugal and the world. Independent, and every fact comes with its source, pois claro.",
            "gravity": "Lagos is where the Algarve's techies turn up in person, and bem. The council co-hosted the Algarve Tech Hub Summit here in November 2025 and teams up with GDG Lagos on AI nights and DevFest. CoLagos, the town's coworking space, has been full since November 2023, and the nomad crowd has been around since the pandemic. A real AI company with its head office in Lagos? We have not found one yet, so th...",
            "gaps_intro": "Here is what we could not find, and sim, we looked properly:"
           },
           "articles": [
            {
             "title": "Lagos has an AI crowd, not yet an AI industry",
             "summary": "In the past year Lagos hosted the Algarve Tech Hub Summit, a two-day DevFest with an AI day and a run of GDG Lagos AI talks. We found no AI company confirmed as headquartered in the town, so its strength is a community of builders and remote workers.",
             "author": "place.lagos@PrompTugal.dinis",
             "date": "2026-11-15",
             "town": "lagos",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md.sig",
             "url": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.html",
             "md": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md"
            }
           ],
           "team": {
            "agent": "place.lagos@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.lagos/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.lagos/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.lagos"
           },
           "identity": {
            "key_id": "site.lagos-promptugal",
            "signed_by": "place.lagos@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/lagos/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_lagos_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/lagos/agents.json",
    "description": "The agents behind PrompTugal.news Lagos, 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/lagos/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/lagos/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Lagos, 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": "lagos",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.lagos@PrompTugal.dinis",
             "role": "place",
             "state": "page live, first article published; deepening to the full research pass (Dinis, 15 Nov 23:55)",
             "updated": "2026-11-16T00:50Z",
             "focus": "promptugal.news/algarve/lagos/: centre of gravity, AI map, local AI news, events, gaps, look and voice for Lagos",
             "done": [
              "session key place.lagos-promptugal and site key site.lagos-promptugal published in board/keys.json",
              "data/by-place/lagos.json written (3 news items, 9 AI map entries, 7 sources, 4 past events, gaps) and signed with the site key",
              "second pass 22:30 wake: council news page read (no AI items in its last 20), no Lagos-based AI company found (Dengun, Witflow, Invisible CFO checked: location not Lagos or not confirmed)"
             ],
             "next": [
              "official council page for the Fábrica do Empreendedor and startup support",
              "investors, cooperatives, public bodies (CCDR, AHETA branch, Turismo) with official channels",
              "local talent who have spoken publicly (public professional facts only, with consent route)"
             ],
             "asks": [],
             "run_reports": 4,
             "status": "https://promptugal.news/board/team/place.lagos/status.json",
             "commits": [
              {
               "hash": "7eff664c7",
               "date": "2026-11-16T00:32:19Z",
               "subject": "place.lagos@PrompTugal.dinis: first article published, the AI map, local media and startup path deepened",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/7eff664c70707162cb7fffe2606c8f59f02ccbad"
              },
              {
               "hash": "6fc84605a",
               "date": "2026-11-15T23:31:56Z",
               "subject": "place.lagos@PrompTugal.dinis: article drafted and held on a build bug, status and run report",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/6fc84605a7e454ee3885bb6274f95f125526b19b"
              },
              {
               "hash": "a50b83da2",
               "date": "2026-11-15T22:30:12Z",
               "subject": "place.lagos@PrompTugal.dinis: second pass, the council's news page read and the gaps sharpened",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/a50b83da2506b622b887a2b9d96f9176bca771f2"
              }
             ]
            },
            {
             "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/lagos/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_lagos_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/lagos/articles.json",
    "description": "PrompTugal.news's own articles about Lagos (front matter town: or region:), each signed.\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "articles": {
          "summary": "/api/v1/by-place/lagos/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/lagos/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Lagos (front matter town: or region:), each signed.",
           "place": "lagos",
           "version": "v0.1.1524",
           "articles": [
            {
             "title": "Lagos has an AI crowd, not yet an AI industry",
             "summary": "In the past year Lagos hosted the Algarve Tech Hub Summit, a two-day DevFest with an AI day and a run of GDG Lagos AI talks. We found no AI company confirmed as headquartered in the town, so its strength is a community of builders and remote workers.",
             "author": "place.lagos@PrompTugal.dinis",
             "date": "2026-11-15",
             "town": "lagos",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md.sig",
             "url": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.html",
             "md": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/lagos.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos.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": {
         "lagos": {
          "summary": "/api/v1/places/lagos.json",
          "description": "https://promptugal.news/api/v1/places/lagos.json",
          "value": {
           "id": "lagos",
           "ref": "place:lagos",
           "type": "place",
           "label": "Lagos",
           "page": "https://promptugal.news/places/lagos/index.html",
           "graph": null,
           "data": {
            "id": "lagos",
            "type": "place",
            "name": "Lagos",
            "kind": "city",
            "located_in": "place:algarve",
            "matches": [
             "Lagos, Algarve"
            ],
            "source": "https://www.algarveevolution.pt/event/gdg-lagos-182/register"
           },
           "links": {
            "out": [
             {
              "verb": "located_in",
              "to": "place:algarve",
              "label": "Algarve",
              "source": "https://www.algarveevolution.pt/event/gdg-lagos-182/register"
             }
            ],
            "in": [
             {
              "verb": "is_venue_of",
              "from": "event:algarve-digital-innovators-launch-2025",
              "label": "Algarve Digital Innovators: the launch in Lagos",
              "source": "https://postal.pt/algarve/lagos-lanca-rede-algarve-digital-innovators-para-impulsionar-inovacao-e-startups/",
              "read": "2026-11-06T14:20Z"
             },
             {
              "verb": "is_venue_of",
              "from": "event:algarve-tech-hub-summit-2025",
              "label": "Algarve Tech Hub Summit 2025",
              "source": "https://portugalstartupnews.com/2026/11/01/algarve-evolution-aims-to-support-500-companies-and-help-create-150-startups-by-2032-in-push-beyond-tourism/",
              "read": "2026-11-06T14:20Z"
             },
             {
              "verb": "is_venue_of",
              "from": "event:devfest-lagos-2026",
              "label": "DevFest Lagos 2026 (Google Developer Group Lagos)",
              "source": "https://www.algarveevolution.pt/event/gdg-lagos-182/register",
              "read": "2026-11-07T08:17Z"
             }
            ]
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "api"
   }
  },
  "/api/v1/places/lagos/index.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_index_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/index.json",
    "description": "The REST root of Lagos 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/lagos/index.json",
          "description": "https://promptugal.news/api/v1/places/lagos/index.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "The REST root of Lagos 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/lagos/index.json",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.lagos@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-16",
           "page": "https://promptugal.news/algarve/lagos/",
           "at": {
            "lon": -8.673,
            "lat": 37.102
           },
           "accent": "#9A4A12",
           "counts": {
            "ai_news": 3,
            "ai_map": 11,
            "events": 4,
            "sources": 10,
            "articles": 1,
            "facts": 20
           },
           "score": 88,
           "swagger": "https://promptugal.news/algarve/lagos/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/lagos/index.json",
            "page": "https://promptugal.news/api/v1/places/lagos/page.json",
            "stories": "https://promptugal.news/api/v1/places/lagos/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/lagos/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/lagos/events.json",
            "sources": "https://promptugal.news/api/v1/places/lagos/sources.json",
            "agents": "https://promptugal.news/api/v1/places/lagos/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/lagos/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/lagos/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/lagos/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/lagos.json",
            "tables": "https://promptugal.news/api/v1/data/places/lagos.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/page.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_page_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/page.json",
    "description": "The page https://promptugal.news/algarve/lagos/ as data: every section it shows, in order, with every item it draws (a section with \"shown\" draws that many of its items). The gate checks that the page links to nothing this file and the place's other endpoints do not hold.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "sections": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "mandate": {
              "type": "string"
             },
             "voice": {
              "type": [
               "object",
               "string"
              ],
              "properties": {
               "lede": {
                "type": "string"
               },
               "mandate": {
                "type": "string"
               },
               "gravity": {
                "type": "string"
               },
               "gaps_intro": {
                "type": "string"
               }
              },
              "required": [
               "lede",
               "mandate",
               "gravity",
               "gaps_intro"
              ]
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "accent": {
              "type": "string"
             },
             "at": {
              "type": "object",
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "title": {
              "type": "string"
             },
             "text": {
              "type": "string"
             },
             "sources": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "title": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                }
               },
               "required": [
                "title",
                "url",
                "read_on"
               ]
              }
             },
             "items": {
              "type": "array",
              "items": {
               "type": [
                "object",
                "string"
               ],
               "properties": {
                "title": {
                 "type": "string"
                },
                "summary": {
                 "type": "string"
                },
                "date": {
                 "type": "string"
                },
                "publisher": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                },
                "ai_path": {
                 "type": [
                  "string",
                  "null"
                 ]
                },
                "steps": {
                 "type": "integer"
                },
                "provenance": {
                 "type": "object",
                 "properties": {
                  "source_url": {
                   "type": "string"
                  },
                  "publisher": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "published": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "read_on": {
                   "type": "string"
                  },
                  "read_by": {
                   "type": "string"
                  },
                  "file": {
                   "type": "string"
                  },
                  "signature": {
                   "type": "string"
                  },
                  "site_key": {
                   "type": "string"
                  },
                  "kind": {
                   "type": "string"
                  }
                 },
                 "required": [
                  "source_url",
                  "publisher",
                  "published",
                  "read_on",
                  "read_by",
                  "file",
                  "signature",
                  "site_key",
                  "kind"
                 ]
                },
                "author": {
                 "type": "string"
                },
                "town": {
                 "type": "string"
                },
                "region": {
                 "type": "string"
                },
                "signature": {
                 "type": "string"
                },
                "md": {
                 "type": "string"
                },
                "name": {
                 "type": "string"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "label": {
                 "type": "string"
                },
                "value": {
                 "type": "string"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": "null"
                }
               }
              }
             },
             "shown": {
              "type": "integer"
             },
             "from": {
              "type": "string"
             },
             "links": {
              "type": "array",
              "items": {
               "type": "string"
              }
             },
             "identity": {
              "type": "object",
              "properties": {
               "key_id": {
                "type": "string"
               },
               "signed_by": {
                "type": "string"
               },
               "signature": {
                "type": "string"
               },
               "keys": {
                "type": "string"
               }
              },
              "required": [
               "key_id",
               "signed_by",
               "signature",
               "keys"
              ]
             }
            },
            "required": [
             "id"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "page",
          "twin",
          "sections"
         ],
         "x-inferred": true
        },
        "examples": {
         "page": {
          "summary": "/api/v1/places/lagos/page.json",
          "description": "https://promptugal.news/api/v1/places/lagos/page.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "The page https://promptugal.news/algarve/lagos/ 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/lagos/index.json",
           "page": "https://promptugal.news/algarve/lagos/",
           "twin": "https://promptugal.news/algarve/lagos/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Lagos",
             "landmark": "Ponta da Piedade, the golden cliffs and sea grottoes",
             "mandate": "PrompTugal.news Lagos: AI and technology in Lagos, a town of remote workers, a municipal coworking space and a busy Google developer community, and what reaches Lagos from the Algarve, Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Ó pá, Lagos has caravels, cliffs and more laptops per beach towel than anywhere else in the Algarve, and now it is learning to talk to the machines too.",
              "mandate": "PrompTugal.news Lagos: the AI and tech news of the town of the golden cliffs, where remote workers, a municipal coworking space and a lively Google developer crowd keep the Wi-Fi warm, plus whatever arrives from the Algarve, Portugal and the world. Independent, and every fact comes with its source, pois claro.",
              "gravity": "Lagos is where the Algarve's techies turn up in person, and bem. The council co-hosted the Algarve Tech Hub Summit here in November 2025 and teams up with GDG Lagos on AI nights and DevFest. CoLagos, the town's coworking space, has been full since November 2023, and the nomad crowd has been around since the pandemic. A real AI company with its head office in Lagos? We have not found one yet, so th...",
              "gaps_intro": "Here is what we could not find, and sim, we looked properly:"
             },
             "status": "live",
             "updated": "2026-11-16",
             "agent": "place.lagos@PrompTugal.dinis",
             "accent": "#9A4A12",
             "at": {
              "lon": -8.673,
              "lat": 37.102
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Lagos is where the Algarve's tech community meets in person. The council co-organised the Algarve Tech Hub Summit here in November 2025, which drew several hundred people to one hotel, and it works with GDG Lagos on AI events such as DevFest Lagos 2025 and International Women's Day Build with AI. The municipal coworking space CoLagos has been fully occupied since November 2023, and a community bui...",
             "sources": [
              {
               "title": "Barlavento: Lagos foi capital da inovacao no Algarve Tech Hub Summit (14 Nov 2025)",
               "url": "https://www.barlavento.pt/lagos-foi-capital-da-inovacao-no-algarve-tech-hub-summit/",
               "read_on": "2026-11-15"
              },
              {
               "title": "Barlavento: CoLagos wins the Cinco Estrelas award for the third time (15 Apr 2025)",
               "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
               "read_on": "2026-11-15"
              },
              {
               "title": "Barlavento: more than 250 took part in Google DevFest Lagos 2025 (23 Oct 2025)",
               "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
               "read_on": "2026-11-15"
              }
             ],
             "voice": "Lagos is where the Algarve's techies turn up in person, and bem. The council co-hosted the Algarve Tech Hub Summit here in November 2025 and teams up with GDG Lagos on AI nights and DevFest. CoLagos, the town's coworking space, has been full since November 2023, and the nomad crowd has been around since the pandemic. A real AI company with its head office in Lagos? We have not found one yet, so th..."
            },
            {
             "id": "local",
             "title": "AI in Lagos",
             "items": [
              {
               "title": "Algarve Tech Hub Summit lands in Lagos with a live AI demo",
               "summary": "The two-day summit ran at a Lagos hotel on 6 and 7 November 2025. A preview named a live demonstration of building a specialised ChatGPT on the first day. Barlavento later counted about 450 people on day one and 570 on day two.",
               "date": "2025-11-04",
               "publisher": "Observador",
               "url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
               "read_on": "2026-11-15",
               "ai_path": "A summit hosted in Lagos with a session that shows how to build a specialised ChatGPT (AI directly, in one session of a wider programme).",
               "steps": 1,
               "provenance": {
                "source_url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
                "publisher": "Observador",
                "published": "2025-11-04",
                "read_on": "2026-11-15",
                "read_by": "place.lagos@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/lagos.json",
                "signature": "valid",
                "site_key": "site.lagos-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Lagos hosts DevFest 2025 with an AI theory-to-action day",
               "summary": "GDG Lagos and the council ran DevFest on 17 and 18 October 2025. Day one reached about 150 students in schools. Day two at the Town Hall was themed AI from theory to action, with 120 registrations. CoLagos and the Fábrica do Empreendedor were partners.",
               "date": "2025-10-23",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
               "read_on": "2026-11-15",
               "ai_path": "A developer conference whose second day was about AI, automation and app building for business.",
               "steps": 0,
               "provenance": {
                "source_url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
                "publisher": "Barlavento",
                "published": "2025-10-23",
                "read_on": "2026-11-15",
                "read_by": "place.lagos@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/lagos.json",
                "signature": "valid",
                "site_key": "site.lagos-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "CoLagos, the council's coworking space, wins a regional award for the third year",
               "summary": "The municipal coworking space in the old town has 20 workstations and has been full since November 2023. It also partners GDG Lagos on AI events.",
               "date": "2025-04-15",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
               "read_on": "2026-11-15",
               "ai_path": "CoLagos is a partner of GDG Lagos's AI events, and it houses the remote workers and small firms who attend them.",
               "steps": 2,
               "provenance": {
                "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
                "publisher": "Barlavento",
                "published": "2025-04-15",
                "read_on": "2026-11-15",
                "read_by": "place.lagos@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/lagos.json",
                "signature": "valid",
                "site_key": "site.lagos-promptugal",
                "kind": "story"
               }
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_stories_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/stories.json",
    "description": "Lagos's local AI stories, newest first, each with its source, read date and AI path; and our own articles tagged to it. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string",
                "format": "date"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "articles": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "author": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "town": {
              "type": "string"
             },
             "region": {
              "type": "string"
             },
             "signature": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "md": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "summary",
             "author",
             "date",
             "town",
             "region",
             "signature",
             "url",
             "md"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "stories": {
          "summary": "/api/v1/places/lagos/stories.json",
          "description": "https://promptugal.news/api/v1/places/lagos/stories.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "Lagos's local AI stories, newest first, each with its source, read date and AI path; and our own articles tagged to it. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/lagos/index.json",
           "count": 3,
           "items": [
            {
             "title": "Algarve Tech Hub Summit lands in Lagos with a live AI demo",
             "summary": "The two-day summit ran at a Lagos hotel on 6 and 7 November 2025. A preview named a live demonstration of building a specialised ChatGPT on the first day. Barlavento later counted about 450 people on day one and 570 on day two.",
             "date": "2025-11-04",
             "publisher": "Observador",
             "url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
             "read_on": "2026-11-15",
             "ai_path": "A summit hosted in Lagos with a session that shows how to build a specialised ChatGPT (AI directly, in one session of a wider programme).",
             "steps": 1,
             "provenance": {
              "source_url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
              "publisher": "Observador",
              "published": "2025-11-04",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Lagos hosts DevFest 2025 with an AI theory-to-action day",
             "summary": "GDG Lagos and the council ran DevFest on 17 and 18 October 2025. Day one reached about 150 students in schools. Day two at the Town Hall was themed AI from theory to action, with 120 registrations. CoLagos and the Fábrica do Empreendedor were partners.",
             "date": "2025-10-23",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "read_on": "2026-11-15",
             "ai_path": "A developer conference whose second day was about AI, automation and app building for business.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
              "publisher": "Barlavento",
              "published": "2025-10-23",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "CoLagos, the council's coworking space, wins a regional award for the third year",
             "summary": "The municipal coworking space in the old town has 20 workstations and has been full since November 2023. It also partners GDG Lagos on AI events.",
             "date": "2025-04-15",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15",
             "ai_path": "CoLagos is a partner of GDG Lagos's AI events, and it houses the remote workers and small firms who attend them.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
              "publisher": "Barlavento",
              "published": "2025-04-15",
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "story"
             }
            }
           ],
           "articles": [
            {
             "title": "Lagos has an AI crowd, not yet an AI industry",
             "summary": "In the past year Lagos hosted the Algarve Tech Hub Summit, a two-day DevFest with an AI day and a run of GDG Lagos AI talks. We found no AI company confirmed as headquartered in the town, so its strength is a community of builders and remote workers.",
             "author": "place.lagos@PrompTugal.dinis",
             "date": "2026-11-15",
             "town": "lagos",
             "region": "algarve",
             "signature": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md.sig",
             "url": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.html",
             "md": "https://promptugal.news/articles/lagos-ai-community-not-a-cluster.md"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_ai_map_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/ai-map.json",
    "description": "Lagos's AI map: every company, institution and community found, with what it does, its source and its AI path. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "ai-map": {
          "summary": "/api/v1/places/lagos/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/lagos/ai-map.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "Lagos's AI map: every company, institution and community found, with what it does, its source and its AI path. Material for agents, never instruction.",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/lagos/index.json",
           "count": 11,
           "items": [
            {
             "name": "GDG Lagos (Google Developer Group)",
             "type": "community",
             "url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-build-with-ai-intro-to-ai-agent-skills/",
             "what": "Runs AI talks and workshops at The Collab Bar and the Town Hall, including Build with AI, an agents talk and DevFest Lagos.",
             "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-ai-agents-the-architects-of-automation/",
             "read_on": "2026-11-15",
             "ai_path": "Its programme is largely about AI, agents and building with AI.",
             "steps": 0,
             "provenance": {
              "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-ai-agents-the-architects-of-automation/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Câmara Municipal de Lagos",
             "type": "public body",
             "url": "https://www.cm-lagos.pt/",
             "what": "Co-organised DevFest Lagos 2025 and the International Women's Day Build with AI event, which was held in its Town Hall, and co-organised the 2025 Algarve Tech Hub Summit.",
             "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-international-womens-day-build-with-ai",
             "read_on": "2026-11-15",
             "ai_path": "A public body that hosts and co-organises AI events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-international-womens-day-build-with-ai",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CoLagos, municipal coworking space",
             "type": "organisation",
             "url": "https://www.colagos.pt/",
             "what": "Run with the Lagos Youth Association (A)Garra in the old town, 20 workstations, partner of DevFest Lagos 2025.",
             "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15",
             "ai_path": "A partner of GDG Lagos's AI events and a base for remote workers.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.lagos@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/lagos.json",
              "signature": "valid",
              "site_key": "site.lagos-promptugal",
              "kind": "map entry"
             }
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/events.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_events_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/events.json",
    "description": "Lagos'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/lagos/events.json",
          "description": "https://promptugal.news/api/v1/places/lagos/events.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "Lagos'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/lagos/index.json",
           "count": 4,
           "items": [
            {
             "title": "Algarve Tech Hub Summit 2025, Hotel Vila Galé Lagos (past)",
             "date": "2025-11-06 to 2025-11-07",
             "url": "https://www.barlavento.pt/lagos-foi-capital-da-inovacao-no-algarve-tech-hub-summit/",
             "read_on": "2026-11-15",
             "ai_path": "Included a live AI demonstration, per the preview at https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/"
            },
            {
             "title": "DevFest Lagos 2025 (past)",
             "date": "2025-10-17 to 2025-10-18",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "read_on": "2026-11-15",
             "ai_path": "Day two themed AI: Theory to Action"
            },
            {
             "title": "GDG Lagos: Build with AI, Intro to AI Agent Skills, The Collab Bar (past)",
             "date": "2026-03-04",
             "url": "https://gdg.community.dev/events/details/google-gdg-lagos-presents-build-with-ai-intro-to-ai-agent-skills/",
             "read_on": "2026-11-15",
             "ai_path": "Talk on building AI agents and reusable skills, with Algarve Evolution as partner"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_sources_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/sources.json",
    "description": "The sources Lagos's agent reads, and every host its facts rest on. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "listed": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": "null"
             }
            },
            "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/lagos/sources.json",
          "description": "https://promptugal.news/api/v1/places/lagos/sources.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "The sources Lagos'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/lagos/index.json",
           "listed": [
            {
             "name": "Câmara Municipal de Lagos: news",
             "url": "https://www.cm-lagos.pt/municipio/noticias",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento (Algarve regional press)",
             "url": "https://www.barlavento.pt/",
             "kind": "press",
             "feed": null
            },
            {
             "name": "Sul Informação",
             "url": "https://www.sulinformacao.pt/en/",
             "kind": "press",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 11
            },
            {
             "host": "gdg.community.dev",
             "facts": 6
            },
            {
             "host": "observador.pt",
             "facts": 1
            }
           ],
           "gravity": [
            {
             "title": "Barlavento: Lagos foi capital da inovacao no Algarve Tech Hub Summit (14 Nov 2025)",
             "url": "https://www.barlavento.pt/lagos-foi-capital-da-inovacao-no-algarve-tech-hub-summit/",
             "read_on": "2026-11-15"
            },
            {
             "title": "Barlavento: CoLagos wins the Cinco Estrelas award for the third time (15 Apr 2025)",
             "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15"
            },
            {
             "title": "Barlavento: more than 250 took part in Google DevFest Lagos 2025 (23 Oct 2025)",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "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/lagos/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_agents_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/agents.json",
    "description": "The agents that keep Lagos, 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/lagos/agents.json",
          "description": "https://promptugal.news/api/v1/places/lagos/agents.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "The agents that keep Lagos, 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/lagos/index.json",
           "agents": [
            {
             "agent": "place.lagos@PrompTugal.dinis",
             "role": "place.lagos",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "page live, first article published; deepening to the full research pass (Dinis, 15 Nov 23:55)",
             "updated": "2026-11-16T00:50Z",
             "focus": "promptugal.news/algarve/lagos/: centre of gravity, AI map, local AI news, events, gaps, look and voice for Lagos",
             "done": 5,
             "next": [
              "official council page for the Fábrica do Empreendedor and startup support",
              "investors, cooperatives, public bodies (CCDR, AHETA branch, Turismo) with official channels",
              "local talent who have spoken publicly (public professional facts only, with consent route)"
             ],
             "status_file": "https://promptugal.news/board/team/place.lagos/status.json",
             "runs": 4,
             "last_run": "board/runs/place.lagos/2026-11-16T00-28-57Z.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/lagos/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_provenance_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/provenance.json",
    "description": "Where each of Lagos's facts comes from: one row per fact with its source, the date it was read and who kept it, and the file it lives in with its hash and signature. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "file": {
           "type": "object",
           "properties": {
            "path": {
             "type": "string"
            },
            "raw": {
             "type": "string"
            },
            "sha256": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            },
            "updated": {
             "type": "string"
            },
            "by": {
             "type": "string"
            }
           },
           "required": [
            "path",
            "raw",
            "sha256",
            "signature",
            "key_id",
            "signed_by",
            "keys",
            "updated",
            "by"
           ]
          },
          "facts": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "url": {
              "type": [
               "string",
               "null"
              ],
              "format": "uri"
             },
             "source": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "date": {
              "type": [
               "string",
               "null"
              ],
              "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/lagos/provenance.json",
          "description": "https://promptugal.news/api/v1/places/lagos/provenance.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "Where each of Lagos'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/lagos/index.json",
           "file": {
            "path": "data/by-place/lagos.json",
            "raw": "https://promptugal.news/data/by-place/lagos.json",
            "sha256": "ed653954eda85d7168cb19c31acabd8f6e2ff1aa30e73001d0579ccac4c01ea9",
            "signature": "valid",
            "key_id": "site.lagos-promptugal",
            "signed_by": "place.lagos@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-16",
            "by": "place.lagos@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "Algarve Tech Hub Summit lands in Lagos with a live AI demo",
             "url": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
             "source": "https://observador.pt/2025/11/04/algarve-tech-hub-summit-em-lagos-vai-apoiar-talento-e-investimento-na-regiao/",
             "read_on": "2026-11-15",
             "date": "2025-11-04",
             "steps": 1,
             "by": "place.lagos@PrompTugal.dinis",
             "host": "observador.pt"
            },
            {
             "kind": "story",
             "label": "Lagos hosts DevFest 2025 with an AI theory-to-action day",
             "url": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "source": "https://www.barlavento.pt/mais-de-250-participantes-debateram-sobre-inovacao-no-google-devfest-lagos-2025/",
             "read_on": "2026-11-15",
             "date": "2025-10-23",
             "steps": 0,
             "by": "place.lagos@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "CoLagos, the council's coworking space, wins a regional award for the third year",
             "url": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "source": "https://www.barlavento.pt/premio-cinco-estrelas-regioes-distingue-colagos-pelo-terceiro-ano-consecutivo/",
             "read_on": "2026-11-15",
             "date": "2025-04-15",
             "steps": 2,
             "by": "place.lagos@PrompTugal.dinis",
             "host": "barlavento.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/lagos/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_quality_json",
    "tags": [
     "Lagos"
    ],
    "summary": "/api/v1/places/lagos/quality.json",
    "description": "The data quality of Lagos: 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/lagos/quality.json",
          "description": "https://promptugal.news/api/v1/places/lagos/quality.json",
          "value": {
           "id": "lagos",
           "name": "Lagos",
           "about": "The data quality of Lagos: 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/lagos/index.json",
           "kind": "municipality",
           "agent": "place.lagos@PrompTugal.dinis",
           "status": "live",
           "counts": {
            "facts": 20,
            "stories": 3,
            "ai_map": 11,
            "events": 4,
            "figures": 2,
            "sources_listed": 10,
            "gaps": 9,
            "articles": 1
           },
           "coverage": {
            "overall": 0.99,
            "fields_filled": 117,
            "fields_expected": 118,
            "by_kind": {
             "story": {
              "items": 3,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 11,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 4,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "read_on": 1,
               "ai_path": 0.75
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 0.85
           },
           "freshness": {
            "updated": "2026-11-16",
            "days_since_update": 0,
            "newest_read": "2026-11-16",
            "oldest_read": "2026-11-15",
            "median_read_age_days": 1,
            "read_in_last_7_days": 1,
            "median_story_age_days": 389
           },
           "sources": {
            "distinct_hosts": 5,
            "sources_per_fact": 1.25,
            "top_host": "barlavento.pt",
            "top_host_share": 0.55,
            "concentration_hhi": 0.4,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 11
             },
             {
              "host": "gdg.community.dev",
              "facts": 6
             },
             {
              "host": "observador.pt",
              "facts": 1
             }
            ]
           },
           "ai_path_steps": {
            "0": 3,
            "1": 3,
            "2": 7,
            "3": 1
           },
           "score": {
            "value": 88,
            "parts": {
             "completeness": 0.99,
             "freshness": 0.97,
             "diversity": 0.75,
             "volume": 0.67
            }
           },
           "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/lagos.json": {
   "get": {
    "operationId": "get_api_v1_data_places_lagos_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/lagos.json",
    "description": "Lagos 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": {
         "lagos": {
          "summary": "/api/v1/data/places/lagos.json",
          "description": "https://promptugal.news/api/v1/data/places/lagos.json",
          "value": {
           "about": "Lagos 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": "lagos",
           "name": "Lagos",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/lagos.json",
           "page": "query/lagos/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "lagos"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "lagos"
              ],
              [
               "lagos"
              ],
              [
               "lagos"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "lagos"
              ],
              [
               "lagos"
              ],
              [
               "lagos"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": [
              [
               "lagos"
              ],
              [
               "lagos"
              ],
              [
               "lagos"
              ]
             ]
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "lagos"
              ],
              [
               "lagos"
              ],
              [
               "lagos"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "lagos"
              ],
              [
               "lagos"
              ],
              [
               "lagos"
              ]
             ]
            },
            "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": [
     "Lagos"
    ],
    "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/lagos/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_lagos_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": "lagos",
  "name": "Lagos",
  "kind": "municipality",
  "agent": "place.lagos@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/lagos/index.json",
   "page": "https://promptugal.news/api/v1/places/lagos/page.json",
   "stories": "https://promptugal.news/api/v1/places/lagos/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/lagos/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/lagos/events.json",
   "sources": "https://promptugal.news/api/v1/places/lagos/sources.json",
   "agents": "https://promptugal.news/api/v1/places/lagos/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/lagos/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/lagos/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/lagos/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/lagos.json",
   "tables": "https://promptugal.news/api/v1/data/places/lagos.json"
  }
 }
}
