mindsystem-cc 3.0.0

package/scripts/ms-lookup/ms_lookup/cache.py

@@ -0,0 +1,48 @@
+"""Caching layer using diskcache."""
+
+import hashlib
+from typing import Any
+
+import diskcache
+
+from ms_lookup.config import CACHE_DIR, CACHE_TTL_DOCS, CACHE_TTL_DEEP
+
+
+def _get_cache() -> diskcache.Cache:
+    """Get or create cache instance."""
+    CACHE_DIR.mkdir(parents=True, exist_ok=True)
+    return diskcache.Cache(str(CACHE_DIR))
+
+
+def _make_key(command: str, *args: str, max_tokens: int | None = None) -> str:
+    """Create cache key from command, args, and optionally max_tokens."""
+    key_parts = [command] + list(args)
+    if max_tokens is not None:
+        key_parts.append(str(max_tokens))
+    key_string = ":".join(key_parts)
+    key_hash = hashlib.sha256(key_string.encode()).hexdigest()[:16]
+    return f"{command}:{key_hash}"
+
+
+def get_cached(command: str, *args: str, max_tokens: int | None = None) -> Any | None:
+    """Get cached result if exists and not expired."""
+    cache = _get_cache()
+    key = _make_key(command, *args, max_tokens=max_tokens)
+    return cache.get(key)
+
+
+def set_cached(command: str, *args: str, max_tokens: int | None = None, value: Any) -> None:
+    """Cache a result with appropriate TTL."""
+    cache = _get_cache()
+    key = _make_key(command, *args, max_tokens=max_tokens)
+
+    # Select TTL based on command
+    ttl = CACHE_TTL_DOCS if command == "docs" else CACHE_TTL_DEEP
+
+    cache.set(key, value, expire=ttl)
+
+
+def clear_cache() -> None:
+    """Clear all cached entries."""
+    cache = _get_cache()
+    cache.clear()

package/scripts/ms-lookup/ms_lookup/cli.py

@@ -0,0 +1,219 @@
+"""Main CLI entry point for ms-lookup."""
+
+import sys
+from typing import Optional
+
+import typer
+
+from ms_lookup import __version__
+from ms_lookup.backends.context7 import Context7Client
+from ms_lookup.backends.perplexity import PerplexityClient
+from ms_lookup.cache import get_cached, set_cached
+from ms_lookup.config import DEFAULT_MAX_TOKENS
+from ms_lookup.errors import MsLookupError
+from ms_lookup.output import format_error, format_success, output_json
+from ms_lookup.tokens import estimate_tokens, truncate_results
+
+app = typer.Typer(
+    name="ms-lookup",
+    help="Mindsystem research CLI - Context7 docs and Perplexity deep research",
+    add_completion=False,
+)
+
+
+def version_callback(value: bool) -> None:
+    """Print version and exit."""
+    if value:
+        typer.echo(f"ms-lookup {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: Optional[bool] = typer.Option(
+        None,
+        "--version",
+        "-v",
+        callback=version_callback,
+        is_eager=True,
+        help="Show version and exit",
+    ),
+) -> None:
+    """Mindsystem research CLI - Context7 docs and Perplexity deep research."""
+    pass
+
+
+@app.command()
+def docs(
+    library: str = typer.Argument(..., help="Library name (e.g., 'nextjs', 'react')"),
+    query: str = typer.Argument(..., help="Documentation query"),
+    max_tokens: int = typer.Option(
+        DEFAULT_MAX_TOKENS,
+        "--max-tokens",
+        "-t",
+        help="Maximum tokens in response",
+    ),
+    no_cache: bool = typer.Option(
+        False,
+        "--no-cache",
+        help="Skip cache lookup",
+    ),
+    json_pretty: bool = typer.Option(
+        False,
+        "--json-pretty",
+        "-p",
+        help="Pretty-print JSON output",
+    ),
+) -> None:
+    """Query library documentation via Context7.
+
+    Use for authoritative, version-aware API documentation.
+
+    Examples:
+        ms-lookup docs nextjs "app router setup"
+        ms-lookup docs react "hooks useEffect cleanup"
+        ms-lookup docs "react-three-fiber" "physics integration"
+    """
+    command = "docs"
+
+    # Check cache first
+    if not no_cache:
+        cached = get_cached(command, library, query, max_tokens=max_tokens)
+        if cached is not None:
+            cached["metadata"]["cache_hit"] = True
+            typer.echo(output_json(cached, pretty=json_pretty))
+            return
+
+    try:
+        client = Context7Client()
+
+        # Resolve library name to ID
+        library_info = client.resolve_library(library, query)
+        library_id = library_info["library_id"]
+
+        # Query documentation
+        raw_response = client.query_docs(library_id, query)
+
+        # Format results
+        results = client.format_results(raw_response)
+        total_available = len(results)
+
+        # Truncate to token budget
+        truncated_results, tokens_used = truncate_results(results, max_tokens)
+
+        # Build response
+        metadata = {
+            "library_id": library_id,
+            "total_available": total_available,
+            "returned": len(truncated_results),
+            "tokens_used": tokens_used,
+            "max_tokens": max_tokens,
+            "cache_hit": False,
+            "confidence": "HIGH",
+            "backend": "context7",
+        }
+
+        response = format_success(
+            command=command,
+            query=query,
+            results=truncated_results,
+            metadata=metadata,
+            library=library,
+        )
+
+        # Cache result
+        if not no_cache:
+            set_cached(command, library, query, max_tokens=max_tokens, value=response)
+
+        typer.echo(output_json(response, pretty=json_pretty))
+
+    except MsLookupError as e:
+        error_response = format_error(command, e)
+        typer.echo(output_json(error_response, pretty=json_pretty))
+        raise typer.Exit(code=1)
+
+
+@app.command()
+def deep(
+    query: str = typer.Argument(..., help="Research query"),
+    no_cache: bool = typer.Option(
+        False,
+        "--no-cache",
+        help="Skip cache lookup",
+    ),
+    json_pretty: bool = typer.Option(
+        False,
+        "--json-pretty",
+        "-p",
+        help="Pretty-print JSON output",
+    ),
+) -> None:
+    """Perform research via Perplexity's reasoning model.
+
+    Uses chain-of-thought reasoning with web search to synthesize
+    actionable findings from multiple sources. Faster than exhaustive
+    deep research while maintaining quality.
+
+    Cost: ~$0.005 per query. Use for high-value technical questions.
+
+    Examples:
+        ms-lookup deep "authentication patterns for SaaS applications"
+        ms-lookup deep "WebGPU browser support and performance 2026"
+        ms-lookup deep "best practices for real-time collaboration"
+    """
+    command = "deep"
+
+    # Check cache first
+    if not no_cache:
+        cached = get_cached(command, query)
+        if cached is not None:
+            cached["metadata"]["cache_hit"] = True
+            typer.echo(output_json(cached, pretty=json_pretty))
+            return
+
+    try:
+        client = PerplexityClient()
+
+        # Perform research query
+        raw_response = client.query(query)
+
+        # Format results - no truncation for deep, output controlled via prompt
+        results, citations = client.format_results(raw_response)
+
+        # Calculate tokens for metadata (no truncation)
+        tokens_used = sum(estimate_tokens(r.get("content", "")) for r in results)
+
+        # Build response
+        metadata = {
+            "total_available": len(results),
+            "returned": len(results),
+            "tokens_used": tokens_used,
+            "cache_hit": False,
+            "confidence": "MEDIUM-HIGH",
+            "backend": "perplexity-reasoning",
+        }
+
+        if citations:
+            metadata["citations"] = citations
+
+        response = format_success(
+            command=command,
+            query=query,
+            results=results,
+            metadata=metadata,
+        )
+
+        # Cache result
+        if not no_cache:
+            set_cached(command, query, value=response)
+
+        typer.echo(output_json(response, pretty=json_pretty))
+
+    except MsLookupError as e:
+        error_response = format_error(command, e)
+        typer.echo(output_json(error_response, pretty=json_pretty))
+        raise typer.Exit(code=1)
+
+
+if __name__ == "__main__":
+    app()

package/scripts/ms-lookup/ms_lookup/config.py

@@ -0,0 +1,23 @@
+"""Configuration and environment variables."""
+
+import os
+from pathlib import Path
+
+# API Keys from environment
+CONTEXT7_API_KEY = os.environ.get("CONTEXT7_API_KEY", "")
+PERPLEXITY_API_KEY = os.environ.get("PERPLEXITY_API_KEY", "")
+
+# API URLs
+CONTEXT7_BASE_URL = "https://context7.com/api/v2"
+PERPLEXITY_BASE_URL = "https://api.perplexity.ai"
+
+# Cache configuration
+CACHE_DIR = Path.home() / ".cache" / "ms-lookup"
+CACHE_TTL_DOCS = 60 * 60 * 24  # 24 hours for docs
+CACHE_TTL_DEEP = 60 * 60 * 6   # 6 hours for deep research
+
+# Default token limits
+DEFAULT_MAX_TOKENS = 2000
+
+# Perplexity model - sonar-reasoning-pro for faster chain-of-thought research
+PERPLEXITY_DEEP_MODEL = "sonar-reasoning-pro"

package/scripts/ms-lookup/ms_lookup/errors.py

@@ -0,0 +1,24 @@
+"""Error codes and error handling."""
+
+from enum import Enum
+
+
+class ErrorCode(str, Enum):
+    """Error codes for CLI responses."""
+
+    MISSING_API_KEY = "MISSING_API_KEY"
+    LIBRARY_NOT_FOUND = "LIBRARY_NOT_FOUND"
+    API_ERROR = "API_ERROR"
+    RATE_LIMITED = "RATE_LIMITED"
+    NETWORK_ERROR = "NETWORK_ERROR"
+    INVALID_RESPONSE = "INVALID_RESPONSE"
+
+
+class MsLookupError(Exception):
+    """Base exception for ms-lookup errors."""
+
+    def __init__(self, code: ErrorCode, message: str, suggestions: list[str] | None = None):
+        self.code = code
+        self.message = message
+        self.suggestions = suggestions or []
+        super().__init__(message)

package/scripts/ms-lookup/ms_lookup/output.py

@@ -0,0 +1,49 @@
+"""JSON output formatting."""
+
+import json
+from typing import Any
+
+from ms_lookup.errors import MsLookupError
+
+
+def format_success(
+    command: str,
+    query: str,
+    results: list[dict],
+    metadata: dict,
+    library: str | None = None,
+) -> dict:
+    """Format successful response."""
+    response = {
+        "success": True,
+        "command": command,
+        "query": query,
+        "results": results,
+        "metadata": metadata,
+    }
+    if library:
+        response["library"] = library
+    return response
+
+
+def format_error(command: str, error: MsLookupError) -> dict:
+    """Format error response."""
+    error_dict: dict[str, Any] = {
+        "code": error.code.value,
+        "message": error.message,
+    }
+    if error.suggestions:
+        error_dict["suggestions"] = error.suggestions
+
+    return {
+        "success": False,
+        "command": command,
+        "error": error_dict,
+    }
+
+
+def output_json(data: dict, pretty: bool = False) -> str:
+    """Convert data to JSON string."""
+    if pretty:
+        return json.dumps(data, indent=2, ensure_ascii=False)
+    return json.dumps(data, ensure_ascii=False)

package/scripts/ms-lookup/ms_lookup/tokens.py

@@ -0,0 +1,56 @@
+"""Token estimation and truncation utilities."""
+
+
+def estimate_tokens(text: str) -> int:
+    """Estimate token count using word count * 1.3."""
+    if not text:
+        return 0
+    word_count = len(text.split())
+    return int(word_count * 1.3)
+
+
+def truncate_results(results: list[dict], max_tokens: int) -> tuple[list[dict], int]:
+    """Truncate results to fit within token budget.
+
+    Args:
+        results: List of result dicts with 'content' field
+        max_tokens: Maximum token budget
+
+    Returns:
+        Tuple of (truncated_results, total_tokens_used)
+    """
+    truncated = []
+    tokens_used = 0
+
+    for result in results:
+        content = result.get("content", "")
+        result_tokens = estimate_tokens(content)
+
+        # Add metadata overhead estimate (title, url, etc.)
+        overhead = 50
+        total_result_tokens = result_tokens + overhead
+
+        if tokens_used + total_result_tokens <= max_tokens:
+            result_with_tokens = {**result, "tokens": result_tokens}
+            truncated.append(result_with_tokens)
+            tokens_used += total_result_tokens
+        else:
+            # Try to fit partial content if we have room
+            remaining = max_tokens - tokens_used - overhead
+            if remaining > 100:  # Only include if meaningful content fits
+                words = content.split()
+                truncated_word_count = int(remaining / 1.3)
+                if truncated_word_count > 0:
+                    truncated_content = " ".join(words[:truncated_word_count]) + "..."
+                    truncated_tokens = estimate_tokens(truncated_content)
+                    result_with_tokens = {
+                        **result,
+                        "content": truncated_content,
+                        "tokens": truncated_tokens,
+                        "truncated": True
+                    }
+                    truncated.append(result_with_tokens)
+                    tokens_used += truncated_tokens + overhead
+            break
+
+    return truncated, tokens_used

package/scripts/ms-lookup/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "ms-lookup"
+version = "1.0.0"
+description = "CLI tool for Mindsystem research - Context7 docs and Perplexity deep research"
+requires-python = ">=3.10"
+dependencies = [
+    "typer>=0.9.0",
+    "httpx>=0.25.0",
+    "diskcache>=5.6.0",
+]
+
+[project.scripts]
+ms-lookup = "ms_lookup.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

package/scripts/ms-lookup/uv.lock

@@ -0,0 +1,207 @@
+version = 1
+revision = 3
+requires-python = ">=3.10"
+
+[[package]]
+name = "anyio"
+version = "4.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "diskcache"
+version = "5.6.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3f/21/1c1ffc1a039ddcc459db43cc108658f32c57d271d7289a2794e401d0fdb6/diskcache-5.6.3.tar.gz", hash = "sha256:2c3a3fa2743d8535d832ec61c2054a1641f41775aa7c556758a109941e33e4fc", size = 67916, upload-time = "2023-08-31T06:12:00.316Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3f/27/4570e78fc0bf5ea0ca45eb1de3818a23787af9b390c0b0a0033a1b8236f9/diskcache-5.6.3-py3-none-any.whl", hash = "sha256:5e31b2d5fbad117cc363ebaf6b689474db18a1f6438bc82358b024abd4c2ca19", size = 45550, upload-time = "2023-08-31T06:11:58.822Z" },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740, upload-time = "2025-11-21T23:01:53.443Z" },
+]
+
+[[package]]
+name = "gsd-lookup"
+version = "1.0.0"
+source = { editable = "." }
+dependencies = [
+    { name = "diskcache" },
+    { name = "httpx" },
+    { name = "typer" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "diskcache", specifier = ">=5.6.0" },
+    { name = "httpx", specifier = ">=0.25.0" },
+    { name = "typer", specifier = ">=0.9.0" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fb/d2/8920e102050a0de7bfabeb4c4614a49248cf8d5d7a8d01885fbb24dc767a/rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4", size = 219990, upload-time = "2025-10-09T14:16:53.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.21.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "rich" },
+    { name = "shellingham" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/bf/8825b5929afd84d0dabd606c67cd57b8388cb3ec385f7ef19c5cc2202069/typer-0.21.1.tar.gz", hash = "sha256:ea835607cd752343b6b2b7ce676893e5a0324082268b48f27aa058bdb7d2145d", size = 110371, upload-time = "2026-01-06T11:21:10.989Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/1d/d9257dd49ff2ca23ea5f132edf1281a0c4f9de8a762b9ae399b670a59235/typer-0.21.1-py3-none-any.whl", hash = "sha256:7985e89081c636b88d172c2ee0cfe33c253160994d47bdfdc302defd7d1f1d01", size = 47381, upload-time = "2026-01-06T11:21:09.824Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]

package/scripts/ms-lookup-wrapper.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Wrapper script for ms-lookup CLI
+# Handles uv/pip installation transparently
+
+# Source uv environment if available
+if [ -f "$HOME/.local/bin/env" ]; then
+  source "$HOME/.local/bin/env"
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR/ms-lookup"
+
+if command -v uv &> /dev/null; then
+  # Prefer uv if available (faster)
+  uv sync --quiet 2>/dev/null
+  uv run python -m ms_lookup "$@"
+else
+  # Fall back to pip
+  pip install -q -e . 2>/dev/null
+  python3 -m ms_lookup "$@"
+fi