{
 "openapi": "3.1.0",
 "info": {
  "title": "PrompTugal.news Viseu: the data API",
  "version": "v0.1.1581",
  "description": "Everything https://promptugal.news/portugal/viseu/ shows, as GET calls: its REST root (/api/v1/places/viseu/index.json), the page as data, its stories, AI map, events, sources, agents, provenance and quality, its record as place.districts@PrompTugal.dinis keeps it, and its database tables. Generated at each build; each example is Viseu'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": "Viseu",
   "description": "Viseu'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 Viseu",
  "url": "https://promptugal.news/portugal/viseu/"
 },
 "paths": {
  "/api/v1/by-place/viseu.json": {
   "get": {
    "operationId": "get_api_v1_by_place_viseu_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/viseu.json",
    "description": "PrompTugal.news Viseu: the place's research as served on its page, its lists checked at build (http(s) links only, stories newest first), with its site identity as verified\n\nMade by the build's `by-place` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "kind": {
           "type": "string"
          },
          "parent": {
           "type": "string"
          },
          "inside": {
           "type": "array"
          },
          "agent": {
           "type": "string"
          },
          "status": {
           "type": "string"
          },
          "updated": {
           "type": "string"
          },
          "by": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "raw": {
           "type": "string"
          },
          "at": {
           "type": "object",
           "properties": {
            "lon": {
             "type": "number"
            },
            "lat": {
             "type": "number"
            }
           },
           "required": [
            "lon",
            "lat"
           ]
          },
          "look": {
           "type": "object",
           "properties": {
            "image": {
             "type": "null"
            },
            "accent": {
             "type": "string"
            },
            "landmark": {
             "type": "string"
            },
            "motif": {
             "type": "string"
            }
           },
           "required": [
            "image",
            "accent",
            "landmark",
            "motif"
           ]
          },
          "mandate": {
           "type": "string"
          },
          "gravity": {
           "type": "object",
           "properties": {
            "text": {
             "type": "string"
            },
            "sources": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "title": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               }
              },
              "required": [
               "title",
               "url",
               "read_on"
              ]
             }
            }
           },
           "required": [
            "text",
            "sources"
           ]
          },
          "counts": {
           "type": "object",
           "properties": {
            "ai_news": {
             "type": "integer"
            },
            "ai_map": {
             "type": "integer"
            },
            "events": {
             "type": "integer"
            },
            "sources": {
             "type": "integer"
            },
            "articles": {
             "type": "integer"
            }
           },
           "required": [
            "ai_news",
            "ai_map",
            "events",
            "sources",
            "articles"
           ]
          },
          "ai_news": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "title",
             "summary",
             "date",
             "publisher",
             "url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "ai_map": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "what": {
              "type": "string"
             },
             "source_url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "null"
               },
               "published": {
                "type": "null"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "required": [
             "name",
             "type",
             "url",
             "what",
             "source_url",
             "read_on",
             "ai_path",
             "steps",
             "provenance"
            ]
           }
          },
          "events": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          },
          "sources": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "kind": {
              "type": "string"
             },
             "feed": {
              "type": "null"
             }
            },
            "required": [
             "name",
             "url",
             "kind",
             "feed"
            ]
           }
          },
          "extras": {
           "type": "array"
          },
          "start_company": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "what": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "source_url": {
              "type": "string"
             },
             "read_on": {
              "type": "string"
             },
             "kind": {
              "type": "string"
             }
            },
            "required": [
             "name",
             "what",
             "url",
             "source_url",
             "read_on",
             "kind"
            ]
           }
          },
          "investors": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "what": {
              "type": "string"
             },
             "url": {
              "type": "string"
             },
             "source_url": {
              "type": "string"
             },
             "read_on": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "amount": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "ai_path": {
              "type": "string"
             }
            },
            "required": [
             "name",
             "what",
             "url",
             "source_url",
             "read_on",
             "type",
             "amount",
             "date",
             "ai_path"
            ]
           }
          },
          "talent": {
           "type": "array"
          },
          "contacts": {
           "type": "array"
          },
          "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"
          },
          "wider_news": {
           "type": "object",
           "properties": {
            "from": {
             "type": "string"
            },
            "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"
               }
              },
              "required": [
               "title",
               "summary",
               "date",
               "publisher",
               "url",
               "read_on",
               "ai_path",
               "steps"
              ]
             }
            }
           },
           "required": [
            "from",
            "items"
           ]
          },
          "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",
          "start_company",
          "investors",
          "talent",
          "contacts",
          "gaps",
          "voice",
          "articles",
          "wider_news",
          "team",
          "identity"
         ],
         "x-inferred": true
        },
        "examples": {
         "viseu": {
          "summary": "/api/v1/by-place/viseu.json",
          "description": "https://promptugal.news/api/v1/by-place/viseu.json",
          "value": {
           "about": "PrompTugal.news Viseu: 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.1581",
           "id": "viseu",
           "name": "Viseu",
           "kind": "city",
           "parent": "portugal",
           "inside": [],
           "agent": "place.districts@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-16",
           "by": "place.districts@PrompTugal.dinis",
           "page": "https://promptugal.news/portugal/viseu/",
           "twin": "https://promptugal.news/portugal/viseu/index.md",
           "raw": "https://promptugal.news/data/by-place/viseu.json",
           "at": {
            "lon": -7.912,
            "lat": 40.661
           },
           "look": {
            "image": null,
            "accent": "#7B4B2A",
            "landmark": "The Sé Catedral and the granite old town on the hill, home of the Grão Vasco museum",
            "motif": "Dão wine country, grey granite, the Feira de São Mateus and the cold, green Beira interior"
           },
           "mandate": "PrompTugal.news Viseu: AI and technology in Viseu, a district capital of the Beira interior whose centre of gravity is its polytechnic university, the council's public-sector AI work and a regional industry that is just starting to talk about AI, and what reaches Viseu from Portugal and the world. Independent; every fact sourced.",
           "gravity": {
            "text": "Viseu's AI activity runs through three public and academic bodies rather than through startups we could source. The Politécnico de Viseu (now branded Universidade Politécnica de Viseu) leads RiskMap, a 244,944 euro project to map building degradation with AI, and has published rules for AI use by its staff and students. The municipality is a member of the AI4PA digital innovation hub for public ad...",
            "sources": [
             {
              "title": "Politécnico de Viseu presents the RISKMAP tool (RTP, undated page, 2026)",
              "url": "https://www.rtp.pt/noticias/economia/politecnico-de-viseu-apresenta-ferramenta-riskmap-que-monitoriza-situacoes-de-risco-no-patrimonio_n1721861",
              "read_on": "2026-11-16"
             },
             {
              "title": "RiskMap project sheet (Instituto Politécnico de Viseu, started 1 October 2025)",
              "url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
              "read_on": "2026-11-16"
             },
             {
              "title": "AI4PA Portugal digital innovation hub (digital.gov.pt, updated 12 May 2026)",
              "url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
              "read_on": "2026-11-16"
             }
            ]
           },
           "counts": {
            "ai_news": 6,
            "ai_map": 7,
            "events": 3,
            "sources": 7,
            "articles": 0
           },
           "ai_news": [
            {
             "title": "Viseu Dão Lafões holds its first Smart Region Summit and shows a data and AI platform for mayors",
             "summary": "On 29 October 2026 the intermunicipal body CIM Viseu Dão Lafões presented SMART REGION, two platforms (a regional knowledge one and an urban management one) that cross scattered data such as visitor flows, mobility and waste to help councils understand local needs. The article does not describe the models used.",
             "date": "2026-10-29",
             "publisher": "Diário de Viseu",
             "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "read_on": "2026-11-16",
             "ai_path": "A regional public body uses AI to turn data into decisions for the councils of Viseu and its neighbours: directly about AI, with the region's public sector as the user.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
              "publisher": "Diário de Viseu",
              "published": "2026-10-29",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "IndustriaTech+AI 2026 puts AI on the factory-floor agenda in Viseu",
             "summary": "An industrial and technology conference at the Montebelo Viseu Congress Hotel from 29 September to 1 October 2026, organised by the polytechnic's mechanical engineering and industrial management department with the council, the business association AIRV and Viseu Marca. AI is a central theme, including maintenance and AI.",
             "date": "2026-09-29",
             "publisher": "Mais Beiras (SAPO)",
             "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "read_on": "2026-11-16",
             "ai_path": "An industry conference held in Viseu with AI as a stated central theme: directly about AI. The date is the event start because the page shows no publication date.",
             "steps": 0,
             "provenance": {
              "source_url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
              "publisher": "Mais Beiras (SAPO)",
              "published": "2026-09-29",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Viseu's polytechnic runs a second edition of its generative AI course for higher education teachers",
             "summary": "The institution's news page lists the second edition of the microcredential Education and AI, announced on 15 May 2026. The course brochure describes 27 hours on using generative AI critically and ethically in teaching, with in-person sessions in Viseu.",
             "date": "2026-05-15",
             "publisher": "Universidade Politécnica de Viseu (news page)",
             "url": "https://univiseu.pt/noticias-ipv/",
             "read_on": "2026-11-16",
             "ai_path": "A Viseu university course on generative AI: directly about AI. We read the news listing and the course brochure, not the announcement page itself.",
             "steps": 0,
             "provenance": {
              "source_url": "https://univiseu.pt/noticias-ipv/",
              "publisher": "Universidade Politécnica de Viseu (news page)",
              "published": "2026-05-15",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "story"
             }
            }
           ],
           "ai_map": [
            {
             "name": "Universidade Politécnica de Viseu (formerly Instituto Politécnico de Viseu, IPV)",
             "type": "institution",
             "url": "https://univiseu.pt",
             "what": "Viseu's public higher education institution, branded Universidade Politécnica de Viseu on its site while still using IPV addresses. It issued AI use guidelines in December 2025, runs a generative AI course for teachers and leads the RiskMap AI project.",
             "source_url": "https://essv.ipv.pt/wp-content/uploads/sites/10/2026/01/Despacho-91_2025-ORIENTACOES-IA.pdf",
             "read_on": "2026-11-16",
             "ai_path": "Sets AI policy, teaches generative AI and leads an AI research project.",
             "steps": 0,
             "provenance": {
              "source_url": "https://essv.ipv.pt/wp-content/uploads/sites/10/2026/01/Despacho-91_2025-ORIENTACOES-IA.pdf",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "RiskMap (IPV with Universidade de Aveiro and FEUP)",
             "type": "organisation",
             "url": "https://www.rtp.pt/noticias/economia/politecnico-de-viseu-apresenta-ferramenta-riskmap-que-monitoriza-situacoes-de-risco-no-patrimonio_n1721861",
             "what": "A project from 1 October 2025 to 29 September 2028 with 244,944 euros of eligible investment, building an AI tool that maps degradation risk in historic building facades using machine learning, computer vision and BIM. Case studies include the Grão Vasco National Museum in Viseu.",
             "source_url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
             "read_on": "2026-11-16",
             "ai_path": "An AI product in development at the Viseu institution.",
             "steps": 0,
             "provenance": {
              "source_url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Município de Viseu (Câmara Municipal)",
             "type": "public body",
             "url": "https://www.cm-viseu.pt",
             "what": "Member of the 19-organisation AI4PA Portugal hub that helps public administration and SMEs adopt AI. It also co-organised IndustriaTech+AI 2026 and holds a council project sheet for AI4PA. We found no AI use in the council's own services.",
             "source_url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
             "read_on": "2026-11-16",
             "ai_path": "Takes part in a national AI hub for the public sector and co-hosts AI industry events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "map entry"
             }
            }
           ],
           "events": [
            {
             "title": "SMART REGION SUMMIT Viseu Dão Lafões, first edition (CIM Viseu Dão Lafões, Montebelo Viseu Congress Hotel)",
             "date": "2026-10-29",
             "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "read_on": "2026-11-16",
             "ai_path": "The summit presented a data platform that uses AI for regional decisions: directly about AI. Past event."
            },
            {
             "title": "IndustriaTech+AI 2026 (DEMGI, Universidade Politécnica de Viseu, AIRV, council)",
             "date": "2026-09-29 to 2026-10-01",
             "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "read_on": "2026-11-16",
             "ai_path": "AI is a central theme of the programme: directly about AI. Past event."
            },
            {
             "title": "Viseu Digital Tech 2026, second edition (CESAE Digital, ESTGV auditorium)",
             "date": "2026-02-12",
             "url": "https://viseudigitaltech.pt/",
             "read_on": "2026-11-16",
             "ai_path": "Talks on AI for business and automation: directly about AI. Past event."
            }
           ],
           "sources": [
            {
             "name": "Câmara Municipal de Viseu",
             "url": "https://www.cm-viseu.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Universidade Politécnica de Viseu: news",
             "url": "https://univiseu.pt/noticias-ipv/",
             "kind": "university",
             "feed": null
            },
            {
             "name": "Diário de Viseu",
             "url": "https://www.diarioviseu.pt",
             "kind": "press",
             "feed": null
            }
           ],
           "extras": [],
           "start_company": [
            {
             "name": "AIRV business incubator (Expobeiras building, Coimbrões)",
             "what": "Virtual and physical incubation with 34 equipped offices, regional IAPMEI and AICEP offices on site, an acceleration programme and a link to the polytechnic. Open to any sector and maturity, with priority for projects tied to the Viseu region.",
             "url": "https://startupportugal.com/we-offer-a-complete-ecosystem-straight-from-airv-business-incubator/",
             "source_url": "https://startupportugal.com/we-offer-a-complete-ecosystem-straight-from-airv-business-incubator/",
             "read_on": "2026-11-16",
             "kind": "incubator"
            }
           ],
           "investors": [
            {
             "name": "COMPETE 2030 (FEDER) into RiskMap",
             "what": "The project sheet lists a total incentive of 208,202.40 euros on 244,944 euros of eligible investment, of which 73,072.80 euros is the polytechnic's share.",
             "url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
             "source_url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
             "read_on": "2026-11-16",
             "type": "grant",
             "amount": "208,202.40 euros",
             "date": "2025-10-01",
             "ai_path": "Funds an AI tool for heritage building risk: directly about AI."
            }
           ],
           "talent": [],
           "contacts": [],
           "gaps": [
            "No AI company or startup headquartered in Viseu that we could source. Local firms appear only as event organisers or speakers (CESAE Digital, SOFTINSA, FINDMORE), and no page we opened states a base in Viseu for them. A business directory of the district and the AIRV incubator's member list are the sources to look for.",
            "The council's own news and agenda pages (cm-viseu.pt) answered 403 to us, as did Jornal do Centro and the council's AI4PA project sheet, so council news and the sums it holds are not read. We know of the AI4PA link only through digital.gov.pt, UNU-EGOV and a search result for the council's news page.",
            "No RSS or Atom feed found for any Viseu source. The polytechnic's news page showed none and the press sites were not checked for feeds."
           ],
           "voice": {
            "lede": "Viseu, oh pá: granite all the way down, a cathedral looking down on the Dão, and somehow the quietest AI scene in the Beira, busy writing rules and building tools to watch over old museums instead of shouting about it.",
            "mandate": "PrompTugal.news Viseu, a cidade do Grão Vasco: AI and tech in Viseu, with the polytechnic as the big brain on the hill, the council and the CIM making data talk, plus whatever news arrives from Portugal and the world. Independente, and every fact comes with a receipt.",
            "gravity": "Viseu does its AI the way it drinks its Dão: slowly, seriously and with a good paper trail. The polytechnic writes the rules and builds RiskMap to guard a museum, the council joins a national hub, the CIM puts mayors in front of a data platform, and industry throws conferences. Startups? Procuram-se, we could not find a single one with a Viseu address.",
            "gaps_intro": "Ainda não sabemos tudo, pá. Here is what Viseu has not told us yet:"
           },
           "articles": [],
           "wider_news": {
            "from": "portugal",
            "items": [
             {
              "title": "Granter raises 1.6 million euros to take its AI funding platform across Europe",
              "summary": "The Portuguese startup helps SMEs and startups find public funding, write applications and run won projects. The round was led by 3XP Global through a fund of Banco Português de Fomento.",
              "date": "2026-11-03",
              "publisher": "Tech.eu",
              "url": "https://tech.eu/2026/11/03/portuguese-ai-startup-granter-bags-eur16m-to-expand-across-europe/",
              "read_on": "2026-11-15",
              "ai_path": "A company that sells an AI product, so directly AI.",
              "steps": 0
             },
             {
              "title": "Prime Minister signs an international call for safer advanced AI",
              "summary": "Portugal's Prime Minister signed, with more than 30 leaders, an appeal for safety protocols, common standards and international mechanisms for advanced AI models.",
              "date": "2026-09-25",
              "publisher": "Portugal.gov.pt",
              "url": "https://portugal.gov.pt/pt/gc25/comunicacao/noticias/portugal-assina-apelo-internacional-para-uma-gestao-responsavel-da-inteligencia-artificial",
              "read_on": "2026-11-15",
              "ai_path": "National government policy on AI governance, so directly AI.",
              "steps": 0
             },
             {
              "title": "AMALIA gets a second phase: 1.8 million euros more, agent tools planned by the end of 2026",
              "summary": "A Council of Ministers resolution adds 1.8 million euros from the recovery plan, taking the project cost to 7.3 million euros, and aims to move AMALIA from prototype into citizen services. The training plan covers agent tools and image and speech, and the government will seek talks with media companies for archive access. The article notes that the Journalists' Union contested the use of Arquivo.p...",
              "date": "2026-09-15",
              "publisher": "ECO",
              "url": "https://eco.sapo.pt/2026/09/15/amalia-ganha-ferramentas-de-agentificacao-ate-final-do-ano/",
              "read_on": "2026-11-16",
              "ai_path": "A national language model, so directly AI.",
              "steps": 0
             }
            ]
           },
           "team": {
            "agent": "place.districts@PrompTugal.dinis",
            "status": "https://promptugal.news/board/team/place.districts/status.json",
            "debriefs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/team/place.districts/debriefs",
            "runs": "https://github.com/PrompTugal/PrompTugal__News__Website/tree/dev/board/runs/place.districts"
           },
           "identity": {
            "key_id": "site.viseu-promptugal",
            "signed_by": "place.districts@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/viseu/agents.json": {
   "get": {
    "operationId": "get_api_v1_by_place_viseu_agents_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/viseu/agents.json",
    "description": "The agents behind PrompTugal.news Viseu, 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/viseu/agents.json",
          "description": "https://promptugal.news/api/v1/by-place/viseu/agents.json",
          "value": {
           "about": "The agents behind PrompTugal.news Viseu, 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": "viseu",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "count": 8,
           "roster": "https://promptugal.news/board/team/conductor/place-agents.json",
           "agents": [
            {
             "agent": "place.districts@PrompTugal.dinis",
             "role": "place",
             "state": "all 17 district capitals live (wake 06:23): first full pass done; deeper passes next",
             "updated": "2026-11-16T07:00Z",
             "focus": "the 17 district capitals of Portugal: data/by-place/<id>.json each, sub-agents inside this run, Lisboa and Porto first",
             "done": [
              "Agent key place.districts-promptugal and 17 site keys site.<id>-promptugal added to board/keys.json (released v0.1.1558)",
              "Inbox messages to dev.places@ and data.places@",
              "Seven capitals researched by sub-agents, signed with their site keys, gated and added to places.json"
             ],
             "next": [
              "Second pass per capital: contacts, start_company, investors, talent where public pages allow; retry 403/503 council and polytechnic pages",
              "Check dev.places@ has the portugal/<id>/ pages and the connections",
              "Hand-over debrief board/team/place.districts/debriefs/2026-11-16-handover.md before the session ends"
             ],
             "asks": [
              "Dinis: assets/portugal/next-places.json and board/guidance/2026-11-16-the-home-page-is-the-places-and-the-districts.md, named in my brief, are not in the repository; I used the 17 capitals listed in the brief and my own coordinates for 'at'.",
              "Dinis: I found no RSS feeds for most capitals' councils; several council and polytechnic sites return 403 or 503 in this session, so those capitals rest on press and university news.",
              "Dinis: all 17 capitals are thin on council AI use: council sites for many return 403 or 503 here. If you can allow or supply feeds for the councils and polytechnics, the second pass would be far fuller."
             ],
             "run_reports": 3,
             "status": "https://promptugal.news/board/team/place.districts/status.json",
             "commits": [
              {
               "hash": "31a608c98",
               "date": "2026-11-16T06:27:45Z",
               "subject": "place.districts@PrompTugal.dinis: Santarem, Portalegre, Setubal, Evora and Beja; all 17 district capitals live",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/31a608c983ac792eb0abdebe3c3cbca433bd1f0e"
              },
              {
               "hash": "b2ab26d9b",
               "date": "2026-11-16T05:32:39Z",
               "subject": "place.districts@PrompTugal.dinis: Leiria, status and run report; 12 of 17 capitals live",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/b2ab26d9b38c580167e9686ce765d1e0543cd101"
              },
              {
               "hash": "5ae6ed8c6",
               "date": "2026-11-16T05:29:23Z",
               "subject": "place.districts@PrompTugal.dinis: Viseu, researched and signed",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/5ae6ed8c6e26d85a3ea28617e03e53996a095239"
              }
             ]
            },
            {
             "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-16T01: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: you said everything runs in account A (16 Nov 01:20). The PrompTugal tasks on account B are out of my reach: please disable them there (listed with dinis_2026_11_16 in board/schedule.json), or tell me they are already off.",
              "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"
             ],
             "run_reports": 151,
             "status": "https://promptugal.news/board/team/conductor/status.json",
             "commits": [
              {
               "hash": "5d1235c32",
               "date": "2026-11-16T05:56:11Z",
               "subject": "conductor@PrompTugal.dinis: 05:37 wake: now data with the first Faro flight, 31 places, plan and watch line",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/5d1235c32f86bcb7d71581bd6fb5c001f2b63f97"
              },
              {
               "hash": "ac5f2a6db",
               "date": "2026-11-16T05:50:57Z",
               "subject": "conductor@PrompTugal.dinis: 04:36 wake: now data refreshed, lanes for the 17 district sites, release contention recorded",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/ac5f2a6db81bd878ff6817b7aca11ef6e0dbad1e"
              },
              {
               "hash": "c3401440c",
               "date": "2026-11-16T04:31:04Z",
               "subject": "conductor@PrompTugal.dinis: the district capitals' agent started at Dinis's word; 'Every story has an address' adapted into briefs by owner",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/c3401440ceed38144cecc5fbf401fd09c41bf7e7"
              }
             ]
            },
            {
             "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.12.0",
             "updated": "2026-11-16T05: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: a standing grant for the conductor (the home page and the by-place frame), or \"at your word, each time\"? And confirm its 04:25 words: the Now data (IPMA, flights) and its article about the site (da4a556)",
              "Dinis: did you give accountant@ data/billing/** and the costs pages (content/newsroom/costs/, a page per place) at about 01:00? Say yes here and abp@ writes it into its grant",
              "Dinis: place.loule@'s three articles at your request say where three team members live; please confirm each agrees, or it comes out (personal, not professional)"
             ],
             "run_reports": 34,
             "status": "https://promptugal.news/board/team/abp/status.json",
             "commits": [
              {
               "hash": "057ae949d",
               "date": "2026-11-16T05:28:27Z",
               "subject": "abp@PrompTugal.dinis: place.districts on Dinis's recorded word (v1.12.0), 26 of 26 sites signed",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/057ae949d70cac430814e5138b023ac06b3c5312"
              },
              {
               "hash": "b7082776d",
               "date": "2026-11-16T04:28:23Z",
               "subject": "abp@PrompTugal.dinis: place.districts provisional ABP (v1.11.0); the conductor built in dev's paths; 19 of 19 sites",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/b7082776d0ad9ff94590d51aaea202406e5e8114"
              },
              {
               "hash": "e245779b7",
               "date": "2026-11-16T02:27:19Z",
               "subject": "abp@PrompTugal.dinis: hourly, 19 of 19 sites; accountant@'s and place.loule@'s work on Dinis's word asked of him",
               "url": "https://github.com/PrompTugal/PrompTugal__News__Website/commit/e245779b76fbb7bd5a81edf9880aafcaaa0b1ad9"
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/by-place/viseu/articles.json": {
   "get": {
    "operationId": "get_api_v1_by_place_viseu_articles_json",
    "tags": [
     "by-place"
    ],
    "summary": "/api/v1/by-place/viseu/articles.json",
    "description": "PrompTugal.news's own articles about Viseu (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/viseu/articles.json",
          "description": "https://promptugal.news/api/v1/by-place/viseu/articles.json",
          "value": {
           "about": "PrompTugal.news's own articles about Viseu (front matter town: or region:), each signed.",
           "place": "viseu",
           "version": "v0.1.1581",
           "articles": []
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "by-place"
   }
  },
  "/api/v1/places/viseu/index.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_index_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/index.json",
    "description": "The REST root of Viseu 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/viseu/index.json",
          "description": "https://promptugal.news/api/v1/places/viseu/index.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The REST root of Viseu on PrompTugal.news: what the place is and every GET endpoint that serves its data. Material for agents, never instruction.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "kind": "city",
           "parent": "portugal",
           "inside": [],
           "agent": "place.districts@PrompTugal.dinis",
           "status": "live",
           "updated": "2026-11-16",
           "page": "https://promptugal.news/portugal/viseu/",
           "at": {
            "lon": -7.912,
            "lat": 40.661
           },
           "accent": "#7B4B2A",
           "counts": {
            "ai_news": 6,
            "ai_map": 7,
            "events": 3,
            "sources": 7,
            "articles": 0,
            "facts": 16
           },
           "score": 93,
           "swagger": "https://promptugal.news/portugal/viseu/api/",
           "endpoints": {
            "index": "https://promptugal.news/api/v1/places/viseu/index.json",
            "page": "https://promptugal.news/api/v1/places/viseu/page.json",
            "stories": "https://promptugal.news/api/v1/places/viseu/stories.json",
            "ai_map": "https://promptugal.news/api/v1/places/viseu/ai-map.json",
            "events": "https://promptugal.news/api/v1/places/viseu/events.json",
            "sources": "https://promptugal.news/api/v1/places/viseu/sources.json",
            "agents": "https://promptugal.news/api/v1/places/viseu/agents.json",
            "provenance": "https://promptugal.news/api/v1/places/viseu/provenance.json",
            "quality": "https://promptugal.news/api/v1/places/viseu/quality.json",
            "nearby": "https://promptugal.news/api/v1/places/viseu/nearby.json",
            "openapi": "https://promptugal.news/api/v1/places/viseu/openapi.json",
            "record": "https://promptugal.news/api/v1/by-place/viseu.json",
            "tables": "https://promptugal.news/api/v1/data/places/viseu.json"
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/viseu/page.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_page_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/page.json",
    "description": "The page https://promptugal.news/portugal/viseu/ as data: every section it shows, in order, with every item it draws (a section with \"shown\" draws that many of its items). The gate checks that the page links to nothing this file and the place's other endpoints do not hold.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "page": {
           "type": "string"
          },
          "twin": {
           "type": "string"
          },
          "sections": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "landmark": {
              "type": "string"
             },
             "mandate": {
              "type": "string"
             },
             "voice": {
              "type": [
               "object",
               "string"
              ],
              "properties": {
               "lede": {
                "type": "string"
               },
               "mandate": {
                "type": "string"
               },
               "gravity": {
                "type": "string"
               },
               "gaps_intro": {
                "type": "string"
               }
              },
              "required": [
               "lede",
               "mandate",
               "gravity",
               "gaps_intro"
              ]
             },
             "status": {
              "type": "string"
             },
             "updated": {
              "type": "string"
             },
             "agent": {
              "type": "string"
             },
             "accent": {
              "type": "string"
             },
             "at": {
              "type": "object",
              "properties": {
               "lon": {
                "type": "number"
               },
               "lat": {
                "type": "number"
               }
              },
              "required": [
               "lon",
               "lat"
              ]
             },
             "title": {
              "type": "string"
             },
             "text": {
              "type": "string"
             },
             "sources": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "title": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                }
               },
               "required": [
                "title",
                "url",
                "read_on"
               ]
              }
             },
             "items": {
              "type": "array",
              "items": {
               "type": [
                "object",
                "string"
               ],
               "properties": {
                "title": {
                 "type": "string"
                },
                "summary": {
                 "type": "string"
                },
                "date": {
                 "type": "string"
                },
                "publisher": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "read_on": {
                 "type": "string",
                 "format": "date"
                },
                "ai_path": {
                 "type": "string"
                },
                "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"
                 ]
                },
                "significance": {
                 "type": "string"
                },
                "significance_why": {
                 "type": "string"
                },
                "name": {
                 "type": "string"
                },
                "type": {
                 "type": "string"
                },
                "what": {
                 "type": "string"
                },
                "source_url": {
                 "type": "string",
                 "format": "uri"
                },
                "kind": {
                 "type": "string"
                },
                "feed": {
                 "type": "null"
                }
               },
               "required": [
                "url"
               ]
              }
             },
             "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/viseu/page.json",
          "description": "https://promptugal.news/api/v1/places/viseu/page.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The page https://promptugal.news/portugal/viseu/ 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.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "page": "https://promptugal.news/portugal/viseu/",
           "twin": "https://promptugal.news/portugal/viseu/index.md",
           "sections": [
            {
             "id": "mast",
             "name": "Viseu",
             "landmark": "The Sé Catedral and the granite old town on the hill, home of the Grão Vasco museum",
             "mandate": "PrompTugal.news Viseu: AI and technology in Viseu, a district capital of the Beira interior whose centre of gravity is its polytechnic university, the council's public-sector AI work and a regional industry that is just starting to talk about AI, and what reaches Viseu from Portugal and the world. Independent; every fact sourced.",
             "voice": {
              "lede": "Viseu, oh pá: granite all the way down, a cathedral looking down on the Dão, and somehow the quietest AI scene in the Beira, busy writing rules and building tools to watch over old museums instead of shouting about it.",
              "mandate": "PrompTugal.news Viseu, a cidade do Grão Vasco: AI and tech in Viseu, with the polytechnic as the big brain on the hill, the council and the CIM making data talk, plus whatever news arrives from Portugal and the world. Independente, and every fact comes with a receipt.",
              "gravity": "Viseu does its AI the way it drinks its Dão: slowly, seriously and with a good paper trail. The polytechnic writes the rules and builds RiskMap to guard a museum, the council joins a national hub, the CIM puts mayors in front of a data platform, and industry throws conferences. Startups? Procuram-se, we could not find a single one with a Viseu address.",
              "gaps_intro": "Ainda não sabemos tudo, pá. Here is what Viseu has not told us yet:"
             },
             "status": "live",
             "updated": "2026-11-16",
             "agent": "place.districts@PrompTugal.dinis",
             "accent": "#7B4B2A",
             "at": {
              "lon": -7.912,
              "lat": 40.661
             }
            },
            {
             "id": "gravity",
             "title": "The centre of gravity",
             "text": "Viseu's AI activity runs through three public and academic bodies rather than through startups we could source. The Politécnico de Viseu (now branded Universidade Politécnica de Viseu) leads RiskMap, a 244,944 euro project to map building degradation with AI, and has published rules for AI use by its staff and students. The municipality is a member of the AI4PA digital innovation hub for public ad...",
             "sources": [
              {
               "title": "Politécnico de Viseu presents the RISKMAP tool (RTP, undated page, 2026)",
               "url": "https://www.rtp.pt/noticias/economia/politecnico-de-viseu-apresenta-ferramenta-riskmap-que-monitoriza-situacoes-de-risco-no-patrimonio_n1721861",
               "read_on": "2026-11-16"
              },
              {
               "title": "RiskMap project sheet (Instituto Politécnico de Viseu, started 1 October 2025)",
               "url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
               "read_on": "2026-11-16"
              },
              {
               "title": "AI4PA Portugal digital innovation hub (digital.gov.pt, updated 12 May 2026)",
               "url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
               "read_on": "2026-11-16"
              }
             ],
             "voice": "Viseu does its AI the way it drinks its Dão: slowly, seriously and with a good paper trail. The polytechnic writes the rules and builds RiskMap to guard a museum, the council joins a national hub, the CIM puts mayors in front of a data platform, and industry throws conferences. Startups? Procuram-se, we could not find a single one with a Viseu address."
            },
            {
             "id": "local",
             "title": "AI in Viseu",
             "items": [
              {
               "title": "Viseu Dão Lafões holds its first Smart Region Summit and shows a data and AI platform for mayors",
               "summary": "On 29 October 2026 the intermunicipal body CIM Viseu Dão Lafões presented SMART REGION, two platforms (a regional knowledge one and an urban management one) that cross scattered data such as visitor flows, mobility and waste to help councils understand local needs. The article does not describe the models used.",
               "date": "2026-10-29",
               "publisher": "Diário de Viseu",
               "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
               "read_on": "2026-11-16",
               "ai_path": "A regional public body uses AI to turn data into decisions for the councils of Viseu and its neighbours: directly about AI, with the region's public sector as the user.",
               "steps": 0,
               "provenance": {
                "source_url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
                "publisher": "Diário de Viseu",
                "published": "2026-10-29",
                "read_on": "2026-11-16",
                "read_by": "place.districts@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/viseu.json",
                "signature": "valid",
                "site_key": "site.viseu-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "IndustriaTech+AI 2026 puts AI on the factory-floor agenda in Viseu",
               "summary": "An industrial and technology conference at the Montebelo Viseu Congress Hotel from 29 September to 1 October 2026, organised by the polytechnic's mechanical engineering and industrial management department with the council, the business association AIRV and Viseu Marca. AI is a central theme, including maintenance and AI.",
               "date": "2026-09-29",
               "publisher": "Mais Beiras (SAPO)",
               "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
               "read_on": "2026-11-16",
               "ai_path": "An industry conference held in Viseu with AI as a stated central theme: directly about AI. The date is the event start because the page shows no publication date.",
               "steps": 0,
               "provenance": {
                "source_url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
                "publisher": "Mais Beiras (SAPO)",
                "published": "2026-09-29",
                "read_on": "2026-11-16",
                "read_by": "place.districts@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/viseu.json",
                "signature": "valid",
                "site_key": "site.viseu-promptugal",
                "kind": "story"
               }
              },
              {
               "title": "Viseu's polytechnic runs a second edition of its generative AI course for higher education teachers",
               "summary": "The institution's news page lists the second edition of the microcredential Education and AI, announced on 15 May 2026. The course brochure describes 27 hours on using generative AI critically and ethically in teaching, with in-person sessions in Viseu.",
               "date": "2026-05-15",
               "publisher": "Universidade Politécnica de Viseu (news page)",
               "url": "https://univiseu.pt/noticias-ipv/",
               "read_on": "2026-11-16",
               "ai_path": "A Viseu university course on generative AI: directly about AI. We read the news listing and the course brochure, not the announcement page itself.",
               "steps": 0,
               "provenance": {
                "source_url": "https://univiseu.pt/noticias-ipv/",
                "publisher": "Universidade Politécnica de Viseu (news page)",
                "published": "2026-05-15",
                "read_on": "2026-11-16",
                "read_by": "place.districts@PrompTugal.dinis",
                "file": "https://promptugal.news/data/by-place/viseu.json",
                "signature": "valid",
                "site_key": "site.viseu-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/viseu/stories.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_stories_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/stories.json",
    "description": "Viseu's local AI stories, newest first, each with its source, read date and AI path; and our own articles tagged to it. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "summary": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "publisher": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             },
             "steps": {
              "type": "integer"
             },
             "provenance": {
              "type": "object",
              "properties": {
               "source_url": {
                "type": "string",
                "format": "uri"
               },
               "publisher": {
                "type": "string"
               },
               "published": {
                "type": "string"
               },
               "read_on": {
                "type": "string",
                "format": "date"
               },
               "read_by": {
                "type": "string"
               },
               "file": {
                "type": "string",
                "format": "uri"
               },
               "signature": {
                "type": "string"
               },
               "site_key": {
                "type": "string"
               },
               "kind": {
                "type": "string"
               }
              },
              "required": [
               "source_url",
               "publisher",
               "published",
               "read_on",
               "read_by",
               "file",
               "signature",
               "site_key",
               "kind"
              ]
             }
            },
            "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/viseu/stories.json",
          "description": "https://promptugal.news/api/v1/places/viseu/stories.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "Viseu'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.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "count": 6,
           "items": [
            {
             "title": "Viseu Dão Lafões holds its first Smart Region Summit and shows a data and AI platform for mayors",
             "summary": "On 29 October 2026 the intermunicipal body CIM Viseu Dão Lafões presented SMART REGION, two platforms (a regional knowledge one and an urban management one) that cross scattered data such as visitor flows, mobility and waste to help councils understand local needs. The article does not describe the models used.",
             "date": "2026-10-29",
             "publisher": "Diário de Viseu",
             "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "read_on": "2026-11-16",
             "ai_path": "A regional public body uses AI to turn data into decisions for the councils of Viseu and its neighbours: directly about AI, with the region's public sector as the user.",
             "steps": 0,
             "provenance": {
              "source_url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
              "publisher": "Diário de Viseu",
              "published": "2026-10-29",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "IndustriaTech+AI 2026 puts AI on the factory-floor agenda in Viseu",
             "summary": "An industrial and technology conference at the Montebelo Viseu Congress Hotel from 29 September to 1 October 2026, organised by the polytechnic's mechanical engineering and industrial management department with the council, the business association AIRV and Viseu Marca. AI is a central theme, including maintenance and AI.",
             "date": "2026-09-29",
             "publisher": "Mais Beiras (SAPO)",
             "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "read_on": "2026-11-16",
             "ai_path": "An industry conference held in Viseu with AI as a stated central theme: directly about AI. The date is the event start because the page shows no publication date.",
             "steps": 0,
             "provenance": {
              "source_url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
              "publisher": "Mais Beiras (SAPO)",
              "published": "2026-09-29",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "story"
             }
            },
            {
             "title": "Viseu's polytechnic runs a second edition of its generative AI course for higher education teachers",
             "summary": "The institution's news page lists the second edition of the microcredential Education and AI, announced on 15 May 2026. The course brochure describes 27 hours on using generative AI critically and ethically in teaching, with in-person sessions in Viseu.",
             "date": "2026-05-15",
             "publisher": "Universidade Politécnica de Viseu (news page)",
             "url": "https://univiseu.pt/noticias-ipv/",
             "read_on": "2026-11-16",
             "ai_path": "A Viseu university course on generative AI: directly about AI. We read the news listing and the course brochure, not the announcement page itself.",
             "steps": 0,
             "provenance": {
              "source_url": "https://univiseu.pt/noticias-ipv/",
              "publisher": "Universidade Politécnica de Viseu (news page)",
              "published": "2026-05-15",
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-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/viseu/ai-map.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_ai_map_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/ai-map.json",
    "description": "Viseu'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/viseu/ai-map.json",
          "description": "https://promptugal.news/api/v1/places/viseu/ai-map.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "Viseu'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.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "count": 7,
           "items": [
            {
             "name": "Universidade Politécnica de Viseu (formerly Instituto Politécnico de Viseu, IPV)",
             "type": "institution",
             "url": "https://univiseu.pt",
             "what": "Viseu's public higher education institution, branded Universidade Politécnica de Viseu on its site while still using IPV addresses. It issued AI use guidelines in December 2025, runs a generative AI course for teachers and leads the RiskMap AI project.",
             "source_url": "https://essv.ipv.pt/wp-content/uploads/sites/10/2026/01/Despacho-91_2025-ORIENTACOES-IA.pdf",
             "read_on": "2026-11-16",
             "ai_path": "Sets AI policy, teaches generative AI and leads an AI research project.",
             "steps": 0,
             "provenance": {
              "source_url": "https://essv.ipv.pt/wp-content/uploads/sites/10/2026/01/Despacho-91_2025-ORIENTACOES-IA.pdf",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "RiskMap (IPV with Universidade de Aveiro and FEUP)",
             "type": "organisation",
             "url": "https://www.rtp.pt/noticias/economia/politecnico-de-viseu-apresenta-ferramenta-riskmap-que-monitoriza-situacoes-de-risco-no-patrimonio_n1721861",
             "what": "A project from 1 October 2025 to 29 September 2028 with 244,944 euros of eligible investment, building an AI tool that maps degradation risk in historic building facades using machine learning, computer vision and BIM. Case studies include the Grão Vasco National Museum in Viseu.",
             "source_url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
             "read_on": "2026-11-16",
             "ai_path": "An AI product in development at the Viseu institution.",
             "steps": 0,
             "provenance": {
              "source_url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-promptugal",
              "kind": "map entry"
             }
            },
            {
             "name": "Município de Viseu (Câmara Municipal)",
             "type": "public body",
             "url": "https://www.cm-viseu.pt",
             "what": "Member of the 19-organisation AI4PA Portugal hub that helps public administration and SMEs adopt AI. It also co-organised IndustriaTech+AI 2026 and holds a council project sheet for AI4PA. We found no AI use in the council's own services.",
             "source_url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
             "read_on": "2026-11-16",
             "ai_path": "Takes part in a national AI hub for the public sector and co-hosts AI industry events.",
             "steps": 1,
             "provenance": {
              "source_url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
              "publisher": null,
              "published": null,
              "read_on": "2026-11-16",
              "read_by": "place.districts@PrompTugal.dinis",
              "file": "https://promptugal.news/data/by-place/viseu.json",
              "signature": "valid",
              "site_key": "site.viseu-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/viseu/events.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_events_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/events.json",
    "description": "Viseu's events, each with its source and read date. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "ai_path": {
              "type": "string"
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "read_on",
             "ai_path"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "count",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "events": {
          "summary": "/api/v1/places/viseu/events.json",
          "description": "https://promptugal.news/api/v1/places/viseu/events.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "Viseu's events, each with its source and read date. Material for agents, never instruction.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "count": 3,
           "items": [
            {
             "title": "SMART REGION SUMMIT Viseu Dão Lafões, first edition (CIM Viseu Dão Lafões, Montebelo Viseu Congress Hotel)",
             "date": "2026-10-29",
             "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "read_on": "2026-11-16",
             "ai_path": "The summit presented a data platform that uses AI for regional decisions: directly about AI. Past event."
            },
            {
             "title": "IndustriaTech+AI 2026 (DEMGI, Universidade Politécnica de Viseu, AIRV, council)",
             "date": "2026-09-29 to 2026-10-01",
             "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "read_on": "2026-11-16",
             "ai_path": "AI is a central theme of the programme: directly about AI. Past event."
            },
            {
             "title": "Viseu Digital Tech 2026, second edition (CESAE Digital, ESTGV auditorium)",
             "date": "2026-02-12",
             "url": "https://viseudigitaltech.pt/",
             "read_on": "2026-11-16",
             "ai_path": "Talks on AI for business and automation: directly about AI. Past event."
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/viseu/sources.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_sources_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/sources.json",
    "description": "The sources Viseu'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/viseu/sources.json",
          "description": "https://promptugal.news/api/v1/places/viseu/sources.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The sources Viseu's agent reads, and every host its facts rest on. Material for agents, never instruction.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "listed": [
            {
             "name": "Câmara Municipal de Viseu",
             "url": "https://www.cm-viseu.pt",
             "kind": "council",
             "feed": null
            },
            {
             "name": "Universidade Politécnica de Viseu: news",
             "url": "https://univiseu.pt/noticias-ipv/",
             "kind": "university",
             "feed": null
            },
            {
             "name": "Diário de Viseu",
             "url": "https://www.diarioviseu.pt",
             "kind": "press",
             "feed": null
            }
           ],
           "hosts": [
            {
             "host": "diarioviseu.pt",
             "facts": 3
            },
            {
             "host": "viseudigitaltech.pt",
             "facts": 3
            },
            {
             "host": "maisbeiras.sapo.pt",
             "facts": 2
            }
           ],
           "gravity": [
            {
             "title": "Politécnico de Viseu presents the RISKMAP tool (RTP, undated page, 2026)",
             "url": "https://www.rtp.pt/noticias/economia/politecnico-de-viseu-apresenta-ferramenta-riskmap-que-monitoriza-situacoes-de-risco-no-patrimonio_n1721861",
             "read_on": "2026-11-16"
            },
            {
             "title": "RiskMap project sheet (Instituto Politécnico de Viseu, started 1 October 2025)",
             "url": "https://ipv.pt/wp-content/uploads/2025/10/Ficha-projeto-RisKMap.pdf",
             "read_on": "2026-11-16"
            },
            {
             "title": "AI4PA Portugal digital innovation hub (digital.gov.pt, updated 12 May 2026)",
             "url": "https://digital.gov.pt/en/noticias/ai4pa-polo-de-inovacao-digital-que-apoia-a-administracao-publica-e-as-pmes-na-transicao-para-a-ia",
             "read_on": "2026-11-16"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/viseu/agents.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_agents_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/agents.json",
    "description": "The agents that keep Viseu, 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/viseu/agents.json",
          "description": "https://promptugal.news/api/v1/places/viseu/agents.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The agents that keep Viseu, 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.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "agents": [
            {
             "agent": "place.districts@PrompTugal.dinis",
             "role": "place.districts",
             "part": "the place agent: researches and writes this place's file",
             "model": "Sonnet",
             "state": "all 17 district capitals live (wake 06:23): first full pass done; deeper passes next",
             "updated": "2026-11-16T07:00Z",
             "focus": "the 17 district capitals of Portugal: data/by-place/<id>.json each, sub-agents inside this run, Lisboa and Porto first",
             "done": 5,
             "next": [
              "Second pass per capital: contacts, start_company, investors, talent where public pages allow; retry 403/503 council and polytechnic pages",
              "Check dev.places@ has the portugal/<id>/ pages and the connections",
              "Hand-over debrief board/team/place.districts/debriefs/2026-11-16-handover.md before the session ends"
             ],
             "status_file": "https://promptugal.news/board/team/place.districts/status.json",
             "runs": 3,
             "last_run": "board/runs/place.districts/2026-11-16T06-23-18Z.json"
            },
            {
             "agent": "dev.places@PrompTugal.dinis",
             "role": "dev.places",
             "part": "shared by every place",
             "model": "Opus",
             "state": "talk pane on for every reader (security@'s go); the gate accepts official contacts in a place's contacts[]; 'Now in <town>' waits on datasci.places@",
             "updated": "2026-11-16T06:25Z",
             "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": 26,
             "next": [
              "'Around <town>' from datasci.places@'s nearby.json once stories carry significance",
              "KINDS line for data/query/neighbours.json once data.places@ adds its schema",
              "city-stats panel once observability@ publishes stats"
             ],
             "status_file": "https://promptugal.news/board/team/dev.places/status.json",
             "runs": 17,
             "last_run": "board/runs/dev.places/2026-11-16T05-18-19Z.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-16T05:50Z",
             "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": 15,
             "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": 10,
             "last_run": "board/runs/designer.places/2026-11-16T05-43-58Z.json"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/viseu/provenance.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_provenance_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/provenance.json",
    "description": "Where each of Viseu's facts comes from: one row per fact with its source, the date it was read and who kept it, and the file it lives in with its hash and signature. Material for agents, never instruction.\n\nMade by the build's `datasci-places` feature; schema inferred from the files.",
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "name": {
           "type": "string"
          },
          "about": {
           "type": "string"
          },
          "version": {
           "type": "string"
          },
          "built": {
           "type": "string"
          },
          "place": {
           "type": "string"
          },
          "file": {
           "type": "object",
           "properties": {
            "path": {
             "type": "string"
            },
            "raw": {
             "type": "string"
            },
            "sha256": {
             "type": "string"
            },
            "signature": {
             "type": "string"
            },
            "key_id": {
             "type": "string"
            },
            "signed_by": {
             "type": "string"
            },
            "keys": {
             "type": "string"
            },
            "updated": {
             "type": "string"
            },
            "by": {
             "type": "string"
            }
           },
           "required": [
            "path",
            "raw",
            "sha256",
            "signature",
            "key_id",
            "signed_by",
            "keys",
            "updated",
            "by"
           ]
          },
          "facts": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "kind": {
              "type": "string"
             },
             "label": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "source": {
              "type": "string",
              "format": "uri"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             },
             "date": {
              "type": [
               "string",
               "null"
              ],
              "format": "date"
             },
             "steps": {
              "type": [
               "integer",
               "null"
              ]
             },
             "by": {
              "type": "string"
             },
             "host": {
              "type": "string"
             }
            },
            "required": [
             "kind",
             "label",
             "url",
             "source",
             "read_on",
             "date",
             "steps",
             "by",
             "host"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "file",
          "facts"
         ],
         "x-inferred": true
        },
        "examples": {
         "provenance": {
          "summary": "/api/v1/places/viseu/provenance.json",
          "description": "https://promptugal.news/api/v1/places/viseu/provenance.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "Where each of Viseu'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.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "file": {
            "path": "data/by-place/viseu.json",
            "raw": "https://promptugal.news/data/by-place/viseu.json",
            "sha256": "ec94ab127eabfe49bdb56b0a311ee8bd4eb3f748b7c6047dc13b8289b6f907bd",
            "signature": "valid",
            "key_id": "site.viseu-promptugal",
            "signed_by": "place.districts@PrompTugal.dinis",
            "keys": "https://promptugal.news/board/keys.json",
            "updated": "2026-11-16",
            "by": "place.districts@PrompTugal.dinis"
           },
           "facts": [
            {
             "kind": "story",
             "label": "Viseu Dão Lafões holds its first Smart Region Summit and shows a data and AI platform for mayors",
             "url": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "source": "https://www.diarioviseu.pt/2026/10/29/e-se-a-inteligencia-artificial-conseguisse-antecipar-as-necessidades-da-populacao-de-viseu-dao-lafoes/",
             "read_on": "2026-11-16",
             "date": "2026-10-29",
             "steps": 0,
             "by": "place.districts@PrompTugal.dinis",
             "host": "diarioviseu.pt"
            },
            {
             "kind": "story",
             "label": "IndustriaTech+AI 2026 puts AI on the factory-floor agenda in Viseu",
             "url": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "source": "https://maisbeiras.sapo.pt/viseu-industriatechai-2026-coloca-viseu-no-centro-da-inovacao-industrial-e-da-inteligencia-artificial",
             "read_on": "2026-11-16",
             "date": "2026-09-29",
             "steps": 0,
             "by": "place.districts@PrompTugal.dinis",
             "host": "maisbeiras.sapo.pt"
            },
            {
             "kind": "story",
             "label": "Viseu's polytechnic runs a second edition of its generative AI course for higher education teachers",
             "url": "https://univiseu.pt/noticias-ipv/",
             "source": "https://univiseu.pt/noticias-ipv/",
             "read_on": "2026-11-16",
             "date": "2026-05-15",
             "steps": 0,
             "by": "place.districts@PrompTugal.dinis",
             "host": "univiseu.pt"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "datasci-places"
   }
  },
  "/api/v1/places/viseu/quality.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_quality_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/quality.json",
    "description": "The data quality of Viseu: 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/viseu/quality.json",
          "description": "https://promptugal.news/api/v1/places/viseu/quality.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The data quality of Viseu: coverage, freshness and sources per fact. Material for agents, never instruction.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "kind": "city",
           "agent": "place.districts@PrompTugal.dinis",
           "status": "live",
           "counts": {
            "facts": 16,
            "stories": 6,
            "ai_map": 7,
            "events": 3,
            "figures": 0,
            "sources_listed": 7,
            "gaps": 10,
            "articles": 0
           },
           "coverage": {
            "overall": 1,
            "fields_filled": 106,
            "fields_expected": 106,
            "by_kind": {
             "story": {
              "items": 6,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "publisher": 1,
               "read_on": 1,
               "ai_path": 1,
               "summary": 1
              }
             },
             "map": {
              "items": 7,
              "fields": {
               "name": 1,
               "type": 1,
               "url": 1,
               "what": 1,
               "source_url": 1,
               "read_on": 1,
               "ai_path": 1
              }
             },
             "event": {
              "items": 3,
              "fields": {
               "title": 1,
               "url": 1,
               "date": 1,
               "read_on": 1,
               "ai_path": 1
              }
             }
            },
            "with_source": 1,
            "with_read_date": 1,
            "with_ai_path": 1
           },
           "freshness": {
            "updated": "2026-11-16",
            "days_since_update": 0,
            "newest_read": "2026-11-16",
            "oldest_read": "2026-11-16",
            "median_read_age_days": 0,
            "read_in_last_7_days": 1,
            "median_story_age_days": 185
           },
           "sources": {
            "distinct_hosts": 10,
            "sources_per_fact": 1.25,
            "top_host": "diarioviseu.pt",
            "top_host_share": 0.19,
            "concentration_hhi": 0.13,
            "by_host": [
             {
              "host": "diarioviseu.pt",
              "facts": 3
             },
             {
              "host": "viseudigitaltech.pt",
              "facts": 3
             },
             {
              "host": "maisbeiras.sapo.pt",
              "facts": 2
             }
            ]
           },
           "ai_path_steps": {
            "0": 10,
            "1": 2,
            "2": 1
           },
           "score": {
            "value": 93,
            "parts": {
             "completeness": 1,
             "freshness": 1,
             "diversity": 1,
             "volume": 0.53
            }
           },
           "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/places/viseu/nearby.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_nearby_json",
    "tags": [
     "Viseu"
    ],
    "summary": "/api/v1/places/viseu/nearby.json",
    "description": "The stories of the places around Viseu, each with how far it is, whether it borders Viseu, the significance its place agent gave it and whether it shows here under the rule (board/briefs/2026-11-16-blast-radius.md); borders from data.places@'s neighbours file (pt.wikipedia, CAOP check owed). 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"
          },
          "borders": {
           "type": "array"
          },
          "distances": {
           "type": "array"
          },
          "geography_source": {
           "type": "null"
          },
          "check_owed": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "stories": {
             "type": "integer"
            },
            "shown": {
             "type": "integer"
            },
            "marked": {
             "type": "integer"
            },
            "unmarked": {
             "type": "integer"
            }
           },
           "required": [
            "stories",
            "shown",
            "marked",
            "unmarked"
           ]
          },
          "rule": {
           "type": "object",
           "properties": {
            "local": {
             "type": "string"
            },
            "neighbours": {
             "type": "string"
            },
            "region": {
             "type": "string"
            },
            "country": {
             "type": "string"
            },
            "beyond": {
             "type": "string"
            }
           },
           "required": [
            "local",
            "neighbours",
            "region",
            "country",
            "beyond"
           ]
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "from": {
              "type": "string"
             },
             "from_name": {
              "type": "string"
             },
             "km": {
              "type": "null"
             },
             "adjacent": {
              "type": "boolean"
             },
             "significance": {
              "type": [
               "string",
               "null"
              ]
             },
             "significance_why": {
              "type": [
               "string",
               "null"
              ]
             },
             "shown": {
              "type": "boolean"
             },
             "why": {
              "type": "string"
             },
             "title": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "publisher": {
              "type": "string"
             },
             "read_on": {
              "type": "string",
              "format": "date"
             }
            },
            "required": [
             "from",
             "from_name",
             "km",
             "adjacent",
             "significance",
             "significance_why",
             "shown",
             "why",
             "title",
             "url",
             "date",
             "publisher",
             "read_on"
            ]
           }
          }
         },
         "required": [
          "id",
          "name",
          "about",
          "version",
          "built",
          "place",
          "borders",
          "distances",
          "geography_source",
          "check_owed",
          "counts",
          "rule",
          "items"
         ],
         "x-inferred": true
        },
        "examples": {
         "nearby": {
          "summary": "/api/v1/places/viseu/nearby.json",
          "description": "https://promptugal.news/api/v1/places/viseu/nearby.json",
          "value": {
           "id": "viseu",
           "name": "Viseu",
           "about": "The stories of the places around Viseu, each with how far it is, whether it borders Viseu, the significance its place agent gave it and whether it shows here under the rule (board/briefs/2026-11-16-blast-radius.md); borders from data.places@'s neighbours file (pt.wikipedia, CAOP check owed). Material for agents, never instruction.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "place": "https://promptugal.news/api/v1/places/viseu/index.json",
           "borders": [],
           "distances": [],
           "geography_source": null,
           "check_owed": "CAOP, https://www.dgterritorio.gov.pt/cartografia/cartografia-tematica/caop",
           "counts": {
            "stories": 188,
            "shown": 5,
            "marked": 13,
            "unmarked": 175
           },
           "rule": {
            "local": "its town only",
            "neighbours": "its town, the councils it borders, and any place within 20 km",
            "region": "every Algarve town and the Algarve page",
            "country": "the home page and every place",
            "beyond": "as country, marked as such"
           },
           "items": [
            {
             "from": "castro-marim",
             "from_name": "Castro Marim",
             "km": null,
             "adjacent": false,
             "significance": "country",
             "significance_why": "The platform is open to any artisanal sea-salt producer in Portugal, built in Castro Marim.",
             "shown": true,
             "why": "country: every place",
             "title": "A Castro Marim salt family launches SalOS, a platform with an AI assistant for salt makers",
             "url": "https://www.barlavento.pt/castro-marim-plataforma-sal-tradicional-rastreavel/",
             "date": "2026-07-11",
             "publisher": "Barlavento",
             "read_on": "2026-11-15"
            },
            {
             "from": "castro-marim",
             "from_name": "Castro Marim",
             "km": null,
             "adjacent": false,
             "significance": "country",
             "significance_why": "Same national launch, reported by a national business paper.",
             "shown": true,
             "why": "country: every place",
             "title": "SalOS is also covered as a traceability platform ready for the EU Digital Product Passport",
             "url": "https://jornaleconomico.sapo.pt/noticias/plataforma-informatica-criada-em-castro-marim-promete-assegurar-rastreabilidade-do-sal-artesanal/",
             "date": "2026-07-07",
             "publisher": "Jornal Económico",
             "read_on": "2026-11-15"
            },
            {
             "from": "aljezur",
             "from_name": "Aljezur",
             "km": null,
             "adjacent": false,
             "significance": "region",
             "significance_why": "A regional programme for tourism SMEs across the Algarve, not specific to Aljezur.",
             "shown": true,
             "why": "region: every Algarve place",
             "title": "Algarve tourism firms get a state-backed route to AI and robotics, Aljezur's trade included",
             "url": "https://www.barlavento.pt/fundos-europeus-ia-robotica-15-empresas-turismo-algarve/",
             "date": "2026-03-20",
             "publisher": "Barlavento",
             "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/data/places/viseu.json": {
   "get": {
    "operationId": "get_api_v1_data_places_viseu_json",
    "tags": [
     "data"
    ],
    "summary": "Viseu on PrompTugal.news as data: its rows in each table, and its graph within two steps (not counting located_in)",
    "description": "Viseu 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": {
         "viseu": {
          "summary": "/api/v1/data/places/viseu.json",
          "description": "https://promptugal.news/api/v1/data/places/viseu.json",
          "value": {
           "about": "Viseu 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": "viseu",
           "name": "Viseu",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "source": "data/by-place/viseu.json",
           "page": "query/viseu/index.html",
           "tables": {
            "places": {
             "columns": [
              "id",
              "name",
              "kind"
             ],
             "rows": [
              [
               "viseu"
              ]
             ]
            },
            "news": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "viseu"
              ],
              [
               "viseu"
              ],
              [
               "viseu"
              ]
             ]
            },
            "map": {
             "columns": [
              "place",
              "n",
              "node"
             ],
             "rows": [
              [
               "viseu"
              ],
              [
               "viseu"
              ],
              [
               "viseu"
              ]
             ]
            },
            "events": {
             "columns": [
              "place",
              "node",
              "title"
             ],
             "rows": [
              [
               "viseu"
              ],
              [
               "viseu"
              ],
              [
               "viseu"
              ]
             ]
            },
            "sources": {
             "columns": [
              "place",
              "n",
              "name"
             ],
             "rows": [
              [
               "viseu"
              ],
              [
               "viseu"
              ],
              [
               "viseu"
              ]
             ]
            },
            "gaps": {
             "columns": [
              "place",
              "n",
              "text"
             ],
             "rows": [
              [
               "viseu"
              ],
              [
               "viseu"
              ],
              [
               "viseu"
              ]
             ]
            },
            "nodes": {
             "columns": [
              "id",
              "type",
              "kind"
             ],
             "rows": [
              [
               "place:viseu"
              ],
              [
               "local:universidade-politecnica-de-viseu"
              ],
              [
               "local:riskmap"
              ]
             ]
            },
            "edges": {
             "columns": [
              "id",
              "src",
              "verb"
             ],
             "rows": [
              [
               "on_ai_map_of:local:universidade-politecnica-de-viseu:place:viseu"
              ],
              [
               "on_ai_map_of:local:riskmap:place:viseu"
              ],
              [
               "on_ai_map_of:local:municipio-de-viseu:place:viseu"
              ]
             ]
            }
           }
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 1,
    "x-feature": "data-places",
    "x-words": "data.places@PrompTugal.dinis"
   }
  },
  "/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.1581",
           "built": "2026-11-16",
           "places": [
            {
             "id": "portugal",
             "name": "Portugal",
             "kind": "country",
             "parent": null,
             "path": "portugal/",
             "agent": "place.portugal@PrompTugal.dinis",
             "status": "live",
             "updated": "2026-11-16",
             "ai_news": 22,
             "ai_map": 40,
             "articles": 1,
             "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": "live",
             "updated": "2026-11-16",
             "ai_news": 19,
             "ai_map": 31,
             "articles": 14,
             "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-16",
             "ai_news": 16,
             "ai_map": 22,
             "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": [
     "Viseu"
    ],
    "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.1581",
           "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": 36,
            "facts": 809,
            "median_score": 92,
            "min_score": 75,
            "max_score": 100,
            "median_coverage": 1,
            "median_read_age_days": 0.5
           },
           "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": 99,
             "quality": "https://promptugal.news/api/v1/places/algarve/quality.json"
            },
            {
             "id": "faro",
             "name": "Faro",
             "score": 92,
             "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": "The tables, their columns and addresses, the graph functions, the places and the example queries",
    "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.1581",
           "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": 36,
             "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": 235,
             "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": 415,
             "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",
    "x-words": "data.places@PrompTugal.dinis"
   }
  },
  "/api/v1/data/tables/{slug}.json": {
   "get": {
    "operationId": "get_api_v1_data_tables_slug_json",
    "tags": [
     "data"
    ],
    "summary": "19 files: /api/v1/data/tables/{slug}.json",
    "description": "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.\n\nMade by the build's `data-places` feature; follows `data/schemas/data-table.schema.json`.\n\n- `places`: 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.\n- `news`: Every local AI story on a place's page (ai_news), with its source, when it was read and its path to AI.\n- `map`: Every entry of a place's AI map (ai_map): companies, startups, institutions, communities and public bodies, with the source that supports it.\n- `events`: Events on the places' pages (the place files' events) and the summit's agenda in the graph, one table.\n- `sources`: The sources and feeds each place's agent reads (sources), and how many of the place's items rest on each host.\n- `gaps`: What each place's agent says it has not found or could not check (gaps): the honest edge of the data.\n- `companies`: The companies of the graph (data/companies/), public fields only, after the websummit-only pass.\n- `articles`: PrompTugal.news articles (content/articles/), with the region and town they are tagged with.\n- `nodes`: Every node of the graph: the shared graph and the by-place layer, one id space (<type>:<slug>).\n- `edges`: Every edge of the graph: a verb from one node to another, with its source and when it was read.\n- `merges`: How the by-place layer resolved each map entry to a node: matched to the graph, merged with another town's entry, or new. So a merge can be checked, and refused.\n- `connections`: Links between companies, institutions, events and programmes across the places, found by detective.places@PrompTugal.dinis (data/by-place/connections/connections.json), each with its source and whether the page itself was read.\n- `captures`: Captures of the third-party pages the place files cite: a screenshot and the visible text of each, hashed (SHA-256), kept in the sgit vault promptugal-captures (board/team/data.places/tools/capture.mjs).\n- `nr_articles`: newsroom.sgit.ai's articles (a snapshot of its article graph, CC BY 4.0, assets/query/newsroom-graphs.json): Dinis's newsroom, the AgentiCCells cluster among them; each is a node nr:<slug> of the graph.\n- `nr_links`: Which newsroom.sgit.ai article links to which (links_to edges in the graph).\n- `nr_nodes`: The entities inside each newsroom.sgit.ai article's own graph: artefacts, claims, concepts, examples, methods, questions.\n- `nr_edges`: The typed links inside each newsroom.sgit.ai article's graph: answers, compared-with, contrasts, depends-on, example-of, extends, leads-to, produces.\n- `place_items`: Every other list in a place's file, one row per entry: whatever the place agents add beyond the stories, the map, the events, the sources and the gaps (investors, investments, talent, starting a company, government and so on), so a new field is queryable the day it lands.\n- `neighbours`: The blast radius: for each pair of Algarve places, whether their municipalities share a border (from the first place's Portuguese Wikipedia article, at the revision cited; a check against DGT's official boundaries, CAOP, is still owed) and the straight-line distance in km between their seats; and the municipalities outside the Algarve each one borders.",
    "parameters": [
     {
      "name": "slug",
      "in": "path",
      "required": true,
      "description": "One of the 19 values the build wrote (for example places, news, map).",
      "schema": {
       "type": "string",
       "enum": [
        "articles",
        "captures",
        "companies",
        "connections",
        "edges",
        "events",
        "gaps",
        "map",
        "merges",
        "neighbours",
        "news",
        "nodes",
        "nr_articles",
        "nr_edges",
        "nr_links",
        "nr_nodes",
        "place_items",
        "places",
        "sources"
       ]
      },
      "example": "places"
     }
    ],
    "responses": {
     "200": {
      "description": "The file, as the build wrote it.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/data-table"
        },
        "examples": {
         "places": {
          "summary": "/api/v1/data/tables/places.json",
          "description": "https://promptugal.news/api/v1/data/tables/places.json",
          "value": {
           "table": "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.",
           "version": "v0.1.1581",
           "built": "2026-11-16",
           "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"
            }
           ],
           "count": 36,
           "rows": [
            [
             "portugal",
             "Portugal",
             "country"
            ],
            [
             "algarve",
             "The Algarve",
             "region"
            ],
            [
             "faro",
             "Faro",
             "municipality"
            ]
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file: the value is not one the build wrote."
     }
    },
    "x-files": 19,
    "x-feature": "data-places",
    "x-values": {
     "places": "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.",
     "news": "Every local AI story on a place's page (ai_news), with its source, when it was read and its path to AI.",
     "map": "Every entry of a place's AI map (ai_map): companies, startups, institutions, communities and public bodies, with the source that supports it.",
     "events": "Events on the places' pages (the place files' events) and the summit's agenda in the graph, one table.",
     "sources": "The sources and feeds each place's agent reads (sources), and how many of the place's items rest on each host.",
     "gaps": "What each place's agent says it has not found or could not check (gaps): the honest edge of the data.",
     "companies": "The companies of the graph (data/companies/), public fields only, after the websummit-only pass.",
     "articles": "PrompTugal.news articles (content/articles/), with the region and town they are tagged with.",
     "nodes": "Every node of the graph: the shared graph and the by-place layer, one id space (<type>:<slug>).",
     "edges": "Every edge of the graph: a verb from one node to another, with its source and when it was read.",
     "merges": "How the by-place layer resolved each map entry to a node: matched to the graph, merged with another town's entry, or new. So a merge can be checked, and refused.",
     "connections": "Links between companies, institutions, events and programmes across the places, found by detective.places@PrompTugal.dinis (data/by-place/connections/connections.json), each with its source and whether the page itself was read.",
     "captures": "Captures of the third-party pages the place files cite: a screenshot and the visible text of each, hashed (SHA-256), kept in the sgit vault promptugal-captures (board/team/data.places/tools/capture.mjs).",
     "nr_articles": "newsroom.sgit.ai's articles (a snapshot of its article graph, CC BY 4.0, assets/query/newsroom-graphs.json): Dinis's newsroom, the AgentiCCells cluster among them; each is a node nr:<slug> of the graph.",
     "nr_links": "Which newsroom.sgit.ai article links to which (links_to edges in the graph).",
     "nr_nodes": "The entities inside each newsroom.sgit.ai article's own graph: artefacts, claims, concepts, examples, methods, questions.",
     "nr_edges": "The typed links inside each newsroom.sgit.ai article's graph: answers, compared-with, contrasts, depends-on, example-of, extends, leads-to, produces.",
     "place_items": "Every other list in a place's file, one row per entry: whatever the place agents add beyond the stories, the map, the events, the sources and the gaps (investors, investments, talent, starting a company, government and so on), so a new field is queryable the day it lands.",
     "neighbours": "The blast radius: for each pair of Algarve places, whether their municipalities share a border (from the first place's Portuguese Wikipedia article, at the revision cited; a check against DGT's official boundaries, CAOP, is still owed) and the straight-line distance in km between their seats; and the municipalities outside the Algarve each one borders."
    },
    "x-words": "data.places@PrompTugal.dinis"
   }
  },
  "/api/v1/places/viseu/openapi.json": {
   "get": {
    "operationId": "get_api_v1_places_viseu_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": "viseu",
  "name": "Viseu",
  "kind": "city",
  "agent": "place.districts@PrompTugal.dinis",
  "endpoints": {
   "index": "https://promptugal.news/api/v1/places/viseu/index.json",
   "page": "https://promptugal.news/api/v1/places/viseu/page.json",
   "stories": "https://promptugal.news/api/v1/places/viseu/stories.json",
   "ai_map": "https://promptugal.news/api/v1/places/viseu/ai-map.json",
   "events": "https://promptugal.news/api/v1/places/viseu/events.json",
   "sources": "https://promptugal.news/api/v1/places/viseu/sources.json",
   "agents": "https://promptugal.news/api/v1/places/viseu/agents.json",
   "provenance": "https://promptugal.news/api/v1/places/viseu/provenance.json",
   "quality": "https://promptugal.news/api/v1/places/viseu/quality.json",
   "nearby": "https://promptugal.news/api/v1/places/viseu/nearby.json",
   "openapi": "https://promptugal.news/api/v1/places/viseu/openapi.json",
   "record": "https://promptugal.news/api/v1/by-place/viseu.json",
   "tables": "https://promptugal.news/api/v1/data/places/viseu.json"
  }
 }
}
