local-knowledge 0.2.0__tar.gz → 0.2.2__tar.gz

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-knowledge
-Version: 0.2.0
+Version: 0.2.2
 Summary: Local file/folder indexer + grounded-Q&A MCP service — same engine as confluence-knowledge, no credentials needed
 License: MIT
 Project-URL: Repository, https://github.com/nkunal1992/agents
@@ -12,7 +12,7 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: confluence-knowledge>=0.5.0
+Requires-Dist: confluence-knowledge>=0.5.1
 Requires-Dist: python-docx>=1.1
 Requires-Dist: pypdf>=4.0
 Requires-Dist: python-pptx>=1.0
@@ -20,7 +20,7 @@ Requires-Dist: openpyxl>=3.1
 Requires-Dist: mcp<2,>=1.6
 Requires-Dist: pip-system-certs>=5.0
 Provides-Extra: models
-Requires-Dist: confluence-knowledge[models]>=0.5.0; extra == "models"
+Requires-Dist: confluence-knowledge[models]>=0.5.2; extra == "models"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "local-knowledge"
-version = "0.2.0"
+version = "0.2.2"
 description = "Local file/folder indexer + grounded-Q&A MCP service — same engine as confluence-knowledge, no credentials needed"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -16,7 +16,7 @@ classifiers = [
     "Programming Language :: Python :: 3 :: Only",
 ]
 dependencies = [
-    "confluence-knowledge>=0.5.0",
+    "confluence-knowledge>=0.5.1",
     "python-docx>=1.1",
     "pypdf>=4.0",
     "python-pptx>=1.0",
@@ -27,7 +27,7 @@ dependencies = [
 
 [project.optional-dependencies]
 models = [
-    "confluence-knowledge[models]>=0.5.0",
+    "confluence-knowledge[models]>=0.5.2",
 ]
 dev = [
     "pytest>=8.0",

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/src/local_knowledge/cli_local.py

@@ -30,6 +30,13 @@ def _doctor() -> int:
     from .server_local import status
     s = status()
     print(json.dumps(s, indent=2))
+    bad = [c for c in s.get("checks", []) if not c["ok"]]
+    if bad:
+        print("\nhealth flags:")
+        for c in bad:
+            print(f"  ✗ {c['flag']}: {c['detail']}")
+            if c.get("remediation"):
+                print(f"    → {c['remediation']}")
     upd = check("local-knowledge")
     if upd["installed"]:
         line = f"version: {upd['installed']}"
@@ -41,7 +48,7 @@ def _doctor() -> int:
     if upd["update_available"]:
         print("update available: run `local-knowledge update` "
               "(or pip install -U local-knowledge[models])")
-    return 0
+    return 4 if bad else 0
 
 
 def main() -> None:
@@ -72,6 +79,9 @@ def main() -> None:
         import subprocess
         cmd = [sys.executable, "-m", "pip", "install", "-U",
                "local-knowledge[models]"]
+        # a running MCP server holds open files — quit the IDE first
+        print("note: quit the IDE (or stop the MCP server) before updating —"
+              " a running server can't be replaced cleanly", flush=True)
         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 command

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/src/local_knowledge/crawl_local.py

@@ -32,7 +32,7 @@ def resolve_root(path: str) -> Path:
     return p.resolve()
 
 
-from confluence_knowledge.retrieval import EMBED_MODEL_ID as _MODEL_ID
+from confluence_knowledge.retrieval import MODEL_MARKER as _MODEL_ID
 
 
 class LocalCrawler:
@@ -133,6 +133,18 @@ class LocalCrawler:
 
         queue: list[str] = job["queue"]
         errors: list[str] = job["errors"]
+        # Mid-crawl model change: already-embedded pages live in the OLD
+        # vector space — finishing would publish mixed dims. Wipe + fail;
+        # start_crawl rebuilds under the new model.
+        stamped = self.index.model_id()
+        if stamped is not None and stamped != _MODEL_ID and queue:
+            self.index.clear_scope()
+            errors = errors + [
+                (f"model changed mid-crawl ({stamped} → {_MODEL_ID}) — "
+                 "index cleared; run start_crawl")]
+            self.index.save_job(job_id, "error", [], errors)
+            return {"job_id": job_id, "state": "error",
+                    "remaining": 0, "errors": errors}
         seen_raw = self.index.meta_get(f"seen:{job_id}")
         seen: set[str] = set(json.loads(seen_raw)) if seen_raw else set()
         levels_raw = self.index.meta_get(f"levels:{job_id}")

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/src/local_knowledge/server_local.py

@@ -14,7 +14,9 @@ import threading
 from confluence_knowledge.client import AccessError, SecurityException
 from confluence_knowledge.index import Index
 from confluence_knowledge.retrieval import (
-    EMBED_MODEL_ID,
+    MODEL_MARKER as EMBED_MODEL_ID,
+)
+from confluence_knowledge.retrieval import (
     LocalEmbedder,
     LocalReranker,
     LocalSparseEmbedder,
@@ -25,7 +27,7 @@ from confluence_knowledge.settings import SetupError
 from mcp.server.fastmcp import FastMCP
 
 from .crawl_local import LocalCrawler, resolve_root
-from .settings_local import APP_NAME, LocalProfile, home, index_root
+from .settings_local import APP_NAME, LocalProfile, home, index_root, workdir
 
 mcp = FastMCP("local-knowledge")
 
@@ -113,19 +115,17 @@ def _scope(scope_handle: str) -> dict:
 @mcp.tool()
 def status() -> dict:
     """Report setup readiness — no credentials exist for this agent."""
-    models = home() / "models"
     try:
         profile = LocalProfile.load()
         cfg = {"root": profile.root_path, "device": profile.device}
     except SetupError as e:
         cfg = {"error": str(e)}
+    from confluence_knowledge.health import health_checks
     return {
         "configured": "error" not in cfg,
         "profile": cfg,
-        "embedding_model_ready": (models / "bge-m3").exists(),
-        "reranker_model_ready": (models / "bge-reranker-v2-m3-ONNX").exists()
-            or (models / "bge-reranker-base-ONNX").exists(),
-        "sparse_model_ready": (models / "fastembed").exists(),
+        "checks": health_checks(home(), workdir(), APP_NAME, "local-knowledge",
+                                index_root=index_root()),
         "models_loaded": _models_ready.is_set() and _EMBEDDER is not None,
         "index_root": str(index_root()),
         "live_scopes": sorted(_scopes),

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/src/local_knowledge.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-knowledge
-Version: 0.2.0
+Version: 0.2.2
 Summary: Local file/folder indexer + grounded-Q&A MCP service — same engine as confluence-knowledge, no credentials needed
 License: MIT
 Project-URL: Repository, https://github.com/nkunal1992/agents
@@ -12,7 +12,7 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: confluence-knowledge>=0.5.0
+Requires-Dist: confluence-knowledge>=0.5.1
 Requires-Dist: python-docx>=1.1
 Requires-Dist: pypdf>=4.0
 Requires-Dist: python-pptx>=1.0
@@ -20,7 +20,7 @@ Requires-Dist: openpyxl>=3.1
 Requires-Dist: mcp<2,>=1.6
 Requires-Dist: pip-system-certs>=5.0
 Provides-Extra: models
-Requires-Dist: confluence-knowledge[models]>=0.5.0; extra == "models"
+Requires-Dist: confluence-knowledge[models]>=0.5.2; extra == "models"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"

{local_knowledge-0.2.0 → local_knowledge-0.2.2}/src/local_knowledge.egg-info/requires.txt

@@ -1,4 +1,4 @@
-confluence-knowledge>=0.5.0
+confluence-knowledge>=0.5.1
 python-docx>=1.1
 pypdf>=4.0
 python-pptx>=1.0
@@ -12,4 +12,4 @@ pytest-cov>=5.0
 ruff>=0.6
 
 [models]
-confluence-knowledge[models]>=0.5.0
+confluence-knowledge[models]>=0.5.2