blq-cli 0.1.0__tar.gz

blq_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+      
+      - name: Run ruff check
+        run: ruff check .
+      
+      - name: Run ruff format check
+        run: ruff format --check .
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      
+      - name: Run tests with coverage
+        run: |
+          pytest --cov=blq --cov-report=xml --cov-report=term
+      
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12'
+        with:
+          files: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+      
+      - name: Build package
+        run: python -m build
+      
+      - name: Check package
+        run: |
+          pip install twine
+          twine check dist/*
+      
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

blq_cli-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,33 @@
+name: Documentation
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material
+      
+      - name: Build documentation
+        run: mkdocs build
+      
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        with:
+          name: docs
+          path: site/

blq_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Deployment environment'
+        required: true
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+      
+      - name: Build package
+        run: python -m build
+      
+            # - name: Publish to TestPyPI
+            #   if: github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'testpypi'
+            #   uses: pypa/gh-action-pypi-publish@release/v1
+            #   with:
+            #     repository-url: https://test.pypi.org/legacy/
+      
+      - name: Publish to PyPI
+        if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'pypi')
+        uses: pypa/gh-action-pypi-publish@release/v1

blq_cli-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# mypy
+.mypy_cache/
+
+# lq data (local to each project)
+.lq/
+
+# Documentation
+site/

blq_cli-0.1.0/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "lq": {
+      "command": "lq",
+      "args": ["serve"]
+    }
+  }
+}

blq_cli-0.1.0/.readthedocs.yml

@@ -0,0 +1,16 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+mkdocs:
+  configuration: mkdocs.yml
+
+python:
+  install:
+    - requirements: docs/requirements.txt

blq_cli-0.1.0/AGENT.md

@@ -0,0 +1,88 @@
+# lq Agent Interface
+
+This document describes how AI agents should interact with `blq` for efficient log analysis.
+
+## Token-Efficient Workflow
+
+**Problem**: Raw build logs can be 10MB+, burning context when agents just need "what failed?"
+
+**Solution**: Use `blq` commands for structured, minimal-token queries.
+
+### Quick Status Check (~10 tokens output)
+```bash
+blq status
+```
+Output:
+```
+[ OK ] make
+[FAIL] gh run 123
+[WARN] eslint
+```
+
+### Get Errors (~200 tokens for 5 errors)
+```bash
+blq errors --limit 5
+```
+
+### Compact Format (~100 tokens for 10 errors)
+```bash
+blq errors --compact --limit 10
+```
+Output:
+```
+src/main.cpp:42:5: undefined reference to 'foo'
+src/utils.cpp:15:1: missing semicolon
+```
+
+### JSON for Programmatic Use
+```bash
+blq errors --json --limit 5
+```
+
+## MCP Tools (When Integrated)
+
+When `blq` is exposed via duckdb_mcp, agents can use these tools:
+
+| Tool | Description | Token Cost |
+|------|-------------|------------|
+| `blq_status` | Quick status badges | ~10 |
+| `blq_errors` | Recent errors | ~200 |
+| `blq_summary` | Aggregate by tool/category | ~100 |
+| `blq_sql` | Custom queries | Variable |
+
+## Recommended Agent Workflow
+
+1. **Start with status**: `blq status` - see if anything failed
+2. **Drill into failures**: `blq errors --source "failed_source" --limit 5`
+3. **Get context if needed**: `blq sql "SELECT * FROM lq_events WHERE event_id = 42"`
+
+## SQL Macros Available
+
+```sql
+-- Quick queries
+FROM lq_status();           -- Status badges
+FROM lq_errors(10);         -- Recent errors
+FROM lq_warnings(10);       -- Recent warnings
+FROM lq_summary();          -- Aggregate summary
+
+-- Filtered queries
+FROM lq_errors_for('make', 5);  -- Errors for specific source
+FROM lq_file('main.cpp');       -- Events for specific file
+
+-- History
+FROM lq_history(20);        -- Run history
+lq_diff(run1, run2);        -- Compare two runs
+```
+
+## Storage Location
+
+Logs are stored in `.lq/logs/` with Hive partitioning:
+```
+.lq/logs/date=2024-01-15/source=run/001_make_103000.parquet
+```
+
+Agents can directly query parquet files if needed:
+```sql
+SELECT * FROM read_parquet('.lq/logs/**/*.parquet', hive_partitioning=true)
+WHERE severity = 'error'
+```