Skip to content

blq v1.0.0 — Stable Release

Choose a tag to compare

@teaguesterling teaguesterling released this 31 Mar 02:54
· 27 commits to main since this release

blq v1.0.0

Build Log Query — capture, store, query, and sandbox build/test logs using DuckDB.

pip install blq-cli
blq init --detect
blq run test
blq errors
blq inspect test:1:1

Stability Guarantees

Starting with 1.0, the following are stable and won't change incompatibly:

  • CLI command names and flags
  • MCP tool names and parameters
  • TOML config format
  • Python API (LogStore, LogQuery, BlqStorage, services)
  • BIRD schema v3.0.0 (tables, columns, macros)
  • Storage directory: .bird/
  • Sandbox spec dimensions and presets
  • Plugin protocols (extensions, engines, annotators)

Highlights

  • 60+ log formats via duck_hunt (gcc, pytest, cargo, eslint, mypy, and more)
  • Sandbox enforcement — declarative specs with bwrap namespace isolation
  • MCP server — 18 tools for AI agent integration
  • Plugin system — extensions, sandbox engines, and annotators via entry points
  • Service layer — shared business logic, CLI and MCP always agree
  • 1,304 tests

Quick Start

pip install blq-cli
cd your-project
blq init --detect          # auto-detect build commands
blq run test               # capture test output
blq errors                 # see what failed
blq sandbox profile test   # discover resource usage
blq sandbox tighten test   # auto-narrow sandbox spec

Documentation