synthadoc 0.9.1__py3-none-any.whl

synthadoc/__init__.py

@@ -0,0 +1,12 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2026 Paul Chen / axoviq.com
+"""synthadoc — domain-agnostic LLM knowledge compilation engine."""
+from importlib.metadata import PackageNotFoundError as _PackageNotFoundError
+from importlib.metadata import version as _version
+from pathlib import Path as _Path
+
+try:
+    __version__ = _version("synthadoc")
+except _PackageNotFoundError:
+    # Fallback for editable installs that haven't been registered yet.
+    __version__ = (_Path(__file__).resolve().parent.parent / "VERSION").read_text(encoding="utf-8").strip()

synthadoc/__main__.py

@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2026 Paul Chen / axoviq.com
+"""Allows running synthadoc as a module: python -m synthadoc <command>"""
+from synthadoc.cli.main import app
+
+app()

synthadoc/agents/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2026 Paul Chen / axoviq.com

synthadoc/agents/_routing.py

@@ -0,0 +1,68 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2026 William Johnason / axoviq.com
+from __future__ import annotations
+
+import json
+import re
+
+from synthadoc.providers.base import Message
+
+
+async def pick_routing_branches(
+    provider,
+    branches: dict[str, list[str]],
+    context: str,
+    *,
+    multi: bool,
+) -> list[str]:
+    """Ask the LLM to select branch names from a ROUTING.md index.
+
+    Args:
+        provider:  LLM provider instance.
+        branches:  Branch mapping from RoutingIndex.branches.
+        context:   Free-text description of what needs to be placed/searched
+                   (e.g. page title+tags for ingest, question text for query).
+        multi:     False → pick exactly one branch (ingest placement).
+                   True  → pick 1-2 branches (query scoping); returns [] when
+                   no branch is clearly relevant so caller can fall back to
+                   full-corpus search.
+    """
+    if not branches:
+        return []
+
+    branch_list = "\n".join(f"- {b}" for b in branches)
+    if multi:
+        prompt = (
+            f"Wiki topic branches:\n{branch_list}\n\n"
+            f"{context}\n\n"
+            "Return a JSON array of the 1-2 most relevant branch names. "
+            "Return [] if no branch is clearly relevant."
+        )
+    else:
+        prompt = (
+            f"Wiki topic branches:\n{branch_list}\n\n"
+            f"{context}\n\n"
+            "Return the single most appropriate branch name for this page. "
+            "Return exactly one branch name from the list above."
+        )
+
+    try:
+        resp = await provider.complete(
+            messages=[Message(role="user", content=prompt)],
+            temperature=0.0,
+        )
+    except Exception:
+        return []
+
+    if multi:
+        m = re.search(r"\[.*?\]", resp.text, re.DOTALL)
+        if not m:
+            return []
+        try:
+            result = json.loads(m.group())
+            return [b for b in result if b in branches]
+        except Exception:
+            return []
+    else:
+        candidate = resp.text.strip().strip('"').strip()
+        return [candidate] if candidate in branches else [next(iter(branches))]

synthadoc/agents/_utils.py

@@ -0,0 +1,25 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (C) 2026 William Johnason / axoviq.com
+from __future__ import annotations
+
+import json
+
+
+def parse_json_string_array(text: str, max_items: int) -> list[str] | None:
+    """Strip code fences, parse a JSON array, return non-empty strings up to max_items.
+
+    Returns None (never raises) when the text cannot be parsed as a non-empty
+    JSON array of strings, so callers can fall back without a try/except.
+    """
+    text = text.strip()
+    if text.startswith("```"):
+        lines = text.splitlines()
+        text = "\n".join(l for l in lines if not l.strip().startswith("```")).strip()
+    try:
+        parts = json.loads(text)
+    except (json.JSONDecodeError, ValueError):
+        return None
+    if not isinstance(parts, list) or not parts:
+        return None
+    filtered = [str(q) for q in parts[:max_items] if str(q).strip()]
+    return filtered or None