local-knowledge 0.2.3__tar.gz → 0.2.4__tar.gz

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-knowledge
-Version: 0.2.3
+Version: 0.2.4
 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
@@ -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.3; extra == "models"
+Requires-Dist: confluence-knowledge[models]>=0.5.4; extra == "models"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "local-knowledge"
-version = "0.2.3"
+version = "0.2.4"
 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"
@@ -27,7 +27,7 @@ dependencies = [
 
 [project.optional-dependencies]
 models = [
-    "confluence-knowledge[models]>=0.5.3",
+    "confluence-knowledge[models]>=0.5.4",
 ]
 dev = [
     "pytest>=8.0",

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/src/local_knowledge/server_local.py

@@ -12,6 +12,7 @@ import socket
 import threading
 
 from confluence_knowledge.client import AccessError, SecurityException
+from confluence_knowledge.feedback import FeedbackStore
 from confluence_knowledge.index import Index
 from confluence_knowledge.retrieval import (
     MODEL_MARKER as EMBED_MODEL_ID,
@@ -34,6 +35,7 @@ mcp = FastMCP("local-knowledge")
 _scopes: dict[str, dict] = {}
 _evidence_sets: dict[str, dict] = {}  # set_id → {scope, ev}
 _indexes: dict[str, Index] = {}
+_feedback: dict[str, FeedbackStore] = {}
 _EMBEDDER = None
 _RERANKER = None
 _SPARSE = None
@@ -51,6 +53,13 @@ def _index_for(scope_key: str) -> Index:
         idx = _indexes[scope_key] = Index(index_root() / f"{scope_key}.db")
     return idx
 
+def _feedback_for(scope_key: str) -> FeedbackStore:
+    st = _feedback.get(scope_key)
+    if st is None:
+        st = _feedback[scope_key] = FeedbackStore(
+            index_root(), scope_key, "local-knowledge")
+    return st
+
 
 def _embedder():
     global _EMBEDDER
@@ -267,7 +276,9 @@ def search(scope_handle: str, question: str) -> dict:
         return {"evidence": [], "coverage": "stale_model",
                 "note": "this index was built with an older embedding model "
                         "— run start_crawl once to rebuild it, then search again"}
-    ev = retrieve(idx, question, _embedder(), _reranker(), sparse=_sparse())
+    emb = _embedder()
+    ev = retrieve(idx, question, emb, _reranker(), sparse=_sparse())
+    corrections = _feedback_for(s["key"]).match(emb.embed([question])[0])
     set_id = f"ev:{len(_evidence_sets)}:{s['key'][:8]}"
     # bound the session cache — sets are never reused after the turn ends
     while len(_evidence_sets) >= 32:
@@ -277,6 +288,7 @@ def search(scope_handle: str, question: str) -> dict:
         "evidence_set": set_id,
         "coverage": _coverage(idx),
         "as_of": st["as_of"],
+        "user_corrections": corrections,
         "evidence": [
             {"chunk_id": e["chunk_id"], "page_title": e["page_title"],
              "page_url": e["page_url"], "heading": e["heading"],
@@ -305,6 +317,30 @@ def get_evidence(scope_handle: str, chunk_ids: list[str]) -> dict:
     return {"chunks": out}
 
 
+@mcp.tool()
+
+
+@mcp.tool()
+def submit_feedback(scope_handle: str, question: str, correction: str,
+                    note: str = "") -> dict:
+    """Store a colleague correction — disclosed alongside the docs on
+    similar future questions (never overrides them)."""
+    s = _scope(scope_handle)
+    if not _models_loaded(0):
+        return {"stored": False, "note": LOADING_NOTE}
+    qvec = _embedder().embed([question])[0]
+    entry = _feedback_for(s["key"]).add(question, qvec, correction, note)
+    return {"stored": entry["id"],
+            "note": "will be disclosed on similar questions"}
+
+
+@mcp.tool()
+def feedback_report(scope_handle: str) -> dict:
+    """Aggregated corrections — which topics keep getting corrected points
+    at outdated/confusing documentation."""
+    s = _scope(scope_handle)
+    return _feedback_for(s["key"]).report()
+
 @mcp.tool()
 def verify_citations(scope_handle: str, evidence_set: str,
                      mappings: list[dict]) -> dict:

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/src/local_knowledge.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: local-knowledge
-Version: 0.2.3
+Version: 0.2.4
 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
@@ -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.3; extra == "models"
+Requires-Dist: confluence-knowledge[models]>=0.5.4; extra == "models"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/src/local_knowledge.egg-info/requires.txt

@@ -12,4 +12,4 @@ pytest-cov>=5.0
 ruff>=0.6
 
 [models]
-confluence-knowledge[models]>=0.5.3
+confluence-knowledge[models]>=0.5.4

{local_knowledge-0.2.3 → local_knowledge-0.2.4}/tests/test_agent_doc_consistency.py

@@ -29,3 +29,24 @@ def test_agent_references_repo_files_that_exist():
     for m in re.findall(r"prompts/([\w.-]+)", doc):
         assert (REPO / "prompts" / m).exists(), \
             f"agent references missing prompts/{m}"
+
+
+def test_agent_frontmatter_tools_exist():
+    """Every tool named in the agent's frontmatter must be a real
+    @mcp.tool() in the server source."""
+    if not AGENT.exists():
+        import pytest
+        pytest.skip("agent file not in this checkout layout")
+    doc = AGENT.read_text()
+    tools_line = re.search(r'tools:\s*\[([^\]]+)\]', doc).group(1)
+    app = AGENT.stem.replace(".agent", "")
+    declared = {t.strip().strip('"').split("/")[1]
+                for t in tools_line.split(",") if f"{app}/" in t}
+    srv_name = {"local-knowledge": "server_local",
+                "sharepoint-knowledge": "server_sp",
+                "confluence-knowledge": "server"}[app]
+    pkg = app.replace("-", "_")
+    srv = (Path(__file__).parents[1] / "src" / pkg / f"{srv_name}.py").read_text()
+    real = set(re.findall(r"@mcp\.tool\(\)\s*\ndef\s+(\w+)", srv))
+    missing = declared - real
+    assert not missing, f"agent frontmatter names tools not in server: {missing}"