contextual-engine 0.2.0__tar.gz → 0.8.1__tar.gz

{contextual_engine-0.2.0 → contextual_engine-0.8.1}/.github/workflows/release.yml

@@ -32,8 +32,6 @@ jobs:
       
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          password: ${{ secrets.PYPI_API_TOKEN }}
       
       - name: Extract version from tag
         id: version

contextual_engine-0.8.1/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "contextual": {
+      "command": "/Users/apple/TechStack/Projects/Contextual/.venv/bin/contextual-mcp",
+      "args": ["--workspace", "/Users/apple/TechStack/Projects/Contextual"]
+    }
+  }
+}

{contextual_engine-0.2.0 → contextual_engine-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contextual-engine
-Version: 0.2.0
+Version: 0.8.1
 Summary: Temporal-first local code memory for AI tools via MCP
 Project-URL: Homepage, https://contextuallabs.dev
 Project-URL: Documentation, https://contextuallabs.dev/docs
@@ -120,63 +120,77 @@ License: BUSINESS SOURCE LICENSE 1.1
         ---
 License-File: LICENSE
 Keywords: ai,code-search,developer-tools,embeddings,local-first,mcp,temporal
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Text Processing :: Indexing
 Classifier: Typing :: Typed
-Requires-Python: <3.15,>=3.12
+Requires-Python: <3.14,>=3.12
 Requires-Dist: blake3>=0.4.1
+Requires-Dist: docutils>=0.21
+Requires-Dist: dulwich>=0.21
 Requires-Dist: einops>=0.7
 Requires-Dist: fastmcp<4,>=3.2
+Requires-Dist: httpx[http2]>=0.27.0
 Requires-Dist: huggingface-hub>=0.23
 Requires-Dist: lancedb<0.31,>=0.26
+Requires-Dist: markdown-it-py>=4.0
+Requires-Dist: mdit-py-plugins
 Requires-Dist: numpy>=1.26
+Requires-Dist: opentelemetry-api>=1.24.0
+Requires-Dist: opentelemetry-sdk>=1.24.0
 Requires-Dist: pathspec>=0.10
 Requires-Dist: platformdirs>=3.3
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: pyarrow>=14.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: pygit2>=1.15
+Requires-Dist: python-frontmatter
+Requires-Dist: rapidfuzz>=3
 Requires-Dist: rich>=13.0
 Requires-Dist: safetensors>=0.4.3
 Requires-Dist: sentence-transformers>=3.0
 Requires-Dist: simsimd<6,>=3.9
-Requires-Dist: sqlite-vec>=0.1.1
+Requires-Dist: starlette>=0.37
 Requires-Dist: structlog>=25.4
 Requires-Dist: tantivy>=0.20.1
 Requires-Dist: tenacity>=8.0
 Requires-Dist: tiktoken>=0.5
 Requires-Dist: tokenizers<=0.23.0,>=0.19
+Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: torch>=2.2
 Requires-Dist: transformers<4.60,>=4.40
 Requires-Dist: tree-sitter-language-pack>=0.7.2
 Requires-Dist: typer<1.0,>=0.9
+Requires-Dist: uvicorn>=0.27
 Requires-Dist: watchdog>=4.0
 Provides-Extra: benchmark
 Requires-Dist: coir-eval; extra == 'benchmark'
 Requires-Dist: ranx>=0.3; extra == 'benchmark'
 Provides-Extra: dev
 Requires-Dist: build>=1.0; extra == 'dev'
-Requires-Dist: docutils>=0.21; extra == 'dev'
-Requires-Dist: markdown-it-py>=4.0; extra == 'dev'
-Requires-Dist: mdit-py-plugins; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
-Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0; extra == 'dev'
-Requires-Dist: pytest-xdist>=3.0; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: python-frontmatter; extra == 'dev'
-Requires-Dist: ranx>=0.3; extra == 'dev'
-Requires-Dist: rapidfuzz>=3; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Requires-Dist: twine>=5.0; extra == 'dev'
 Provides-Extra: mps
 Requires-Dist: torch>=2.4.0; extra == 'mps'
 Requires-Dist: torchvision>=0.19.0; extra == 'mps'
+Provides-Extra: test
+Requires-Dist: anyio[trio]>=4.3.0; extra == 'test'
+Requires-Dist: freezegun>=1.5.0; extra == 'test'
+Requires-Dist: hypothesis>=6.100.0; extra == 'test'
+Requires-Dist: polyfactory>=2.16.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-benchmark>=4.0.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest-xdist>=3.5.0; extra == 'test'
+Requires-Dist: pytest>=8.3.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
 Description-Content-Type: text/markdown
 
 # Contextual
@@ -184,8 +198,8 @@ Description-Content-Type: text/markdown
 **Local-first temporal semantic code memory engine for AI tools**
 
 [![PyPI](https://img.shields.io/pypi/v/contextual-engine)](https://pypi.org/project/contextual-engine/)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-BUSL%201.1-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
 
 ## What is Contextual?
 
@@ -252,4 +266,5 @@ Add to your AI tool's MCP config:
 
 ## License
 
-Apache 2.0
+Business Source License 1.1 (BUSL-1.1) — see [LICENSE](LICENSE) for the full
+terms, including the Additional Use Grant and the Change Date / Change License.

{contextual_engine-0.2.0 → contextual_engine-0.8.1}/README.md

@@ -3,8 +3,8 @@
 **Local-first temporal semantic code memory engine for AI tools**
 
 [![PyPI](https://img.shields.io/pypi/v/contextual-engine)](https://pypi.org/project/contextual-engine/)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-BUSL%201.1-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/downloads/)
 
 ## What is Contextual?
 
@@ -71,4 +71,5 @@ Add to your AI tool's MCP config:
 
 ## License
 
-Apache 2.0
+Business Source License 1.1 (BUSL-1.1) — see [LICENSE](LICENSE) for the full
+terms, including the Additional Use Grant and the Change Date / Change License.

{contextual_engine-0.2.0 → contextual_engine-0.8.1}/contextual/__init__.py

@@ -6,9 +6,15 @@ through bi-temporal fact tracking and deterministic retrieval.
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+try:
+    __version__ = _pkg_version("contextual-engine")
+except PackageNotFoundError:
+    __version__ = "0.0.0+dev"
+
 __author__ = "Contextual Team"
-__license__ = "BSL-1.1"
+__license__ = "BUSL-1.1"
 
 # Public API exports will be added as modules are built
 __all__ = [

contextual_engine-0.8.1/contextual/__main__.py

@@ -0,0 +1,8 @@
+"""Package entrypoint for `python -m contextual`."""
+
+from __future__ import annotations
+
+from contextual.cli import main
+
+if __name__ == "__main__":
+    main()

contextual_engine-0.8.1/contextual/cli/__init__.py

@@ -0,0 +1,271 @@
+"""
+Contextual CLI - Auto-discovering command-line interface.
+
+Commands are registered via @register_command decorator and automatically
+discovered at import time. No manual wiring required.
+"""
+
+import asyncio
+import inspect
+import shutil
+import sys
+from functools import wraps
+from pathlib import Path
+from typing import Any
+
+import typer
+
+from contextual.cli import commands
+from contextual.cli.core.decorators import _COMMAND_REGISTRY
+from contextual.cli.core.output import (
+    print_error,
+    print_reset_start,
+    print_reset_success,
+    print_version,
+)
+
+from contextual import __version__  # single source: pyproject.toml via importlib.metadata
+
+# ── Brand theme: override Typer's default Rich help colors ────────────
+# Must run before typer.Typer() is instantiated.
+try:
+    try:
+        import typer.rich_utils as _ru
+    except ImportError:
+        import typer._rich_utils as _ru
+
+    _ru.STYLE_OPTION                  = "white"
+    _ru.STYLE_SWITCH                  = "white"
+    _ru.STYLE_NEGATIVE_OPTION         = "white"
+    _ru.STYLE_NEGATIVE_SWITCH         = "white"
+    _ru.STYLE_METAVAR                 = "#6b6b6b"
+    _ru.STYLE_METAVAR_SEPARATOR       = "#6b6b6b"
+    _ru.STYLE_USAGE                   = "white bold"
+    _ru.STYLE_USAGE_COMMAND           = "white"
+    _ru.STYLE_HELPTEXT_FIRST_LINE     = "white"
+    _ru.STYLE_HELPTEXT                = "#6b6b6b"
+    _ru.STYLE_OPTION_HELP             = "#6b6b6b"
+    _ru.STYLE_OPTION_DEFAULT          = "#6b6b6b"
+    _ru.STYLE_OPTION_ENVVAR           = "#6b6b6b"
+    _ru.STYLE_REQUIRED_SHORT          = "white bold"
+    _ru.STYLE_REQUIRED_LONG           = "white bold"
+    _ru.STYLE_DEPRECATED_COMMAND      = "#6b6b6b"
+    _ru.STYLE_ERRORS_PANEL_BORDER     = "white"
+    _ru.STYLE_ERRORS_SUGGESTION       = "#6b6b6b"
+    _ru.STYLE_ERRORS_SUGGESTION_COMMAND = "white bold"
+    _ru.STYLE_ABORTED                 = "#6b6b6b"
+    
+    # Custom additions to ensure no yellow/cyan is shown
+    _ru.STYLE_COMMANDS_TABLE_FIRST_COLUMN = "white"
+    _ru.STYLE_DEPRECATED = "#6b6b6b"
+except (ImportError, AttributeError):
+    pass  # Graceful — if Typer internals change, don't crash
+# ─────────────────────────────────────────────────────────────────────
+
+# Create main Typer app
+app = typer.Typer(
+    name="contextual",
+    help="Local-first temporal semantic code memory engine",
+    add_completion=False,
+    no_args_is_help=True,
+)
+
+
+@app.callback(invoke_without_command=True)
+def _root_callback(
+    ctx: typer.Context,
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-V",
+        help="Show version and exit.",
+        is_eager=True,
+    ),
+    reset: bool = typer.Option(
+        False,
+        "--reset",
+        help="Reset the current workspace .contextual directory and reinitialise.",
+        is_eager=True,
+    ),
+    purge: bool = typer.Option(
+        False,
+        "--purge",
+        help="Nuclear: delete workspace, deregister globally, remove from MCP configs.",
+        is_eager=True,
+    ),
+) -> None:
+    """Local-first temporal semantic code memory engine."""
+    if version:
+        print_version(__version__)
+        raise typer.Exit()
+
+    if reset:
+        workspace_dir = Path.cwd()
+        contextual_dir = workspace_dir / ".contextual"
+
+        print_reset_start(str(workspace_dir))
+
+        try:
+            shutil.rmtree(contextual_dir, ignore_errors=False)
+        except FileNotFoundError:
+            pass
+        except Exception as e:
+            print_error(f"Failed to purge workspace: {e}")
+            raise typer.Exit(1) from e
+
+        from contextual.cli.commands.initialisation import init as init_workspace
+
+        try:
+            loop = get_shared_loop()
+            loop.run_until_complete(init_workspace("."))
+            # Fresh state — nothing indexed yet. Write valid JSON ("{}"), not an
+            # empty file, so stats/workspace readers parse it as "never indexed"
+            # instead of hitting a JSONDecodeError.
+            (contextual_dir / "state.json").write_text("{}\n", encoding="utf-8")
+        except Exception as e:
+            print_error(f"Failed to reinitialise workspace: {e}")
+            raise typer.Exit(1) from e
+
+        print_reset_success(str(workspace_dir))
+        raise typer.Exit()
+
+    if purge:
+        from contextual.cli.core.output import (
+            print_error,
+            print_purge_complete,
+            print_purge_warning,
+            print_warning,
+        )
+
+        workspace_dir = Path.cwd()
+        workspace_name = workspace_dir.name
+        contextual_dir = workspace_dir / ".contextual"
+
+        print_purge_warning(workspace_name)
+
+        confirm = typer.prompt("Type workspace name to confirm")
+        if confirm.strip() != workspace_name:
+            print_error("Name mismatch. Aborted. Nothing was deleted.")
+            raise typer.Exit(1)
+
+        # 1. Stop daemon if running for this workspace
+        try:
+            from contextual.mcp.daemon import read_lock, stop_daemon
+            if read_lock():
+                stop_daemon()
+        except Exception:
+            pass
+
+        # 2. Read workspace_id before deleting (needed for deregistration)
+        workspace_id: str | None = None
+        try:
+            import tomllib
+            ws_config = contextual_dir / "config.toml"
+            if ws_config.exists():
+                with open(ws_config, "rb") as f:
+                    ws_cfg = tomllib.load(f)
+                workspace_id = ws_cfg.get("workspace", {}).get("workspace_id")
+        except Exception:
+            pass
+
+        # 3. Delete .contextual/ directory
+        try:
+            shutil.rmtree(contextual_dir, ignore_errors=False)
+        except FileNotFoundError:
+            pass
+        except Exception as e:
+            print_error(f"Failed to delete workspace directory: {e}")
+            raise typer.Exit(1) from e
+
+        # 4. Deregister from global registry
+        if workspace_id:
+            try:
+                from contextual.storage import deregister_workspace
+                loop = get_shared_loop()
+                loop.run_until_complete(deregister_workspace(workspace_id))
+            except Exception:
+                print_warning(
+                    "Could not remove the workspace from the global registry. "
+                    "Run 'contextual workspace list' to verify."
+                )
+
+        print_purge_complete(workspace_name)
+        raise typer.Exit()
+
+
+_SHARED_LOOP: asyncio.AbstractEventLoop | None = None
+
+
+def get_shared_loop() -> asyncio.AbstractEventLoop:
+    global _SHARED_LOOP
+    if _SHARED_LOOP is None or _SHARED_LOOP.is_closed():
+        _SHARED_LOOP = asyncio.new_event_loop()
+        asyncio.set_event_loop(_SHARED_LOOP)
+    return _SHARED_LOOP
+
+
+def make_sync(func: Any) -> Any:
+    """Wrap async function in a synchronous runner sharing one loop."""
+    if not inspect.iscoroutinefunction(func):
+        return func
+
+    @wraps(func)
+    def wrapper(*args: Any, **kwargs: Any) -> Any:
+        loop = get_shared_loop()
+        return loop.run_until_complete(func(*args, **kwargs))
+
+    return wrapper
+
+
+# Build command structure
+_groups: dict[str, typer.Typer] = {}
+
+for group_name, cmd_name, cmd_help, command_func in _COMMAND_REGISTRY:
+    # Derive CLI name: explicit name wins, else function name
+    fn_name = getattr(command_func, "__name__", str(command_func))
+    cli_name = cmd_name or fn_name.replace("_", "-")
+
+    # Strip group prefix from function name if no explicit name given
+    # e.g. mcp_status under group="mcp" → "status" not "mcp-status"
+    if cmd_name is None and group_name and fn_name.startswith(group_name + "_"):
+        cli_name = fn_name[len(group_name) + 1:].replace("_", "-")
+
+    sync_func = make_sync(command_func)
+
+    kwargs: dict[str, Any] = {}
+    if cmd_help:
+        kwargs["help"] = cmd_help
+
+    if group_name is None:
+        app.command(name=cli_name, **kwargs)(sync_func)
+    else:
+        if group_name not in _groups:
+            _groups[group_name] = typer.Typer(
+                help=f"{group_name.title()} commands",
+                no_args_is_help=True,
+            )
+            app.add_typer(_groups[group_name], name=group_name)
+        if cli_name == group_name:
+            _groups[group_name].callback(invoke_without_command=True, **kwargs)(sync_func)
+        else:
+            _groups[group_name].command(name=cli_name, **kwargs)(sync_func)
+
+
+# CLI entry point (called from __main__.py)
+def main() -> None:
+    """Main CLI entry point."""
+    from contextual.observability import ObservabilityConfig
+    from contextual.observability.logging import configure_logging
+
+    configure_logging(ObservabilityConfig(log_level="WARNING"))
+    try:
+        app()
+    except KeyboardInterrupt:
+        sys.exit(130)
+    except Exception as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

contextual_engine-0.8.1/contextual/cli/commands/__init__.py

@@ -0,0 +1,35 @@
+"""
+Auto-import all command modules.
+
+This file is imported by cli/__init__.py, which triggers all
+@register_command decorators in command files.
+"""
+
+# Import all command modules (order doesn't matter)
+from contextual.cli.commands import (
+    auth,
+    client,
+    config,
+    doctor,
+    fetch,
+    index,
+    initialisation,
+    install,
+    mcp,
+    stats,
+    workspace,
+)
+
+__all__ = [
+    "auth",
+    "client",
+    "config",
+    "doctor",
+    "fetch",
+    "index",
+    "initialisation",
+    "install",
+    "mcp",
+    "stats",
+    "workspace",
+]

contextual_engine-0.8.1/contextual/cli/commands/auth.py

@@ -0,0 +1,24 @@
+"""Authentication stub commands."""
+
+from __future__ import annotations
+
+from contextual.cli.core import register_command
+from contextual.cli.core.output import print_auth_stub
+
+
+@register_command()
+def login() -> None:
+    """Authenticate the CLI with user credentials."""
+    print_auth_stub("login")
+
+
+@register_command()
+def logout() -> None:
+    """Sign out and remove credentials."""
+    print_auth_stub("logout")
+
+
+@register_command()
+def account() -> None:
+    """Show authentication and account status."""
+    print_auth_stub("account")