How manveer04/qryndel works
Qryndel is a SQLite-first query language for safely running reads, joins, aggregates, writes, and transactions. The main workflow is a CLI or Python client submitting UDL; the client parses and validates it against schema and safety rules, creates and optimizes a logical plan, compiles parameterized SQLite, then executes under budgets and optionally verifies result contracts. Separate capabilities include explain/preview, schema-drift checks, metrics, and agent-oriented read-only access. Relationships are based on README statements and SOURCE INDEX references; unsampled implementation details are not asserted.
Main entry points: sdk.py Python client · executor.py Query execution · logical_plan.py Logical plan · cli.py UDL CLI
Components 20
User interfaces
- UDL CLI
qryndel/cli.py - Python client
qryndel/sdk.py
Language processing
- UDL parser
qryndel/parser.py - Query AST
qryndel/ast_nodes.py - Rule expansion
qryndel/rules.py
Planning and validation
- Semantic validation
qryndel/semantic.py - Schema discovery
qryndel/schema.py - Schema drift
qryndel/schema_drift.py - Query optimizer
qryndel/optimizer.py - Logical plan
qryndel/logical_plan.py - Capability checks
qryndel/capabilities.py - Safety controls
qryndel/safety.py
SQLite runtime
- SQLite compiler
qryndel/backends/sqlite.py - SQLite database
- Query execution
qryndel/executor.py - Execution budgets
qryndel/budgets.py - Result contracts
qryndel/contracts.py - Explain output
qryndel/explain.py - Execution metrics
qryndel/metrics.py
Other components
- Query caller
Connections 25
- Query caller → UDL CLI: submits query
README.md - Query caller → Python client: submits query
README.md - UDL CLI → Python client: invokes
qryndel/cli.py - Python client → UDL parser: parses
qryndel/sdk.py - UDL parser → Query AST: constructs
qryndel/parser.py - Python client → Schema discovery: loads schema
README.md - Python client → Semantic validation: validates
qryndel/sdk.py - Semantic validation → Rule expansion: expands rules
qryndel/semantic.py - Semantic validation → Query AST: checks nodes
qryndel/semantic.py - Python client → Query optimizer: optimizes query
qryndel/sdk.py - Query optimizer → Logical plan: rewrites plan
qryndel/optimizer.py - Python client → Logical plan: builds plan
qryndel/sdk.py - Logical plan → Query AST: uses nodes
qryndel/logical_plan.py - Python client → Safety controls: applies controls
qryndel/sdk.py - Python client → SQLite compiler: compiles plan
qryndel/sdk.py - SQLite compiler → Capability checks: preflights features
qryndel/backends/sqlite.py - SQLite compiler → Logical plan: compiles plan
qryndel/backends/sqlite.py - Python client → Query execution: runs compiled query
qryndel/sdk.py - Query execution → SQLite database: executes SQL
README.md - Query execution → Execution budgets: enforces limits
qryndel/executor.py - Python client → Result contracts: verifies results
qryndel/sdk.py - Python client → Explain output: formats explanation
qryndel/sdk.py - Python client → Schema drift: checks declarations
qryndel/sdk.py - UDL CLI → Schema drift: offers drift check
qryndel/cli.py - Query execution → Execution metrics: records execution
qryndel/executor.py