eurekiusz 0.4.0__tar.gz

eurekiusz-0.4.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: eurekiusz
+Version: 0.4.0
+Summary: Lokalny asystent ustaw podatkowych: ustawa → nowela → KIS. Bez zgadywania kwot.
+Author-email: QA10 <hello@qa10.io>
+License: Proprietary
+Project-URL: Homepage, https://qa10.io
+Keywords: vat,podatki,eli,kis,eureka
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Legal Industry
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: gui
+Requires-Dist: pywebview>=5; extra == "gui"
+
+# Eurekiusz
+
+Lokalny asystent ustaw podatkowych. Trzy warstwy: ustawa → nowela → KIS.
+Model nie zgaduje kwot. Pusty kontekst = `Nie znalazlem w bazie.`
+
+## Instalacja
+
+```
+python -m pip install -U eurekiusz
+eurekiusz gui
+```
+
+Windows: `winget install Python.Python.3.12`, nowy PowerShell, potem powyższe.
+Okno natywne: `python -m pip install pywebview` (WebView2). Bez tego workbench wstaje na 127.0.0.1.
+
+## Użycie
+
+```
+eurekiusz ask "jaki jest limit zwolnienia VAT 2026"
+eurekiusz lookup DU/2025/775 113
+eurekiusz health
+eurekiusz gui
+```
+
+Bramka: art. 113 TJ DU/2025/775 = 200 000 zł. Limit 240 000 zł to nowela DU/2025/896 od 1.01.2026.
+
+## Czego tu nie ma
+
+- modelu LLM / GGUF
+- `eurekiusz.exe` z tego builda (Wails tylko na Windows)
+- Qdrant, 8 botów, treści Optima `prawo_rachunkowe`

eurekiusz-0.4.0/README.md

@@ -0,0 +1,31 @@
+# Eurekiusz
+
+Lokalny asystent ustaw podatkowych. Trzy warstwy: ustawa → nowela → KIS.
+Model nie zgaduje kwot. Pusty kontekst = `Nie znalazlem w bazie.`
+
+## Instalacja
+
+```
+python -m pip install -U eurekiusz
+eurekiusz gui
+```
+
+Windows: `winget install Python.Python.3.12`, nowy PowerShell, potem powyższe.
+Okno natywne: `python -m pip install pywebview` (WebView2). Bez tego workbench wstaje na 127.0.0.1.
+
+## Użycie
+
+```
+eurekiusz ask "jaki jest limit zwolnienia VAT 2026"
+eurekiusz lookup DU/2025/775 113
+eurekiusz health
+eurekiusz gui
+```
+
+Bramka: art. 113 TJ DU/2025/775 = 200 000 zł. Limit 240 000 zł to nowela DU/2025/896 od 1.01.2026.
+
+## Czego tu nie ma
+
+- modelu LLM / GGUF
+- `eurekiusz.exe` z tego builda (Wails tylko na Windows)
+- Qdrant, 8 botów, treści Optima `prawo_rachunkowe`

eurekiusz-0.4.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eurekiusz"
+version = "0.4.0"
+description = "Lokalny asystent ustaw podatkowych: ustawa → nowela → KIS. Bez zgadywania kwot."
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "QA10", email = "hello@qa10.io" }]
+license = { text = "Proprietary" }
+keywords = ["vat", "podatki", "eli", "kis", "eureka"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Environment :: Console",
+  "Environment :: Win32 (MS Windows)",
+  "Intended Audience :: Legal Industry",
+  "Topic :: Office/Business :: Financial",
+]
+dependencies = []
+
+[project.optional-dependencies]
+gui = ["pywebview>=5"]
+
+[project.urls]
+Homepage = "https://qa10.io"
+
+[project.scripts]
+eurekiusz = "eurekiusz.cli:main"
+
+[project.gui-scripts]
+eurekiusz-gui = "eurekiusz.gui:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+eurekiusz = ["data/chunks.db", "static/index.html"]

eurekiusz-0.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eurekiusz-0.4.0/src/eurekiusz/__init__.py

@@ -0,0 +1,3 @@
+"""Eurekiusz — lokalny asystent ustaw podatkowych (ustawa → nowela → KIS)."""
+
+__version__ = "0.4.0"

eurekiusz-0.4.0/src/eurekiusz/cli.py

@@ -0,0 +1,167 @@
+"""CLI: eurekiusz ask|lookup|search|health|gui"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from eurekiusz import __version__
+from eurekiusz.law import ask, health, lookup, search
+
+
+def _clip(text: str, n: int = 900) -> str:
+    text = (text or "").strip()
+    if len(text) > n:
+        return text[:n] + "…"
+    return text
+
+
+def _hit_lines(hit: dict) -> list[str]:
+    if not hit:
+        return []
+    inner = hit.get("article") or hit
+    eli = inner.get("eli") or hit.get("eli") or ""
+    art = inner.get("art") or hit.get("art") or ""
+    text = inner.get("text") or hit.get("text") or hit.get("head") or ""
+    lines = [f"{eli} art. {art}".strip()]
+    if text:
+        lines.append(_clip(text))
+    return lines
+
+
+def format_ask(out: dict) -> str:
+    if not out.get("ok"):
+        return (out.get("reason") or "Nie znalazlem w bazie.") + "\n"
+    lines: list[str] = []
+    mode = out.get("mode")
+    if mode == "dual_cite":
+        if out.get("ruling"):
+            lines.append(out["ruling"])
+            lines.append("")
+        lines.extend(_hit_lines(out.get("tj") or {}))
+        lines.append("")
+        nowela = out.get("nowela") or {}
+        if nowela.get("ok"):
+            lines.append("Nowela DU/2025/896 (wejście 1.01.2026):")
+            lines.extend(_hit_lines(nowela))
+            lines.append("")
+    elif mode == "lookup":
+        lines.extend(_hit_lines(out.get("hit") or {}))
+        lines.append("")
+    elif mode == "disambiguate":
+        lines.append(out.get("note") or "Kilka ustaw. Sprecyzuj.")
+        for c in out.get("candidates") or []:
+            lines.append(f"- {c.get('eli')} art. {c.get('art')} ({c.get('domain')})")
+        lines.append("")
+    else:
+        hits = out.get("hits") or []
+        if not hits:
+            return "Nie znalazlem w bazie.\n"
+        for h in hits[:3]:
+            lines.extend(_hit_lines(h))
+            lines.append("")
+    kis = out.get("kis")
+    if kis:
+        lines.append(f"KIS {kis.get('sygnatura') or kis.get('id')}: {kis.get('teza') or ''}")
+        if kis.get("url"):
+            lines.append(kis["url"])
+        if kis.get("uwaga"):
+            lines.append(kis["uwaga"])
+    elif mode != "disambiguate":
+        lines.append("KIS: nie znalazłem w bazie interpretacji dla tego artykułu.")
+    return "\n".join(lines).strip() + "\n"
+
+
+def format_ask_md(out: dict) -> str:
+    """Markdown for the desktop chat. Never invents amounts."""
+    if not out.get("ok"):
+        return out.get("reason") or "Nie znalazlem w bazie."
+    parts: list[str] = []
+    mode = out.get("mode")
+    if mode == "dual_cite":
+        parts.append("## Rozstrzygnięcie")
+        parts.append(out.get("ruling") or "")
+        parts.append("## Ustawa")
+        parts.extend(_hit_lines(out.get("tj") or {}))
+        nowela = out.get("nowela") or {}
+        if nowela.get("ok"):
+            parts.append("## Nowela")
+            parts.append("DU/2025/896, wejście **1.01.2026**.")
+            parts.extend(_hit_lines(nowela))
+    elif mode == "lookup":
+        parts.append("## Ustawa")
+        parts.extend(_hit_lines(out.get("hit") or {}))
+    elif mode == "disambiguate":
+        parts.append("## Sprecyzuj")
+        parts.append(out.get("note") or "Ten numer artykułu jest w kilku ustawach.")
+        for c in out.get("candidates") or []:
+            parts.append(f"- {c.get('eli')} art. {c.get('art')} ({c.get('domain')})")
+        return "\n\n".join(p for p in parts if p).strip()
+    else:
+        hits = out.get("hits") or []
+        if not hits:
+            return "Nie znalazlem w bazie."
+        parts.append("## Ustawa")
+        for h in hits[:3]:
+            parts.extend(_hit_lines(h))
+            parts.append("")
+    kis = out.get("kis")
+    parts.append("## KIS")
+    if kis:
+        syg = kis.get("sygnatura") or kis.get("id") or ""
+        parts.append(f"{syg}: {kis.get('teza') or ''}".strip())
+        if kis.get("url"):
+            parts.append(f"[Źródło EUREKA]({kis['url']})")
+        if kis.get("uwaga"):
+            parts.append(kis["uwaga"])
+    else:
+        parts.append("Nie znalazlem w bazie interpretacji dla tego artykułu.")
+    return "\n\n".join(p for p in parts if p is not None).strip()
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(prog="eurekiusz")
+    p.add_argument("--version", action="version", version=f"eurekiusz {__version__}")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    pa = sub.add_parser("ask", help="pytanie → ustawa + nowela + KIS")
+    pa.add_argument("question")
+    pa.add_argument("--json", action="store_true")
+
+    pl = sub.add_parser("lookup")
+    pl.add_argument("eli")
+    pl.add_argument("art")
+
+    ps = sub.add_parser("search")
+    ps.add_argument("query")
+    ps.add_argument("--domain")
+    ps.add_argument("--eli")
+    ps.add_argument("-k", type=int, default=5)
+
+    sub.add_parser("health")
+    sub.add_parser("gui", help="okno desktopowe")
+
+    args = p.parse_args()
+    if args.cmd == "gui":
+        from eurekiusz.gui import run_gui
+
+        run_gui()
+        return 0
+    if args.cmd == "lookup":
+        out = lookup(args.eli, args.art)
+    elif args.cmd == "search":
+        out = search(args.query, domain=args.domain, eli=args.eli, k=args.k)
+    elif args.cmd == "health":
+        out = health()
+    else:
+        out = ask(args.question)
+        if not getattr(args, "json", False) and args.cmd == "ask":
+            sys.stdout.write(format_ask(out))
+            return 0 if out.get("ok") else 1
+    json.dump(out, sys.stdout, ensure_ascii=False, indent=2)
+    sys.stdout.write("\n")
+    return 0 if out.get("ok") else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

eurekiusz-0.4.0/src/eurekiusz/eureka.py

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+"""EUREKA (KIS) layer 3. Never overrides statute. Empty is success."""
+from __future__ import annotations
+
+import json
+import re
+import urllib.error
+import urllib.request
+
+EUREKA_SEARCH = (
+    "https://eureka.mf.gov.pl/api/public/v1/wyszukiwarka/informacje/"
+    "?size=12&page=0&sort=parametryPozycjonowania%2Casc"
+)
+UA = "Mozilla/5.0 (compatible; Eurekiusz/1.0; +https://qa10.io)"
+
+
+def _przepisy_blob(pr) -> str:
+    if isinstance(pr, list):
+        return " ".join(str(x) for x in pr)
+    return str(pr or "")
+
+
+def _status_ok(st) -> bool:
+    s = st[0] if isinstance(st, list) else st
+    return bool(s) and "aktualna" in str(s).lower()
+
+
+def art_in_przepisy(pr, art: str) -> bool:
+    """EUREKA encodes 'art. 113-ust. 1'. Substring '113' is a false friend."""
+    blob = _przepisy_blob(pr)
+    art = art.strip()
+    return bool(re.search(rf"art\.\s*{re.escape(art)}-", blob, re.I))
+
+
+def search_kis(nouns: str, art: str | None = None, timeout: float = 8.0) -> dict | None:
+    """Return at most one aktualna interpretacja, or None.
+
+    Requires art in PRZEPISY when art is given. Requires at least one
+    query token (len>=4) in TEZA. Otherwise skip — ranking is garbage.
+    """
+    q = " ".join((nouns or "").split()[:8]).strip()
+    if len(q) < 4:
+        return None
+    body = json.dumps(
+        {
+            "searchQuery": q,
+            "searchInContent": True,
+            "searchInSynonyms": True,
+            "searchInFullPhrase": False,
+            "filter": {},
+            "columns": [
+                "ID_INFORMACJI",
+                "SYG",
+                "DT_WYD",
+                "TEZA",
+                "STATUS_INFORMACJI",
+                "PRZEPISY",
+                "KATEGORIA_INFORMACJI",
+            ],
+            "warunkiDodatkowe": [],
+        }
+    ).encode()
+    req = urllib.request.Request(
+        EUREKA_SEARCH,
+        data=body,
+        headers={
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "User-Agent": UA,
+        },
+        method="POST",
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as r:
+            data = json.loads(r.read().decode())
+    except (urllib.error.URLError, TimeoutError, json.JSONDecodeError, OSError):
+        return None
+    tokens = [t.lower() for t in re.findall(r"[a-ząćęłńóśźż]{4,}", q, re.I)]
+    for item in data.get("results") or []:
+        if not _status_ok(item.get("STATUS_INFORMACJI")):
+            continue
+        if art and not art_in_przepisy(item.get("PRZEPISY"), art):
+            continue
+        teza = (item.get("TEZA") or "").lower()
+        if tokens and not any(t in teza for t in tokens):
+            continue
+        iid = str(item.get("ID_INFORMACJI") or "")
+        return {
+            "id": iid,
+            "sygnatura": item.get("SYG"),
+            "data": item.get("DT_WYD"),
+            "teza": (item.get("TEZA") or "")[:400],
+            "przepisy": item.get("PRZEPISY") or [],
+            "url": f"https://eureka.mf.gov.pl/informacje/podglad/{iid}" if iid else None,
+            "uwaga": "Interpretacja KIS nie zmienia ustawy. To wykładnia organu.",
+        }
+    return None

eurekiusz-0.4.0/src/eurekiusz/gui.py

@@ -0,0 +1,44 @@
+"""Desktop chat window: local HTML UI + 127.0.0.1 API."""
+from __future__ import annotations
+
+import threading
+import time
+import webbrowser
+
+from eurekiusz.server import make_server
+
+
+def run_gui() -> None:
+    httpd = make_server("127.0.0.1", 0)
+    host, port = httpd.server_address[:2]
+    url = f"http://{host}:{port}/"
+    worker = threading.Thread(target=httpd.serve_forever, daemon=True)
+    worker.start()
+
+    opened = False
+    try:
+        import webview  # type: ignore
+
+        webview.create_window("Eurekiusz", url, width=1120, height=760)
+        webview.start()
+        opened = True
+    except Exception:
+        opened = False
+
+    if not opened:
+        webbrowser.open(url)
+        print(f"Eurekiusz okno nie wstało (brak pywebview). Workbench: {url}", flush=True)
+        try:
+            while worker.is_alive():
+                time.sleep(0.4)
+        except KeyboardInterrupt:
+            pass
+    httpd.shutdown()
+
+
+def main() -> None:
+    run_gui()
+
+
+if __name__ == "__main__":
+    main()