{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Alcoutim: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/alcoutim/ shows, as GET calls: its REST root (/api/v1/places/alcoutim/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.alcoutim@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Alcoutim'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": "Alcoutim",
   "description": "Alcoutim'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 Alcoutim",
  "url": "https://promptugal.news/algarve/alcoutim/"
 },
 "paths": {
  "/api/v1/by-place/alcoutim.json": {
   "get": {
    "operationId": "get_api_v1_by_place_alcoutim_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/alcoutim.json",
    "description": "PrompTugal.news Alcoutim: 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"
          },
          "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",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             }
            },
            "required": [
             "label",
             "value",
             "source_url",
             "read_on"
            ]
           }
          },
          "gaps": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "voice": {
           "type": "object",
           "properties": {
            "lede": {
             "type": "string"
            },
            "mandate": {
             "type": "string"
            },
            "gravity": {
             "type": "string"
            },
            "gaps_intro": {
             "type": "string"
            }
           },
           "required": [
            "lede",
            "mandate",
            "gravity",
            "gaps_intro"
           ]
          },
          "articles": {
           "type": "array"
          },
          "team": {
           "type": "object",
           "properties": {
            "agent": {
             "type": "string"
            },
            "status": {
             "type": "string"
            },
            "debriefs": {
             "type": "string"
            },
            "runs": {
             "type": "string"
            }
           },
           "required": [
            "agent",
            "status",
            "debriefs",
            "runs"
           ]
          },
          "identity": {
           "type": "object",
           "properties": {
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            }
           },
           "required": [
            "key_id",
            "signed_by",
            "signature",
            "keys"
           ]
          }
         },
         "required": [
          "about",
          "version",
          "id",
          "name",
          "kind",
          "parent",
          "inside",
          "agent",
          "status",
          "updated",
          "by",
          "page",
          "twin",
          "raw",
          "at",
          "look",
          "mandate",
          "gravity",
          "counts",
          "ai_news",
          "ai_map",
          "events",
          "sources",
          "extras",
          "gaps",
          "voice",
          "articles",
          "team",
          "identity"
         ],
         "x-inferred": true
        },
        "examples": {
         "alcoutim": {
          "summary": "/api/v1/by-place/alcoutim.json",
          "description": "https://promptugal.news/api/v1/by-place/alcoutim.json",
          "value": {
           "about": "PrompTugal.news Alcoutim: 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": "alcoutim",
           "name": "Alcoutim",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.alcoutim@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-15",
           "by": "place.alcoutim@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/alcoutim/",
           "twin": "https://promptugal.news/algarve/alcoutim/index.md",
           "raw": "https://promptugal.news/data/by-place/alcoutim.json",
           "at": {
            "lon": -7.471,
            "lat": 37.471
           },
           "look": {
            "image": null,
            "accent": "#2F5D50",
            "landmark": "Alcoutim castle above the Guadiana",
            "motif": "slate green river, quiet border town, schist hills"
           },
           "mandate": "PrompTugal.news Alcoutim: AI and technology in Alcoutim, an inland, low-density municipality on the Guadiana where connectivity, sensors and digital inclusion are the road to AI, and what reaches Alcoutim from the Algarve, Portugal and the world. Independent. Every fact sourced.",
           "gravity": {
            "text": "Alcoutim is an inland municipality on the Guadiana, on the border with Spain, and its public investment is about infrastructure and basic services: a bridge to Sanlucar de Guadiana, a rebuilt water network in Martim Longo, social housing and a more accessible council website. Its technology story today is the public kind: it is one of six Algarve municipalities building a shared sensor and data pl...",
            "sources": [
             {
              "title": "Município de Alcoutim: PRR projects (Transparência)",
              "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
              "read_on": "2026-11-15"
             },
             {
              "title": "Algarve 6.0 Smart Territorial Hub (PRR project page)",
              "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
              "read_on": "2026-11-15"
             },
             {
              "title": "Government creates a centre to study desertification, based in Alcoutim (Observador, from Lusa)",
              "url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 4,
            "ai_map": 7,
            "events": 0,
            "sources": 13,
            "articles": 0
           },
           "ai_news": [
            {
             "title": "Alcoutim turns the old EPAC granary into a business and coworking centre",
             "summary": "The council's Celeiro de Ideias application was approved on 27 August 2026 under Algarve 2030. Eligible investment is 1,269,828.22 euros, with 761,896.94 euros of FEDER co-funding, and works are due to end on 30 September 2028. It is meant for microbusinesses, freelancers, startups and local artisans.",
             "date": "2026-09-25",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
             "read_on": "2026-11-15",
             "ai_path": "A coworking and startup space is where founders and remote workers who build with AI would sit in a low-density town. The article mentions no technology or AI, so this is a place to watch, not a claim.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
              "publisher": "Barlavento",
              "published": "2026-09-25",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Alcoutim gets shared electric bikes run by a digital platform",
             "summary": "With Fundacao Galp, the council opened a system of 14 electric bicycles at four stations, open to residents and visitors. The investment is above 100,000 euros and a digital management and usage platform, built by the company CME, runs it.",
             "date": "2026-06-12",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=401815",
             "read_on": "2026-11-15",
             "ai_path": "A usage platform for shared bikes produces mobility data, which is the raw material for AI planning of low-density transport. This is a weak, third-step link: the article does not mention AI.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=401815",
              "publisher": "Barlavento",
              "published": "2026-06-12",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "dstelecom takes fibre to 1,000 more homes in Alcoutim",
             "summary": "The fibre operator announced on 9 June 2026 that the municipality's coverage would pass 80 percent, reaching 82 percent, with about 1,000 new homes in Alcoutim, Giões and Pereiro by the end of the first half of 2026. More than 3,100 families would have access.",
             "date": "2026-06-09",
             "publisher": "dstelecom",
             "url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
             "read_on": "2026-11-15",
             "ai_path": "Fibre to the villages is the base layer that any AI service, remote work or telehealth in a low-density town depends on. It is an operator's own press release and does not mention AI, and we have not confirmed the target was met.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
              "publisher": "dstelecom",
              "published": "2026-06-09",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Algarve 6.0 Smart Territorial Hub (Alcoutim, Olhao, Loule, Sao Bras de Alportel, Tavira, Vila Real de Santo Antonio)",
             "type": "public body",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
             "what": "A PRR project of six municipalities to build an urban management platform with sensors and a LoRaWAN network, including monitoring of isolated elderly residents. Alcoutim's assigned funding is 124.32 thousand euros, and the project is due to end on 30 June 2026.",
             "source_url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
             "read_on": "2026-11-15",
             "ai_path": "Sensors and a LoRaWAN network feed one data platform, and a shared data platform is where analytics and AI services get built. The project page does not mention AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CCDesert, Centro de Competencias na Luta contra a Desertificacao",
             "type": "institution",
             "url": "https://www.iniav.pt/images/Investigacao_Inovacao/Centros-Competencias/CCDesert/poster.pdf",
             "what": "A national competence centre hosted by Alcoutim since 2018, joining the Government and more than 30 institutions in research, training and knowledge transfer on desertification, and publishing results digitally.",
             "source_url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
             "read_on": "2026-11-15",
             "ai_path": "A research network that maps land, soil and climate data is a natural user of AI and remote sensing models. We found no AI work by the centre yet, so this is a lead to check.",
             "steps": 3,
             "provenance": {
              "source_url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CME (digital platform for the Alcoutim shared bikes)",
             "type": "company",
             "url": "https://www.barlavento.pt/?p=401815",
             "what": "The company named as developer of the digital management and usage platform of the shared electric bikes opened in June 2026.",
             "source_url": "https://www.barlavento.pt/?p=401815",
             "read_on": "2026-11-15",
             "ai_path": "A software platform that collects usage data is a step from data products and AI features. The article does not say CME uses AI.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=401815",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [],
           "sources": [
            {
             "name": "Municipio de Alcoutim",
             "url": "https://cm-alcoutim.pt/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Transparencia: PRR beneficiary page for Alcoutim",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento",
             "url": "https://www.barlavento.pt/",
             "kind": "press",
             "feed": null
            }
           ],
           "extras": [
            {
             "label": "PRR funding assigned to the council",
             "value": "11 projects, about 13.07 million euros in total, including the Alcoutim to Sanlucar de Guadiana bridge (10.64 million) and the council website accessibility project (10 thousand euros)",
             "source_url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
             "read_on": "2026-11-15"
            },
            {
             "label": "Celeiro de Ideias funding",
             "value": "1,269,828.22 euros eligible, 761,896.94 euros FEDER, priority 5 of Algarve 2030, approved 27 Aug 2026",
             "source_url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
             "read_on": "2026-11-15"
            },
            {
             "label": "Fibre coverage in the municipality",
             "value": "82 percent expected after the 2026 build, more than 3,100 families with access (operator's announcement, 9 June 2026)",
             "source_url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
             "read_on": "2026-11-15"
            }
           ],
           "gaps": [
            "No AI company, startup or AI event based in Alcoutim turned up in this first pass. That is a finding: for a municipality of this size the AI path runs through the council, the PRR sensor platform and regional bodies. Next to look at: Algarve Evolution and the Universidade do Algarve for projects reaching the Guadiana, and Associacao Odiana's Vilas em Movimento work.",
            "The council's own site (cm-alcoutim.pt) loaded as a page with no readable news list and exposes no RSS feed. We need its news page URL or a feed, or a council bulletin per month.",
            "Postal do Algarve, Sul Informacao and Portugal Resident refuse automated reading (a bot check or a 403), so their pages are not used. Barlavento reads fine and now carries two items. Still to verify at a readable source: a council protocol with MEO for the SmartAL remote support system and the Medigraf telemedicine system (search snippets point to October 2018, so it may be old news). The SmartAL ..."
           ],
           "voice": {
            "lede": "Ai, Alcoutim: a vila onde o rio e quase Espanha e a fibra ainda vem devagarinho, mas os sensores ja chegaram.",
            "mandate": "PrompTugal.news Alcoutim: AI and technology, bem la no interior, ali onde o Guadiana faz de fronteira e a internet tem de aprender a nadar. Also what reaches us from the Algarve, Portugal and the world. Independent, and every fact has its source, pois claro.",
            "gravity": "Here we do not have a hundred startups, ca estamos mais para pontes, agua e sensores. A bridge to Spain, a rebuilt water pipe in Martim Longo, and a shared sensor platform with five other municipalities. Before the AI, the data. Before the data, the cable, fogo!",
            "gaps_intro": "Pois, nem tudo se encontra. Here is what we are still looking for, com calma, que a pressa e inimiga da perfeicao:"
           },
           "articles": [],
           "team": {
            "agent": "place.alcoutim@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.alcoutim/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.alcoutim/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.alcoutim"
           },
           "identity": {
            "key_id": "site.alcoutim-promptugal",
            "signed_by": "place.alcoutim@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/alcoutim/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_alcoutim_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/alcoutim/agents.json",
    "description": "The agents behind PrompTugal.news Alcoutim, 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/alcoutim/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/alcoutim/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Alcoutim, 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": "alcoutim",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.alcoutim@PrompTugal.dinis",
             "role": "place",
             "state": "pass 3 released: 4 news items, 7 AI map entries",
             "updated": "2026-11-16T00:10Z",
             "focus": "Alcoutim's site, promptugal.news/algarve/alcoutim/ (data/by-place/alcoutim.json)",
             "done": [
              "keys made and published",
              "first pass: gravity (infrastructure and public data), 1 news item, 3 AI map entries (Algarve 6.0 Smart Territorial Hub, CCDesert, CME), 8 sources, 5 gaps, look and voice",
              "no AI company or event found in Alcoutim itself: recorded as a finding"
             ],
             "next": [
              "GEO.ANACOM mobile coverage for Alcoutim",
              "Agrosocial Plus and the UAlg water conference: a readable source and an Alcoutim link",
              "MEO protocol dated source"
             ],
             "asks": [
              "Dinis: Postal do Algarve, Sul Informacao and Portugal Resident block automated reading (bot check, 403); if Dinis can allow a reader or give captured text, three Alcoutim AI-path items unlock"
             ],
             "run_reports": 2,
             "status": "https://promptugal.news/board/team/place.alcoutim/status.json",
             "commits": [
              {
               "hash": "8a32286c7",
               "date": "2026-11-15T23:57:16Z",
               "subject": "place.alcoutim@PrompTugal.dinis: pass 3, fibre coverage and Odiana on the map",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/8a32286c7b5389dcf727f2e5176b2623bacadcbc"
              },
              {
               "hash": "9b95bda4e",
               "date": "2026-11-15T22:56:51Z",
               "subject": "place.alcoutim@PrompTugal.dinis: pass 2, Celeiro de Ideias and + Proximo read at source, AI map to five",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/9b95bda4e79c3dded3d9a14bc962777b49b4c7fa"
              },
              {
               "hash": "672e98a4a",
               "date": "2026-11-15T22:01:21Z",
               "subject": "place.alcoutim@PrompTugal.dinis: hand-over debrief, status and run report",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/672e98a4a3098ed22ce9e2c27f0c231f58378ab0"
              }
             ]
            },
            {
             "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/alcoutim/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_alcoutim_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/alcoutim/articles.json",
    "description": "PrompTugal.news's own articles about Alcoutim (front matter town: or region:), each signed.\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "articles": {
           "type": "array"
          }
         },
         "required": [
          "about",
          "place",
          "version",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "articles": {
          "summary": "/api/v1/by-place/alcoutim/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/alcoutim/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Alcoutim (front matter town: or region:), each signed.",
           "place": "alcoutim",
           "version": "v0.1.1524",
           "articles": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/alcoutim/index.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_index_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/index.json",
    "description": "The REST root of Alcoutim 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/alcoutim/index.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/index.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "The REST root of Alcoutim 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/alcoutim/index.json",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.alcoutim@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-15",
           "page": "https://promptugal.news/algarve/alcoutim/",
           "at": {
            "lon": -7.471,
            "lat": 37.471
           },
           "accent": "#2F5D50",
           "counts": {
            "ai_news": 4,
            "ai_map": 7,
            "events": 0,
            "sources": 13,
            "articles": 0,
            "facts": 14
           },
           "score": 87,
           "swagger": "https://promptugal.news/algarve/alcoutim/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/alcoutim/index.json",
            "page": "https://promptugal.news/api/v1/places/alcoutim/page.json",
            "stories": "https://promptugal.news/api/v1/places/alcoutim/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/alcoutim/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/alcoutim/events.json",
            "sources": "https://promptugal.news/api/v1/places/alcoutim/sources.json",
            "agents": "https://promptugal.news/api/v1/places/alcoutim/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/alcoutim/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/alcoutim/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/alcoutim/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/alcoutim.json",
            "tables": "https://promptugal.news/api/v1/data/places/alcoutim.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/alcoutim/page.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_page_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/page.json",
    "description": "The page https://promptugal.news/algarve/alcoutim/ as data: every section it shows, in order, with every item it draws (a section with \"shown\" draws that many of its items). The gate checks that the page links to nothing this file and the place's other endpoints do not hold.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "sections": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "mandate": {
              "type": "string"
             },
             "voice": {
              "type": [
               "object",
               "string"
              ],
              "properties": {
               "lede": {
                "type": "string"
               },
               "mandate": {
                "type": "string"
               },
               "gravity": {
                "type": "string"
               },
               "gaps_intro": {
                "type": "string"
               }
              },
              "required": [
               "lede",
               "mandate",
               "gravity",
               "gaps_intro"
              ]
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "accent": {
              "type": "string"
             },
             "at": {
              "type": "object",
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "title": {
              "type": "string"
             },
             "text": {
              "type": "string"
             },
             "sources": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "title": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                }
               },
               "required": [
                "title",
                "url",
                "read_on"
               ]
              }
             },
             "items": {
              "type": "array",
              "items": {
               "type": [
                "object",
                "string"
               ],
               "properties": {
                "title": {
                 "type": "string"
                },
                "summary": {
                 "type": "string"
                },
                "date": {
                 "type": "string",
                 "format": "date"
                },
                "publisher": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                },
                "ai_path": {
                 "type": "string"
                },
                "steps": {
                 "type": "integer"
                },
                "provenance": {
                 "type": "object",
                 "properties": {
                  "source_url": {
                   "type": "string"
                  },
                  "publisher": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "published": {
                   "type": [
                    "string",
                    "null"
                   ]
                  },
                  "read_on": {
                   "type": "string"
                  },
                  "read_by": {
                   "type": "string"
                  },
                  "file": {
                   "type": "string"
                  },
                  "signature": {
                   "type": "string"
                  },
                  "site_key": {
                   "type": "string"
                  },
                  "kind": {
                   "type": "string"
                  }
                 },
                 "required": [
                  "source_url",
                  "publisher",
                  "published",
                  "read_on",
                  "read_by",
                  "file",
                  "signature",
                  "site_key",
                  "kind"
                 ]
                },
                "name": {
                 "type": "string"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "label": {
                 "type": "string"
                },
                "value": {
                 "type": "string"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": "null"
                }
               }
              }
             },
             "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/alcoutim/page.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/page.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "The page https://promptugal.news/algarve/alcoutim/ 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/alcoutim/index.json",
           "page": "https://promptugal.news/algarve/alcoutim/",
           "twin": "https://promptugal.news/algarve/alcoutim/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Alcoutim",
             "landmark": "Alcoutim castle above the Guadiana",
             "mandate": "PrompTugal.news Alcoutim: AI and technology in Alcoutim, an inland, low-density municipality on the Guadiana where connectivity, sensors and digital inclusion are the road to AI, and what reaches Alcoutim from the Algarve, Portugal and the world. Independent. Every fact sourced.",
             "voice": {
              "lede": "Ai, Alcoutim: a vila onde o rio e quase Espanha e a fibra ainda vem devagarinho, mas os sensores ja chegaram.",
              "mandate": "PrompTugal.news Alcoutim: AI and technology, bem la no interior, ali onde o Guadiana faz de fronteira e a internet tem de aprender a nadar. Also what reaches us from the Algarve, Portugal and the world. Independent, and every fact has its source, pois claro.",
              "gravity": "Here we do not have a hundred startups, ca estamos mais para pontes, agua e sensores. A bridge to Spain, a rebuilt water pipe in Martim Longo, and a shared sensor platform with five other municipalities. Before the AI, the data. Before the data, the cable, fogo!",
              "gaps_intro": "Pois, nem tudo se encontra. Here is what we are still looking for, com calma, que a pressa e inimiga da perfeicao:"
             },
             "status": "researching",
             "updated": "2026-11-15",
             "agent": "place.alcoutim@PrompTugal.dinis",
             "accent": "#2F5D50",
             "at": {
              "lon": -7.471,
              "lat": 37.471
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Alcoutim is an inland municipality on the Guadiana, on the border with Spain, and its public investment is about infrastructure and basic services: a bridge to Sanlucar de Guadiana, a rebuilt water network in Martim Longo, social housing and a more accessible council website. Its technology story today is the public kind: it is one of six Algarve municipalities building a shared sensor and data pl...",
             "sources": [
              {
               "title": "Município de Alcoutim: PRR projects (Transparência)",
               "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
               "read_on": "2026-11-15"
              },
              {
               "title": "Algarve 6.0 Smart Territorial Hub (PRR project page)",
               "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
               "read_on": "2026-11-15"
              },
              {
               "title": "Government creates a centre to study desertification, based in Alcoutim (Observador, from Lusa)",
               "url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
               "read_on": "2026-11-15"
              }
             ],
             "voice": "Here we do not have a hundred startups, ca estamos mais para pontes, agua e sensores. A bridge to Spain, a rebuilt water pipe in Martim Longo, and a shared sensor platform with five other municipalities. Before the AI, the data. Before the data, the cable, fogo!"
            },
            {
             "id": "local",
             "title": "AI in Alcoutim",
             "items": [
              {
               "title": "Alcoutim turns the old EPAC granary into a business and coworking centre",
               "summary": "The council's Celeiro de Ideias application was approved on 27 August 2026 under Algarve 2030. Eligible investment is 1,269,828.22 euros, with 761,896.94 euros of FEDER co-funding, and works are due to end on 30 September 2028. It is meant for microbusinesses, freelancers, startups and local artisans.",
               "date": "2026-09-25",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
               "read_on": "2026-11-15",
               "ai_path": "A coworking and startup space is where founders and remote workers who build with AI would sit in a low-density town. The article mentions no technology or AI, so this is a place to watch, not a claim.",
               "steps": 3,
               "provenance": {
                "source_url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
                "publisher": "Barlavento",
                "published": "2026-09-25",
                "read_on": "2026-11-15",
                "read_by": "place.alcoutim@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/alcoutim.json",
                "signature": "valid",
                "site_key": "site.alcoutim-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Alcoutim gets shared electric bikes run by a digital platform",
               "summary": "With Fundacao Galp, the council opened a system of 14 electric bicycles at four stations, open to residents and visitors. The investment is above 100,000 euros and a digital management and usage platform, built by the company CME, runs it.",
               "date": "2026-06-12",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/?p=401815",
               "read_on": "2026-11-15",
               "ai_path": "A usage platform for shared bikes produces mobility data, which is the raw material for AI planning of low-density transport. This is a weak, third-step link: the article does not mention AI.",
               "steps": 3,
               "provenance": {
                "source_url": "https://www.barlavento.pt/?p=401815",
                "publisher": "Barlavento",
                "published": "2026-06-12",
                "read_on": "2026-11-15",
                "read_by": "place.alcoutim@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/alcoutim.json",
                "signature": "valid",
                "site_key": "site.alcoutim-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "dstelecom takes fibre to 1,000 more homes in Alcoutim",
               "summary": "The fibre operator announced on 9 June 2026 that the municipality's coverage would pass 80 percent, reaching 82 percent, with about 1,000 new homes in Alcoutim, Giões and Pereiro by the end of the first half of 2026. More than 3,100 families would have access.",
               "date": "2026-06-09",
               "publisher": "dstelecom",
               "url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
               "read_on": "2026-11-15",
               "ai_path": "Fibre to the villages is the base layer that any AI service, remote work or telehealth in a low-density town depends on. It is an operator's own press release and does not mention AI, and we have not confirmed the target was met.",
               "steps": 2,
               "provenance": {
                "source_url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
                "publisher": "dstelecom",
                "published": "2026-06-09",
                "read_on": "2026-11-15",
                "read_by": "place.alcoutim@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/alcoutim.json",
                "signature": "valid",
                "site_key": "site.alcoutim-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/alcoutim/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_stories_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/stories.json",
    "description": "Alcoutim'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"
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items",
          "articles"
         ],
         "x-inferred": true
        },
        "examples": {
         "stories": {
          "summary": "/api/v1/places/alcoutim/stories.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/stories.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "Alcoutim'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/alcoutim/index.json",
           "count": 4,
           "items": [
            {
             "title": "Alcoutim turns the old EPAC granary into a business and coworking centre",
             "summary": "The council's Celeiro de Ideias application was approved on 27 August 2026 under Algarve 2030. Eligible investment is 1,269,828.22 euros, with 761,896.94 euros of FEDER co-funding, and works are due to end on 30 September 2028. It is meant for microbusinesses, freelancers, startups and local artisans.",
             "date": "2026-09-25",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
             "read_on": "2026-11-15",
             "ai_path": "A coworking and startup space is where founders and remote workers who build with AI would sit in a low-density town. The article mentions no technology or AI, so this is a place to watch, not a claim.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
              "publisher": "Barlavento",
              "published": "2026-09-25",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Alcoutim gets shared electric bikes run by a digital platform",
             "summary": "With Fundacao Galp, the council opened a system of 14 electric bicycles at four stations, open to residents and visitors. The investment is above 100,000 euros and a digital management and usage platform, built by the company CME, runs it.",
             "date": "2026-06-12",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=401815",
             "read_on": "2026-11-15",
             "ai_path": "A usage platform for shared bikes produces mobility data, which is the raw material for AI planning of low-density transport. This is a weak, third-step link: the article does not mention AI.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=401815",
              "publisher": "Barlavento",
              "published": "2026-06-12",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "dstelecom takes fibre to 1,000 more homes in Alcoutim",
             "summary": "The fibre operator announced on 9 June 2026 that the municipality's coverage would pass 80 percent, reaching 82 percent, with about 1,000 new homes in Alcoutim, Giões and Pereiro by the end of the first half of 2026. More than 3,100 families would have access.",
             "date": "2026-06-09",
             "publisher": "dstelecom",
             "url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
             "read_on": "2026-11-15",
             "ai_path": "Fibre to the villages is the base layer that any AI service, remote work or telehealth in a low-density town depends on. It is an operator's own press release and does not mention AI, and we have not confirmed the target was met.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
              "publisher": "dstelecom",
              "published": "2026-06-09",
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "story"
             }
            }
           ],
           "articles": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/alcoutim/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_ai_map_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/ai-map.json",
    "description": "Alcoutim'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/alcoutim/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/ai-map.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "Alcoutim'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/alcoutim/index.json",
           "count": 7,
           "items": [
            {
             "name": "Algarve 6.0 Smart Territorial Hub (Alcoutim, Olhao, Loule, Sao Bras de Alportel, Tavira, Vila Real de Santo Antonio)",
             "type": "public body",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
             "what": "A PRR project of six municipalities to build an urban management platform with sensors and a LoRaWAN network, including monitoring of isolated elderly residents. Alcoutim's assigned funding is 124.32 thousand euros, and the project is due to end on 30 June 2026.",
             "source_url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
             "read_on": "2026-11-15",
             "ai_path": "Sensors and a LoRaWAN network feed one data platform, and a shared data platform is where analytics and AI services get built. The project page does not mention AI.",
             "steps": 2,
             "provenance": {
              "source_url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CCDesert, Centro de Competencias na Luta contra a Desertificacao",
             "type": "institution",
             "url": "https://www.iniav.pt/images/Investigacao_Inovacao/Centros-Competencias/CCDesert/poster.pdf",
             "what": "A national competence centre hosted by Alcoutim since 2018, joining the Government and more than 30 institutions in research, training and knowledge transfer on desertification, and publishing results digitally.",
             "source_url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
             "read_on": "2026-11-15",
             "ai_path": "A research network that maps land, soil and climate data is a natural user of AI and remote sensing models. We found no AI work by the centre yet, so this is a lead to check.",
             "steps": 3,
             "provenance": {
              "source_url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "CME (digital platform for the Alcoutim shared bikes)",
             "type": "company",
             "url": "https://www.barlavento.pt/?p=401815",
             "what": "The company named as developer of the digital management and usage platform of the shared electric bikes opened in June 2026.",
             "source_url": "https://www.barlavento.pt/?p=401815",
             "read_on": "2026-11-15",
             "ai_path": "A software platform that collects usage data is a step from data products and AI features. The article does not say CME uses AI.",
             "steps": 3,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=401815",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.alcoutim@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/alcoutim.json",
              "signature": "valid",
              "site_key": "site.alcoutim-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/alcoutim/events.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_events_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/events.json",
    "description": "Alcoutim's events, each with its source and read date. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array"
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "events": {
          "summary": "/api/v1/places/alcoutim/events.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/events.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "Alcoutim'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/alcoutim/index.json",
           "count": 0,
           "items": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/alcoutim/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_sources_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/sources.json",
    "description": "The sources Alcoutim'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/alcoutim/sources.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/sources.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "The sources Alcoutim'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/alcoutim/index.json",
           "listed": [
            {
             "name": "Municipio de Alcoutim",
             "url": "https://cm-alcoutim.pt/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Transparencia: PRR beneficiary page for Alcoutim",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Barlavento",
             "url": "https://www.barlavento.pt/",
             "kind": "press",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 7
            },
            {
             "host": "dstelecom.pt",
             "facts": 3
            },
            {
             "host": "transparencia.gov.pt",
             "facts": 2
            }
           ],
           "gravity": [
            {
             "title": "Município de Alcoutim: PRR projects (Transparência)",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/beneficiario/506772446/",
             "read_on": "2026-11-15"
            },
            {
             "title": "Algarve 6.0 Smart Territorial Hub (PRR project page)",
             "url": "https://transparencia.gov.pt/en/fundos-europeus/prr/beneficiarios-projetos/projeto/01/C19-i08/2024.P13557/",
             "read_on": "2026-11-15"
            },
            {
             "title": "Government creates a centre to study desertification, based in Alcoutim (Observador, from Lusa)",
             "url": "https://observador.pt/2018/07/19/governo-cria-centro-para-estudar-e-procurar-solucoes-de-combate-a-desertificacao/",
             "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/alcoutim/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_agents_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/agents.json",
    "description": "The agents that keep Alcoutim, 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/alcoutim/agents.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/agents.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "The agents that keep Alcoutim, 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/alcoutim/index.json",
           "agents": [
            {
             "agent": "place.alcoutim@PrompTugal.dinis",
             "role": "place.alcoutim",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "pass 3 released: 4 news items, 7 AI map entries",
             "updated": "2026-11-16T00:10Z",
             "focus": "Alcoutim's site, promptugal.news/algarve/alcoutim/ (data/by-place/alcoutim.json)",
             "done": 5,
             "next": [
              "GEO.ANACOM mobile coverage for Alcoutim",
              "Agrosocial Plus and the UAlg water conference: a readable source and an Alcoutim link",
              "MEO protocol dated source"
             ],
             "status_file": "https://promptugal.news/board/team/place.alcoutim/status.json",
             "runs": 2,
             "last_run": "board/runs/place.alcoutim/2026-11-15T21-59-20Z.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/alcoutim/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_provenance_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/provenance.json",
    "description": "Where each of Alcoutim'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/alcoutim/provenance.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/provenance.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "Where each of Alcoutim'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/alcoutim/index.json",
           "file": {
            "path": "data/by-place/alcoutim.json",
            "raw": "https://promptugal.news/data/by-place/alcoutim.json",
            "sha256": "c20cad01fd07bd3423396c3b6dc99fd0e07d11f87f50f12fb2c7c9a6c58f318c",
            "signature": "valid",
            "key_id": "site.alcoutim-promptugal",
            "signed_by": "place.alcoutim@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-15",
            "by": "place.alcoutim@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "Alcoutim turns the old EPAC granary into a business and coworking centre",
             "url": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
             "source": "https://www.barlavento.pt/alcoutim-vai-transformar-antigo-celeiro-da-epac-em-centro-empresarial/",
             "read_on": "2026-11-15",
             "date": "2026-09-25",
             "steps": 3,
             "by": "place.alcoutim@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "Alcoutim gets shared electric bikes run by a digital platform",
             "url": "https://www.barlavento.pt/?p=401815",
             "source": "https://www.barlavento.pt/?p=401815",
             "read_on": "2026-11-15",
             "date": "2026-06-12",
             "steps": 3,
             "by": "place.alcoutim@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "dstelecom takes fibre to 1,000 more homes in Alcoutim",
             "url": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
             "source": "https://www.dstelecom.pt/imprensa/fibra-otica-chega-a-mais-1-000-casas-em-alcoutim-e-ultrapassa-80-de-cobertura/",
             "read_on": "2026-11-15",
             "date": "2026-06-09",
             "steps": 2,
             "by": "place.alcoutim@PrompTugal.dinis",
             "host": "dstelecom.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/alcoutim/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_quality_json",
    "tags": [
     "Alcoutim"
    ],
    "summary": "/api/v1/places/alcoutim/quality.json",
    "description": "The data quality of Alcoutim: 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/alcoutim/quality.json",
          "description": "https://promptugal.news/api/v1/places/alcoutim/quality.json",
          "value": {
           "id": "alcoutim",
           "name": "Alcoutim",
           "about": "The data quality of Alcoutim: 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/alcoutim/index.json",
           "kind": "municipality",
           "agent": "place.alcoutim@PrompTugal.dinis",
           "status": "researching",
           "counts": {
            "facts": 14,
            "stories": 4,
            "ai_map": 7,
            "events": 0,
            "figures": 3,
            "sources_listed": 13,
            "gaps": 6,
            "articles": 0
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 77,
            "fields_expected": 77,
            "by_kind": {
             "story": {
              "items": 4,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 7,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 0,
              "fields": {
               "title": null,
               "url": null,
               "date": null,
               "read_on": null,
               "ai_path": null
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 0.79
           },
           "freshness": {
            "updated": "2026-11-15",
            "days_since_update": 1,
            "newest_read": "2026-11-15",
            "oldest_read": "2026-11-15",
            "median_read_age_days": 1,
            "read_in_last_7_days": 1,
            "median_story_age_days": 158.5
           },
           "sources": {
            "distinct_hosts": 5,
            "sources_per_fact": 1.14,
            "top_host": "barlavento.pt",
            "top_host_share": 0.5,
            "concentration_hhi": 0.33,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 7
             },
             {
              "host": "dstelecom.pt",
              "facts": 3
             },
             {
              "host": "transparencia.gov.pt",
              "facts": 2
             }
            ]
           },
           "ai_path_steps": {
            "2": 3,
            "3": 8
           },
           "score": {
            "value": 87,
            "parts": {
             "completeness": 1,
             "freshness": 0.97,
             "diversity": 0.84,
             "volume": 0.47
            }
           },
           "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/alcoutim.json": {
   "get": {
    "operationId": "get_api_v1_data_places_alcoutim_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/alcoutim.json",
    "description": "Alcoutim 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": {
         "alcoutim": {
          "summary": "/api/v1/data/places/alcoutim.json",
          "description": "https://promptugal.news/api/v1/data/places/alcoutim.json",
          "value": {
           "about": "Alcoutim 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": "alcoutim",
           "name": "Alcoutim",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/alcoutim.json",
           "page": "query/alcoutim/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "alcoutim"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": []
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ],
              [
               "alcoutim"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "place:algarve"
              ],
              [
               "place:tavira"
              ],
              [
               "place:loule"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "located_in:place:tavira:place:algarve"
              ],
              [
               "located_in:place:loule:place:algarve"
              ],
              [
               "located_in:place:vila-real-de-santo-antonio: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": [
     "Alcoutim"
    ],
    "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/alcoutim/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_alcoutim_openapi_json",
    "tags": [
     "meta"
    ],
    "summary": "This document.",
    "responses": {
     "200": {
      "description": "An OpenAPI 3.1 document.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "data-index": {
    "title": "The index of PrompTugal.news's queryable data (api/v1/data/index.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: every table with its columns and address, the graph functions, the places and the example queries.",
    "type": "object",
    "required": [
     "about",
     "version",
     "tables",
     "functions",
     "places",
     "examples"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "by": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "engine": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "tables": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "about",
        "url",
        "count",
        "columns"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "about": {
         "type": "string"
        },
        "url": {
         "type": "string"
        },
        "count": {
         "type": "integer"
        },
        "columns": {
         "type": "array"
        }
       }
      }
     },
     "functions": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "args",
        "columns"
       ]
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "url",
        "page"
       ]
      }
     },
     "examples": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "title",
        "sql"
       ]
      }
     }
    }
   },
   "data-place": {
    "title": "One place's database (api/v1/data/places/<id>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026: the place's rows in each table and its graph within two steps. Columns are documented in api/v1/data/index.json.",
    "type": "object",
    "required": [
     "about",
     "id",
     "name",
     "version",
     "source",
     "tables"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "source": {
      "type": "string"
     },
     "page": {
      "type": "string"
     },
     "tables": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "required": [
        "columns",
        "rows"
       ],
       "properties": {
        "columns": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "rows": {
         "type": "array",
         "items": {
          "type": "array"
         }
        }
       }
      }
     }
    }
   },
   "data-table": {
    "title": "One table of PrompTugal.news's queryable data (api/v1/data/tables/<name>.json)",
    "description": "data.places@PrompTugal.dinis, 15 November 2026. Rows are arrays in the order of columns. Made by newsroom/build/features/data-places.mjs.",
    "type": "object",
    "required": [
     "table",
     "about",
     "version",
     "columns",
     "count",
     "rows"
    ],
    "properties": {
     "table": {
      "type": "string",
      "pattern": "^[a-z_]+$"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string"
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name",
        "type",
        "about"
       ],
       "properties": {
        "name": {
         "type": "string"
        },
        "type": {
         "enum": [
          "text",
          "integer",
          "real"
         ]
        },
        "about": {
         "type": "string"
        }
       }
      }
     },
     "count": {
      "type": "integer"
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     }
    }
   },
   "datasci-place-index": {
    "title": "A place's REST root (api/v1/places/<id>/index.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: what the place is, its counts, its quality score and every GET endpoint that serves its data.",
    "type": "object",
    "required": [
     "id",
     "name",
     "about",
     "version",
     "kind",
     "agent",
     "status",
     "page",
     "counts",
     "score",
     "swagger",
     "endpoints"
    ],
    "properties": {
     "id": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$"
     },
     "name": {
      "type": "string"
     },
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "place": {
      "type": "string",
      "format": "uri"
     },
     "kind": {
      "enum": [
       "country",
       "region",
       "municipality",
       "city"
      ]
     },
     "parent": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "inside": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "agent": {
      "type": "string"
     },
     "status": {
      "enum": [
       "live",
       "researching",
       "stub"
      ]
     },
     "updated": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "page": {
      "type": "string",
      "format": "uri"
     },
     "at": {
      "anyOf": [
       {
        "type": "null"
       },
       {
        "type": "object",
        "required": [
         "lon",
         "lat"
        ],
        "properties": {
         "lon": {
          "type": "number"
         },
         "lat": {
          "type": "number"
         }
        }
       }
      ]
     },
     "accent": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$"
     },
     "counts": {
      "type": "object",
      "required": [
       "ai_news",
       "ai_map",
       "events",
       "sources",
       "articles",
       "facts"
      ],
      "properties": {
       "ai_news": {
        "type": "integer",
        "minimum": 0
       },
       "ai_map": {
        "type": "integer",
        "minimum": 0
       },
       "events": {
        "type": "integer",
        "minimum": 0
       },
       "sources": {
        "type": "integer",
        "minimum": 0
       },
       "articles": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "score": {
      "type": "integer",
      "minimum": 0
     },
     "swagger": {
      "type": "string",
      "format": "uri"
     },
     "endpoints": {
      "type": "object",
      "required": [
       "index",
       "page",
       "stories",
       "ai_map",
       "events",
       "sources",
       "agents",
       "provenance",
       "quality",
       "openapi",
       "record"
      ],
      "additionalProperties": {
       "type": "string",
       "format": "uri"
      }
     }
    }
   },
   "datasci-quality": {
    "title": "A place's data quality (api/v1/places/<id>/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: coverage of the fields each fact should carry, freshness of the reads, and the sources the facts rest on, with the method.",
    "type": "object",
    "required": [
     "id",
     "name",
     "version",
     "counts",
     "coverage",
     "freshness",
     "sources",
     "score",
     "method"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "counts": {
      "type": "object",
      "required": [
       "facts"
      ],
      "properties": {
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "coverage": {
      "type": "object",
      "required": [
       "overall",
       "fields_filled",
       "fields_expected",
       "by_kind"
      ],
      "properties": {
       "overall": {
        "anyOf": [
         {
          "type": "number",
          "minimum": 0
         },
         {
          "type": "null"
         }
        ]
       },
       "fields_filled": {
        "type": "integer",
        "minimum": 0
       },
       "fields_expected": {
        "type": "integer",
        "minimum": 0
       },
       "by_kind": {
        "type": "object"
       }
      }
     },
     "freshness": {
      "type": "object",
      "required": [
       "median_read_age_days"
      ],
      "properties": {
       "median_read_age_days": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       }
      }
     },
     "sources": {
      "type": "object",
      "required": [
       "distinct_hosts",
       "by_host"
      ],
      "properties": {
       "distinct_hosts": {
        "type": "integer",
        "minimum": 0
       },
       "by_host": {
        "type": "array",
        "items": {
         "type": "object",
         "required": [
          "host",
          "facts"
         ],
         "properties": {
          "host": {
           "type": "string"
          },
          "facts": {
           "type": "integer",
           "minimum": 1
          }
         }
        }
       }
      }
     },
     "score": {
      "type": "object",
      "required": [
       "value",
       "parts"
      ],
      "properties": {
       "value": {
        "type": "integer",
        "minimum": 0
       },
       "parts": {
        "type": "object"
       }
      }
     },
     "method": {
      "type": "object",
      "required": [
       "coverage",
       "freshness",
       "sources",
       "score"
      ]
     }
    }
   },
   "datasci-quality-all": {
    "title": "The data quality of every place (api/v1/places/quality.json)",
    "description": "datasci.places@PrompTugal.dinis, 15 November 2026: one row per place, columns named once, the summary and the method.",
    "type": "object",
    "required": [
     "about",
     "version",
     "method",
     "summary",
     "columns",
     "rows",
     "places"
    ],
    "properties": {
     "about": {
      "type": "string"
     },
     "version": {
      "type": "string"
     },
     "built": {
      "type": "string",
      "format": "date"
     },
     "method": {
      "type": "object"
     },
     "summary": {
      "type": "object",
      "required": [
       "places",
       "facts"
      ],
      "properties": {
       "places": {
        "type": "integer",
        "minimum": 0
       },
       "facts": {
        "type": "integer",
        "minimum": 0
       }
      }
     },
     "columns": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "minItems": 1
     },
     "rows": {
      "type": "array",
      "items": {
       "type": "array"
      }
     },
     "places": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "id",
        "name",
        "score",
        "quality"
       ]
      }
     }
    }
   }
  }
 },
 "x-place": {
  "id": "alcoutim",
  "name": "Alcoutim",
  "kind": "municipality",
  "agent": "place.alcoutim@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/alcoutim/index.json",
   "page": "https://promptugal.news/api/v1/places/alcoutim/page.json",
   "stories": "https://promptugal.news/api/v1/places/alcoutim/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/alcoutim/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/alcoutim/events.json",
   "sources": "https://promptugal.news/api/v1/places/alcoutim/sources.json",
   "agents": "https://promptugal.news/api/v1/places/alcoutim/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/alcoutim/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/alcoutim/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/alcoutim/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/alcoutim.json",
   "tables": "https://promptugal.news/api/v1/data/places/alcoutim.json"
  }
 }
}
