docs: clarify sqlquack positioning

Author: kvlonge

README.md

@@ -1,7 +1,9 @@
 # SQLQuack
 
-SQLQuack is an early-stage Rust SQL semantic engine for warehouse SQL analysis and fail-closed DuckDB transpilation.
+SQLQuack is an early-stage SQLGlot-inspired Rust engine for warehouse SQL analysis and fail-closed DuckDB transpilation.
 
-The project is inspired by SQLGlot's feature breadth, but it is not intended to be an `N x N` best-effort transpiler. SQLQuack focuses on structured analysis first and only emits DuckDB SQL when supported semantics are expected to be preserved.
+SQLQuack is not a broad `N x N` dialect transpiler. It is intended for callers that need structured facts about expanded warehouse SQL: diagnostics, output columns, references, lineage, and conservative type/nullability information.
+
+DuckDB output is fail-closed. SQLQuack should only emit DuckDB SQL when the source semantics are expected to be preserved; unsupported or ambiguous constructs should produce diagnostics instead of best-effort rewrites.
 
 Status: early development. APIs are unstable.

crates/sqlquack-structure-checker/tests/rules/imports.rs

@@ -13,8 +13,9 @@ const TEST_CASES: &[test_types::CheckRepoTestCase] = &[
     test_types::CheckRepoTestCase {
         description: "reports pub crate use reexport",
         repo_files: &[test_types::RepoFile {
-            path: "crates/sqlquack/src/analysis/mod.rs",
-            contents: "pub(crate) use models::AnalysisResult;\n",
+            path: "crates/sqlquack/src/analysis/models.rs",
+            contents:
+                "pub(crate) use crate::ast::models as ast_models;\npub struct AnalysisResult;\n",
         }],
         expected_violation_codes: &["SQS023"],
     },

crates/sqlquack/Cargo.toml

@@ -5,8 +5,8 @@ edition.workspace = true
 license.workspace = true
 repository.workspace = true
 readme.workspace = true
-description = "Rust SQL semantic analysis and fail-closed DuckDB transpilation engine"
-keywords = ["sql", "duckdb", "parser", "transpiler", "lineage"]
+description = "Warehouse SQL analysis and fail-closed DuckDB transpilation engine"
+keywords = ["sql", "duckdb", "parser", "analysis", "lineage"]
 categories = ["parser-implementations", "database"]
 
 [dependencies]