Skip to content

Commit 84fc76f

Browse files
rustyconoverclaude
andcommitted
docs(protocol): update the catalog query pushdown design to the VGI 2.1 baseline
Re-baselines the proposed design (originally 2026-09-13) on the current stack: wire 2.1.0 under vgi.v2, with query preparation proposed for 2.2.0; pinned component baselines for vgi-python, the extension, its DuckDB 1.5 submodule and the DuckDB 2.0 development tree. Automatic mode now prototypes an early bound-plan optimizer extension using DuckDB's LogicalPlanSQLExporter, keeping the original plan until the worker accepts, so a new catalog hook becomes a conditional alternative rather than a first dependency. Adds the integration decisions that reuse existing machinery (catalog_contents caches, generated routing, cancellation, credential-aware caches). The protocol index entry is updated to match. mkdocs build --strict passes. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
1 parent e4aa440 commit 84fc76f

2 files changed

Lines changed: 397 additions & 140 deletions

File tree

‎docs/protocol/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Each document declares its own status; “proposed” means the contract is stil
88
| [VGI Filter Encoding v2](vgi-filter-encoding-v2-spec.md) | **Normative, proposed** | Engine-neutral wire format, semantics, validation, and conformance requirements for `vgi.filters.v2`. |
99
| [VGI Runtime-Filter Artifacts](vgi-runtime-filter-artifacts.md) | **Normative optional extension, proposed** | Additional requirements for capability-gated advisory runtime-pruning artifacts. Base filter-v2 conformance does not require this extension. |
1010
| [VGI DuckDB Filter Adapter](vgi-duckdb-filter-adapter.md) | **Informative implementation guide, proposed** | DuckDB 1.5 and 2.0 mappings into the normative filter-v2 wire contract. |
11-
| [VGI catalog query pushdown](vgi-catalog-query-pushdown-design.md) | **Informative implementation design, proposed** | Optional read-query preparation and streaming, Python provider API, DuckDB 1.5 explicit execution, and DuckDB 2.0 automatic pushdown. |
11+
| [VGI catalog query pushdown](vgi-catalog-query-pushdown-design.md) | **Informative implementation design, proposed** | Updated 2026-10-06: proposed VGI 2.2 query preparation, DuckDB 1.5 explicit execution, and DuckDB 2.0 bound-plan SQL export for automatic pushdown. |
1212
| [Proposed VGI protocol changes for DuckDB 2.0](vgi-protocol-proposed-changes.md) | **Informative design/audit report** | Rationale, migration inventory, implementation status, and deferred protocol decisions. It is not an implementation specification. |
1313

1414
## Reading order

0 commit comments

Comments
 (0)