{
 "openapi": "3.1.0",
 "info": {
  "title": "ENISA publications: data.promptugal.news",
  "version": "v0.1.151",
  "description": "The newest publications on the European Union Agency for Cybersecurity's publications page: title, date, link and the topics ENISA gives, for cyber.promptugal.news. ENISA has no feed, so the HTML list (one page) is read. No report text is kept.\n\nPublisher: ENISA (European Union Agency for Cybersecurity). Reuse terms: ENISA legal notice 1.2: reproduction of material on its website is authorised if the source is acknowledged, unless stated otherwise; the logo only for press and media use with the source acknowledged. robots.txt allows /publications to our agent and asks for a 10 second crawl delay; it blocks named AI crawlers (we are code, no model, and not named). Dinis decided on 18 Nov 2026 that ENISA is read through its published interfaces. Not reviewed by a person. Not a warning service: follow IPMA and ANEPC.\n\nCode: Apache-2.0. Text: CC BY 4.0. The data keeps the terms of its own source (see each source card); nothing here relaxes them.",
  "license": {
   "name": "Apache-2.0 for code; each source keeps its own data terms",
   "identifier": "Apache-2.0"
  },
  "contact": {
   "name": "PrompTugal.news data",
   "url": "https://github.com/PrompTugal/PrompTugal__News__Data"
  }
 },
 "servers": [
  {
   "url": "https://data.promptugal.news",
   "description": "Production"
  }
 ],
 "externalDocs": {
  "description": "How to use the API",
  "url": "https://data.promptugal.news/api/"
 },
 "paths": {
  "/api/v1/enisa-pubs/latest.json": {
   "get": {
    "operationId": "get_enisa_pubs_latest",
    "tags": [
     "enisa-pubs"
    ],
    "summary": "ENISA publications: the latest read",
    "description": "The newest publications on ENISA's publications page (title, date, link and the topics ENISA gives), as listed. The listing gives topics and audience, not a document type. Source: ENISA, www.enisa.europa.eu (legal notice 1.2: reproduction authorised if the source is acknowledged).",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "robots": {
             "type": "string"
            },
            "feed": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "robots",
            "feed"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "publications": {
             "type": "integer"
            },
            "newest": {
             "type": "string"
            },
            "fields_dropped_em_dash": {
             "type": "integer"
            },
            "page_bytes": {
             "type": "integer"
            }
           },
           "required": [
            "publications",
            "newest",
            "fields_dropped_em_dash",
            "page_bytes"
           ]
          },
          "publications": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "title": {
              "type": "string"
             },
             "date": {
              "type": "string",
              "format": "date"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "topics": {
              "type": "array",
              "items": {
               "type": "string"
              }
             }
            },
            "required": [
             "title",
             "date",
             "url",
             "topics"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "about",
          "counts",
          "publications"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "enisa-pubs",
           "title": "ENISA publications",
           "read_at": "2026-11-21T07:06:19Z",
           "provenance": {
            "source": "https://www.enisa.europa.eu/",
            "page": "https://www.enisa.europa.eu/publications",
            "read_at": "2026-11-21T07:06:19Z",
            "by": "sources/enisa-pubs/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "ENISA legal notice 1.2: reproduction of material on its website is authorised if the source is acknowledged, unless stated otherwise; the logo only for press and media use with the source acknowledged. robots.txt allows /publications to our agent and asks for a 10 second crawl delay; it blocks named...",
            "robots": "https://www.enisa.europa.eu/robots.txt (Crawl-delay 10; this path allowed)",
            "feed": "none: the HTML list is read"
           },
           "about": "The newest publications on ENISA's publications page (title, date, link and the topics ENISA gives), as listed. The listing gives topics and audience, not a document type. Source: ENISA, www.enisa.europa.eu (legal notice 1.2: reproduction authorised if the source is acknowledged).",
           "counts": {
            "publications": 10,
            "newest": "2026-11-16",
            "fields_dropped_em_dash": 0,
            "page_bytes": 79005
           },
           "publications": [
            {
             "title": "CRA-Module B and H: CABs accreditation for notification",
             "date": "2026-11-16",
             "url": "https://www.enisa.europa.eu/publications/cra-module-b-and-h-cabs-accreditation-for-notification",
             "topics": [
              "Certification and Standards"
             ]
            },
            {
             "title": "Joint Advisory on the Use of Frontier AI Models for Code Review",
             "date": "2026-11-12",
             "url": "https://www.enisa.europa.eu/publications/joint-advisory-on-the-use-of-frontier-ai-models-for-code-review",
             "topics": [
              "Artificial Intelligence and Next Gen Technologies"
             ]
            },
            {
             "title": "2026 Report on the State of Cybersecurity in the Union",
             "date": "2026-11-10",
             "url": "https://www.enisa.europa.eu/publications/2026-report-on-the-state-of-cybersecurity-in-the-union",
             "topics": [
              "State of cybersecurity in the EU"
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/enisa-pubs/reads.json": {
   "get": {
    "operationId": "get_enisa_pubs_reads",
    "tags": [
     "enisa-pubs"
    ],
    "summary": "ENISA publications: every read, newest first",
    "description": "Every run of sources/enisa-pubs/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "runs": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string"
             },
             "finished": {
              "type": "string"
             },
             "ok": {
              "type": "integer"
             },
             "failed": {
              "type": "integer"
             },
             "reads": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": [
                  "boolean",
                  "string"
                 ]
                }
               },
               "required": [
                "name",
                "url",
                "at",
                "status",
                "bytes",
                "sha256_prefix",
                "changed"
               ]
              }
             }
            },
            "required": [
             "at",
             "finished",
             "ok",
             "failed",
             "reads"
            ]
           }
          }
         },
         "required": [
          "about",
          "source",
          "runs"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "about": "Every run of sources/enisa-pubs/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
           "source": "enisa-pubs",
           "runs": [
            {
             "at": "2026-11-21T07:06:19Z",
             "finished": "2026-11-21T07:06:30Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "publications",
               "url": "https://www.enisa.europa.eu/publications",
               "at": "2026-11-21T07:06:29Z",
               "status": 200,
               "bytes": 79005,
               "sha256_prefix": "15431e631401adc7",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-20T18:06:42Z",
             "finished": "2026-11-20T18:06:46Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "publications",
               "url": "https://www.enisa.europa.eu/publications",
               "at": "2026-11-20T18:06:45Z",
               "status": 200,
               "bytes": 79005,
               "sha256_prefix": "15431e631401adc7",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-20T07:07:48Z",
             "finished": "2026-11-20T07:07:58Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "publications",
               "url": "https://www.enisa.europa.eu/publications",
               "at": "2026-11-20T07:07:57Z",
               "status": 200,
               "bytes": 79005,
               "sha256_prefix": "1f210a5f439b1659",
               "changed": true
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/enisa-pubs/card.json": {
   "get": {
    "operationId": "get_enisa_pubs_card",
    "tags": [
     "enisa-pubs"
    ],
    "summary": "ENISA publications: the card",
    "description": "Who publishes the source, its reuse terms, the schedule, who owns it, what runs by code, by agents and by people, and the vault.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "what": {
           "type": "string"
          },
          "publisher": {
           "type": "string"
          },
          "owner": {
           "type": "string"
          },
          "region": {
           "type": "string"
          },
          "collector": {
           "type": "string"
          },
          "source_home": {
           "type": "string"
          },
          "reader_page": {
           "type": "string"
          },
          "schedule": {
           "type": "object",
           "properties": {
            "cadence": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "cadence",
            "how"
           ]
          },
          "terms": {
           "type": "object",
           "properties": {
            "summary": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "quote": {
             "type": "string"
            },
            "quote_lang": {
             "type": "string"
            },
            "quotes": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "page": {
                "type": "string"
               },
               "read_at": {
                "type": "string",
                "format": "date"
               },
               "topic": {
                "type": "string"
               },
               "quote": {
                "type": "string"
               }
              },
              "required": [
               "page",
               "read_at",
               "topic",
               "quote"
              ]
             }
            },
            "republish": {
             "type": "string"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "quotes",
            "republish",
            "open_question"
           ]
          },
          "api": {
           "type": "object",
           "properties": {
            "latest": {
             "type": "string"
            },
            "reads": {
             "type": "string"
            },
            "card": {
             "type": "string"
            },
            "openapi": {
             "type": "string"
            },
            "page": {
             "type": "string"
            }
           },
           "required": [
            "latest",
            "reads",
            "card",
            "openapi",
            "page"
           ]
          },
          "vault": {
           "type": "null"
          },
          "split": {
           "type": "object",
           "properties": {
            "code": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "agents": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "people": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "code",
            "agents",
            "people"
           ]
          },
          "cost": {
           "type": "object",
           "properties": {
            "per_run_tokens": {
             "type": "integer"
            },
            "per_run_model_cost_usd": {
             "type": "integer"
            },
            "runner": {
             "type": "string"
            },
            "build_tokens": {
             "type": "string"
            },
            "note": {
             "type": "string"
            }
           },
           "required": [
            "per_run_tokens",
            "per_run_model_cost_usd",
            "runner",
            "build_tokens",
            "note"
           ]
          },
          "since": {
           "type": "string"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "region",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "enisa-pubs",
           "title": "ENISA publications",
           "what": "The newest publications on the European Union Agency for Cybersecurity's publications page: title, date, link and the topics ENISA gives, for cyber.promptugal.news. ENISA has no feed, so the HTML list (one page) is read. No report text is kept.",
           "publisher": "ENISA (European Union Agency for Cybersecurity)",
           "owner": "data.b@PrompTugal.dinis",
           "region": "portugal",
           "collector": "sources/enisa-pubs/collect.mjs",
           "source_home": "https://www.enisa.europa.eu/",
           "reader_page": "https://www.enisa.europa.eu/publications",
           "schedule": {
            "cadence": "every 6 hours",
            "how": "the Pages workflow (.github/workflows/pages.yml) at 17 minutes past 00, 06, 12 and 18 UTC; one GET of the first page of ENISA's publications list (robots.txt allows /publications to everyone; Crawl-delay 10 respected; a refusal is recorded and respected); every other run keeps the last read, copied ..."
           },
           "terms": {
            "summary": "ENISA legal notice 1.2: reproduction of material on its website is authorised if the source is acknowledged, unless stated otherwise; the logo only for press and media use with the source acknowledged. robots.txt allows /publications to our agent and asks for a 10 second crawl delay; it blocks named...",
            "page": "https://www.enisa.europa.eu/about-enisa/legal-notice",
            "read_at": "2026-11-18",
            "quote": "Reproduction of ENISA material published on this website is authorized, provided the source is acknowledged, unless it is stated otherwise.",
            "quote_lang": "en",
            "quotes": [
             {
              "page": "https://www.enisa.europa.eu/robots.txt",
              "read_at": "2026-11-18",
              "topic": "crawl delay",
              "quote": "User-agent: * / Crawl-delay: 10"
             },
             {
              "page": "https://www.enisa.europa.eu/robots.txt",
              "read_at": "2026-11-18",
              "topic": "paths",
              "quote": "No Disallow line covers /publications (the file disallows /search/, sorting and facet query strings and, for named AI crawlers, everything)."
             },
             {
              "page": "https://www.enisa.europa.eu/about-enisa/legal-notice",
              "read_at": "2026-11-18",
              "topic": "logo",
              "quote": "The reproduction of the ENISA logo is permitted provided that the source is acknowledged and the logo is used for press and media related purposes. All other uses are prohibited unless permission is obtained."
             }
            ],
            "republish": "yes: title, date and link, with ENISA named as the source; no logo; no report text or images",
            "open_question": "Decided by Dinis on 18 Nov 2026 (about 23:40 UTC): reading is in order. The robots.txt still blocks named AI crawlers; this collector is plain code that reads one page, uses no model and is not named. A person may still want to confirm it with ENISA."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/enisa-pubs/latest.json",
            "reads": "https://data.promptugal.news/api/v1/enisa-pubs/reads.json",
            "card": "https://data.promptugal.news/api/v1/enisa-pubs/card.json",
            "openapi": "https://data.promptugal.news/api/v1/enisa-pubs/openapi.json",
            "page": "https://data.promptugal.news/sources/enisa-pubs/"
           },
           "vault": null,
           "split": {
            "code": [
             "the collector reads ENISA's publications page and keeps title, date, link and topics of each item",
             "GitHub Actions runs it and deploys the site"
            ],
            "agents": [
             "data.b@PrompTugal.dinis wrote the collector and card on 18 November 2026, at cyber.b@PrompTugal.dinis's request; terms read the same day by data.b.dev@"
            ],
            "people": [
             "Dinis Cruz decided the cyber signals on 18 November 2026 (board/guidance/2026-11-18-people-blogs-cyber-and-simulated-payments.md); no person has checked the values (not reviewed); Dinis Cruz decided on 18 November 2026 (about 23:40 UTC) that ENISA is read through its published interfaces"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge; one request a run (about 80 KB)",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-18"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/enisa-pubs/openapi.json": {
   "get": {
    "operationId": "get_enisa_pubs_openapi",
    "tags": [
     "enisa-pubs"
    ],
    "summary": "ENISA publications: this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "enisa-pubs",
   "description": "The newest publications on the European Union Agency for Cybersecurity's publications page: title, date, link and the topics ENISA gives, for cyber.promptugal.news. ENISA has no feed, so the HTML list (one page) is read. No report text is kept."
  }
 ],
 "x-source": {
  "id": "enisa-pubs",
  "card": "https://data.promptugal.news/api/v1/enisa-pubs/card.json",
  "page": "https://data.promptugal.news/sources/enisa-pubs/"
 }
}
