know-cli 0.3.5__tar.gz → 0.3.7__tar.gz

{know_cli-0.3.5 → know_cli-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: know-cli
-Version: 0.3.5
+Version: 0.3.7
 Summary: Context Intelligence for AI Coding Agents — smart, token-budgeted code context
 Project-URL: Homepage, https://github.com/vic/know-cli
 Project-URL: Repository, https://github.com/vic/know-cli

know_cli-0.3.7/docs/arc.md

@@ -0,0 +1,43 @@
+# know-cli
+
+**Description:**
+
+know-cli is a command-line interface tool designed to help users quickly access and manage knowledge bases from the terminal. It streamlines the process of storing, retrieving, and organizing information without leaving your command line environment. Whether you're documenting project notes, technical references, or quick facts, know-cli makes knowledge management fast and efficient.
+
+**Features:**
+
+- **Quick Search & Retrieval** – Instantly find and display stored knowledge entries with powerful search capabilities
+- **Easy Organization** – Create, update, and categorize your knowledge base with intuitive commands
+- **Lightweight & Fast** – Minimal dependencies and optimized performance for seamless terminal integration
+
+## 📁 Project Structure
+
+- **[src.know.index](src/know/index.py)** - Index management for incremental code scanning.
+- **[src.know.ai](src/know/ai.py)** - AI integration for intelligent code understanding with advanced token optimization.
+- **[src.know.lexical_index](src/know/lexical_index.py)** - SQLite FTS5 index for chunk-level lexical search.
+- **[src.know.stats](src/know/stats.py)** - Usage statistics tracker for know-cli.
+- **[src.know.history](src/know/history.py)** - Execution history tracking for know-cli.
+- **[src.know.models](src/know/models.py)** - Data models for know-cli.
+- **[src.know.watcher](src/know/watcher.py)** - File system watcher for auto-updating documentation.
+- **[src.know.quality](src/know/quality.py)** - Code quality metrics and dashboard.
+- **[src.know.mcp_server](src/know/mcp_server.py)** - MCP (Model Context Protocol) server for know-cli.
+- **[src.know.exceptions](src/know/exceptions.py)** - Custom exceptions for know-cli.
+- **[src.know.logger](src/know/logger.py)** - Logging configuration for know.
+- **[src.know.generator](src/know/generator.py)** - Documentation generator.
+- **[src.know.parsers](src/know/parsers.py)** - Parser strategy pattern for language-specific parsing.
+- **[src.know.cli](src/know/cli.py)** - CLI entry point for know.
+- **[src.know.semantic_search](src/know/semantic_search.py)** - Semantic code search using real embeddings and vector similarity.
+- ... and 12 more modules
+
+## 📊 Statistics
+
+- **Files:** 27
+- **Modules:** 27
+- **Functions:** 80
+- **Classes:** 52
+
+---
+
+*Generated by [know](https://github.com/sushilk1991/know-cli) v1.0.0*
+
+Run `know update` to refresh this documentation.

{know_cli-0.3.5 → know_cli-0.3.7}/docs/architecture.md

@@ -2,51 +2,41 @@
 
 ```mermaid
 graph TB
-    logger["logger\n(2f, 0c)"]
-    token_counter["token_counter\n(3f, 0c)"]
-    semantic_search["semantic_search\n(0f, 2c)"]
+    index["index\n(1f, 1c)"]
     ai["ai\n(0f, 4c)"]
-    import_graph["import_graph\n(0f, 1c)"]
-    watcher["watcher\n(0f, 2c)"]
-    cli["cli\n(33f, 0c)"]
+    lexical_index["lexical_index\n(0f, 2c)"]
     stats["stats\n(0f, 1c)"]
+    history["history\n(0f, 2c)"]
+    models["models\n(0f, 4c)"]
+    watcher["watcher\n(0f, 2c)"]
+    quality["quality\n(0f, 2c)"]
     mcp_server["mcp_server\n(5f, 0c)"]
     exceptions["exceptions\n(0f, 8c)"]
-    diff["diff\n(0f, 1c)"]
+    logger["logger\n(2f, 0c)"]
     generator["generator\n(0f, 1c)"]
     parsers["parsers\n(0f, 5c)"]
-    quality["quality\n(0f, 2c)"]
-    git_hooks["git_hooks\n(0f, 1c)"]
-    context_engine["context_engine\n(6f, 2c)"]
-    config["config\n(1f, 6c)"]
-    __init__["__init__"]
-    models["models\n(0f, 4c)"]
+    cli["cli\n(58f, 0c)"]
+    semantic_search["semantic_search\n(2f, 2c)"]
+    __init__["__init__\n(1f, 0c)"]
     scanner["scanner\n(1f, 1c)"]
+    token_counter["token_counter\n(3f, 0c)"]
+    state["state\n(0f, 1c)"]
+    knowledge_base["knowledge_base\n(0f, 2c)"]
 
-    semantic_search --> context_engine
+    index --> exceptions
+    index --> logger
+    index --> config
+    index --> scanner
+    index --> context_engine
     ai --> config
-    import_graph --> logger
-    import_graph --> config
+    lexical_index --> logger
+    lexical_index --> context_engine
+    stats --> logger
+    stats --> config
+    history --> config
     watcher --> config
     watcher --> scanner
     watcher --> generator
-    cli --> config
-    cli --> scanner
-    cli --> generator
-    cli --> watcher
-    cli --> ai
-    cli --> git_hooks
-    cli --> logger
-    cli --> exceptions
-    cli --> semantic_search
-    cli --> context_engine
-    cli --> import_graph
-    cli --> diff
-    cli --> knowledge_base
-    cli --> stats
-    cli --> mcp_server
-    stats --> logger
-    stats --> config
     mcp_server --> logger
     mcp_server --> config
     mcp_server --> context_engine
@@ -56,19 +46,34 @@ graph TB
     mcp_server --> ai
     mcp_server --> import_graph
     mcp_server --> stats
-    diff --> config
-    diff --> scanner
     generator --> config
     generator --> scanner
     generator --> ai
     parsers --> exceptions
     parsers --> models
-    git_hooks --> config
-    context_engine --> token_counter
-    context_engine --> logger
-    context_engine --> config
-    context_engine --> scanner
-    context_engine --> import_graph
+    cli --> config
+    cli --> scanner
+    cli --> generator
+    cli --> watcher
+    cli --> ai
+    cli --> git_hooks
+    cli --> logger
+    cli --> exceptions
+    cli --> context_engine
+    cli --> import_graph
+    cli --> diff
+    cli --> knowledge_base
+    cli --> stats
+    cli --> state
+    cli --> tools
+    cli --> history
+    cli --> cost
+    cli --> semantic_search
+    cli --> mcp_server
+    semantic_search --> context_engine
+    semantic_search --> lexical_index
+    semantic_search --> config
+    semantic_search --> scanner
     __init__ --> cli
     scanner --> exceptions
     scanner --> logger
@@ -76,13 +81,21 @@ graph TB
     scanner --> models
     scanner --> config
     scanner --> index
+    state --> config
     knowledge_base --> logger
     knowledge_base --> config
     knowledge_base --> token_counter
-    index --> exceptions
-    index --> logger
-    index --> config
-    index --> scanner
+    import_graph --> logger
+    import_graph --> config
+    git_hooks --> config
+    diff --> config
+    diff --> scanner
+    cost --> config
+    context_engine --> token_counter
+    context_engine --> logger
+    context_engine --> config
+    context_engine --> scanner
+    context_engine --> import_graph
 ```
 
 *Generated by know*

{know_cli-0.3.5 → know_cli-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "know-cli"
-version = "0.3.5"
+version = "0.3.7"
 description = "Context Intelligence for AI Coding Agents — smart, token-budgeted code context"
 readme = "README.md"
 license = "MIT"

{know_cli-0.3.5 → know_cli-0.3.7}/src/know/lexical_index.py

@@ -144,6 +144,8 @@ class ChunkFTSIndex:
                 ".tsx",
                 ".js",
                 ".jsx",
+                ".css",
+                ".scss",
                 ".go",
                 ".rs",
                 ".java",

{know_cli-0.3.5 → know_cli-0.3.7}/src/know/semantic_search.py

@@ -395,7 +395,7 @@ class SemanticSearcher:
     def index_directory(self, root: Path, extensions: List[str] = None) -> int:
         """Index all files in a directory. Returns count of indexed files."""
         if extensions is None:
-            extensions = [".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs", ".java", ".cpp", ".c", ".h"]
+            extensions = [".py", ".ts", ".tsx", ".js", ".jsx", ".css", ".scss", ".go", ".rs", ".java", ".cpp", ".c", ".h"]
         
         # Load .gitignore if present
         ignore_spec = None
@@ -684,8 +684,11 @@ class SemanticSearcher:
         # Hard fallback: plain text grep when hybrid/vector/lexical all miss.
         # This guarantees useful results for exact keyword queries in TS/React projects.
         if not results and query.strip():
+            import re
+
             q = query.strip().lower()
-            exts = {".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs", ".java", ".cpp", ".c", ".h", ".md"}
+            q_tokens = [t for t in re.findall(r"[a-z0-9_]+", q) if len(t) >= 3]
+            exts = {".py", ".ts", ".tsx", ".js", ".jsx", ".css", ".scss", ".go", ".rs", ".java", ".cpp", ".c", ".h", ".md"}
             fallback = []
             for p in root.rglob("*"):
                 if not p.is_file() or p.suffix.lower() not in exts:
@@ -703,16 +706,32 @@ class SemanticSearcher:
                     text = p.read_text(encoding="utf-8", errors="ignore")
                 except Exception:
                     continue
-                idx = text.lower().find(q)
+
+                text_l = text.lower()
+                # Prefer exact phrase, fallback to token hits.
+                idx = text_l.find(q)
+                if idx < 0 and q_tokens:
+                    token_positions = [text_l.find(tok) for tok in q_tokens]
+                    token_positions = [pos for pos in token_positions if pos >= 0]
+                    if not token_positions:
+                        continue
+                    idx = min(token_positions)
+
                 if idx < 0:
                     continue
+
                 line_no = text[:idx].count("\n") + 1
                 snippet = _format_snippet(p, line_no, line_no, context=2, include_line_numbers=include_line_numbers)
-                fallback.append((rel, line_no, snippet))
-                if len(fallback) >= top_k:
-                    break
+                # crude relevance: token coverage in file text
+                coverage = 0
+                if q_tokens:
+                    coverage = sum(1 for tok in q_tokens if tok in text_l)
+                fallback.append((coverage, rel, line_no, snippet))
+
+            fallback.sort(key=lambda x: (-x[0], x[1]))
+            fallback = fallback[:top_k]
 
-            for i, (rel, line_no, snippet) in enumerate(fallback, start=1):
+            for i, (coverage, rel, line_no, snippet) in enumerate(fallback, start=1):
                 results.append({
                     "schema": "know.search.v1",
                     "engine": "text-fallback",
@@ -723,7 +742,7 @@ class SemanticSearcher:
                     "chunk_type": "line",
                     "start_line": line_no,
                     "end_line": line_no,
-                    "scores": {"rrf": 0.01, "lexical_bm25": None, "vector": None},
+                    "scores": {"rrf": 0.01 + min(0.01, 0.002 * coverage), "lexical_bm25": None, "vector": None},
                     "snippet": snippet,
                     "rationale": {"lexical_available": lexical_available, "vector_available": vector_available},
                 })
@@ -746,7 +765,7 @@ class SemanticSearcher:
         from know.context_engine import extract_chunks_from_file
 
         if extensions is None:
-            extensions = [".py", ".ts", ".tsx", ".js", ".jsx", ".go", ".rs", ".java", ".cpp", ".c", ".h"]
+            extensions = [".py", ".ts", ".tsx", ".js", ".jsx", ".css", ".scss", ".go", ".rs", ".java", ".cpp", ".c", ".h"]
 
         ignore_spec = None
         gitignore_path = root / ".gitignore"

know_cli-0.3.5/docs/arc.md

@@ -1,38 +0,0 @@
-# know-cli
-
-
-
-*Generated by [know](https://github.com/sushilk1991/know-cli)*
-
-
-## 📁 Project Structure
-
-- **[src.know.logger](src/know/logger.py)** - Logging configuration for know.
-- **[src.know.token_counter](src/know/token_counter.py)** - Token counting for context budget management.
-- **[src.know.semantic_search](src/know/semantic_search.py)** - Semantic code search using real embeddings and vector similarity.
-- **[src.know.ai](src/know/ai.py)** - AI integration for intelligent code understanding with advanced token optimization.
-- **[src.know.import_graph](src/know/import_graph.py)** - Import graph: tracks dependencies between project modules.
-- **[src.know.watcher](src/know/watcher.py)** - File system watcher for auto-updating documentation.
-- **[src.know.cli](src/know/cli.py)** - CLI entry point for know.
-- **[src.know.stats](src/know/stats.py)** - Usage statistics tracker for know-cli.
-- **[src.know.mcp_server](src/know/mcp_server.py)** - MCP (Model Context Protocol) server for know-cli.
-- **[src.know.exceptions](src/know/exceptions.py)** - Custom exceptions for know-cli.
-- **[src.know.diff](src/know/diff.py)** - Diff mode for tracking architectural changes safely using git worktrees.
-- **[src.know.generator](src/know/generator.py)** - Documentation generator.
-- **[src.know.parsers](src/know/parsers.py)** - Parser strategy pattern for language-specific parsing.
-- **[src.know.quality](src/know/quality.py)** - Code quality metrics and dashboard.
-- **[src.know.git_hooks](src/know/git_hooks.py)** - Git hook management.
-- ... and 7 more modules
-
-## 📊 Statistics
-
-- **Files:** 22
-- **Modules:** 22
-- **Functions:** 52
-- **Classes:** 44
-
----
-
-*Generated by [know](https://github.com/sushilk1991/know-cli) v1.0.0*
-
-Run `know update` to refresh this documentation.