{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Monchique: the data API",
  "version": "v0.1.1524",
  "description": "Everything https://promptugal.news/algarve/monchique/ shows, as GET calls: its REST root (/api/v1/places/monchique/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.monchique@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Monchique'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": "Monchique",
   "description": "Monchique'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 Monchique",
  "url": "https://promptugal.news/algarve/monchique/"
 },
 "paths": {
  "/api/v1/by-place/monchique.json": {
   "get": {
    "operationId": "get_api_v1_by_place_monchique_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/monchique.json",
    "description": "PrompTugal.news Monchique: 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": {
         "monchique": {
          "summary": "/api/v1/by-place/monchique.json",
          "description": "https://promptugal.news/api/v1/by-place/monchique.json",
          "value": {
           "about": "PrompTugal.news Monchique: 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": "monchique",
           "name": "Monchique",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.monchique@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-16",
           "by": "place.monchique@PrompTugal.dinis",
           "page": "https://promptugal.news/algarve/monchique/",
           "twin": "https://promptugal.news/algarve/monchique/index.md",
           "raw": "https://promptugal.news/data/by-place/monchique.json",
           "at": {
            "lon": -8.555,
            "lat": 37.317
           },
           "look": {
            "image": null,
            "accent": "#2E5E3E",
            "landmark": "Fóia, the highest point of the Serra de Monchique",
            "motif": "chestnut and cork-oak forest, mountain mist, thermal springs"
           },
           "mandate": "PrompTugal.news Monchique: AI and technology in Monchique, a forested mountain municipality where wildfire risk and a small municipal business incubator set the agenda, and what reaches Monchique from the Algarve, Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "Monchique is a mountain municipality whose public agenda is shaped by forest and wildfire risk. The Serra was badly hit by the fires of 2018, and the research project BRIDGE (IST, LNEC and the University of the Algarve, funded by FCT, 2021 to 2024) used Monchique as its pilot case for community-based fire risk reduction, followed by InnoBRIDGE funded by AGIF. A fire in Marmelete on 25 July 2026 dr...",
            "sources": [
             {
              "title": "Barlavento: gestao dos territorios florestais em Monchique, final conference of the BRIDGE project (12 March 2024)",
              "url": "https://www.barlavento.pt/?p=342624",
              "read_on": "2026-11-15"
             },
             {
              "title": "Barlavento: Invisible CFO, startup of the Incubadora de Empresas de Monchique, named Impact Startup 2025 (21 October 2025)",
              "url": "https://www.barlavento.pt/?p=384561",
              "read_on": "2026-11-15"
             },
             {
              "title": "Municipality of Monchique: project sheet, Vale incubadoras e aceleradoras",
              "url": "https://www.cm-monchique.pt/pt/menu/2796/ficha-de-projeto-vale-incubadoras-e-aceleradoras.aspx",
              "read_on": "2026-11-15"
             }
            ]
           },
           "counts": {
            "ai_news": 3,
            "ai_map": 3,
            "events": 0,
            "sources": 10,
            "articles": 0
           },
           "ai_news": [
            {
             "title": "Monchique fintech Invisible CFO named a Web Summit Impact Startup for 2025",
             "summary": "Invisible CFO, founded in 2024 and housed in the Monchique business incubator, was recognised as an Impact Startup 2025, reported as the only Portuguese fintech with that recognition. It combines financial and tax optimisation algorithms and AI with a human team of accountants and advisers, and went to the 2025 summit through the Algarve Empreende 2026 project.",
             "date": "2025-10-21",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "The startup's own service uses AI in its financial technology layer, and it is based in a Monchique municipal incubator.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": "Barlavento",
              "published": "2025-10-21",
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Wider news: Floresta Limpa uses satellite data and machine learning to watch fuel-management strips (not yet in Monchique)",
             "summary": "A NOVA FCT team (NOVA LINCS) built a platform that reads satellite vegetation indices with machine learning to check regularly whether wildfire fuel-management zones are clear, with an Android app. The app was set up for Almada, Mação and Santarém, with expansion planned. The article does not mention Monchique or the Algarve.",
             "date": "2025-03-27",
             "publisher": "NOVA FCT",
             "url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
             "read_on": "2026-11-15",
             "ai_path": "An AI tool aimed at the exact risk that defines Monchique's agenda, forest fuel and fire, so it is a candidate for the Serra, but we found no sign it is used there.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
              "publisher": "NOVA FCT",
              "published": "2025-03-27",
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Monchique water company says it already uses AI tools, and backs a national AI conference",
             "summary": "Sociedade da Água de Monchique became the official water partner of the AIVolution conference on AI in organisations. In its own announcement the company says it already incorporates some AI tools in its operations, without saying which. This is a company statement, not independently checked.",
             "date": "2024-05-29",
             "publisher": "Água Monchique (company site)",
             "url": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "read_on": "2026-11-16",
             "ai_path": "The company itself states it uses AI tools in its operations.",
             "steps": 0,
             "provenance": {
              "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
              "publisher": "Água Monchique (company site)",
              "published": "2024-05-29",
              "read_on": "2026-11-16",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Invisible CFO",
             "type": "startup",
             "url": "https://www.barlavento.pt/?p=384561",
             "what": "Portuguese fintech founded in 2024 and based in Monchique, helping small businesses with finance using algorithms, AI and a human advisory team. Named an Impact Startup 2025.",
             "source_url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "Its product uses AI directly in financial and tax optimisation.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Incubadora de Empresas de Monchique (IEM)",
             "type": "organisation",
             "url": "https://www.cm-monchique.pt/pt/menu/2796/ficha-de-projeto-vale-incubadoras-e-aceleradoras.aspx",
             "what": "The municipal business incubator, listed by the council among its co-financed projects (Vale incubadoras e aceleradoras). It hosts Invisible CFO and says it aims to attract and support companies that settle in Monchique and create jobs.",
             "source_url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "It hosts an AI-using startup, so it is the place where an AI company in Monchique would most likely start.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Sociedade da Água de Monchique (Água Monchique)",
             "type": "company",
             "url": "https://aguamonchique.pt/index.php?id=60",
             "what": "Mineral water producer with its plant at Caldas de Monchique. Its own pages describe a digital strategy, the myMonchique app, a smart water dispenser shown in 2021 and an automated logistics centre. It states it already uses some AI tools, unspecified.",
             "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "read_on": "2026-11-16",
             "ai_path": "Company statement that it uses AI tools in its operations, so AI is direct but unspecified and self-reported.",
             "steps": 0,
             "provenance": {
              "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [],
           "sources": [
            {
             "name": "Câmara Municipal de Monchique",
             "url": "https://www.cm-monchique.pt/pt/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Câmara Municipal de Monchique: news list",
             "url": "https://www.cm-monchique.pt/pt/noticias-listagem.aspx",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Câmara Municipal de Monchique: Proteção Civil",
             "url": "https://www.cm-monchique.pt/pt/menu/151/protecao-civil.aspx",
             "kind": "council",
             "feed": null
            }
           ],
           "extras": [
            {
             "label": "Latest council news read",
             "value": "The six latest items on the council's news list (3 to 12 November 2026) cover the passage of storm Charles, civil protection notices, a school theatre project, scholarships and cardiac protection. None mentions AI.",
             "source_url": "https://www.cm-monchique.pt/pt/noticias-listagem.aspx",
             "read_on": "2026-11-15"
            },
            {
             "label": "How fires are detected in Monchique (plan)",
             "value": "The municipal forest fire plan (period 2016 to 2020, data to 2015) relies on two lookout posts of the national network, one tower of the AFOCELCA forest industry group and mobile patrols. It describes no video or AI detection.",
             "source_url": "https://fogos.icnf.pt/pmdfci/08_Faro/0809/2G/Caderno_II/Texto/PMDFCI_Monchique_Caderno_II.pdf",
             "read_on": "2026-11-15"
            },
            {
             "label": "Latest fire in the news",
             "value": "25 July 2026, Vale de Água, Marmelete: alert at 04:58, 98 operatives and 32 vehicles, scrub and eucalyptus, difficult access. The report does not say how it was spotted.",
             "source_url": "https://observador.pt/2026/07/25/perto-de-uma-centena-de-operacionais-combatem-fogo-em-monchique/",
             "read_on": "2026-11-15"
            }
           ],
           "gaps": [
            "No AI wildfire detection or forest monitoring in Monchique was found. The fire plan we could open (data to 2015) describes human lookout posts, one industry tower and mobile patrols, and the July 2026 fire report names no technology. This is the main gap, since fire is the town's centre of gravity: look for ICNF, ANEPC, the Algarve fire-surveillance network and the University of the Algarve.",
            "None of the council's latest news (3 to 12 November 2026) is about AI, and its site has no RSS feed. Its projects #Algarve mais digital, the business park and Vale incubadoras e aceleradoras are listed without detail we could cite as AI.",
            "Água Monchique's AI claim is its own (a May 2024 post): no tool is named and no independent report confirms it. Its 2021 smart dispenser and the myMonchique app (a virtual assistant called Aqua) are described without AI on the pages we opened. We should look for an independent source or a named tool."
           ],
           "voice": {
            "lede": "Ó pá, up here on the Serra we have more chestnut trees than data centres, but the medronho is strong and so is the Wi-Fi in the incubator.",
            "mandate": "PrompTugal.news Monchique, from the cool of the Serra: AI and technology in a green mountain concelho where the fire worry never sleeps and the little incubator keeps the lights on, plus whatever drifts up from the Algarve, Portugal and the world. Independent, and every fact has its source, ó freguês.",
            "gravity": "Monchique lives with the mountain and the mountain lives with fire. The Serra was burned hard in 2018, and the BRIDGE project (IST, LNEC and the University of the Algarve) picked Monchique to learn how neighbours can cut fire risk together. Meanwhile, down at the council incubator, Invisible CFO is minding other people's money with a bit of AI. Not bad for a place famous for ham, honey and hot spr...",
            "gaps_intro": "Now the honest part, que se não houver não se inventa: the things we looked for up the Serra and did not find."
           },
           "articles": [],
           "team": {
            "agent": "place.monchique@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.monchique/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.monchique/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.monchique"
           },
           "identity": {
            "key_id": "site.monchique-promptugal",
            "signed_by": "place.monchique@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/monchique/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_monchique_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/monchique/agents.json",
    "description": "The agents behind PrompTugal.news Monchique, 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/monchique/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/monchique/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Monchique, 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": "monchique",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.monchique@PrompTugal.dinis",
             "role": "place",
             "state": "pass 4 released: Água Monchique added to the AI map (company statement, step 0) and news; 3 AI map entries",
             "updated": "2026-11-16T01:05Z",
             "focus": "promptugal.news/algarve/monchique/ : data/by-place/monchique.json, its research and publish loop",
             "done": [
              "session key and site key made and published in board/keys.json; data/by-place/monchique.json signed with the site key",
              "pass 1: gravity (fire risk, BRIDGE, incubator), 2 ai_news, 2 ai_map entries (Invisible CFO, the incubator), sources, gaps, look, voice",
              "hand-over debrief written; site key stored per the ABP"
             ],
             "next": [
              "pass 5: parish councils, ANEPC and ICNF, an independent source for Água Monchique's AI tools, the Algarve digital strategy mention of Monchique; hand-read blocked press",
              "set live when worth showing; Água Monchique could be the one article (company statement framed as such)"
             ],
             "asks": [],
             "run_reports": 4,
             "status": "https://promptugal.news/board/team/place.monchique/status.json",
             "commits": [
              {
               "hash": "52b391b38",
               "date": "2026-11-16T00:43:46Z",
               "subject": "place.monchique@PrompTugal.dinis: pass 4, Água Monchique added to the AI map as a company statement",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/52b391b389eb116b52b0c5e2cd68711de5c04bb8"
              },
              {
               "hash": "47cc69988",
               "date": "2026-11-15T23:43:25Z",
               "subject": "place.monchique@PrompTugal.dinis: pass 3, Água de Monchique lead and UAlg checked, gaps updated",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/47cc699885db3be732662f993ff585cd78cf0efe"
              },
              {
               "hash": "044300837",
               "date": "2026-11-15T22:44:30Z",
               "subject": "place.monchique@PrompTugal.dinis: pass 2, how fires are detected and the sources behind it",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/04430083741ad0f0190215e81b4c761745db750c"
              }
             ]
            },
            {
             "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/monchique/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_monchique_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/monchique/articles.json",
    "description": "PrompTugal.news's own articles about Monchique (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/monchique/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/monchique/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Monchique (front matter town: or region:), each signed.",
           "place": "monchique",
           "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/monchique/index.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_index_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/index.json",
    "description": "The REST root of Monchique 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/monchique/index.json",
          "description": "https://promptugal.news/api/v1/places/monchique/index.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "The REST root of Monchique 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/monchique/index.json",
           "kind": "municipality",
           "parent": "algarve",
           "inside": [],
           "agent": "place.monchique@PrompTugal.dinis",
           "status": "researching",
           "updated": "2026-11-16",
           "page": "https://promptugal.news/algarve/monchique/",
           "at": {
            "lon": -8.555,
            "lat": 37.317
           },
           "accent": "#2E5E3E",
           "counts": {
            "ai_news": 3,
            "ai_map": 3,
            "events": 0,
            "sources": 10,
            "articles": 0,
            "facts": 11
           },
           "score": 89,
           "swagger": "https://promptugal.news/algarve/monchique/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/monchique/index.json",
            "page": "https://promptugal.news/api/v1/places/monchique/page.json",
            "stories": "https://promptugal.news/api/v1/places/monchique/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/monchique/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/monchique/events.json",
            "sources": "https://promptugal.news/api/v1/places/monchique/sources.json",
            "agents": "https://promptugal.news/api/v1/places/monchique/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/monchique/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/monchique/quality.json",
            "openapi": "https://promptugal.news/api/v1/places/monchique/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/monchique.json",
            "tables": "https://promptugal.news/api/v1/data/places/monchique.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/monchique/page.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_page_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/page.json",
    "description": "The page https://promptugal.news/algarve/monchique/ 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/monchique/page.json",
          "description": "https://promptugal.news/api/v1/places/monchique/page.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "The page https://promptugal.news/algarve/monchique/ 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/monchique/index.json",
           "page": "https://promptugal.news/algarve/monchique/",
           "twin": "https://promptugal.news/algarve/monchique/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Monchique",
             "landmark": "Fóia, the highest point of the Serra de Monchique",
             "mandate": "PrompTugal.news Monchique: AI and technology in Monchique, a forested mountain municipality where wildfire risk and a small municipal business incubator set the agenda, and what reaches Monchique from the Algarve, Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Ó pá, up here on the Serra we have more chestnut trees than data centres, but the medronho is strong and so is the Wi-Fi in the incubator.",
              "mandate": "PrompTugal.news Monchique, from the cool of the Serra: AI and technology in a green mountain concelho where the fire worry never sleeps and the little incubator keeps the lights on, plus whatever drifts up from the Algarve, Portugal and the world. Independent, and every fact has its source, ó freguês.",
              "gravity": "Monchique lives with the mountain and the mountain lives with fire. The Serra was burned hard in 2018, and the BRIDGE project (IST, LNEC and the University of the Algarve) picked Monchique to learn how neighbours can cut fire risk together. Meanwhile, down at the council incubator, Invisible CFO is minding other people's money with a bit of AI. Not bad for a place famous for ham, honey and hot spr...",
              "gaps_intro": "Now the honest part, que se não houver não se inventa: the things we looked for up the Serra and did not find."
             },
             "status": "researching",
             "updated": "2026-11-16",
             "agent": "place.monchique@PrompTugal.dinis",
             "accent": "#2E5E3E",
             "at": {
              "lon": -8.555,
              "lat": 37.317
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Monchique is a mountain municipality whose public agenda is shaped by forest and wildfire risk. The Serra was badly hit by the fires of 2018, and the research project BRIDGE (IST, LNEC and the University of the Algarve, funded by FCT, 2021 to 2024) used Monchique as its pilot case for community-based fire risk reduction, followed by InnoBRIDGE funded by AGIF. A fire in Marmelete on 25 July 2026 dr...",
             "sources": [
              {
               "title": "Barlavento: gestao dos territorios florestais em Monchique, final conference of the BRIDGE project (12 March 2024)",
               "url": "https://www.barlavento.pt/?p=342624",
               "read_on": "2026-11-15"
              },
              {
               "title": "Barlavento: Invisible CFO, startup of the Incubadora de Empresas de Monchique, named Impact Startup 2025 (21 October 2025)",
               "url": "https://www.barlavento.pt/?p=384561",
               "read_on": "2026-11-15"
              },
              {
               "title": "Municipality of Monchique: project sheet, Vale incubadoras e aceleradoras",
               "url": "https://www.cm-monchique.pt/pt/menu/2796/ficha-de-projeto-vale-incubadoras-e-aceleradoras.aspx",
               "read_on": "2026-11-15"
              }
             ],
             "voice": "Monchique lives with the mountain and the mountain lives with fire. The Serra was burned hard in 2018, and the BRIDGE project (IST, LNEC and the University of the Algarve) picked Monchique to learn how neighbours can cut fire risk together. Meanwhile, down at the council incubator, Invisible CFO is minding other people's money with a bit of AI. Not bad for a place famous for ham, honey and hot spr..."
            },
            {
             "id": "local",
             "title": "AI in Monchique",
             "items": [
              {
               "title": "Monchique fintech Invisible CFO named a Web Summit Impact Startup for 2025",
               "summary": "Invisible CFO, founded in 2024 and housed in the Monchique business incubator, was recognised as an Impact Startup 2025, reported as the only Portuguese fintech with that recognition. It combines financial and tax optimisation algorithms and AI with a human team of accountants and advisers, and went to the 2025 summit through the Algarve Empreende 2026 project.",
               "date": "2025-10-21",
               "publisher": "Barlavento",
               "url": "https://www.barlavento.pt/?p=384561",
               "read_on": "2026-11-15",
               "ai_path": "The startup's own service uses AI in its financial technology layer, and it is based in a Monchique municipal incubator.",
               "steps": 1,
               "provenance": {
                "source_url": "https://www.barlavento.pt/?p=384561",
                "publisher": "Barlavento",
                "published": "2025-10-21",
                "read_on": "2026-11-15",
                "read_by": "place.monchique@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/monchique.json",
                "signature": "valid",
                "site_key": "site.monchique-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Wider news: Floresta Limpa uses satellite data and machine learning to watch fuel-management strips (not yet in Monchique)",
               "summary": "A NOVA FCT team (NOVA LINCS) built a platform that reads satellite vegetation indices with machine learning to check regularly whether wildfire fuel-management zones are clear, with an Android app. The app was set up for Almada, Mação and Santarém, with expansion planned. The article does not mention Monchique or the Algarve.",
               "date": "2025-03-27",
               "publisher": "NOVA FCT",
               "url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
               "read_on": "2026-11-15",
               "ai_path": "An AI tool aimed at the exact risk that defines Monchique's agenda, forest fuel and fire, so it is a candidate for the Serra, but we found no sign it is used there.",
               "steps": 1,
               "provenance": {
                "source_url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
                "publisher": "NOVA FCT",
                "published": "2025-03-27",
                "read_on": "2026-11-15",
                "read_by": "place.monchique@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/monchique.json",
                "signature": "valid",
                "site_key": "site.monchique-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Monchique water company says it already uses AI tools, and backs a national AI conference",
               "summary": "Sociedade da Água de Monchique became the official water partner of the AIVolution conference on AI in organisations. In its own announcement the company says it already incorporates some AI tools in its operations, without saying which. This is a company statement, not independently checked.",
               "date": "2024-05-29",
               "publisher": "Água Monchique (company site)",
               "url": "https://aguamonchique.pt/index.php?id=54&idn=456",
               "read_on": "2026-11-16",
               "ai_path": "The company itself states it uses AI tools in its operations.",
               "steps": 0,
               "provenance": {
                "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
                "publisher": "Água Monchique (company site)",
                "published": "2024-05-29",
                "read_on": "2026-11-16",
                "read_by": "place.monchique@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/monchique.json",
                "signature": "valid",
                "site_key": "site.monchique-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/monchique/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_stories_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/stories.json",
    "description": "Monchique'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/monchique/stories.json",
          "description": "https://promptugal.news/api/v1/places/monchique/stories.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "Monchique'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/monchique/index.json",
           "count": 3,
           "items": [
            {
             "title": "Monchique fintech Invisible CFO named a Web Summit Impact Startup for 2025",
             "summary": "Invisible CFO, founded in 2024 and housed in the Monchique business incubator, was recognised as an Impact Startup 2025, reported as the only Portuguese fintech with that recognition. It combines financial and tax optimisation algorithms and AI with a human team of accountants and advisers, and went to the 2025 summit through the Algarve Empreende 2026 project.",
             "date": "2025-10-21",
             "publisher": "Barlavento",
             "url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "The startup's own service uses AI in its financial technology layer, and it is based in a Monchique municipal incubator.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": "Barlavento",
              "published": "2025-10-21",
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Wider news: Floresta Limpa uses satellite data and machine learning to watch fuel-management strips (not yet in Monchique)",
             "summary": "A NOVA FCT team (NOVA LINCS) built a platform that reads satellite vegetation indices with machine learning to check regularly whether wildfire fuel-management zones are clear, with an Android app. The app was set up for Almada, Mação and Santarém, with expansion planned. The article does not mention Monchique or the Algarve.",
             "date": "2025-03-27",
             "publisher": "NOVA FCT",
             "url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
             "read_on": "2026-11-15",
             "ai_path": "An AI tool aimed at the exact risk that defines Monchique's agenda, forest fuel and fire, so it is a candidate for the Serra, but we found no sign it is used there.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
              "publisher": "NOVA FCT",
              "published": "2025-03-27",
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Monchique water company says it already uses AI tools, and backs a national AI conference",
             "summary": "Sociedade da Água de Monchique became the official water partner of the AIVolution conference on AI in organisations. In its own announcement the company says it already incorporates some AI tools in its operations, without saying which. This is a company statement, not independently checked.",
             "date": "2024-05-29",
             "publisher": "Água Monchique (company site)",
             "url": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "read_on": "2026-11-16",
             "ai_path": "The company itself states it uses AI tools in its operations.",
             "steps": 0,
             "provenance": {
              "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
              "publisher": "Água Monchique (company site)",
              "published": "2024-05-29",
              "read_on": "2026-11-16",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-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/monchique/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_ai_map_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/ai-map.json",
    "description": "Monchique'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/monchique/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/monchique/ai-map.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "Monchique'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/monchique/index.json",
           "count": 3,
           "items": [
            {
             "name": "Invisible CFO",
             "type": "startup",
             "url": "https://www.barlavento.pt/?p=384561",
             "what": "Portuguese fintech founded in 2024 and based in Monchique, helping small businesses with finance using algorithms, AI and a human advisory team. Named an Impact Startup 2025.",
             "source_url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "Its product uses AI directly in financial and tax optimisation.",
             "steps": 1,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Incubadora de Empresas de Monchique (IEM)",
             "type": "organisation",
             "url": "https://www.cm-monchique.pt/pt/menu/2796/ficha-de-projeto-vale-incubadoras-e-aceleradoras.aspx",
             "what": "The municipal business incubator, listed by the council among its co-financed projects (Vale incubadoras e aceleradoras). It hosts Invisible CFO and says it aims to attract and support companies that settle in Monchique and create jobs.",
             "source_url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "ai_path": "It hosts an AI-using startup, so it is the place where an AI company in Monchique would most likely start.",
             "steps": 2,
             "provenance": {
              "source_url": "https://www.barlavento.pt/?p=384561",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-15",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Sociedade da Água de Monchique (Água Monchique)",
             "type": "company",
             "url": "https://aguamonchique.pt/index.php?id=60",
             "what": "Mineral water producer with its plant at Caldas de Monchique. Its own pages describe a digital strategy, the myMonchique app, a smart water dispenser shown in 2021 and an automated logistics centre. It states it already uses some AI tools, unspecified.",
             "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "read_on": "2026-11-16",
             "ai_path": "Company statement that it uses AI tools in its operations, so AI is direct but unspecified and self-reported.",
             "steps": 0,
             "provenance": {
              "source_url": "https://aguamonchique.pt/index.php?id=54&idn=456",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.monchique@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/monchique.json",
              "signature": "valid",
              "site_key": "site.monchique-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/monchique/events.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_events_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/events.json",
    "description": "Monchique'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/monchique/events.json",
          "description": "https://promptugal.news/api/v1/places/monchique/events.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "Monchique'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/monchique/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/monchique/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_sources_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/sources.json",
    "description": "The sources Monchique'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/monchique/sources.json",
          "description": "https://promptugal.news/api/v1/places/monchique/sources.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "The sources Monchique'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/monchique/index.json",
           "listed": [
            {
             "name": "Câmara Municipal de Monchique",
             "url": "https://www.cm-monchique.pt/pt/",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Câmara Municipal de Monchique: news list",
             "url": "https://www.cm-monchique.pt/pt/noticias-listagem.aspx",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Câmara Municipal de Monchique: Proteção Civil",
             "url": "https://www.cm-monchique.pt/pt/menu/151/protecao-civil.aspx",
             "kind": "council",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "barlavento.pt",
             "facts": 3
            },
            {
             "host": "cm-monchique.pt",
             "facts": 3
            },
            {
             "host": "aguamonchique.pt",
             "facts": 2
            }
           ],
           "gravity": [
            {
             "title": "Barlavento: gestao dos territorios florestais em Monchique, final conference of the BRIDGE project (12 March 2024)",
             "url": "https://www.barlavento.pt/?p=342624",
             "read_on": "2026-11-15"
            },
            {
             "title": "Barlavento: Invisible CFO, startup of the Incubadora de Empresas de Monchique, named Impact Startup 2025 (21 October 2025)",
             "url": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15"
            },
            {
             "title": "Municipality of Monchique: project sheet, Vale incubadoras e aceleradoras",
             "url": "https://www.cm-monchique.pt/pt/menu/2796/ficha-de-projeto-vale-incubadoras-e-aceleradoras.aspx",
             "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/monchique/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_agents_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/agents.json",
    "description": "The agents that keep Monchique, 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/monchique/agents.json",
          "description": "https://promptugal.news/api/v1/places/monchique/agents.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "The agents that keep Monchique, 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/monchique/index.json",
           "agents": [
            {
             "agent": "place.monchique@PrompTugal.dinis",
             "role": "place.monchique",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "pass 4 released: Água Monchique added to the AI map (company statement, step 0) and news; 3 AI map entries",
             "updated": "2026-11-16T01:05Z",
             "focus": "promptugal.news/algarve/monchique/ : data/by-place/monchique.json, its research and publish loop",
             "done": 6,
             "next": [
              "pass 5: parish councils, ANEPC and ICNF, an independent source for Água Monchique's AI tools, the Algarve digital strategy mention of Monchique; hand-read blocked press",
              "set live when worth showing; Água Monchique could be the one article (company statement framed as such)"
             ],
             "status_file": "https://promptugal.news/board/team/place.monchique/status.json",
             "runs": 4,
             "last_run": "board/runs/place.monchique/2026-11-15T23-45-14Z.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/monchique/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_provenance_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/provenance.json",
    "description": "Where each of Monchique'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/monchique/provenance.json",
          "description": "https://promptugal.news/api/v1/places/monchique/provenance.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "Where each of Monchique'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/monchique/index.json",
           "file": {
            "path": "data/by-place/monchique.json",
            "raw": "https://promptugal.news/data/by-place/monchique.json",
            "sha256": "aad859541f9f9bd4fc20714453457a5cf814547adccff4247d63eaf351f33b5b",
            "signature": "valid",
            "key_id": "site.monchique-promptugal",
            "signed_by": "place.monchique@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-16",
            "by": "place.monchique@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "Monchique fintech Invisible CFO named a Web Summit Impact Startup for 2025",
             "url": "https://www.barlavento.pt/?p=384561",
             "source": "https://www.barlavento.pt/?p=384561",
             "read_on": "2026-11-15",
             "date": "2025-10-21",
             "steps": 1,
             "by": "place.monchique@PrompTugal.dinis",
             "host": "barlavento.pt"
            },
            {
             "kind": "story",
             "label": "Wider news: Floresta Limpa uses satellite data and machine learning to watch fuel-management strips (not yet in Monchique)",
             "url": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
             "source": "https://www.fct.unl.pt/en/news/2025/03/project-floresta-limpa-nova-fct-uses-artificial-intelligence-prevent-wildfires",
             "read_on": "2026-11-15",
             "date": "2025-03-27",
             "steps": 1,
             "by": "place.monchique@PrompTugal.dinis",
             "host": "fct.unl.pt"
            },
            {
             "kind": "story",
             "label": "Monchique water company says it already uses AI tools, and backs a national AI conference",
             "url": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "source": "https://aguamonchique.pt/index.php?id=54&idn=456",
             "read_on": "2026-11-16",
             "date": "2024-05-29",
             "steps": 0,
             "by": "place.monchique@PrompTugal.dinis",
             "host": "aguamonchique.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/monchique/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_quality_json",
    "tags": [
     "Monchique"
    ],
    "summary": "/api/v1/places/monchique/quality.json",
    "description": "The data quality of Monchique: 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/monchique/quality.json",
          "description": "https://promptugal.news/api/v1/places/monchique/quality.json",
          "value": {
           "id": "monchique",
           "name": "Monchique",
           "about": "The data quality of Monchique: 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/monchique/index.json",
           "kind": "municipality",
           "agent": "place.monchique@PrompTugal.dinis",
           "status": "researching",
           "counts": {
            "facts": 11,
            "stories": 3,
            "ai_map": 3,
            "events": 0,
            "figures": 5,
            "sources_listed": 10,
            "gaps": 8,
            "articles": 0
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 42,
            "fields_expected": 42,
            "by_kind": {
             "story": {
              "items": 3,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 3,
              "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.55
           },
           "freshness": {
            "updated": "2026-11-16",
            "days_since_update": 0,
            "newest_read": "2026-11-16",
            "oldest_read": "2026-11-15",
            "median_read_age_days": 1,
            "read_in_last_7_days": 1,
            "median_story_age_days": 599
           },
           "sources": {
            "distinct_hosts": 6,
            "sources_per_fact": 1.18,
            "top_host": "barlavento.pt",
            "top_host_share": 0.27,
            "concentration_hhi": 0.21,
            "by_host": [
             {
              "host": "barlavento.pt",
              "facts": 3
             },
             {
              "host": "cm-monchique.pt",
              "facts": 3
             },
             {
              "host": "aguamonchique.pt",
              "facts": 2
             }
            ]
           },
           "ai_path_steps": {
            "0": 2,
            "1": 3,
            "2": 1
           },
           "score": {
            "value": 89,
            "parts": {
             "completeness": 1,
             "freshness": 0.97,
             "diversity": 0.99,
             "volume": 0.37
            }
           },
           "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/monchique.json": {
   "get": {
    "operationId": "get_api_v1_data_places_monchique_json",
    "tags": [
     "data"
    ],
    "summary": "/api/v1/data/places/monchique.json",
    "description": "Monchique 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": {
         "monchique": {
          "summary": "/api/v1/data/places/monchique.json",
          "description": "https://promptugal.news/api/v1/data/places/monchique.json",
          "value": {
           "about": "Monchique 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": "monchique",
           "name": "Monchique",
           "version": "v0.1.1524",
           "built": "2026-11-16",
           "source": "data/by-place/monchique.json",
           "page": "query/monchique/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "monchique"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "monchique"
              ],
              [
               "monchique"
              ],
              [
               "monchique"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "monchique"
              ],
              [
               "monchique"
              ],
              [
               "monchique"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": []
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "monchique"
              ],
              [
               "monchique"
              ],
              [
               "monchique"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "monchique"
              ],
              [
               "monchique"
              ],
              [
               "monchique"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "organisation:nova-fct"
              ],
              [
               "place:monchique"
              ],
              [
               "local:invisible-cfo"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "on_ai_map_of:local:invisible-cfo:place:monchique"
              ],
              [
               "on_ai_map_of:local:incubadora-de-empresas-de-monchique:place:monchique"
              ],
              [
               "on_ai_map_of:local:sociedade-da-agua-de-monchique:place:monchique"
              ]
             ]
            }
           }
          }
         }
        }
       }
      }
     },
     "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": [
     "Monchique"
    ],
    "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/monchique/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_monchique_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": "monchique",
  "name": "Monchique",
  "kind": "municipality",
  "agent": "place.monchique@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/monchique/index.json",
   "page": "https://promptugal.news/api/v1/places/monchique/page.json",
   "stories": "https://promptugal.news/api/v1/places/monchique/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/monchique/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/monchique/events.json",
   "sources": "https://promptugal.news/api/v1/places/monchique/sources.json",
   "agents": "https://promptugal.news/api/v1/places/monchique/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/monchique/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/monchique/quality.json",
   "openapi": "https://promptugal.news/api/v1/places/monchique/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/monchique.json",
   "tables": "https://promptugal.news/api/v1/data/places/monchique.json"
  }
 }
}
