blq-cli 1.2.0__tar.gz → 1.2.2__tar.gz

{blq_cli-1.2.0 → blq_cli-1.2.2}/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## v1.2.2
+
+### Fixed — Suppress FastMCP banners on stdio transport
+
+When starting the MCP server over stdio, FastMCP banner rendering is suppressed
+(`show_banner=False`) so that stdout contains strictly valid JSON-RPC messages
+without terminal box decorations. Also derives `__version__` from installed package
+metadata.
+
+## v1.2.1
+
+### Fixed — 1.2.0 was broken on Python 3.10 and 3.11
+
+The TypedDicts added in 1.2.0 were imported from `typing`. pydantic refuses to
+build a schema from `typing.TypedDict` below 3.12 ("Please use
+`typing_extensions.TypedDict` instead"), so importing `blq.serve` raised on
+every supported Python under 3.12 — which is to say the MCP server did not
+start at all there.
+
+`requires-python` is `>=3.10`, so 1.2.0 should not have shipped. It passed
+local checks because the development interpreter was 3.14; CI caught it on the
+3.10 matrix entry, but the publish workflow triggers on release rather than on
+a green CI run, so the package reached PyPI anyway.
+
+Now imported from `typing_extensions` below 3.12, with the backport declared as
+a conditional dependency. Verified against a real 3.11 interpreter: 1382 tests
+pass, where 1.2.0 could not import.
+
+**If you installed 1.2.0 on Python 3.10 or 3.11, upgrade.** On 3.12+ it was
+unaffected.
+
+
 ## v1.2.0
 
 ### Added — MCP tools publish the names of the keys they return (#47)

{blq_cli-1.2.0 → blq_cli-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: blq-cli
-Version: 1.2.0
+Version: 1.2.2
 Summary: Build Log Query - capture and query build/test logs with DuckDB
 Project-URL: Homepage, https://blq-cli.readthedocs.io/
 Project-URL: Repository, https://github.com/teaguesterling/blq-cli
@@ -27,6 +27,7 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: tabulate>=0.9.0
 Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typing-extensions>=4.0; python_version < '3.12'
 Requires-Dist: watchdog>=3.0.0
 Provides-Extra: dev
 Requires-Dist: fastmcp>=2.0.0; extra == 'dev'

{blq_cli-1.2.0 → blq_cli-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "blq-cli"
-version = "1.2.0"
+version = "1.2.2"
 description = "Build Log Query - capture and query build/test logs with DuckDB"
 readme = "README.md"
 license = "MIT"
@@ -33,6 +33,9 @@ dependencies = [
     "pyyaml>=6.0",
     "tabulate>=0.9.0",
     "tomli>=2.0.0;python_version<'3.11'",
+    # pydantic will not build a schema from `typing.TypedDict` below 3.12, so
+    # the MCP tools' output schemas need the backport there.
+    "typing_extensions>=4.0;python_version<'3.12'",
     "tomli-w>=1.0.0",
     "watchdog>=3.0.0",
 ]

blq_cli-1.2.2/src/blq/__init__.py

@@ -0,0 +1,32 @@
+"""
+blq - Log Query
+
+Capture and query build/test logs with DuckDB.
+
+Example usage:
+    from blq import LogStore, LogQuery
+
+    # Query stored events
+    store = LogStore.open()
+    errors = store.errors().filter(ref_file="%main%").df()
+
+    # Query a log file directly
+    events = LogQuery.from_file("build.log").filter(severity="error").df()
+"""
+
+from importlib.metadata import PackageNotFoundError, version as _dist_version
+
+# Derived, never written by hand. The literal here read "1.0.1" against a
+# distribution version of 1.2.1 — two releases stale, and immune to
+# --force-reinstall because it was not derived from anything. Nothing consumes
+# it today (the CLI reads importlib.metadata directly), which is exactly why it
+# drifted unnoticed; a version string that lies makes a healthy install look
+# broken, which is the most expensive direction to send a reader.
+try:
+    __version__ = _dist_version("blq-cli")
+except PackageNotFoundError:  # running from a source tree with no install
+    __version__ = "0.0.0.dev0"
+
+from blq.query import LogQuery, LogQueryGrouped, LogStore
+
+__all__ = ["LogQuery", "LogStore", "LogQueryGrouped", "__version__"]

{blq_cli-1.2.0 → blq_cli-1.2.2}/src/blq/serve.py

@@ -34,7 +34,17 @@ import re as _re
 import shlex
 import subprocess
 import sys
-from typing import Any, TypedDict
+from typing import Any
+
+# pydantic rejects `typing.TypedDict` below 3.12 and refuses to build a schema
+# from it ("Please use typing_extensions.TypedDict instead"). This package
+# supports 3.10+, so the stdlib import breaks every MCP tool on 3.10/3.11 —
+# which is exactly how it shipped in 1.2.0, because the dev interpreter was
+# 3.14 and only CI runs the older matrix.
+if sys.version_info >= (3, 12):
+    from typing import TypedDict
+else:
+    from typing_extensions import TypedDict
 
 import pandas as pd  # type: ignore[import-untyped]
 from fastmcp import FastMCP
@@ -4164,9 +4174,9 @@ def serve(
     _init_disabled_tools(cli_disabled=disabled_tools, safe_mode=safe_mode)
 
     if transport == "stdio":
-        mcp.run()
+        mcp.run(show_banner=False)
     elif transport == "sse":
-        mcp.run(transport="sse", port=port)
+        mcp.run(transport="sse", port=port, show_banner=False)
     else:
         raise ValueError(f"Unknown transport: {transport}")
 

blq_cli-1.2.2/tests/test_version.py

@@ -0,0 +1,37 @@
+"""The exported version must match the installed distribution.
+
+`__version__` was a hand-written literal and drifted two releases behind
+pyproject.toml before anyone noticed — nothing consumes it (the CLI reads
+importlib.metadata directly), so nothing failed. The same defect in squackit
+reached four releases of drift.
+
+Asserting a hardcoded string here would recreate the problem: the module and
+its test would agree with each other and with nothing else. Assert the
+correspondence instead.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+
+def test_version_matches_the_installed_distribution():
+    import blq
+
+    try:
+        expected = version("blq-cli")
+    except PackageNotFoundError:
+        expected = "0.0.0.dev0"
+    assert blq.__version__ == expected
+
+
+def test_version_is_not_a_hardcoded_literal():
+    """Guard the mechanism, not just today's value."""
+    import pathlib
+
+    src = pathlib.Path(blq_init()).read_text()
+    assert "_dist_version" in src, "version is no longer derived from metadata"
+
+
+def blq_init():
+    import blq
+
+    return blq.__file__

blq_cli-1.2.0/src/blq/__init__.py

@@ -1,21 +0,0 @@
-"""
-blq - Log Query
-
-Capture and query build/test logs with DuckDB.
-
-Example usage:
-    from blq import LogStore, LogQuery
-
-    # Query stored events
-    store = LogStore.open()
-    errors = store.errors().filter(ref_file="%main%").df()
-
-    # Query a log file directly
-    events = LogQuery.from_file("build.log").filter(severity="error").df()
-"""
-
-__version__ = "1.0.1"
-
-from blq.query import LogQuery, LogQueryGrouped, LogStore
-
-__all__ = ["LogQuery", "LogStore", "LogQueryGrouped", "__version__"]