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.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Access Databricks through the REST API only | Accepted |
| 0002 | Columnar JSON output for queries | Accepted |
| 0003 | Export large results with EXTERNAL_LINKS | Accepted |
| 0004 | Parquet with parquet-wasm from Arrow chunks | Accepted |
| 0005 | Do not adopt ADBC or Arrow Flight SQL for now | Accepted |
| 0006 | Minimal MCP surface of 5 tools | Accepted |
| 0007 | Logging policy | Accepted |
| 0008 | Simplified read-only check | Accepted |
| 0009 | Statement lifecycle module | Accepted |
| 0010 | Exports on the statement lifecycle module | Accepted |
| 0011 | Statement lookup for get_statement | Accepted, partly superseded by 0023 |
| 0012 | Warehouse selection module | Accepted |
| 0013 | Execution scope module | Accepted |
| 0014 | Workspace session module | Accepted, partly superseded by 0023 |
| 0015 | Review fixes for the deepened modules | Accepted |
| 0016 | CI/CD pipeline, simplified GitFlow and automated releases | Accepted, partly superseded by 0022 |
| 0017 | Documentation site on GitHub Pages with VitePress | Accepted |
| 0018 | Excalidraw diagrams rendered to SVG with headless Chrome | Accepted |
| 0019 | Dependabot branches in the branch policy, and Mermaid pinned to 11 | Accepted |
| 0020 | Dependabot reads its configuration from main | Accepted |
| 0021 | Metadata cache and a REST-only describe_table | Accepted |
| 0022 | Releases with Release Please, squash merges into develop and an install script | Accepted |
| 0023 | Agent statements module for execute_sql and get_statement | Accepted |
| 0024 | A disabled metadata cache is an adapter | Accepted |
Current design: docs/design.md.