confluence-knowledge 0.4.0__tar.gz → 0.4.1__tar.gz

{confluence_knowledge-0.4.0 → confluence_knowledge-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: confluence-knowledge
-Version: 0.4.0
+Version: 0.4.1
 Summary: Local, GET-only Confluence subtree indexer + grounded-Q&A MCP service
 License: MIT
 Project-URL: Repository, https://github.com/nkunal1992/agents

{confluence_knowledge-0.4.0 → confluence_knowledge-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "confluence-knowledge"
-version = "0.4.0"
+version = "0.4.1"
 description = "Local, GET-only Confluence subtree indexer + grounded-Q&A MCP service"
 readme = "README.md"
 requires-python = ">=3.11"

{confluence_knowledge-0.4.0 → confluence_knowledge-0.4.1}/src/confluence_knowledge/cli.py

@@ -94,9 +94,21 @@ def _wizard() -> int:
 
 def _doctor() -> int:
     from .server import status
+    from .update import check
     try:
         s = status()
         print(json.dumps(s, indent=2))
+        upd = check("confluence-knowledge")
+        if upd["installed"]:
+            line = f"version: {upd['installed']}"
+            if upd["latest"]:
+                line += f" (latest: {upd['latest']})"
+            elif upd["latest"] is None:
+                line += " (latest: unchecked — offline or internal mirror)"
+            print(line)
+        if upd["update_available"]:
+            print("update available: run `confluence-knowledge update` "
+                  "(or pip install -U confluence-knowledge[models])")
         if s.get("configured"):
             from .server import _client_for  # internal but fine in CLI
             profile = SiteProfile.load(default_home())
@@ -122,6 +134,7 @@ def main() -> None:
     sub.add_parser("setup", help="guided credential + config setup")
     sub.add_parser("doctor", help="verify config, credentials, models")
     sub.add_parser("prepare-models", help="download the pinned local models")
+    sub.add_parser("update", help="upgrade this package via pip -U")
     reg = sub.add_parser(
         "register",
         help="write this server into the IDE's MCP config (no manual paste)")
@@ -145,6 +158,22 @@ def main() -> None:
         for line in prepare_models(default_home()):
             print(line)
         return
+    if args.cmd == "update":
+        import subprocess
+        cmd = [sys.executable, "-m", "pip", "install", "-U",
+               "confluence-knowledge[models]"]
+        if os.name == "nt":
+            # this exe is the running process on Windows — pip can't replace
+            # a file that's in use; hand the user the equivalent python -m
+            # pip command instead (same mechanism `pip install -U pip` uses)
+            print("on Windows, upgrade via the venv python directly:\n  "
+                  + " ".join(f'"{c}"' if " " in c else c for c in cmd))
+            return
+        r = subprocess.run(cmd, check=False)
+        if r.returncode == 0:
+            print("\nupdated — models are pinned and unchanged; "
+                  "run `confluence-knowledge doctor` to confirm")
+        sys.exit(r.returncode)
     if args.cmd == "register":
         from .registration import register
         try:

confluence_knowledge-0.4.1/src/confluence_knowledge/update.py

@@ -0,0 +1,55 @@
+"""Self-update check — installed vs latest published version.
+
+One GET to the package index (PyPI or an internal mirror set via
+KNOWLEDGE_UPDATE_INDEX) — fails silent to ``latest: None`` when offline or
+proxied, and never blocks doctor.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import urllib.request
+from importlib.metadata import PackageNotFoundError, version
+
+INDEX = "https://pypi.org/pypi/{dist}/json"
+ENV_INDEX = "KNOWLEDGE_UPDATE_INDEX"
+TIMEOUT = 5
+
+
+def installed_version(dist: str) -> str | None:
+    try:
+        return version(dist)
+    except PackageNotFoundError:
+        return None
+
+
+def latest_version(dist: str, timeout: float = TIMEOUT) -> str | None:
+    """Latest version on the index — None when it can't be checked (offline,
+    internal mirror without the package, network policy). Never raises."""
+    url = os.environ.get(ENV_INDEX, INDEX).format(dist=dist)
+    try:
+        with urllib.request.urlopen(url, timeout=timeout) as r:
+            return json.loads(r.read())["info"]["version"]
+    except Exception:  # noqa: BLE001 — every failure mode means "couldn't check"
+        return None
+
+
+def check(dist: str) -> dict:
+    """{installed, latest, update_available} — the dict doctor reports."""
+    inst = installed_version(dist)
+    latest = latest_version(dist)
+    return {
+        "installed": inst,
+        "latest": latest,
+        "update_available": bool(
+            inst and latest and _version_tuple(latest) > _version_tuple(inst)),
+    }
+
+
+def _version_tuple(v: str) -> tuple:
+    out = []
+    for part in v.split("."):
+        num = "".join(c for c in part if c.isdigit())
+        out.append(int(num) if num else 0)
+    return tuple(out)

{confluence_knowledge-0.4.0 → confluence_knowledge-0.4.1}/src/confluence_knowledge.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: confluence-knowledge
-Version: 0.4.0
+Version: 0.4.1
 Summary: Local, GET-only Confluence subtree indexer + grounded-Q&A MCP service
 License: MIT
 Project-URL: Repository, https://github.com/nkunal1992/agents

{confluence_knowledge-0.4.0 → confluence_knowledge-0.4.1}/src/confluence_knowledge.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ src/confluence_knowledge/registration.py
 src/confluence_knowledge/retrieval.py
 src/confluence_knowledge/server.py
 src/confluence_knowledge/settings.py
+src/confluence_knowledge/update.py
 src/confluence_knowledge.egg-info/PKG-INFO
 src/confluence_knowledge.egg-info/SOURCES.txt
 src/confluence_knowledge.egg-info/dependency_links.txt
@@ -28,4 +29,5 @@ tests/test_prepare_models.py
 tests/test_registration.py
 tests/test_retrieval.py
 tests/test_secrets.py
-tests/test_server_flow.py
+tests/test_server_flow.py
+tests/test_update.py

confluence_knowledge-0.4.1/tests/test_update.py

@@ -0,0 +1,40 @@
+"""Self-update check — mocked index, offline path, version compare."""
+from __future__ import annotations
+
+from confluence_knowledge import update
+
+
+def test_installed_version():
+    v = update.installed_version("confluence-knowledge")
+    assert v and v[0].isdigit()
+
+
+def test_latest_offline_returns_none(monkeypatch):
+    monkeypatch.setattr(update, "INDEX", "https://invalid.invalid/{dist}")
+    monkeypatch.delenv("KNOWLEDGE_UPDATE_INDEX", raising=False)
+    # urllib will fail to resolve — must return None, not raise
+    assert update.latest_version("confluence-knowledge", timeout=1) is None
+
+
+def test_check_update_available(monkeypatch):
+    monkeypatch.setattr(update, "latest_version", lambda d, **k: "99.0.0")
+    r = update.check("confluence-knowledge")
+    assert r["update_available"] is True and r["latest"] == "99.0.0"
+
+
+def test_check_up_to_date(monkeypatch):
+    inst = update.installed_version("confluence-knowledge")
+    monkeypatch.setattr(update, "latest_version", lambda d, **k: inst)
+    r = update.check("confluence-knowledge")
+    assert r["update_available"] is False
+
+
+def test_check_cannot_check(monkeypatch):
+    monkeypatch.setattr(update, "latest_version", lambda d, **k: None)
+    r = update.check("confluence-knowledge")
+    assert r["update_available"] is False and r["latest"] is None
+
+
+def test_version_tuple():
+    assert update._version_tuple("1.2.10") > update._version_tuple("1.2.9")
+    assert update._version_tuple("0.4.1") == update._version_tuple("0.4.1")