sqlprism 1.0.0__py3-none-any.whl

sqlprism-1.0.0.dist-info/METADATA

@@ -0,0 +1,429 @@
+Metadata-Version: 2.4
+Name: sqlprism
+Version: 1.0.0
+Summary: SQL codebase indexer with column-level lineage, impact analysis, and MCP server support
+Project-URL: Homepage, https://github.com/darkcofy/sqlprism
+Project-URL: Documentation, https://darkcofy.github.io/sqlprism/
+Project-URL: Repository, https://github.com/darkcofy/sqlprism
+Project-URL: Issues, https://github.com/darkcofy/sqlprism/issues
+Author-email: Alfred Johnson <alfjohnfred@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: duckdb>=1.5.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: sqlglot<30,>=28.0.0
+Description-Content-Type: text/markdown
+
+# SQLPrism
+
+[![CI](https://github.com/darkcofy/sqlprism/actions/workflows/ci.yml/badge.svg)](https://github.com/darkcofy/sqlprism/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/darkcofy/sqlprism/branch/main/graph/badge.svg)](https://codecov.io/gh/darkcofy/sqlprism)
+[![PyPI](https://img.shields.io/pypi/v/sqlprism)](https://pypi.org/project/sqlprism/)
+[![Python](https://img.shields.io/pypi/pyversions/sqlprism)](https://pypi.org/project/sqlprism/)
+[![License](https://img.shields.io/github/license/darkcofy/sqlprism)](LICENSE)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://darkcofy.github.io/sqlprism/)
+
+An MCP server that indexes SQL codebases into a queryable knowledge graph backed by DuckDB. Instead of grepping through files, ask structural questions: *what touches this table, where is this column transformed, what's the blast radius of this PR.*
+
+Built for SQL-heavy data projects — works with raw SQL, [SQLMesh](https://sqlmesh.com/), and [dbt](https://www.getdbt.com/).
+
+## Why Not Just Grep?
+
+Grep finds strings. This tool understands SQL structure.
+
+| Capability | Grep | SQLPrism |
+|---|---|---|
+| Find table references | Yes | Yes |
+| CTE-to-CTE data flow | No — manual file reading | Yes — edges tracked in graph |
+| Column lineage with transforms (CAST, COALESCE, SUM) | No | Yes — parsed from AST |
+| Usage type (WHERE vs SELECT vs JOIN vs GROUP BY) | Fragile regex | Precise — parsed from AST |
+| Multi-hop impact analysis | Manual tracing | Automatic graph traversal |
+| PR blast radius | DIY with git diff | One call |
+| Cross-CTE column tracing | Basically impossible | Built-in |
+
+On a 200-model SQLMesh project, a column impact query returns **75 structured results in ~5,000 tokens**. The grep equivalent would need **40-60 files opened, ~100,000+ tokens**, and still wouldn't tell you whether a column appears in a WHERE filter or a SELECT.
+
+## What's New in v1.0
+
+- **Non-blocking reindex** — reindex runs in the background; queries remain available during indexing via DuckDB MVCC. Call `index_status` to check progress.
+- **PR Impact delta mode** — `pr_impact` now shows *net-new* blast radius vs the base branch (default), not just total downstream. New fields: `newly_affected`, `no_longer_affected`, `delta`. Note: delta mode captures net-new downstream impact; reduced blast radius from removed edges is not detected.
+- **Thread-safe concurrency** — `asyncio.Lock` on reindex guard, atomic status updates, `threading.local` for transaction flags. Safe under both stdio and HTTP transports.
+- **SELECT \* lineage for dbt/sqlmesh** — schema catalog is passed to dbt and sqlmesh renderers, enabling column expansion through `SELECT *` statements.
+- **Input validation** — `compare_mode`, `direction`, and other string parameters use `Literal` types with Pydantic, rejecting invalid values at the API boundary.
+- **Logging** — `--log-level` global CLI option. `serve` defaults to INFO for production visibility.
+- **File error resilience** — unreadable files are skipped instead of aborting the entire reindex.
+- **Code coverage** — 82%+ line coverage with 235 tests enforced via pytest-cov.
+
+## Quick Start
+
+### From source (local development)
+
+```bash
+git clone https://github.com/darkcofy/sqlprism.git && cd sqlprism
+
+# Install dependencies and the package
+uv sync
+
+# Create config
+uv run sqlprism init
+
+# Edit ~/.sqlprism/config.json (see Configuration below)
+
+# Index your repos
+uv run sqlprism reindex
+
+# Start the MCP server
+uv run sqlprism serve
+```
+
+All commands use `uv run sqlprism` to run within the project's virtualenv. If you activate the venv (`source .venv/bin/activate`), you can drop the `uv run` prefix.
+
+## Configuration
+
+`sqlprism init` creates a default config at `~/.sqlprism/config.json`. You can override the path with `--config PATH` on any command.
+
+```json
+{
+  "db_path": "~/.sqlprism/graph.duckdb",
+  "sql_dialect": null,
+  "repos": {
+    "my-queries": "/path/to/sql/repo",
+    "multi-dialect-repo": {
+      "path": "/path/to/repo",
+      "dialect": "starrocks",
+      "dialect_overrides": {
+        "athena/": "athena",
+        "postgres/": "postgres"
+      }
+    }
+  },
+  "sqlmesh_repos": {
+    "my-sqlmesh-project": {
+      "project_path": "/path/to/sqlmesh/folder",
+      "env_file": "/path/to/.env",
+      "dialect": "athena",
+      "variables": {
+        "GRACE_PERIOD": 7
+      }
+    }
+  },
+  "dbt_repos": {
+    "my-dbt-project": {
+      "project_path": "/path/to/dbt/project",
+      "env_file": "/path/to/.env",
+      "target": "dev",
+      "dialect": "starrocks",
+      "dbt_command": "uv run dbt"
+    }
+  }
+}
+```
+
+| Field | Description |
+|---|---|
+| `db_path` | Path to the DuckDB database file. Defaults to `~/.sqlprism/graph.duckdb`. |
+| `sql_dialect` | Global default SQL dialect. `null` for auto-detect. |
+| `repos` | Plain SQL repos. Value is a path string or an object with `path`, `dialect`, `dialect_overrides`. |
+| `dialect` | Per-repo dialect override (e.g. `"starrocks"`, `"athena"`, `"bigquery"`). |
+| `dialect_overrides` | Per-directory overrides using prefix matching or glob patterns. |
+| `sqlmesh_repos` | SQLMesh projects. Renders models before parsing. See [SQLMesh and dbt Support](#sqlmesh-and-dbt-support). |
+| `dbt_repos` | dbt projects. Compiles models before parsing. See [SQLMesh and dbt Support](#sqlmesh-and-dbt-support). |
+
+## SQL Dialect Support
+
+Powered by [sqlglot](https://github.com/tobymao/sqlglot), the indexer supports **33 SQL dialects** out of the box:
+
+| Dialect | Dialect | Dialect | Dialect |
+|---|---|---|---|
+| Athena | Doris | Materialize | Snowflake |
+| BigQuery | Dremio | MySQL | Spark |
+| ClickHouse | Drill | Oracle | Spark2 |
+| Databricks | Druid | Postgres | SQLite |
+| DuckDB | Dune | Presto | StarRocks |
+| Exasol | Fabric | PRQL | Tableau |
+| Hive | | Redshift | Teradata |
+| RisingWave | | SingleStore | Trino / TSQL |
+
+Pass the dialect name as a lowercase string (e.g., `"starrocks"`, `"bigquery"`, `"athena"`). Dialect-specific quoting (backticks for MySQL/StarRocks, double-quotes for Postgres) and identifier case normalization (lowercase for Postgres/DuckDB, uppercase for Snowflake/Oracle) are handled automatically.
+
+## SQLMesh and dbt Support
+
+Both SQLMesh and dbt use macros/Jinja that can't be parsed as raw SQL. The indexer solves this by rendering models first, then parsing the clean SQL output.
+
+Both renderers use subprocess execution — no SQLMesh or dbt Python dependencies are required in the indexer's environment. They use whatever version the project already has installed.
+
+### SQLMesh
+
+```bash
+sqlprism reindex-sqlmesh \
+  --name my-project \
+  --project /path/to/sqlmesh/project \
+  --dialect athena \
+  --env-file /path/to/.env \
+  --var GRACE_PERIOD 7
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--name` | Yes | Repo name used in the index. Used to filter queries later. |
+| `--project` | Yes | Path to the sqlmesh project directory (containing `config.yaml`). |
+| `--dialect` | No | SQL dialect for rendering output. Default: `athena`. |
+| `--env-file` | No | Path to `.env` file. Variables are loaded into the subprocess environment before rendering. Useful for connection strings, S3 paths, etc. |
+| `--var` | No | SQLMesh macro variables as key-value pairs. Repeatable. e.g. `--var GRACE_PERIOD 7 --var ENV prod`. These override variables defined in `config.yaml`. |
+| `--sqlmesh-command` | No | Command to run python in the sqlmesh project's venv. The indexer runs an inline script that imports sqlmesh's Python API. Default: `uv run python`. |
+| `--config` | No | Path to sqlprism config file. Default: `~/.sqlprism/config.json`. |
+| `--db` | No | Path to DuckDB file. Overrides the value in config. |
+
+### dbt
+
+```bash
+sqlprism reindex-dbt \
+  --name my-project \
+  --project /path/to/dbt/project \
+  --dialect starrocks \
+  --env-file /path/to/.env \
+  --target dev
+```
+
+| Parameter | Required | Description |
+|---|---|---|
+| `--name` | Yes | Repo name used in the index. |
+| `--project` | Yes | Path to dbt project directory (containing `dbt_project.yml`). |
+| `--dialect` | No | SQL dialect for parsing the compiled output (e.g. `starrocks`, `postgres`, `bigquery`). |
+| `--env-file` | No | Path to `.env` file for dbt connection variables. |
+| `--target` | No | dbt target name (e.g. `dev`, `prod`). Maps to the target in `profiles.yml`. |
+| `--profiles-dir` | No | Path to directory containing `profiles.yml`. Defaults to the project directory. |
+| `--dbt-command` | No | Base command to invoke dbt. `compile` is appended automatically. Default: `uv run dbt`. Use `dbt` if globally installed, or `uvx --with dbt-starrocks dbt` for ephemeral install. |
+| `--config` | No | Path to sqlprism config file. |
+| `--db` | No | Path to DuckDB file. Overrides config. |
+
+## CLI Commands
+
+> **Global option:** `--log-level` sets logging verbosity (default: `WARNING`). The `serve` command defaults to `INFO`.
+
+### `sqlprism init`
+
+Creates a default config file at `~/.sqlprism/config.json` with example entries for repos, sqlmesh_repos, and dbt_repos.
+
+```bash
+sqlprism init [--config PATH]
+```
+
+### `sqlprism reindex`
+
+Incremental reindex of all configured plain SQL repos (from `repos` in config). Checksums files and only re-parses what changed.
+
+```bash
+sqlprism reindex [--config PATH] [--db PATH] [--repo NAME]
+```
+
+| Parameter | Description |
+|---|---|
+| `--repo` | Reindex a single repo only. Omit to reindex all. |
+
+### `sqlprism serve`
+
+Starts the MCP server. Exposes all 10 tools to any MCP client.
+
+```bash
+sqlprism [--log-level DEBUG|INFO|WARNING|ERROR] serve [--config PATH] [--db PATH] [--transport stdio|streamable_http] [--port 8000]
+```
+
+| Parameter | Default | Description |
+|---|---|---|
+| `--transport` | `stdio` | Transport mode. Use `stdio` for Claude Code / Claude Desktop. Use `streamable_http` for web-based clients. |
+| `--port` | `8000` | Port for HTTP transport. Only used when `--transport streamable_http`. |
+
+### `sqlprism status`
+
+Shows index status: repos, file counts, node counts, last indexed time, git commit/branch.
+
+```bash
+sqlprism status [--config PATH] [--db PATH]
+```
+
+## CLI Query Commands
+
+All query commands output JSON to stdout. They share common parameters:
+
+| Parameter | Description |
+|---|---|
+| `--config PATH` | Path to config file. Default: `~/.sqlprism/config.json`. |
+| `--db PATH` | Path to DuckDB file. Overrides config. |
+| `--repo TEXT` | Filter results by repo name. Omit to query across all repos. |
+
+### `sqlprism query search`
+
+Find tables, views, CTEs, and queries by name pattern (case-insensitive partial match).
+
+```bash
+sqlprism query search PATTERN [--kind KIND] [--schema SCHEMA] [--repo REPO] [--limit 20]
+```
+
+| Parameter | Description |
+|---|---|
+| `PATTERN` | Search string. Matches against node names (partial, case-insensitive). |
+| `--kind` | Filter by node kind: `table`, `view`, `cte`, `query`. |
+| `--schema` | Filter by SQL schema name (e.g. `bronze`, `silver`, `public`). |
+| `--limit` | Max results to return. Default: `20`. |
+
+### `sqlprism query references`
+
+Find what depends on an entity (inbound) and what it depends on (outbound).
+
+```bash
+sqlprism query references NAME [--direction both|inbound|outbound] [--kind KIND] [--schema SCHEMA] [--repo REPO]
+```
+
+| Parameter | Description |
+|---|---|
+| `NAME` | Entity name (table, view, CTE, etc.). |
+| `--direction` | `inbound` (what depends on this), `outbound` (what this depends on), or `both`. Default: `both`. |
+| `--kind` | Filter by node kind to disambiguate if the name exists as multiple kinds. |
+| `--schema` | Filter by SQL schema name. |
+
+### `sqlprism query column-usage`
+
+Find where and how a table's columns are used across the codebase.
+
+```bash
+sqlprism query column-usage TABLE [--column COL] [--usage-type TYPE] [--repo REPO]
+```
+
+| Parameter | Description |
+|---|---|
+| `TABLE` | Table name to search column usage for. |
+| `--column` | Filter by specific column name. Omit for all columns. |
+| `--usage-type` | Filter by usage type: `select`, `where`, `join_on`, `group_by`, `order_by`, `having`, `partition_by`, `window_order`, `insert`, `update`. |
+
+Each result includes: table, column, usage type, alias, transform expression, the node/CTE it appears in, file path, and repo.
+
+### `sqlprism query trace`
+
+Multi-hop dependency tracing for impact analysis.
+
+```bash
+sqlprism query trace NAME [--direction downstream|upstream|both] [--max-depth 3] [--kind KIND] [--repo REPO]
+```
+
+| Parameter | Description |
+|---|---|
+| `NAME` | Starting entity name. |
+| `--direction` | `downstream` (what breaks if I change this), `upstream` (what does this depend on), or `both`. Default: `downstream`. |
+| `--max-depth` | Maximum hops to traverse. Default: `3`, max: `6`. Higher values find more transitive dependencies but produce larger results. |
+| `--kind` | Filter by node kind to disambiguate. |
+
+### `sqlprism query lineage`
+
+Query end-to-end column lineage chains through CTEs and subqueries.
+
+```bash
+sqlprism query lineage [--table TABLE] [--column COL] [--output-node NODE] [--repo REPO]
+```
+
+| Parameter | Description |
+|---|---|
+| `--table` | Filter by source or intermediate table name in the lineage chain. |
+| `--column` | Filter by column name at any hop in the chain. |
+| `--output-node` | Filter by the output entity name (the final table/view/query the lineage flows into). |
+
+At least one of `--table`, `--column`, or `--output-node` should be provided to avoid returning the entire lineage graph.
+
+## MCP Tools
+
+When running as an MCP server (`sqlprism serve`), the following 10 tools are exposed. These are the same queries as the CLI but with additional parameters like `offset` for pagination and `include_snippets` for source code context.
+
+| Tool | Description |
+|---|---|
+| `search` | Find tables, views, CTEs, queries by name pattern. Filter by kind, schema, repo. Supports `limit` and `offset` for pagination. |
+| `find_references` | What depends on X / what does X depend on. Supports `direction` (inbound/outbound/both), `limit`, `offset`. |
+| `find_column_usage` | Where and how columns are used — usage type, transforms, aliases. Supports `limit`, `offset`. |
+| `trace_dependencies` | Multi-hop upstream/downstream dependency chains. `max_depth` (1-6), `include_snippets`. |
+| `trace_column_lineage` | End-to-end column lineage through CTEs and subqueries. Filter by `table`, `column`, `output_node`. |
+| `pr_impact` | Structural diff + blast radius since a `base_commit`. **Delta mode** (default) shows net-new impact vs base branch. `absolute` mode returns total blast radius (v1 behavior). Traces `max_blast_radius_depth` hops. |
+| `reindex` | Trigger incremental reindex of plain SQL repos. **Runs in background** — returns immediately, queries remain available during reindex. Call `index_status` to check progress. |
+| `reindex_sqlmesh` | Render and index a SQLMesh project. **Runs in background.** Pass `variables` as a dict for macro variables. |
+| `reindex_dbt` | Compile and index a dbt project. **Runs in background.** Pass `target`, `dialect`, `profiles_dir`. |
+| `index_status` | Repos, file counts, node counts, last commit, staleness. **Includes reindex progress** when a background reindex is running. |
+
+### MCP Tool Parameters
+
+**Pagination** — `search`, `find_references`, `find_column_usage`, and `trace_column_lineage` all support:
+- `limit`: Max results to return (default varies by tool, max 100-500).
+- `offset`: Number of results to skip. Use for paginating through large result sets.
+
+**Snippets** — `search`, `find_references`, and `trace_dependencies` support:
+- `include_snippets`: Include source code snippets in results. Default `true` for search/references, `false` for trace (which can produce large output).
+
+## MCP Client Configuration
+
+### Claude Code
+```bash
+claude mcp add sqlprism -- uv run --directory /path/to/sqlprism sqlprism serve
+```
+
+### Claude Desktop / Cursor / Continue.dev (`.mcp.json`)
+```json
+{
+  "mcpServers": {
+    "sqlprism": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/sqlprism", "sqlprism", "serve"]
+    }
+  }
+}
+```
+
+Replace `/path/to/sqlprism` with the absolute path to your clone of this repo.
+
+## Architecture
+
+```
+src/sqlprism/
+  types.py              <- ParseResult, NodeResult, EdgeResult, ColumnUsageResult, parse_repo_config
+  languages/
+    __init__.py         <- SQL_EXTENSIONS, is_sql_file()
+    sql.py              <- sqlglot: tables, views, CTEs, column lineage, transforms
+    sqlmesh.py          <- SQLMesh model renderer (subprocess)
+    dbt.py              <- dbt model renderer (subprocess)
+    utils.py            <- Shared helpers (find_venv_dir, parse_dotenv, build_env, enrich_nodes)
+  core/
+    graph.py            <- DuckDB schema (v8), read/write separation (MVCC), queries, snippets
+    indexer.py          <- Orchestrator: scan -> checksum -> parse -> store (per-file error resilience)
+    mcp_tools.py        <- FastMCP tool definitions (10 tools, non-blocking reindex)
+  cli.py                <- Click CLI with --log-level: serve, reindex, reindex-sqlmesh, reindex-dbt, status, init
+```
+
+The SQL parser extracts:
+- **Nodes**: tables, views, CTEs, queries (with schema metadata and dialect-aware case normalization)
+- **Edges**: table references, CTE references, JOINs (with context like "FROM clause", "JOIN clause")
+- **Column usage**: per-column tracking with usage type (select, where, join_on, group_by, order_by, having, partition_by, window_order), transforms (CAST, COALESCE, SUM, etc.), output aliases, and WHERE filter expressions
+- **Column lineage**: end-to-end tracing through CTEs and subqueries back to source tables, with SELECT * expansion when schema catalog is available
+
+## Development
+
+```bash
+uv sync
+uv run pytest                          # run tests (235 tests)
+uv run pytest --cov=sqlprism        # run with coverage report
+uv run pytest --cov=sqlprism --cov-report=html:coverage_html  # HTML report
+```
+
+### Code Coverage
+
+![Coverage Grid](https://codecov.io/github/darkcofy/sqlprism/graphs/tree.svg?token=8H5XNZEFOW)
+
+## License
+
+Apache License 2.0 — see [LICENSE](LICENSE).

sqlprism-1.0.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+sqlprism/__init__.py,sha256=D6XgcTFrKGMFOcoPF-JJTxLa2yvW79lQ3NEqvDzfRYg,64
+sqlprism/cli.py,sha256=4U1dDg6VImNR13GqN4BSyBFqT0eNDCVlUtzKzEciVWI,19958
+sqlprism/types.py,sha256=plUN7dJFZcJQG_S3YtmwiJvIYYGHg2FMwZMFqT9RZ1k,7303
+sqlprism/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlprism/core/graph.py,sha256=zfPd9jU6A58wI9lW_WwfiSBR229VWNLNKzyMpIV-rXo,59217
+sqlprism/core/indexer.py,sha256=4Wi1IYEimBIpfuwZZUmKpSIReSQ3TrfXgQf9u-lOgNc,26404
+sqlprism/core/mcp_tools.py,sha256=_CgzHY9Yflobp9uPAJM_9vsWp5V0ptoHd4t46am0MLk,35485
+sqlprism/languages/__init__.py,sha256=FPKTIRA7kZ3p3RHgVcGfCJ7toL1HvriXU0WgVp6_QFY,810
+sqlprism/languages/dbt.py,sha256=hC-lQ909tmwSKC0tiSjhLawDFkMLVBQ4DTDoY6C1-mI,7707
+sqlprism/languages/sql.py,sha256=ii8AIcqmBYm6jvR1LX7QFGWiLwPDGmY0ETztbxP4oCc,40285
+sqlprism/languages/sqlmesh.py,sha256=UCiteZ3awm805qZ8UoWQhCe-wnxSrOveuMdsf8Vq_hM,6967
+sqlprism/languages/utils.py,sha256=kSXxXKlWjRCBa6jNiWiZo63sXsIFtHJZdhDpmDcdeiU,2307
+sqlprism-1.0.0.dist-info/METADATA,sha256=aBRHKNc1zhBJI6T6159yOJXQEFs7VZViwyPCds-pZlA,19253
+sqlprism-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sqlprism-1.0.0.dist-info/entry_points.txt,sha256=hbk6Yzuvhvqh27pUtBVsm1Hz7hgYgBEhoD0sIixV3E0,47
+sqlprism-1.0.0.dist-info/licenses/LICENSE,sha256=N5EVbd0AQKJ-1kHcOM2hnW_UH1Ek10hNgpqkQyMIezI,10779
+sqlprism-1.0.0.dist-info/RECORD,,

sqlprism-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sqlprism-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sqlprism = sqlprism.cli:main

sqlprism-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 sql-indexer-mcp contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.