From 034cde56ee790e4150f7c9a410293a7031a6e3e9 Mon Sep 17 00:00:00 2001 From: godavid Date: Wed, 11 Nov 2026 18:23:23 +0100 Subject: [PATCH] =?UTF-8?q?docs(api):=20valtozasok=20le=C3=ADr=C3=A1s=20ig?= =?UTF-8?q?az=C3=ADt=C3=A1sa=20a=20val=C3=B3s=20sz=C5=B1r=C5=91szab=C3=A1l?= =?UTF-8?q?yhoz?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Az MCP `valtozasok` tool és az llms.txt a `q`-t a `slugs`-szal egyenrangú szűrőnek, az `until`-t önálló szűrőnek írta, és a napló 2026-09-es kezdetét nem említette. A valós szabály (lib/api/valtozasok.ts): `felveve_utan`, `since` vagy `slugs` nélkül 400; a `q` önmagában nem elég (400), de ezek mellett címre szűr; az `until` önmagában nem elég. A docs/uzemeltetes.md megfelelő sora is igazítva. Closes #45 Co-Authored-By: Claude Sonnet 5.5 --- apps/web/app/api/mcp/route.ts | 6 ++++-- apps/web/app/llms.txt/route.ts | 2 +- docs/uzemeltetes.md | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/apps/web/app/api/mcp/route.ts b/apps/web/app/api/mcp/route.ts index 78d8cfa..466b78e 100644 --- a/apps/web/app/api/mcp/route.ts +++ b/apps/web/app/api/mcp/route.ts @@ -74,8 +74,10 @@ const handler = createMcpHandler( title: "Mi változott?", description: "Hatályba lépett módosítások listája az érintett §-ok régi/új szövegével — egy hívás elég egy értesítéshez. " + - "Figyeléshez: add meg a `felveve_utan` cursort (első hívásnál egy ISO-8601 időbélyeg, utána a válasz `kovetkezo_felveve_utan` mezője változtatás nélkül: átlátszatlan szöveg; a tételek legrégebbi elöl jönnek, rés nélkül) és szűrj `q`-val (címbeli szókezdet, pl. „termőföld|földek forgalm|Földalap”) vagy `slugs`-szal. " + - "Történeti kérdésre (`mi változott a Btk.-ban 2024-ben?`) a `since`/`until`/`slugs` szűrők valók.", + "Figyeléshez: add meg a `felveve_utan` cursort (első hívásnál egy ISO-8601 időbélyeg, utána a válasz `kovetkezo_felveve_utan` mezője változtatás nélkül: átlátszatlan szöveg; a tételek legrégebbi elöl jönnek, rés nélkül) és szűrj `slugs`-szal, vagy `q`-val (címbeli szókezdet, pl. „termőföld|földek forgalm|Földalap”; a `q` önmagában nem elég, 400-at ad, de a `felveve_utan`, `since` vagy `slugs` mellett szűr). " + + "Cursor nélkül legalább a `since` vagy a `slugs` kell (az `until` önmagában nem elég, 400-at ad). " + + "Történeti kérdésre (`mi változott a Btk.-ban 2024-ben?`) a `since`/`until` és a `slugs` valók (legújabb elöl). " + + "A `felveve_utan` napló 2026-09-től létezik: ennél régebbi cursor is csak 2026-09-től kap tételeket.", inputSchema: MCP.valtozasok, annotations: OLVASO, }, diff --git a/apps/web/app/llms.txt/route.ts b/apps/web/app/llms.txt/route.ts index d3916fa..fe1a215 100644 --- a/apps/web/app/llms.txt/route.ts +++ b/apps/web/app/llms.txt/route.ts @@ -75,7 +75,7 @@ Négy művelet, REST-en és MCP-toolként ugyanúgy: ${pelda.kereses} - szakasz — egy § egy adott napon hatályos szövege; § nélkül a jogszabály időállapotai és tartalomjegyzéke. ${pelda.szakasz} -- valtozasok — mi változott: cursorral (felveve_utan) vagy since/until/slugs szűrővel; az érintett §-ok régi/új szövegével. +- valtozasok — mi változott: cursorral (felveve_utan, a napló 2026-09-től létezik), vagy since/slugs szűrővel (az until ezek mellé szűkít, önmagában nem elég); felveve_utan, since vagy slugs nélkül 400 jön. A q önmagában nem elég (400), de ezek mellett címre szűr. Az érintett §-ok régi/új szövegével. ${pelda.valtozasok} - diff — két időállapot teljes §-szintű összevetése. ${pelda.diff} diff --git a/docs/uzemeltetes.md b/docs/uzemeltetes.md index 1243749..535f9cf 100644 --- a/docs/uzemeltetes.md +++ b/docs/uzemeltetes.md @@ -445,7 +445,7 @@ művelet, kulcs nélkül, ugyanabban a Next appban: |---|---|---| | `kereses` | `GET /api/v1/kereses?q=` | hivatkozás-feloldás (index) vagy FTS (`kereses_api` SQL), a § teljes szövegével | | `szakasz` | `GET /api/v1/szakasz?slug=¶grafus=&datum=` | egy § egy időállapotban; § nélkül meta + időállapotok + tartalomjegyzék | -| `valtozasok` | `GET /api/v1/valtozasok?felveve_utan=&q=` | mi változott — veszteségmentes keyset-cursorral (napló-ág, legrégebbi elöl) vagy since/until/slugs szűrővel (hatálybalépés-ág, legújabb elöl), érintett §-okkal | +| `valtozasok` | `GET /api/v1/valtozasok?felveve_utan=&q=` | mi változott — veszteségmentes keyset-cursorral (napló-ág, legrégebbi elöl) vagy since/slugs szűrővel (hatálybalépés-ág, legújabb elöl; az until ezek mellé szűkít; felveve_utan, since vagy slugs nélkül 400), érintett §-okkal | | `diff` | `GET /api/v1/diff?slug=&tol=&ig=` | két időállapot §-szintű diffje | - **Rétegek:** `packages/szoveg` (megosztott: §-darabolás, horgony, hivatkozás-parser,