Architecture Overview
Layer 1: Intent qail-core AST + parser + validator Layer 2: Protocol AST -> PostgreSQL/Qdrant wire messages Layer 3: Drivers Connection I/O, pooling, response decode Layer 4: Tooling CLI, static fixtures, compatibility transpiler
Plain English: app input becomes one typed AST, then protocol messages are sent to the database engine.
Release Snapshot
Latest stable: v0.27.0 (March 25, 2026)
Current release track includes pipeline API naming consistency, AST pipeline strategy/planner controls,
and cached execution-path hardening.
Runtime tenant scoping remains tenant-only (tenant_id) across auth and RLS flows.
Gateway AutoREST page: /gateway
Layer 1: Intent (qail-core)
| Component | Ready | Notes |
|---|---|---|
| Qail AST | ✓ | Core typed structure for read/write/query workflows |
| Builder API | ✓ | .get() .filter() .order_by() .limit() |
| Parser | ✓ | Text syntax to AST for CLI/LSP pipelines (browser WASM packaging deferred) |
| Validator | ✓ | Schema checks with field/type hints |
| Formatter | ✓ | Canonical output for qail fmt |
| Schema-as-Proof | ✓ | Compile-time proof path via TypedQail, RelatedTo, and RLS witness builders |
Dedicated SDK page: /sdk
Layer 2: Protocol Encoders
| Target | Query Path | Params | Scope |
|---|---|---|---|
 PostgreSQL | ✓ | ✓ | Production protocol path |
 Qdrant | ✓ | ✓ | Active vector target (driver surface currently beta) |
| Native Cache | ✓ | ✓ | Built-in cache layer (Moka) |
Layer 3: Drivers
| Driver | Language | Connection | Pooling | Status |
|---|---|---|---|---|
 qail-pg | Rust | ✓ | ✓ | Production |
 qail-zig | Zig | ✓ | ✓ | Production |
| qail-qdrant | Rust | ✓ | ✓ | Beta (vector) |
SDK Surface
| SDK | Package / Path | Status | Notes |
|---|---|---|---|
| TypeScript | @qail/client | Production | First-party direct SDK |
| Swift | sdk/swift | Production | First-party direct SDK |
| Kotlin | sdk/kotlin | Production | First-party direct SDK |
 Node.js Native | deferred | Deferred | Native binding remains out of current release scope |
Layer 4: Tooling
| Tool | State | Purpose |
|---|---|---|
| qail CLI | Live | Build, validate, format, and migration workflows |
| Static validation fixtures | Live | CLI-first reference fixtures and query-shape validation flow |
| SQL Transpiler Compatibility | Live | Compatibility output for docs/tooling paths |
| Browser WASM Transpiler | Deferred | Out of current release scope; use CLI/runtime driver paths instead |