chore: remove dead native bindings, stub entries, Rust items and test helpers

Remove 33 native functions that no Python or Rust code calls besides
their registration, the stub entries no Python code names (keeping
every class a kept entry annotates), public Rust constants, methods
and wrappers nothing uses, unused test helpers and a dead test helper
package, nine workflow path filters that match deleted directories,
and the unused `rich` runtime dependency.

Add `make check-native-stub`, part of `make check-ci`: the stub may
declare only functions, classes and constants the extension
registers; protocols, typed dicts, type aliases and private stub-only
classes are typing-only and exempt.

Author: kvlonge

.github/workflows/verify.yml

@@ -147,7 +147,7 @@ jobs:
                 ;;
             esac
             case "${path}" in
-              scripts/compiler_differential/*|scripts/run_compiler_differential.py|tests/*/scripts/compiler_differential/*|tests/goldens/*|tests/e2e/fixtures/*|website/examples/*|src/sqlbuild/cli/commands/_helpers/compile/*|.github/workflows/verify.yml|Makefile)
+              scripts/compiler_differential/*|scripts/run_compiler_differential.py|tests/*/scripts/compiler_differential/*|tests/goldens/*|tests/e2e/fixtures/*|website/examples/*|.github/workflows/verify.yml|Makefile)
                 compiler_differential=true
                 ;;
             esac
@@ -163,16 +163,16 @@ jobs:
                 performance=true
                 rules_performance=true
                 ;;
-              src/sqlbuild/cli/commands/_helpers/compile/*|src/sqlbuild/executor/testing/*|scripts/cold_compile_performance/*|scripts/compile_performance_ratio/*|scripts/compare_compile_performance.py|tests/e2e/src/sqlbuild/cli/commands/main/compile/*)
+              src/sqlbuild/executor/testing/*|scripts/cold_compile_performance/*|scripts/compile_performance_ratio/*|scripts/compare_compile_performance.py|tests/e2e/src/sqlbuild/cli/commands/main/compile/*)
                 broad=true
                 performance=true
                 ;;
-              src/sqlbuild/cli/commands/_helpers/lineage/*|src/sqlbuild/cli/commands/_helpers/plan/*|src/sqlbuild/cli/commands/_helpers/scope/*|src/sqlbuild/cli/commands/_helpers/build_planning/*|src/sqlbuild/cli/commands/main/inspection/*|src/sqlbuild/cli/commands/main/project/*|src/sqlbuild/cli/output/*|src/sqlbuild/executor/build/*|src/sqlbuild/executor/run/*|src/sqlbuild/presentation/*)
+              src/sqlbuild/executor/build/*|src/sqlbuild/executor/run/*|src/sqlbuild/presentation/*)
                 # Inspection, plan, and build guards run inside the fresh-process compile jobs.
                 broad=true
                 performance=true
                 ;;
-              src/sqlbuild/rule_engine/*|src/sqlbuild/lint/*|scripts/rules_benchmark/*|scripts/benchmark_rules_ci.py|tests/performance/*)
+              src/sqlbuild/rule_engine/*|src/sqlbuild/lint/*|scripts/rules_benchmark/*|scripts/benchmark_rules_ci.py)
                 broad=true
                 performance=true
                 format_performance=true

Makefile

@@ -1,6 +1,6 @@
 SHELL := /bin/bash
 
-.PHONY: verify verify-quick verify-pg coverage cli-preview rust-check check-native-layering check-build-features check-python-boundary check-release-gate check-docs-skill \
+.PHONY: verify verify-quick verify-pg coverage cli-preview rust-check check-native-layering check-native-stub check-build-features check-python-boundary check-release-gate check-docs-skill \
 	check-e2e-shards test-e2e-duckdb test-e2e-duckdb-build-core \
 	test-e2e-duckdb-build-incremental \
 	test-e2e-duckdb-cli-data test-e2e-duckdb-cli test-e2e-duckdb-inspection \
@@ -645,7 +645,7 @@ verify-quick:
 	exit $$status
 
 
-check-ci: check-e2e-shards check-native-layering check-build-features check-python-boundary check-release-gate check-docs-skill rust-lint
+check-ci: check-e2e-shards check-native-layering check-native-stub check-build-features check-python-boundary check-release-gate check-docs-skill rust-lint
 	uv run ruff format --check .
 	uv run ruff check .
 	uv run ty check src tests
@@ -657,6 +657,10 @@ check-native-layering:
 	uv run python -m scripts.check_native_layering
 
 
+check-native-stub:
+	uv run python -m scripts.check_native_stub
+
+
 check-build-features:
 	uv run python -m scripts.check_build_features
 

crates/sqlbuild-analysis/src/compiled_project/models.rs

@@ -140,16 +140,6 @@ pub struct ModelLoopSettings {
     pub require_sql_analysis: bool,
 }
 
-/// The `description` config value's shape.
-#[derive(Clone, Debug, Default, PartialEq, Eq)]
-pub enum DescriptionShape {
-    #[default]
-    Absent,
-    Text(String),
-    /// Present but not a non-blank string.
-    Invalid,
-}
-
 /// The per-model `sql_analysis` / legacy `sql_validation` override.
 #[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
 pub enum AnalysisOverride {

crates/sqlbuild-config/src/command_connection/constants.rs

@@ -4,7 +4,6 @@ pub const CLI_WAREHOUSE_SOURCE: &str = "--warehouse";
 pub const CONNECTION_WAREHOUSE_SOURCE: &str = "connection warehouse";
 pub const CONNECTION_DEFAULT_WAREHOUSE_SOURCE: &str = "connection default";
 pub const CONNECTION_WAREHOUSE_KEY: &str = "warehouse";
-pub const CONNECTION_DATABASE_KEY: &str = "database";
 pub const CONNECTION_SOURCE_KEY: &str = "source";
 pub const DBT_PROFILE_CONNECTION_SOURCE: &str = "dbt_profile";
 pub const DUCKDB_ADAPTER: &str = "duckdb";

crates/sqlbuild-core/src/dbt_cli/constants.rs

@@ -2,13 +2,6 @@
 
 /// The dbt executable when no override is set.
 pub const DEFAULT_DBT_EXECUTABLE: &str = "dbt";
-/// SQLBuild cursor flags `sqb dbt` forwards to SQLBuild.
-pub const CURSOR_FLAGS: [&str; 4] = [
-    "--start-cursor-ts",
-    "--end-cursor-ts",
-    "--start-cursor-int",
-    "--end-cursor-int",
-];
 /// SQLBuild-only flags `sqb dbt run` and `sqb dbt build` accept.
 pub const EXECUTION_SQLBUILD_FLAGS: [&str; 7] = [
     "--start-cursor-ts",

crates/sqlbuild-core/src/diagnostic_routing/constants.rs

@@ -57,7 +57,6 @@ pub const SAFE_FIELDS: [&str; 7] = [
 /// The safe fields a retained SQL diagnostic keeps.
 pub const SQL_SAFE_FIELDS: [&str; 4] = ["sql_action", "sql_digest", "sql_intent", "sql_query_id"];
 /// Python logging level numbers.
-pub const LEVEL_DEBUG: i64 = 10;
 pub const LEVEL_INFO: i64 = 20;
 pub const LEVEL_WARNING: i64 = 30;
 pub const LEVEL_ERROR: i64 = 40;

crates/sqlbuild-core/src/event_export/constants.rs

@@ -32,7 +32,6 @@ pub const OUTCOME_EVENT_TYPES: [&str; 6] = [
 pub const OUTCOME_RESERVE_FRACTION: f64 = 0.25;
 pub const RETRY_EVENT_TYPE: &str = "retry_scheduled";
 pub const RETRY_EVENT_KIND: &str = "retry";
-pub const RESOURCE_EVENT_PREFIX: &str = "resource";
 pub const FAILED_EVENT_SUFFIX: &str = "_failed";
 pub const FAILED_EVENT_PRIORITY: u8 = 3;
 pub const TERMINAL_EVENT_PRIORITY: u8 = 2;

crates/sqlbuild-core/src/text/models.rs

@@ -9,13 +9,6 @@ pub struct TextPosition {
     pub column: usize,
 }
 
-/// A half-open range of text.
-#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
-pub struct TextSpan {
-    pub start: TextPosition,
-    pub end: TextPosition,
-}
-
 /// Line starts of one text, converting offsets into Python-compatible lines and columns.
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct LineIndex<'text> {
@@ -64,38 +57,4 @@ impl<'text> LineIndex<'text> {
             column,
         })
     }
-
-    /// The position at a code-point offset (a Python string index), or `None` past the end.
-    pub fn position_at_char(&self, char_offset: usize) -> Option<TextPosition> {
-        if char_offset > self.char_len {
-            return None;
-        }
-        let line_index = self
-            .line_char_starts
-            .partition_point(|start| *start <= char_offset)
-            - 1;
-        let line_start = self.line_byte_starts[line_index];
-        let column = char_offset - self.line_char_starts[line_index] + 1;
-        let byte_offset = self.text[line_start..]
-            .char_indices()
-            .nth(column - 1)
-            .map_or(self.text.len(), |(offset, _)| line_start + offset);
-        Some(TextPosition {
-            byte_offset,
-            char_offset,
-            line: line_index + 1,
-            column,
-        })
-    }
-
-    /// The span between two UTF-8 byte offsets, or `None` when either end is not a position.
-    pub fn span_at_bytes(&self, start: usize, end: usize) -> Option<TextSpan> {
-        if start > end {
-            return None;
-        }
-        Some(TextSpan {
-            start: self.position_at_byte(start)?,
-            end: self.position_at_byte(end)?,
-        })
-    }
 }

crates/sqlbuild-core/src/text/tests/test_text.rs

@@ -2,9 +2,7 @@ use crate::text::main::decimal_digit_value::decimal_digit_value;
 use crate::text::main::decode_text::decode_text;
 use crate::text::main::is_decimal_digit::is_decimal_digit;
 use crate::text::models::LineIndex;
-use crate::text::tests::test_types::{
-    DecimalDigitTestCase, DecodeTestCase, PositionTestCase, SpanTestCase,
-};
+use crate::text::tests::test_types::{DecimalDigitTestCase, DecodeTestCase, PositionTestCase};
 
 #[test]
 fn given_offsets_when_indexing_text_then_lines_and_columns_match_python() {
@@ -61,45 +59,12 @@ fn given_offsets_when_indexing_text_then_lines_and_columns_match_python() {
     for test_case in test_cases {
         let index = LineIndex::new(test_case.text);
         let position = index.position_at_byte(test_case.byte_offset);
-        let round_trip = position.and_then(|found| index.position_at_char(found.char_offset));
         assert_eq!(
             position.map(|found| (found.char_offset, found.line, found.column)),
             test_case.expected_position,
             "{}",
             test_case.description
         );
-        assert_eq!(round_trip, position, "{} round trip", test_case.description);
-    }
-}
-
-#[test]
-fn given_byte_ranges_when_building_spans_then_both_ends_are_positions() {
-    let test_cases = [
-        SpanTestCase {
-            description: "range on the second line",
-            text: "one\ntwo é three",
-            byte_range: (8, 10),
-            expected_ends: Some(((2, 5), (2, 6))),
-        },
-        SpanTestCase {
-            description: "reversed range is rejected",
-            text: "one",
-            byte_range: (2, 1),
-            expected_ends: None,
-        },
-    ];
-    for test_case in test_cases {
-        let span = LineIndex::new(test_case.text)
-            .span_at_bytes(test_case.byte_range.0, test_case.byte_range.1);
-        assert_eq!(
-            span.map(|found| (
-                (found.start.line, found.start.column),
-                (found.end.line, found.end.column)
-            )),
-            test_case.expected_ends,
-            "{}",
-            test_case.description
-        );
     }
 }
 

crates/sqlbuild-core/src/text/tests/test_types.rs

@@ -5,13 +5,6 @@ pub(super) struct PositionTestCase {
     pub(super) expected_position: Option<(usize, usize, usize)>,
 }
 
-pub(super) struct SpanTestCase {
-    pub(super) description: &'static str,
-    pub(super) text: &'static str,
-    pub(super) byte_range: (usize, usize),
-    pub(super) expected_ends: Option<((usize, usize), (usize, usize))>,
-}
-
 pub(super) struct DecodeTestCase {
     pub(super) description: &'static str,
     pub(super) bytes: &'static [u8],