v0.2.0 - Retrofit do kanonu MCP MateMatic (Python)

Drugi Python MCP MateMatic z pelnym kanonem (po sejm-eli-mcp v0.2.0). Pattern z dograh-hq/dograh v1.31.0 (BSD-2). Backward-compatible.

Added

• INSTRUCTIONS pelne procedural orchestration (5 tooli, twarde ograniczenia, iteracja po bledach, disclaimer KIO art. 87 Konstytucji RP)
• ToolAnnotations na 5 @mcp.tool: readOnlyHint + openWorldHint (UZP scraping live)
• KIOError klasa z VALID_CODES: invalid_signature, missing_arg, invalid_arg, not_found, upstream_error
• Drift test 6 testow

Validation

• 29/29 testow non-smoke PASS
• 4 smoke live UZP fail to znane ograniczenie POC v0.1.0 (selektory HTML best-effort)

Pre-production wymagane: wlasny smoke test + powiadomienie UZP.

v0.1.0 - POC initial release

Pierwsza wersja POC serwera MCP dla publicznej bazy orzeczen Krajowej Izby Odwolawczej (orzeczenia.uzp.gov.pl).

Tooly (5)

• kio_search - wyszukiwanie po slowach kluczowych, sygnaturze, dacie, typie orzeczenia
• kio_get_orzeczenie - pelne orzeczenie po sygnaturze (KIO 5072/25) lub internal_id
• kio_recent - najnowsze orzeczenia (limit, days_back)
• kio_by_pzp_article - wyszukiwanie po artykule PZP (np. art. 226 PZP)
• kio_get_pdf_url - bezposredni URL do PDF orzeczenia

Infrastruktura

• Parser sygnatury PL (KIO 5072/25 <-> (5072, 2025))
• Parser HTML (selectolax) dla pojedynczego orzeczenia i listy
• Audit log JSONL bez pelnej tresci
• Rate limit token bucket (1 req/s, hard cap 2.0)
• Cache TTL: 7 dni orzeczenie, 6h lista, 30 dni slowniki PZP
• Konstytucja governance z 4 zasadami
• Smoke testy live API + testy offline parsera sygnatury

Status: POC pre-alpha

Selektory HTML to best-effort - pierwsze smoke moga ujawnic rozbieznosci wymagajace kalibracji.

Pre-production wymagane: wlasny smoke test + powiadomienie UZP.

Licencja

Apache-2.0.