libcontext 0.2.0__tar.gz → 0.3.0__tar.gz

{libcontext-0.2.0 → libcontext-0.3.0}/.github/workflows/ci.yml

@@ -23,18 +23,17 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+        run: uv sync --group dev
 
       - name: Run tests
-        run: pytest -v --cov=libcontext --cov-report=xml
+        run: uv run pytest -v --cov=libcontext --cov-report=xml
 
       - name: Upload coverage
         if: matrix.python-version == '3.12' && matrix.os == 'ubuntu-latest'
@@ -50,24 +49,23 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
       - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
+        run: uv python install 3.12
 
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[dev]"
+        run: uv sync --group dev
 
       - name: Ruff lint
-        run: ruff check src/ tests/
+        run: uv run ruff check src/ tests/
 
       - name: Ruff format check
-        run: ruff format --check src/ tests/
+        run: uv run ruff format --check src/ tests/
 
       - name: Type checking (mypy)
-        run: mypy src/libcontext
+        run: uv run mypy src/libcontext
 
   build:
     name: Build package
@@ -76,21 +74,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install build tools
-        run: |
-          python -m pip install --upgrade pip
-          pip install build twine
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
       - name: Build
-        run: python -m build
+        run: uv build
 
       - name: Check package
-        run: twine check dist/*
+        run: uvx twine check dist/*
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4

{libcontext-0.2.0 → libcontext-0.3.0}/.gitignore

@@ -62,6 +62,11 @@ dmypy.json
 # ruff
 .ruff_cache/
 
+# Specs / internal docs
+specs/
+CHECKLIST_SPEC.md
+ROADMAP.md
+
 # OS files
 .DS_Store
 Thumbs.db

libcontext-0.3.0/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.0] - 2026-03-23
+
+### Added
+
+- **Security module** (`_security.py`): centralised input sanitisation, path boundary validation, output size guards, and search result caps. All security invariants enforced in one auditable location.
+- **Stub file support**: `.pyi` stub files are discovered (colocated and standalone stub packages) and merged with `.py` sources — signatures from stubs, docstrings from sources.
+- **Overload grouping**: `@typing.overload`-decorated functions are grouped into a single entry showing all signatures in one code block.
+- **Type alias rendering**: PEP 613 (`TypeAlias`) and PEP 695 (`type X = T`) type aliases are detected via AST analysis and rendered in dedicated "Type Aliases" sections.
+- **JSON output**: `--format json` flag for all CLI modes; versioned JSON envelope with `schema_version`; `from_dict()` classmethods on all model dataclasses; `search_package_structured()` for programmatic search results.
+- **API diff**: `libctx diff old.json new.json` compares two API snapshots and reports added, removed, and modified symbols with breaking change detection; `render_diff()` Markdown output; `--format json` support.
+- **Search enhancements**: `--type` filter (`class`, `function`, `variable`, `alias`); docstring search with preview annotations.
+- **Persistent disk cache**: Caches collected `PackageInfo` as JSON on disk; invalidation by `(version, max_mtime, file_count)`; LRU eviction (max 50 entries); `--no-cache` flag; `libctx cache clear` subcommand.
+
+### Security
+
+- **Path traversal prevention**: cache filenames are sanitised via regex allowlist — crafted package names like `../../etc/passwd` can no longer escape the cache directory.
+- **Symlink boundary enforcement**: all `rglob()` file walks (collector and cache stats) now verify that resolved paths remain within the package root, blocking symlink-based file read attacks.
+- **File size guard**: source files exceeding 10 MiB are skipped during both collection and inspection, preventing memory exhaustion from generated or malicious files.
+- **HTML marker escaping**: package names are escaped before insertion into `<!-- BEGIN/END LIBCONTEXT -->` markers, preventing comment injection and downstream prompt injection.
+- **Output truncation**: all MCP tool responses are capped at 120k characters (~30k tokens) with an explicit truncation notice, preventing context window saturation.
+- **Search result cap**: `search_package()` and `search_package_structured()` return at most 100 results by default, with a configurable `max_results` parameter.
+- **JSON input size limit**: the `diff` command (CLI and MCP) rejects inputs exceeding 50 MiB before deserialisation, preventing JSON-based denial of service.
+- **Config bounds validation**: `max_readme_lines` now rejects negative values.
+- **Legacy marker backward compatibility**: `inject_into_file()` detects and upgrades unescaped markers written by previous versions, preventing duplicate blocks.
+
+### Changed
+
+- `models.py` now includes diff dataclasses (`DiffResult`, `ModuleDiff`, `ClassDiff`, `FunctionDiff`, `VariableDiff`) and JSON envelope utilities.
+- `renderer.py` now exports `search_package_structured()` and `render_diff()`.
+- `collector.py` integrates the disk cache automatically for installed packages with version metadata.
+- MCP server `search_api` tool now accepts `kind` and `format` parameters; supports JSON structured output.
+- MCP server `get_api_json` tool now accepts an optional `module_name` for single-module extraction.
+- MCP server `refresh_cache` tool now clears both in-memory (LRU) and disk caches.
+- MCP server adds `diff_api` tool for comparing two API snapshots directly from the IDE.
+- `/lib` skill now documents `--type` filter, `--no-cache`, `--format json`, and diff workflow.
+
+## [0.2.0] - 2026-03-18
+
+### Added
+
+- Progressive disclosure CLI flags: `--overview`, `--module`, `--search` for on-demand API inspection.
+- `libctx install` subcommand with `--skills`, `--mcp`, `--all`, and `--target` options.
+- `/lib` skill for Claude Code and GitHub Copilot — on-demand library discovery via slash command.
+- MCP server (`libctx-mcp`) for VS Code / Cursor integration with `get_package_overview`, `get_module_api`, `search_api`, and `refresh_cache` tools.
+- `render_module()`, `render_package_overview()`, and `search_package()` public API functions.
+- Optional `[mcp]` extra for MCP server dependencies (requires Python 3.10+).
+- Non-destructive JSON merge for MCP config files (preserves existing entries).
+
+### Changed
+
+- CLI restructured as a click Group with `inspect` and `install` subcommands.
+
+## [0.1.0] - 2026-02-13
+
+### Added
+
+- Initial release of libcontext.
+- AST-based static analysis of Python packages (no code execution).
+- CLI command `libctx` to generate Markdown context files.
+- Support for inspecting any installed Python package by name.
+- Support for inspecting local package directories by path.
+- Extraction of classes, methods, functions, parameters, type annotations, decorators, and docstrings.
+- Automatic README discovery via `importlib.metadata` and filesystem search.
+- Marker-based injection (`<!-- BEGIN/END LIBCONTEXT -->`) for updating existing files without overwriting.
+- Optional `[tool.libcontext]` configuration in `pyproject.toml` for library authors.
+- Module include/exclude filtering.
+- Private member filtering with `--include-private` override.
+- Multi-package support in a single CLI invocation.
+- Intelligent dunder method filtering (includes useful ones like `__init__`, `__call__`, etc.).
+- Respects `__all__` when defined in modules.
+- Positional-only, keyword-only, `*args`, and `**kwargs` parameter handling.
+- Inner class and decorated class support.
+- README truncation with configurable line limit.
+- Free-form `extra_context` field for library authors.
+- Python API for programmatic usage (`collect_package`, `render_package`).
+
+[Unreleased]: https://github.com/Syclaw/libcontext/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/Syclaw/libcontext/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/Syclaw/libcontext/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Syclaw/libcontext/releases/tag/v0.1.0

{libcontext-0.2.0 → libcontext-0.3.0}/DEPENDENCIES.md

@@ -19,10 +19,10 @@ This document lists all dependencies used by **libcontext** and their respective
 
 | Package | Version | License | Description |
 |---------|---------|---------|-------------|
-| [pytest](https://pypi.org/project/pytest/) | >=7.0 | MIT | Testing framework. |
-| [pytest-cov](https://pypi.org/project/pytest-cov/) | >=4.0 | MIT | Coverage plugin for pytest. |
-| [ruff](https://pypi.org/project/ruff/) | >=0.4.0 | MIT | Fast Python linter and formatter (replaces flake8, isort, black, pyupgrade). |
-| [mypy](https://pypi.org/project/mypy/) | >=1.10 | MIT | Static type checker for Python. |
+| [pytest](https://pypi.org/project/pytest/) | >=8.4.2 | MIT | Testing framework. |
+| [pytest-cov](https://pypi.org/project/pytest-cov/) | >=7.0.0 | MIT | Coverage plugin for pytest. |
+| [ruff](https://pypi.org/project/ruff/) | >=0.15.1 | MIT | Fast Python linter and formatter (replaces flake8, isort, black, pyupgrade). |
+| [mypy](https://pypi.org/project/mypy/) | >=1.19.1 | MIT | Static type checker for Python. |
 
 ## Build Dependencies
 
@@ -35,16 +35,22 @@ This document lists all dependencies used by **libcontext** and their respective
 The following standard library modules are used and require **no additional installation**:
 
 - `ast` — Abstract Syntax Trees (core of the inspection engine)
+- `contextlib` — Context managers (cache file handling)
+- `copy` — Deep copy of data structures (stub merging)
+- `dataclasses` — Data model definitions
+- `datetime` — Timestamp handling (cache metadata)
+- `difflib` — Fuzzy matching (similar package name suggestions)
+- `functools` — LRU cache (MCP server in-memory caching)
 - `importlib.metadata` — Package metadata access
 - `importlib.util` — Package location discovery
-- `dataclasses` — Data model definitions
-- `pathlib` — Filesystem path handling
+- `json` — JSON serialization (cache, MCP config, JSON output)
 - `logging` — Diagnostic logging
+- `os` — OS-level operations (cache directory, file stats)
+- `pathlib` — Filesystem path handling
 - `sys` — System-specific parameters
-- `io` — I/O handling (UTF-8 stdout wrapper)
-- `json` — JSON reading/writing (MCP config merge)
 - `textwrap` — Text formatting (skill content generation)
 - `tomllib` — TOML parsing (Python 3.11+, replaces `tomli`)
+- `typing` — Type annotations (`Any`)
 
 ## License Compatibility
 

{libcontext-0.2.0 → libcontext-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcontext
-Version: 0.2.0
+Version: 0.3.0
 Summary: Generate optimized LLM context from Python library APIs — CLI, skill, and MCP server
 Project-URL: Homepage, https://github.com/Syclaw/libcontext
 Project-URL: Repository, https://github.com/Syclaw/libcontext
@@ -65,7 +65,8 @@ libcontext solves this with **progressive disclosure**: overview first, then dri
 ## Quick Start
 
 ```bash
-pip install libcontext
+# Install globally with uv (recommended — available in all projects)
+uv tool install libcontext
 
 # Install the /lib skill into your Claude Code project
 libctx install --skills
@@ -78,7 +79,7 @@ libctx install --skills
 For VS Code with MCP support:
 
 ```bash
-pip install libcontext[mcp]
+uv tool install "libcontext[mcp]"
 libctx install --mcp --target vscode
 ```
 
@@ -120,35 +121,67 @@ libctx inspect requests -o .github/copilot-instructions.md
 
 # Multiple libraries at once
 libctx inspect requests httpx pydantic -o context.md
+
+# JSON output (programmatic consumption)
+libctx inspect requests --format json
+libctx inspect requests --search Session --format json
+
+# Filter search by type
+libctx inspect requests --search Session --type class -q
+
+# Compare two API snapshots
+libctx inspect requests --format json > old.json
+# ... upgrade requests ...
+libctx inspect requests --format json > new.json
+libctx diff old.json new.json
+
+# Bypass disk cache
+libctx inspect requests --no-cache
+
+# Clear all cached API data
+libctx cache clear
 ```
 
 ### AST Analysis
 
-1. **Parsing** — Reads source files of installed packages using Python's `ast` module. No code is ever executed.
-2. **Extraction** — Classes, functions, methods, parameters, type annotations, decorators, and docstrings.
-3. **Compact rendering** — Structured Markdown optimised for LLM context windows.
-4. **Marker injection** — `<!-- BEGIN/END LIBCONTEXT -->` markers for idempotent file updates.
+1. **Parsing** — Reads `.py` and `.pyi` source files using Python's `ast` module. No code is ever executed.
+2. **Stub merging** — Discovers colocated and standalone stub packages; merges signatures from stubs with docstrings from sources.
+3. **Extraction** — Classes, functions, methods, parameters, type annotations, decorators, type aliases, and docstrings.
+4. **Compact rendering** — Structured Markdown (or JSON) optimised for LLM context windows.
+5. **Disk cache** — Results are cached on disk and revalidated via `(version, mtime, file_count)` to avoid re-parsing unchanged packages.
 
 ## Installation
 
-```bash
-pip install libcontext
-```
+### Global install (recommended)
 
-With MCP server support (requires Python 3.10+):
+Install once, use across all projects — no per-project dependency needed:
 
 ```bash
-pip install libcontext[mcp]
+uv tool install libcontext              # CLI only
+uv tool install "libcontext[mcp]"       # with MCP server (requires Python 3.10+)
 ```
 
-Or with [uv](https://docs.astral.sh/uv/):
+Update later with `uv tool upgrade libcontext`.
+
+> **One-off usage without installing:** `uvx --from libcontext libctx inspect requests`
+
+### Per-project install
+
+If you prefer to add libcontext as a project dependency:
 
 ```bash
 uv add libcontext           # basic
 uv add libcontext[mcp]      # with MCP server
 ```
 
-For development:
+Or with pip:
+
+```bash
+pip install libcontext
+pip install libcontext[mcp]
+```
+
+### Development
 
 ```bash
 git clone https://github.com/Syclaw/libcontext.git
@@ -206,8 +239,10 @@ After `libctx install --mcp`, the MCP server provides tools:
 
 - `get_package_overview` — structural overview of a package
 - `get_module_api` — detailed API for a single module
-- `search_api` — search for classes, functions, or methods
-- `refresh_cache` — clear the session cache
+- `search_api` — search by name or docstring (with optional `kind` filter and `format` for JSON output)
+- `get_api_json` — full package or single-module API as structured JSON
+- `diff_api` — compare two API snapshots and report changes with breaking change detection
+- `refresh_cache` — clear both in-memory and disk caches
 
 ## Python API
 
@@ -234,6 +269,29 @@ for mod in pkg.non_empty_modules:
 
 # Search — find specific classes or functions
 print(search_package(pkg, "Session"))
+
+# Search with type filter
+print(search_package(pkg, "Session", kind="class"))
+```
+
+```python
+import dataclasses, json
+from libcontext import collect_package, diff_packages, render_diff
+from libcontext.models import PackageInfo, _serialize_envelope
+
+# JSON serialization (roundtrip-safe)
+pkg = collect_package("requests")
+data = _serialize_envelope(dataclasses.asdict(pkg))
+print(json.dumps(data, indent=2))
+
+# Reconstruct from JSON
+pkg_restored = PackageInfo.from_dict(data["data"])
+
+# API diff between versions
+old_pkg = PackageInfo.from_dict(old_data)
+new_pkg = PackageInfo.from_dict(new_data)
+result = diff_packages(old_pkg, new_pkg)
+print(render_diff(result))
 ```
 
 ## Configuration (Optional)
@@ -256,12 +314,14 @@ All async operations use httpx internally.
 
 | Module | Role |
 |---|---|
-| `models.py` | Dataclasses representing Python components |
-| `inspector.py` | Static AST analysis — signatures, docstrings, decorators |
-| `collector.py` | Package discovery and module collection |
+| `models.py` | Dataclasses for packages, modules, classes, functions, and diff results |
+| `inspector.py` | Static AST analysis — signatures, docstrings, decorators, type aliases |
+| `collector.py` | Package discovery, module collection, stub merging, and disk cache integration |
 | `config.py` | Reads `[tool.libcontext]` from pyproject.toml |
-| `renderer.py` | LLM-optimised Markdown generation |
-| `cli.py` | CLI entry point with `inspect` and `install` subcommands |
+| `renderer.py` | LLM-optimised Markdown generation (full, overview, module, search, diff) |
+| `diff.py` | API diff between two package versions with breaking change detection |
+| `cache.py` | Persistent disk cache with mtime/file-count invalidation and LRU eviction |
+| `cli.py` | CLI entry point — `inspect`, `install`, `diff`, and `cache` subcommands |
 | `mcp_server.py` | MCP server for VS Code / Cursor integration (optional) |
 
 ## Development

{libcontext-0.2.0 → libcontext-0.3.0}/README.md

@@ -36,7 +36,8 @@ libcontext solves this with **progressive disclosure**: overview first, then dri
 ## Quick Start
 
 ```bash
-pip install libcontext
+# Install globally with uv (recommended — available in all projects)
+uv tool install libcontext
 
 # Install the /lib skill into your Claude Code project
 libctx install --skills
@@ -49,7 +50,7 @@ libctx install --skills
 For VS Code with MCP support:
 
 ```bash
-pip install libcontext[mcp]
+uv tool install "libcontext[mcp]"
 libctx install --mcp --target vscode
 ```
 
@@ -91,35 +92,67 @@ libctx inspect requests -o .github/copilot-instructions.md
 
 # Multiple libraries at once
 libctx inspect requests httpx pydantic -o context.md
+
+# JSON output (programmatic consumption)
+libctx inspect requests --format json
+libctx inspect requests --search Session --format json
+
+# Filter search by type
+libctx inspect requests --search Session --type class -q
+
+# Compare two API snapshots
+libctx inspect requests --format json > old.json
+# ... upgrade requests ...
+libctx inspect requests --format json > new.json
+libctx diff old.json new.json
+
+# Bypass disk cache
+libctx inspect requests --no-cache
+
+# Clear all cached API data
+libctx cache clear
 ```
 
 ### AST Analysis
 
-1. **Parsing** — Reads source files of installed packages using Python's `ast` module. No code is ever executed.
-2. **Extraction** — Classes, functions, methods, parameters, type annotations, decorators, and docstrings.
-3. **Compact rendering** — Structured Markdown optimised for LLM context windows.
-4. **Marker injection** — `<!-- BEGIN/END LIBCONTEXT -->` markers for idempotent file updates.
+1. **Parsing** — Reads `.py` and `.pyi` source files using Python's `ast` module. No code is ever executed.
+2. **Stub merging** — Discovers colocated and standalone stub packages; merges signatures from stubs with docstrings from sources.
+3. **Extraction** — Classes, functions, methods, parameters, type annotations, decorators, type aliases, and docstrings.
+4. **Compact rendering** — Structured Markdown (or JSON) optimised for LLM context windows.
+5. **Disk cache** — Results are cached on disk and revalidated via `(version, mtime, file_count)` to avoid re-parsing unchanged packages.
 
 ## Installation
 
-```bash
-pip install libcontext
-```
+### Global install (recommended)
 
-With MCP server support (requires Python 3.10+):
+Install once, use across all projects — no per-project dependency needed:
 
 ```bash
-pip install libcontext[mcp]
+uv tool install libcontext              # CLI only
+uv tool install "libcontext[mcp]"       # with MCP server (requires Python 3.10+)
 ```
 
-Or with [uv](https://docs.astral.sh/uv/):
+Update later with `uv tool upgrade libcontext`.
+
+> **One-off usage without installing:** `uvx --from libcontext libctx inspect requests`
+
+### Per-project install
+
+If you prefer to add libcontext as a project dependency:
 
 ```bash
 uv add libcontext           # basic
 uv add libcontext[mcp]      # with MCP server
 ```
 
-For development:
+Or with pip:
+
+```bash
+pip install libcontext
+pip install libcontext[mcp]
+```
+
+### Development
 
 ```bash
 git clone https://github.com/Syclaw/libcontext.git
@@ -177,8 +210,10 @@ After `libctx install --mcp`, the MCP server provides tools:
 
 - `get_package_overview` — structural overview of a package
 - `get_module_api` — detailed API for a single module
-- `search_api` — search for classes, functions, or methods
-- `refresh_cache` — clear the session cache
+- `search_api` — search by name or docstring (with optional `kind` filter and `format` for JSON output)
+- `get_api_json` — full package or single-module API as structured JSON
+- `diff_api` — compare two API snapshots and report changes with breaking change detection
+- `refresh_cache` — clear both in-memory and disk caches
 
 ## Python API
 
@@ -205,6 +240,29 @@ for mod in pkg.non_empty_modules:
 
 # Search — find specific classes or functions
 print(search_package(pkg, "Session"))
+
+# Search with type filter
+print(search_package(pkg, "Session", kind="class"))
+```
+
+```python
+import dataclasses, json
+from libcontext import collect_package, diff_packages, render_diff
+from libcontext.models import PackageInfo, _serialize_envelope
+
+# JSON serialization (roundtrip-safe)
+pkg = collect_package("requests")
+data = _serialize_envelope(dataclasses.asdict(pkg))
+print(json.dumps(data, indent=2))
+
+# Reconstruct from JSON
+pkg_restored = PackageInfo.from_dict(data["data"])
+
+# API diff between versions
+old_pkg = PackageInfo.from_dict(old_data)
+new_pkg = PackageInfo.from_dict(new_data)
+result = diff_packages(old_pkg, new_pkg)
+print(render_diff(result))
 ```
 
 ## Configuration (Optional)
@@ -227,12 +285,14 @@ All async operations use httpx internally.
 
 | Module | Role |
 |---|---|
-| `models.py` | Dataclasses representing Python components |
-| `inspector.py` | Static AST analysis — signatures, docstrings, decorators |
-| `collector.py` | Package discovery and module collection |
+| `models.py` | Dataclasses for packages, modules, classes, functions, and diff results |
+| `inspector.py` | Static AST analysis — signatures, docstrings, decorators, type aliases |
+| `collector.py` | Package discovery, module collection, stub merging, and disk cache integration |
 | `config.py` | Reads `[tool.libcontext]` from pyproject.toml |
-| `renderer.py` | LLM-optimised Markdown generation |
-| `cli.py` | CLI entry point with `inspect` and `install` subcommands |
+| `renderer.py` | LLM-optimised Markdown generation (full, overview, module, search, diff) |
+| `diff.py` | API diff between two package versions with breaking change detection |
+| `cache.py` | Persistent disk cache with mtime/file-count invalidation and LRU eviction |
+| `cli.py` | CLI entry point — `inspect`, `install`, `diff`, and `cache` subcommands |
 | `mcp_server.py` | MCP server for VS Code / Cursor integration (optional) |
 
 ## Development

{libcontext-0.2.0 → libcontext-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libcontext"
-version = "0.2.0"
+version = "0.3.0"
 description = "Generate optimized LLM context from Python library APIs — CLI, skill, and MCP server"
 readme = "README.md"
 license = "MIT"

{libcontext-0.2.0 → libcontext-0.3.0}/src/libcontext/__init__.py

@@ -22,8 +22,9 @@ from __future__ import annotations
 import importlib.metadata
 import logging
 
-from .collector import collect_package, find_package_path
+from .collector import collect_package, find_package_path, suggest_similar_packages
 from .config import LibcontextConfig
+from .diff import diff_packages
 from .exceptions import (
     ConfigError,
     InspectionError,
@@ -32,19 +33,26 @@ from .exceptions import (
 )
 from .inspector import inspect_file, inspect_source
 from .models import (
+    ClassDiff,
     ClassInfo,
+    DiffResult,
+    FunctionDiff,
     FunctionInfo,
+    ModuleDiff,
     ModuleInfo,
     PackageInfo,
     ParameterInfo,
+    VariableDiff,
     VariableInfo,
 )
 from .renderer import (
     inject_into_file,
+    render_diff,
     render_module,
     render_package,
     render_package_overview,
     search_package,
+    search_package_structured,
 )
 
 # Library best practice: add NullHandler to prevent "No handlers could be found"
@@ -57,24 +65,33 @@ except importlib.metadata.PackageNotFoundError:
     __version__ = "0.0.0-dev"
 
 __all__ = [
+    "ClassDiff",
     "ClassInfo",
     "ConfigError",
+    "DiffResult",
+    "FunctionDiff",
     "FunctionInfo",
     "InspectionError",
     "LibcontextConfig",
     "LibcontextError",
+    "ModuleDiff",
     "ModuleInfo",
     "PackageInfo",
     "PackageNotFoundError",
     "ParameterInfo",
+    "VariableDiff",
     "VariableInfo",
     "collect_package",
+    "diff_packages",
     "find_package_path",
     "inject_into_file",
     "inspect_file",
     "inspect_source",
+    "render_diff",
     "render_module",
     "render_package",
     "render_package_overview",
     "search_package",
+    "search_package_structured",
+    "suggest_similar_packages",
 ]