minder-cli 0.3.6__tar.gz → 0.4.0__tar.gz

{minder_cli-0.3.6 → minder_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minder-cli
-Version: 0.3.6
+Version: 0.4.0
 Summary: Minder CLI is the command-line interface for the Minder self-hosted MCP platform.
 Project-URL: Homepage, https://github.com/hiimtrung/minder
 Project-URL: Repository, https://github.com/hiimtrung/minder
@@ -37,83 +37,99 @@ Requires-Dist: zipp>=3.21.0; extra == 'server'
 Requires-Dist: zstandard>=0.25.0; extra == 'server'
 Description-Content-Type: text/markdown
 
-# minder-cli
+# Minder
 
 [![PyPI version](https://img.shields.io/pypi/v/minder-cli.svg)](https://pypi.org/project/minder-cli/)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**minder-cli** is the command-line interface for [Minder](https://github.com/hiimtrung/minder) — a self-hosted MCP platform for repository-aware engineering intelligence.
+**Minder** is a self-hosted MCP (Model Context Protocol) platform for repository-aware engineering intelligence.
 
-The CLI handles IDE scaffolding, repository sync, authentication, and self-updates. It connects to a **Minder Server** which runs the MCP gateway, RAG pipeline, memory engine, and admin console.
+It combines a local-first inference stack, a persistent memory and workflow engine, and a developer-facing CLI into a single deployable unit.
 
-## Installation
+## What's in this repo
 
-```bash
-# Recommended
-uv tool install minder-cli
+| Component | Description |
+|-----------|-------------|
+| **Minder Server** | MCP gateway — SSE + stdio transport, RAG pipeline, workflow engine, memory, admin HTTP |
+| **Minder CLI** (`minder-cli` on PyPI) | Edge CLI — IDE scaffold, repo sync, login, self-update |
+| **Minder Dashboard** | Astro admin console — client management, onboarding, skill catalog |
 
-# Alternative
-pipx install minder-cli
-```
+## Architecture
 
-## Requirements
+```
+Developer → minder-cli → Minder Server ←→ AI agents (Codex / Copilot / Claude)
+                              │
+               ┌──────────────┼──────────────┐
+               │              │              │
+           MongoDB          Redis         Milvus
+         (graph/memory)   (cache)      (vector search)
+               │
+          ┌─────┴──────┐
+          │            │
+       LiteRT-LM    FastEmbed
+       (LLM gen)   (embedding)
+```
 
-A running [Minder Server](https://github.com/hiimtrung/minder) — see the [server setup guide](https://github.com/hiimtrung/minder/blob/main/docs/minder-server.md) to get one running in minutes with Docker.
+- **LLM inference**: LiteRT-LM (Google AI Edge) — on-device, hardware-accelerated, no HTTP overhead
+- **Embedding inference**: FastEmbed running natively in-process (`mxbai-embed-large-v1`) — zero-dependency ONNX acceleration
 
 ## Quick Start
 
-### 1. Connect to your server
+### Run the server
 
 ```bash
-minder login --client-key mkc_your_client_key --server-url http://localhost:8800/sse
+# 1. Download the LiteRT-LM model
+./scripts/download_models.sh
+
+# 2. Start infra (MongoDB + Redis + Milvus)
+docker compose -f docker/docker-compose.local.yml up -d
+
+# 3. Run Minder Server
+uv run python -m minder.server
 ```
 
-### 2. Set up IDE integration
+Or use the one-command release installer (Docker only, no local uv needed):
 
 ```bash
-# In your project root — scaffolds MCP config for your editor
-minder install-ide --target vscode --target claude-code
+curl -fsSL https://raw.githubusercontent.com/hiimtrung/minder/main/scripts/release/install-minder-release.sh | bash
 ```
 
-Supported targets: `vscode`, `cursor`, `claude-code`.
-
-### 3. Sync a repository
+### Connect the CLI
 
 ```bash
-minder sync --repo-id <repository-uuid>
-```
+# Install
+uv tool install minder-cli
 
-Indexes code and documentation so AI agents can use semantic search and RAG tools.
+# Log in with your client key
+minder login --client-key mkc_your_key --server-url http://localhost:8800/sse
 
-## Commands
+# Set up IDE integration (VS Code, Cursor, Claude Code)
+minder install-ide --target vscode --target claude-code
 
-| Command | Description |
-|---------|-------------|
-| `minder login` | Authenticate the CLI against a Minder Server |
-| `minder install-ide` | Scaffold MCP assets for VS Code / Cursor / Claude Code |
-| `minder sync` | Index a repository into the Minder Server |
-| `minder check-update` | Check for available CLI and server updates |
-| `minder self-update` | Update CLI or server in place |
+# Sync a repository
+minder sync --repo-id <uuid>
+```
 
-## MCP Tools (once connected)
+## MCP Tools
 
-Your AI agents will have access to:
+When connected, Minder exposes these tools to your AI agents:
 
 | Tool | Description |
 |------|-------------|
 | `minder_query` | Full RAG pipeline: retrieve → reason → verify → respond |
-| `minder_search_code` | Semantic code search across indexed repositories |
+| `minder_search_code` | Semantic code search across indexed repos |
 | `minder_memory_recall` | Retrieve persisted engineering memory |
 | `minder_workflow_get` | Read current workflow state |
 | `minder_session_restore` | Restore session continuity across context windows |
 
-## Links
+## Documentation
 
-- [GitHub Repository](https://github.com/hiimtrung/minder)
-- [Server Setup Guide](https://github.com/hiimtrung/minder/blob/main/docs/minder-server.md)
-- [Local Dev Setup](https://github.com/hiimtrung/minder/blob/main/docs/guides/local-setup.md)
-- [System Design](https://github.com/hiimtrung/minder/blob/main/docs/system-design.md)
+- [System Design](docs/system-design.md)
+- [Server Setup](docs/minder-server.md)
+- [Local Dev Setup](docs/guides/local-setup.md)
+- [Production Deployment](docs/guides/production-deployment.md)
+- [Admin & Client Onboarding](docs/guides/admin-client-onboarding.md)
 
 ## License
 
-Apache License 2.0. See [LICENSE](https://github.com/hiimtrung/minder/blob/main/LICENSE) for details.
+Apache License 2.0. See [LICENSE](LICENSE) for details.

{minder_cli-0.3.6 → minder_cli-0.4.0}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "minder-cli"
-version = "0.3.6"
+version = "0.4.0"
 description = "Minder CLI is the command-line interface for the Minder self-hosted MCP platform."
-readme = "README-pypi.md"
+readme = "README.md"
 requires-python = ">=3.14"
 keywords = ["mcp", "cli", "ai", "code-search", "workflow"]
 classifiers = [

{minder_cli-0.3.6 → minder_cli-0.4.0}/src/minder/presentation/cli/commands/update.py

@@ -35,7 +35,7 @@ def version_command(args: argparse.Namespace) -> int:
             else:
                 print("  status: up to date")
     else:
-        print("minder version unknown (not installed as a package)")
+        print("minder-cli version unknown (not installed as a package)")
     return 0
 
 
@@ -109,15 +109,15 @@ def check_update_command(args: argparse.Namespace) -> int:
 
 def _cli_update_commands(manager: str) -> list[list[str]]:
     if manager == "uv":
-        return [["uv", "tool", "upgrade", "minder"]]
+        return [["uv", "tool", "upgrade", "minder-cli"]]
     if manager == "pipx":
-        return [["pipx", "upgrade", "minder"]]
+        return [["pipx", "upgrade", "minder-cli"]]
     if manager == "pip":
-        return [[sys.executable, "-m", "pip", "install", "--upgrade", "minder"]]
+        return [[sys.executable, "-m", "pip", "install", "--upgrade", "minder-cli"]]
     return [
-        ["uv", "tool", "upgrade", "minder"],
-        ["pipx", "upgrade", "minder"],
-        [sys.executable, "-m", "pip", "install", "--upgrade", "minder"],
+        ["uv", "tool", "upgrade", "minder-cli"],
+        ["pipx", "upgrade", "minder-cli"],
+        [sys.executable, "-m", "pip", "install", "--upgrade", "minder-cli"],
     ]
 
 

{minder_cli-0.3.6 → minder_cli-0.4.0}/src/minder/presentation/cli/utils/version.py

@@ -6,11 +6,12 @@ from importlib.metadata import (
     version as package_version,
 )
 
+from pathlib import Path
 import httpx
 
 logger = logging.getLogger(__name__)
 
-_PYPI_JSON_URL = "https://pypi.org/pypi/minder/json"
+_PYPI_JSON_URL = "https://pypi.org/pypi/minder-cli/json"
 
 
 def parse_version(raw_version: str) -> tuple[int, ...]:
@@ -26,8 +27,20 @@ def parse_version(raw_version: str) -> tuple[int, ...]:
 
 def installed_package_version() -> str | None:
     try:
-        return package_version("minder")
+        return package_version("minder-cli")
     except PackageNotFoundError:
+        # Fallback for development mode: try to read from pyproject.toml
+        try:
+            # Look for pyproject.toml in the repo root (5 levels up from this file)
+            pyproject_path = Path(__file__).parents[5] / "pyproject.toml"
+            if pyproject_path.exists():
+                content = pyproject_path.read_text()
+                import re
+                match = re.search(r'^version\s*=\s*["\']([^"\']+)["\']', content, re.MULTILINE)
+                if match:
+                    return match.group(1) + "-dev"
+        except Exception:
+            pass
         return None
 
 

{minder_cli-0.3.6 → minder_cli-0.4.0}/src/minder/tools/repo_scanner.py

@@ -132,6 +132,7 @@ class RepoScanner:
         self._git_metadata_cache: dict[str, dict[str, Any]] = {}
         self._git_line_commit_cache: dict[tuple[str, int], dict[str, str] | None] = {}
         self._git_commit_detail_cache: dict[str, dict[str, str]] = {}
+        self._git_file_blame_cache: dict[str, dict[int, str]] = {}
         self._git_enabled = True
 
     def _run_git(
@@ -280,6 +281,7 @@ class RepoScanner:
         builder._git_metadata_cache = {}
         builder._git_line_commit_cache = {}
         builder._git_commit_detail_cache = {}
+        builder._git_file_blame_cache = {}
         builder._git_enabled = True
 
         service_dirs = builder._discover_service_boundaries()
@@ -374,24 +376,21 @@ class RepoScanner:
         }
 
     def _discover_service_boundaries(self) -> list[Path]:
-        service_dirs: list[Path] = []
-        for marker in _SERVICE_MARKERS:
-            for marker_path in self._root.rglob(marker):
-                if any(part.startswith(".") for part in marker_path.parts):
-                    continue
-                svc_dir = marker_path.parent
-                if svc_dir not in service_dirs:
-                    service_dirs.append(svc_dir)
-        return sorted(service_dirs, key=lambda path: len(path.parts), reverse=True)
+        service_dirs: set[Path] = set()
+        for path in self._root.rglob("*"):
+            if any(part.startswith(".") for part in path.parts):
+                continue
+            if path.is_file() and path.name in _SERVICE_MARKERS:
+                service_dirs.add(path.parent)
+        return sorted(list(service_dirs), key=lambda path: len(path.parts), reverse=True)
 
     def _discover_source_files(self) -> list[Path]:
         files: list[Path] = []
-        for suffix in _SOURCE_SUFFIXES:
-            for path in self._root.rglob(f"*{suffix}"):
-                if any(part.startswith(".") or part == "__pycache__" for part in path.parts):
-                    continue
-                if path.is_file():
-                    files.append(path)
+        for path in self._root.rglob("*"):
+            if any(part.startswith(".") or part == "__pycache__" for part in path.parts):
+                continue
+            if path.is_file() and path.suffix.lower() in _SOURCE_SUFFIXES:
+                files.append(path)
         return sorted(set(files))
 
     def _resolve_source_files(self, changed_files: list[str] | None) -> list[Path]:
@@ -579,34 +578,32 @@ class RepoScanner:
         return commits
 
     def _git_line_commit(self, rel_path: str, line_number: int) -> dict[str, str] | None:
-        cache_key = (rel_path, line_number)
-        if cache_key in self._git_line_commit_cache:
-            return self._git_line_commit_cache[cache_key]
-
-        result = self._run_git(
-            [
-                "blame",
-                "--line-porcelain",
-                "-L",
-                f"{line_number},{line_number}",
-                "--",
-                rel_path,
-            ],
-            check=False,
-        )
-        if result.returncode != 0:
-            self._git_line_commit_cache[cache_key] = None
-            return None
-
-        first_line = next((line for line in result.stdout.splitlines() if line.strip()), "")
-        sha = first_line.split(" ", 1)[0].strip()
-        if not sha or set(sha) == {"0"}:
-            self._git_line_commit_cache[cache_key] = None
+        if rel_path not in self._git_file_blame_cache:
+            result = self._run_git(["blame", "--line-porcelain", "--", rel_path], check=False)
+            if result.returncode != 0:
+                self._git_file_blame_cache[rel_path] = {}
+            else:
+                blame_data: dict[int, str] = {}
+                current_sha = None
+                for line in result.stdout.splitlines():
+                    if not line:
+                        continue
+                    if current_sha is None:
+                        current_sha = line.split(" ", 1)[0]
+                    elif line.startswith("\t"):
+                        # This line indicates the end of a porcelain block
+                        current_sha = None
+                    elif line.startswith("result-line "):
+                        target_line = int(line.split(" ")[1])
+                        if current_sha and set(current_sha) != {"0"}:
+                            blame_data[target_line] = current_sha
+                self._git_file_blame_cache[rel_path] = blame_data
+
+        sha = self._git_file_blame_cache.get(rel_path, {}).get(line_number)
+        if not sha:
             return None
 
-        details = self._git_commit_details(sha)
-        self._git_line_commit_cache[cache_key] = details
-        return details
+        return self._git_commit_details(sha)
 
     def _git_commit_details(self, sha: str) -> dict[str, str]:
         cached = self._git_commit_detail_cache.get(sha)