orm-lens 1.16.0__tar.gz

orm_lens-1.16.0/PKG-INFO

@@ -0,0 +1,298 @@
+Metadata-Version: 2.4
+Name: orm-lens
+Version: 1.16.0
+Summary: Static analysis + MCP server for Django and SQLAlchemy models. ER diagrams, N+1, migration risk for Django migrations and Alembic, blast radius and schema drift for CI, terminals and AI agents. No DB, no app boot. Free and MIT.
+Author: frowningdev
+License: MIT
+Project-URL: Homepage, https://github.com/FROWNINGdev/orm-lens
+Project-URL: Documentation, https://frowningdev.github.io/orm-lens/
+Project-URL: Repository, https://github.com/FROWNINGdev/orm-lens
+Project-URL: Bug Tracker, https://github.com/FROWNINGdev/orm-lens/issues
+Project-URL: Changelog, https://github.com/FROWNINGdev/orm-lens/blob/main/CHANGELOG.md
+Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens
+Keywords: django,sqlalchemy,alembic,fastapi,flask,sqlmodel,orm,n+1,migrations,models,er-diagram,mermaid,mcp,ai-agents,cursor,aider,code-analysis,static-analysis
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
+Classifier: Framework :: FastAPI
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.0; python_version >= "3.10" and extra == "mcp"
+Provides-Extra: full
+Requires-Dist: mcp<3,>=2.0; python_version >= "3.10" and extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+
+# orm-lens
+
+<!-- mcp-name: io.github.FROWNINGdev/orm-lens -->
+
+[![PyPI](https://img.shields.io/pypi/v/orm-lens?color=3775a9&label=PyPI&logo=pypi&logoColor=white)](https://pypi.org/project/orm-lens/)
+[![Python](https://img.shields.io/pypi/pyversions/orm-lens?color=3775a9&logo=python&logoColor=white)](https://pypi.org/project/orm-lens/)
+[![Downloads](https://img.shields.io/pepy/dt/django-orm-lens?color=3775a9&label=downloads&logo=pypi&logoColor=white)](https://pepy.tech/project/django-orm-lens)
+[![License](https://img.shields.io/github/license/FROWNINGdev/orm-lens?color=16a34a)](https://github.com/FROWNINGdev/orm-lens/blob/main/LICENSE)
+
+**Static analysis + MCP server for Django and SQLAlchemy models.** Terminal- and AI-agent-friendly.
+
+Formerly **django-orm-lens**: `pip install django-orm-lens` still works, installs
+this package and keeps the old `django-orm-lens` command and `import django_orm_lens`.
+
+SQLAlchemy (preview): `scan`, `er` and `nplusone` read SQLAlchemy 2.0 / 1.x,
+Flask-SQLAlchemy and SQLModel models, and `migration-risk` reads Alembic
+revisions — see [SQLAlchemy models](https://github.com/FROWNINGdev/orm-lens/blob/main/docs/rules/sqlalchemy.md)
+and [Alembic rules](https://github.com/FROWNINGdev/orm-lens/blob/main/docs/rules/alembic.md).
+
+Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.FROWNINGdev/orm-lens`.
+
+Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
+MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
+Continue, and any other MCP client — can navigate your Django schema without
+importing Django or spinning up your app.
+
+Companion to the [ORM Lens VS Code
+extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
+
+## Paid-tier capabilities, free and MIT
+
+Schema review is a paid category nearly everywhere. A bot that reviews every
+pull request, analysis that follows a queryset past the function it was built in, a check that
+catches schema drift, index advice grounded in real table statistics — those
+normally sit behind a per-seat or per-database subscription.
+
+All of it is here, MIT-licensed, with no tier gate, no seat count, no account
+and no telemetry:
+
+| Capability usually sold as a paid tier | Here |
+|---|---|
+| PR review bot for schema changes — posts once, then updates in place | `blast-radius` + the GitHub Action |
+| Analysis that follows a queryset across functions | `nplusone` |
+| Schema drift detection | `drift` |
+| Index proposals from observed QuerySet usage | `suggest-indexes` |
+| Migration risk weighed against real table sizes | `blast-radius --stats` |
+| Blast radius of a destructive migration | `blast-radius` |
+| Cross-layer impact of removing a field | `impact` |
+
+**There is no Pro tier, and none is planned.**
+
+---
+
+## Install
+
+```bash
+# Core CLI (zero third-party deps)
+pip install orm-lens
+
+# With the MCP server (adds the `mcp` package)
+pip install "orm-lens[mcp]"
+```
+
+Requires Python **3.9+**; the MCP server needs **3.10+**, like the `mcp` SDK. Works on Linux, macOS, and Windows.
+
+---
+
+## CLI usage
+
+```bash
+# Scan a Django project for models (JSON, Markdown, or table)
+orm-lens scan -f json
+orm-lens scan -f markdown
+orm-lens scan -f table
+
+# Describe one model
+orm-lens describe blog.Post
+orm-lens describe Post -f json
+
+# Compact hover card (great for pipeing into your editor)
+orm-lens hover blog.Post
+
+# Flat list — pipes into fzf, grep, etc.
+orm-lens list | fzf
+
+# ER diagram — Mermaid (default), DBML, D2, or PlantUML
+orm-lens er > schema.mmd
+orm-lens er -f dbml > schema.dbml     # paste into dbdiagram.io
+orm-lens er -f d2 > schema.d2         # render: d2 schema.d2 schema.svg
+orm-lens er -f plantuml > schema.puml
+
+# Diff two schema dumps (exit 1 on changes — CI-friendly)
+orm-lens diff before.json after.json
+
+# Static analyzers — text, json, sarif, or github annotation output
+orm-lens nplusone --format github     # N+1 findings as PR annotations
+orm-lens migration-risk -f sarif      # SARIF for GitHub Code Scanning
+orm-lens suggest-indexes blog.Post    # Meta.indexes proposals from usage
+orm-lens signals                      # sender→signal→handler graph
+orm-lens migration-deps blog -f mermaid   # per-app migration DAG
+orm-lens cascade blog.Author          # delete blast radius by on_delete
+```
+
+Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
+skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
+
+---
+
+## MCP server — for AI coding agents
+
+The MCP server exposes ten read-only tools that any MCP-compatible agent can
+call while it edits your Django project:
+
+| Tool | Purpose |
+| --- | --- |
+| `list_apps` | Every Django app in the workspace with model counts |
+| `list_models` | Flat `app.Model` list, optional app filter |
+| `describe_model` | Full field / relation / Meta detail for one model |
+| `find_relations` | Inbound + outbound relations for one model |
+| `cascade_preview` | Blast radius of one `delete()`, grouped by `on_delete` |
+| `er_diagram` | ER diagram — `mermaid` / `dbml` / `d2` / `plantuml` |
+| `describe_migration_dependency` | Per-app migration DAG: roots, leaves, cross-app deps |
+| `suggest_indexes` | `Meta.indexes` proposals from observed QuerySet usage |
+| `signal_graph` | Sender→signal→handler graph from `@receiver` decorators |
+| `nplusone_scan` | Static N+1 findings for the whole workspace |
+
+### Start the server manually
+
+```bash
+orm-lens-mcp     # dedicated entry point
+# or
+orm-lens mcp     # subcommand
+```
+
+**Workspace resolution (py-1.3.0+).** Priority: explicit `workspace_root`
+argument on the tool call → `ORM_LENS_ROOT` env var → current working
+directory. If none resolves to a Django project (`manage.py`, `django` in
+`pyproject.toml`, or any `models.py`) you get a structured error envelope
+back — `{"error": "WORKSPACE_NOT_DJANGO", "hint": "…"}` — instead of an
+empty list, so the agent knows what to do next.
+
+Optional sandbox: set `ORM_LENS_ALLOWED_ROOTS` (`;`-separated on
+Windows, `:`-separated elsewhere) to a whitelist of prefixes; any path
+outside them is rejected with `WORKSPACE_NOT_ALLOWED`.
+
+### Register it with an agent
+
+**Cursor** — add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "orm-lens": {
+      "command": "orm-lens-mcp",
+      "env": { "ORM_LENS_ROOT": "/abs/path/to/your/project" }
+    }
+  }
+}
+```
+
+**Any MCP client** — same shape, generic tool. Point `command` at the
+installed `orm-lens-mcp` binary. Two ways to tell it which Django
+project to scan:
+
+1. **Set `ORM_LENS_ROOT` in `env`** — the whole session uses one
+   project. Simplest for single-repo workflows.
+2. **Pass `workspace_root` on each tool call** — the agent switches
+   projects per call. Useful for mono-repos and multi-workspace setups.
+
+The tool signatures include `workspace_root: str = ""` as an optional
+parameter, so any agent inspecting `tools/list` sees it and can supply it.
+
+---
+
+## CI gates
+
+`diff` and `nplusone` exit `1` on findings; `migration-risk` exits `1` on
+critical findings (`--exit-zero` for report-only). Two annotation-ready
+formats: `--format github` prints `::warning`/`::error` workflow commands
+(PR annotations with no extra permissions), `--format sarif` emits
+SARIF 2.1.0 for `github/codeql-action/upload-sarif`.
+
+pre-commit users get two ready-made hooks:
+
+```yaml
+repos:
+  - repo: https://github.com/FROWNINGdev/orm-lens
+    rev: py-v1.16.0
+    hooks:
+      - id: orm-lens-nplusone
+      - id: orm-lens-migration-risk
+```
+
+GitHub Actions users get a composite action:
+`uses: FROWNINGdev/orm-lens@action-v1` with `command:` / `format:` inputs.
+
+---
+
+## Why?
+
+Django's ORM is Python, and Python is dynamic. AI agents that only see
+`models.py` as raw text miss:
+
+* which fields belong to which model;
+* the direction and cardinality of every relation;
+* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
+* which app owns which model when the project uses split `models/` packages.
+
+`orm-lens` gives them a **static, deterministic, JSON view** of the
+schema — no Django boot, no database, no side effects. And you get a nice CLI
+for humans too.
+
+---
+
+## Programmatic API
+
+```python
+from orm_lens import scan_workspace
+
+index = scan_workspace(".")
+for app in index.apps:
+    for model in app.models:
+        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
+
+# The full parsed tree serialises to the same JSON schema the VS Code
+# extension emits, so tools can share it interchangeably.
+import json
+json.dumps(index.to_dict(), indent=2)
+```
+
+---
+
+## Links
+
+* Repo: <https://github.com/FROWNINGdev/orm-lens>
+* Issues: <https://github.com/FROWNINGdev/orm-lens/issues>
+* Changelog: <https://github.com/FROWNINGdev/orm-lens/blob/main/CHANGELOG.md>
+* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
+
+MIT licensed.

orm_lens-1.16.0/README.md

@@ -0,0 +1,240 @@
+# orm-lens
+
+<!-- mcp-name: io.github.FROWNINGdev/orm-lens -->
+
+[![PyPI](https://img.shields.io/pypi/v/orm-lens?color=3775a9&label=PyPI&logo=pypi&logoColor=white)](https://pypi.org/project/orm-lens/)
+[![Python](https://img.shields.io/pypi/pyversions/orm-lens?color=3775a9&logo=python&logoColor=white)](https://pypi.org/project/orm-lens/)
+[![Downloads](https://img.shields.io/pepy/dt/django-orm-lens?color=3775a9&label=downloads&logo=pypi&logoColor=white)](https://pepy.tech/project/django-orm-lens)
+[![License](https://img.shields.io/github/license/FROWNINGdev/orm-lens?color=16a34a)](https://github.com/FROWNINGdev/orm-lens/blob/main/LICENSE)
+
+**Static analysis + MCP server for Django and SQLAlchemy models.** Terminal- and AI-agent-friendly.
+
+Formerly **django-orm-lens**: `pip install django-orm-lens` still works, installs
+this package and keeps the old `django-orm-lens` command and `import django_orm_lens`.
+
+SQLAlchemy (preview): `scan`, `er` and `nplusone` read SQLAlchemy 2.0 / 1.x,
+Flask-SQLAlchemy and SQLModel models, and `migration-risk` reads Alembic
+revisions — see [SQLAlchemy models](https://github.com/FROWNINGdev/orm-lens/blob/main/docs/rules/sqlalchemy.md)
+and [Alembic rules](https://github.com/FROWNINGdev/orm-lens/blob/main/docs/rules/alembic.md).
+
+Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.FROWNINGdev/orm-lens`.
+
+Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
+MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
+Continue, and any other MCP client — can navigate your Django schema without
+importing Django or spinning up your app.
+
+Companion to the [ORM Lens VS Code
+extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
+
+## Paid-tier capabilities, free and MIT
+
+Schema review is a paid category nearly everywhere. A bot that reviews every
+pull request, analysis that follows a queryset past the function it was built in, a check that
+catches schema drift, index advice grounded in real table statistics — those
+normally sit behind a per-seat or per-database subscription.
+
+All of it is here, MIT-licensed, with no tier gate, no seat count, no account
+and no telemetry:
+
+| Capability usually sold as a paid tier | Here |
+|---|---|
+| PR review bot for schema changes — posts once, then updates in place | `blast-radius` + the GitHub Action |
+| Analysis that follows a queryset across functions | `nplusone` |
+| Schema drift detection | `drift` |
+| Index proposals from observed QuerySet usage | `suggest-indexes` |
+| Migration risk weighed against real table sizes | `blast-radius --stats` |
+| Blast radius of a destructive migration | `blast-radius` |
+| Cross-layer impact of removing a field | `impact` |
+
+**There is no Pro tier, and none is planned.**
+
+---
+
+## Install
+
+```bash
+# Core CLI (zero third-party deps)
+pip install orm-lens
+
+# With the MCP server (adds the `mcp` package)
+pip install "orm-lens[mcp]"
+```
+
+Requires Python **3.9+**; the MCP server needs **3.10+**, like the `mcp` SDK. Works on Linux, macOS, and Windows.
+
+---
+
+## CLI usage
+
+```bash
+# Scan a Django project for models (JSON, Markdown, or table)
+orm-lens scan -f json
+orm-lens scan -f markdown
+orm-lens scan -f table
+
+# Describe one model
+orm-lens describe blog.Post
+orm-lens describe Post -f json
+
+# Compact hover card (great for pipeing into your editor)
+orm-lens hover blog.Post
+
+# Flat list — pipes into fzf, grep, etc.
+orm-lens list | fzf
+
+# ER diagram — Mermaid (default), DBML, D2, or PlantUML
+orm-lens er > schema.mmd
+orm-lens er -f dbml > schema.dbml     # paste into dbdiagram.io
+orm-lens er -f d2 > schema.d2         # render: d2 schema.d2 schema.svg
+orm-lens er -f plantuml > schema.puml
+
+# Diff two schema dumps (exit 1 on changes — CI-friendly)
+orm-lens diff before.json after.json
+
+# Static analyzers — text, json, sarif, or github annotation output
+orm-lens nplusone --format github     # N+1 findings as PR annotations
+orm-lens migration-risk -f sarif      # SARIF for GitHub Code Scanning
+orm-lens suggest-indexes blog.Post    # Meta.indexes proposals from usage
+orm-lens signals                      # sender→signal→handler graph
+orm-lens migration-deps blog -f mermaid   # per-app migration DAG
+orm-lens cascade blog.Author          # delete blast radius by on_delete
+```
+
+Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
+skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
+
+---
+
+## MCP server — for AI coding agents
+
+The MCP server exposes ten read-only tools that any MCP-compatible agent can
+call while it edits your Django project:
+
+| Tool | Purpose |
+| --- | --- |
+| `list_apps` | Every Django app in the workspace with model counts |
+| `list_models` | Flat `app.Model` list, optional app filter |
+| `describe_model` | Full field / relation / Meta detail for one model |
+| `find_relations` | Inbound + outbound relations for one model |
+| `cascade_preview` | Blast radius of one `delete()`, grouped by `on_delete` |
+| `er_diagram` | ER diagram — `mermaid` / `dbml` / `d2` / `plantuml` |
+| `describe_migration_dependency` | Per-app migration DAG: roots, leaves, cross-app deps |
+| `suggest_indexes` | `Meta.indexes` proposals from observed QuerySet usage |
+| `signal_graph` | Sender→signal→handler graph from `@receiver` decorators |
+| `nplusone_scan` | Static N+1 findings for the whole workspace |
+
+### Start the server manually
+
+```bash
+orm-lens-mcp     # dedicated entry point
+# or
+orm-lens mcp     # subcommand
+```
+
+**Workspace resolution (py-1.3.0+).** Priority: explicit `workspace_root`
+argument on the tool call → `ORM_LENS_ROOT` env var → current working
+directory. If none resolves to a Django project (`manage.py`, `django` in
+`pyproject.toml`, or any `models.py`) you get a structured error envelope
+back — `{"error": "WORKSPACE_NOT_DJANGO", "hint": "…"}` — instead of an
+empty list, so the agent knows what to do next.
+
+Optional sandbox: set `ORM_LENS_ALLOWED_ROOTS` (`;`-separated on
+Windows, `:`-separated elsewhere) to a whitelist of prefixes; any path
+outside them is rejected with `WORKSPACE_NOT_ALLOWED`.
+
+### Register it with an agent
+
+**Cursor** — add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "orm-lens": {
+      "command": "orm-lens-mcp",
+      "env": { "ORM_LENS_ROOT": "/abs/path/to/your/project" }
+    }
+  }
+}
+```
+
+**Any MCP client** — same shape, generic tool. Point `command` at the
+installed `orm-lens-mcp` binary. Two ways to tell it which Django
+project to scan:
+
+1. **Set `ORM_LENS_ROOT` in `env`** — the whole session uses one
+   project. Simplest for single-repo workflows.
+2. **Pass `workspace_root` on each tool call** — the agent switches
+   projects per call. Useful for mono-repos and multi-workspace setups.
+
+The tool signatures include `workspace_root: str = ""` as an optional
+parameter, so any agent inspecting `tools/list` sees it and can supply it.
+
+---
+
+## CI gates
+
+`diff` and `nplusone` exit `1` on findings; `migration-risk` exits `1` on
+critical findings (`--exit-zero` for report-only). Two annotation-ready
+formats: `--format github` prints `::warning`/`::error` workflow commands
+(PR annotations with no extra permissions), `--format sarif` emits
+SARIF 2.1.0 for `github/codeql-action/upload-sarif`.
+
+pre-commit users get two ready-made hooks:
+
+```yaml
+repos:
+  - repo: https://github.com/FROWNINGdev/orm-lens
+    rev: py-v1.16.0
+    hooks:
+      - id: orm-lens-nplusone
+      - id: orm-lens-migration-risk
+```
+
+GitHub Actions users get a composite action:
+`uses: FROWNINGdev/orm-lens@action-v1` with `command:` / `format:` inputs.
+
+---
+
+## Why?
+
+Django's ORM is Python, and Python is dynamic. AI agents that only see
+`models.py` as raw text miss:
+
+* which fields belong to which model;
+* the direction and cardinality of every relation;
+* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
+* which app owns which model when the project uses split `models/` packages.
+
+`orm-lens` gives them a **static, deterministic, JSON view** of the
+schema — no Django boot, no database, no side effects. And you get a nice CLI
+for humans too.
+
+---
+
+## Programmatic API
+
+```python
+from orm_lens import scan_workspace
+
+index = scan_workspace(".")
+for app in index.apps:
+    for model in app.models:
+        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
+
+# The full parsed tree serialises to the same JSON schema the VS Code
+# extension emits, so tools can share it interchangeably.
+import json
+json.dumps(index.to_dict(), indent=2)
+```
+
+---
+
+## Links
+
+* Repo: <https://github.com/FROWNINGdev/orm-lens>
+* Issues: <https://github.com/FROWNINGdev/orm-lens/issues>
+* Changelog: <https://github.com/FROWNINGdev/orm-lens/blob/main/CHANGELOG.md>
+* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
+
+MIT licensed.

orm_lens-1.16.0/orm_lens/__init__.py

@@ -0,0 +1,52 @@
+"""ORM Lens — sidebar tree, ER diagrams, and JSON for Django models.
+
+Terminal / editor-agnostic parser for Django models.py files.
+Ships a CLI and an optional MCP server for AI coding agents.
+"""
+
+try:
+    from importlib.metadata import PackageNotFoundError
+    from importlib.metadata import version as _pkg_version
+    try:
+        __version__ = _pkg_version("orm-lens")
+    except PackageNotFoundError:
+        __version__ = "0.0.0+local"
+except ImportError:
+    __version__ = "0.0.0+local"
+
+from .models import (
+    ParsedApp,
+    ParsedField,
+    ParsedModel,
+    WorkspaceIndex,
+    cascade_preview,
+    find_model,
+    find_user_model,
+    find_user_model_from_dict,
+    resolve_related_tail,
+)
+from .parser import (
+    BROAD_SKIP_DIRS,
+    iter_workspace_py_files,
+    parse_models_file,
+    scan_workspace,
+)
+
+__all__ = [
+    "ParsedApp",
+    "ParsedField",
+    "ParsedModel",
+    "WorkspaceIndex",
+    "parse_models_file",
+    "scan_workspace",
+    # v1.2.0 — shared helpers for downstream tools that build on the parser.
+    "BROAD_SKIP_DIRS",
+    "find_model",
+    "find_user_model",
+    "find_user_model_from_dict",
+    "iter_workspace_py_files",
+    "resolve_related_tail",
+    # shared relation analysis used by both the CLI and the MCP server.
+    "cascade_preview",
+    "__version__",
+]

orm_lens-1.16.0/orm_lens/__main__.py

@@ -0,0 +1,17 @@
+"""Entry point for ``python -m orm_lens``.
+
+The console scripts declared in pyproject.toml cover the common case, but
+``python -m`` is the invocation that does not depend on the scripts directory
+being on PATH — which is exactly the situation inside CI images, tox
+environments and freshly created venvs. Mirrors what pip, pytest and venv do.
+
+Delegates to the same ``cli.main`` the console script uses, so the two paths
+cannot drift.
+"""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())