Skip to content

Architecture decision records ​

Every relevant technical decision has an ADR (Architecture Decision Record) in this directory. An ADR is not rewritten when a decision changes: a new one is created to replace it and the old one becomes "Superseded".

Possible statuses: Proposed, Accepted, Superseded.

ADRDecisionStatus
0001Access Databricks through the REST API onlyAccepted
0002Columnar JSON output for queriesAccepted
0003Export large results with EXTERNAL_LINKSAccepted
0004Parquet with parquet-wasm from Arrow chunksAccepted
0005Do not adopt ADBC or Arrow Flight SQL for nowAccepted
0006Minimal MCP surface of 5 toolsAccepted
0007Logging policyAccepted
0008Simplified read-only checkAccepted
0009Statement lifecycle moduleAccepted
0010Exports on the statement lifecycle moduleAccepted
0011Statement lookup for get_statementAccepted, partly superseded by 0023
0012Warehouse selection moduleAccepted
0013Execution scope moduleAccepted
0014Workspace session moduleAccepted, partly superseded by 0023
0015Review fixes for the deepened modulesAccepted
0016CI/CD pipeline, simplified GitFlow and automated releasesAccepted, partly superseded by 0022
0017Documentation site on GitHub Pages with VitePressAccepted
0018Excalidraw diagrams rendered to SVG with headless ChromeAccepted
0019Dependabot branches in the branch policy, and Mermaid pinned to 11Accepted
0020Dependabot reads its configuration from mainAccepted
0021Metadata cache and a REST-only describe_tableAccepted
0022Releases with Release Please, squash merges into develop and an install scriptAccepted
0023Agent statements module for execute_sql and get_statementAccepted
0024A disabled metadata cache is an adapterAccepted

Current design: docs/design.md.

Released under the MIT License.