Skip to content

Convert Claude Code or Codex into the most intelligent Deep Research Agent. Collect, search, and synthesize web research into a persistent, searchable wiki that builds on itself. Hosted API + MCP: hyperresearch.ai

fix: make CI install what the tests import, and lock packaging metadata (#40)

synqing618a8a5ef5a9
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6a8c787..d7fc7a7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -18,6 +18,7 @@ jobs:
- uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
- - run: pip install -e ".[dev]"
+ - run: pip install -e ".[dev]" build
- run: ruff check src/ tests/
- run: pytest tests/ -v
+ - run: python -m build --outdir /tmp/hyperresearch-dist
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 4b80b9b..84722ae 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -21,8 +21,14 @@ jobs:
with:
python-version: "3.13"
- - name: Install build tools
- run: pip install build
+ - name: Install test and build tools
+ run: pip install -e ".[dev]" build
+
+ - name: Lint
+ run: ruff check src/ tests/
+
+ - name: Test
+ run: pytest tests/ -v
- name: Build package
run: python -m build
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 65c80b7..7678215 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
# Changelog
+## [Unreleased]
+
+### Release readiness and deployability
+
+- **Version metadata is consistent again.** `hyperresearch.__version__` now tracks the version declared in `pyproject.toml`, fixing the state where the built wheel reported `0.8.6` while `hyperresearch --version` reported `0.8.5`.
+- **CI installs the dependencies used by the tests.** The `dev` extra now includes `exa-py`, so the Exa provider tests pass under the same `pip install -e ".[dev]"` command CI runs. Without it, `main` fails 10 tests in `tests/test_web/test_exa_provider.py` with `ModuleNotFoundError: No module named 'exa_py'`.
+- **Optional extras match CLI guidance.** Declared the `crawl4ai` and `watch` extras the CLI already directs users to install. `pip install hyperresearch[watch]` previously resolved to no extra and installed no `watchdog`, so `hpr watch` stayed broken while telling the user to run the command that had just failed.
+- **Publish workflow now gates on lint and tests before building.** Tagged releases still publish via trusted PyPI publishing, but the publish job now fails before upload if ruff or pytest fails.
+- **Packaging regression tests added.** The test suite now checks that runtime version metadata tracks `pyproject.toml` and that dev/install extras cover the tested optional provider surface.
+
## [0.8.6] - 2026-05-14
### Run-to-run safety: no more silent overwrites between /hyperresearch sessions
diff --git a/pyproject.toml b/pyproject.toml
index 4ecdf33..871e22c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -34,14 +34,20 @@ dependencies = [
]
[project.optional-dependencies]
+crawl4ai = ["Crawl4AI>=0.4"]
mcp = ["mcp>=1.6"]
exa = ["exa-py>=2.0.0"]
-all = ["hyperresearch[mcp,exa]"]
+watch = ["watchdog>=4.0"]
+all = ["hyperresearch[crawl4ai,mcp,exa,watch]"]
dev = [
"pytest>=7.4",
"pytest-cov>=4.1",
"ruff>=0.3",
"mypy>=1.8",
+ "exa-py>=2.0.0",
+ "mcp>=1.6",
+ "types-PyYAML>=6.0.12",
+ "watchdog>=4.0",
]
[project.scripts]
diff --git a/src/hyperresearch/__init__.py b/src/hyperresearch/__init__.py
index 6ee899c..b482de3 100644
--- a/src/hyperresearch/__init__.py
+++ b/src/hyperresearch/__init__.py
@@ -1,3 +1,3 @@
"""Hyperresearch — agent-driven research knowledge base."""
-__version__ = "0.8.5"
+__version__ = "0.8.6"
diff --git a/tests/test_core/test_packaging.py b/tests/test_core/test_packaging.py
new file mode 100644
index 0000000..3024ecb
--- /dev/null
+++ b/tests/test_core/test_packaging.py
@@ -0,0 +1,31 @@
+"""Packaging and release metadata regression tests."""
+
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+import hyperresearch
+
+
+def _pyproject() -> dict:
+ root = Path(__file__).resolve().parents[2]
+ with (root / "pyproject.toml").open("rb") as f:
+ return tomllib.load(f)
+
+
+def test_runtime_version_matches_project_metadata():
+ """The CLI version comes from __version__, so it must track package metadata."""
+ project = _pyproject()["project"]
+ assert hyperresearch.__version__ == project["version"]
+
+
+def test_dev_extra_covers_tested_optional_providers():
+ """CI installs only .[dev], so dev must include optional providers tested by pytest."""
+ optional = _pyproject()["project"]["optional-dependencies"]
+ dev_deps = set(optional["dev"])
+
+ assert "exa-py>=2.0.0" in dev_deps
+ assert "exa" in optional
+ assert "crawl4ai" in optional
+ assert "watch" in optional