Skip to content

Commit b8a869b

Browse files
committed
feat: integrate clio-agentic-search into monorepo
- Remove planning artifacts (EXECUTION_PLAN, RISK_REGISTER, CLOUD_CONTINUE_HERE) - Add standalone CI jobs (ruff, mypy, pytest) to quality_control.yml - Add to README package listing as standalone service - Add dev commands section to CLAUDE.md - Add website entry in mcpData.js and docs page
1 parent e9e8dc1 commit b8a869b

8 files changed

Lines changed: 198 additions & 327 deletions

File tree

.github/workflows/quality_control.yml

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -246,3 +246,69 @@ jobs:
246246
fi
247247
248248
echo "PASS: server.json is in sync for ${{ matrix.mcp }}"
249+
250+
# ── clio-agentic-search (standalone service, not an MCP server) ──
251+
252+
agentic-search-ruff:
253+
name: Ruff - clio-agentic-search
254+
runs-on: ubuntu-latest
255+
steps:
256+
- uses: actions/checkout@v4
257+
- uses: astral-sh/setup-uv@v3
258+
with:
259+
version: "latest"
260+
- run: uv python install 3.12
261+
- name: Install dependencies
262+
run: |
263+
cd clio-agentic-search
264+
uv sync --all-extras --dev
265+
- name: Ruff lint
266+
run: |
267+
cd clio-agentic-search
268+
uv run ruff check --output-format=github .
269+
- name: Ruff format check
270+
run: |
271+
cd clio-agentic-search
272+
uv run ruff format --check .
273+
274+
agentic-search-mypy:
275+
name: MyPy - clio-agentic-search
276+
runs-on: ubuntu-latest
277+
continue-on-error: true
278+
steps:
279+
- uses: actions/checkout@v4
280+
- uses: astral-sh/setup-uv@v3
281+
with:
282+
version: "latest"
283+
- run: uv python install 3.12
284+
- name: Install dependencies
285+
run: |
286+
cd clio-agentic-search
287+
uv sync --all-extras --dev
288+
- name: Run MyPy
289+
run: |
290+
cd clio-agentic-search
291+
uv run mypy src/ --ignore-missing-imports --show-error-codes --no-error-summary
292+
293+
agentic-search-test:
294+
name: Test - clio-agentic-search (py${{ matrix.python-version }})
295+
runs-on: ubuntu-latest
296+
continue-on-error: ${{ matrix.python-version != '3.12' }}
297+
strategy:
298+
fail-fast: false
299+
matrix:
300+
python-version: ["3.10", "3.11", "3.12"]
301+
steps:
302+
- uses: actions/checkout@v4
303+
- uses: astral-sh/setup-uv@v3
304+
with:
305+
version: "latest"
306+
- run: uv python install ${{ matrix.python-version }}
307+
- name: Install dependencies
308+
run: |
309+
cd clio-agentic-search
310+
uv sync --all-extras --dev
311+
- name: Run tests
312+
run: |
313+
cd clio-agentic-search
314+
uv run pytest --ignore=tests/benchmarks -v --tb=short

CLAUDE.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ clio-kit/ # Monorepo root
3535
│ ├── plot/ # Data visualization
3636
│ ├── adios/ # ADIOS2 data I/O
3737
│ └── [each has its own pyproject.toml, dependencies, tests]
38+
├── clio-agentic-search/ # Standalone hybrid retrieval engine (not an MCP server)
3839
├── clio-kit-website/ # Docusaurus documentation site
3940
├── scripts/ # Utility scripts (generate_docs.py, etc)
4041
├── .github/workflows/ # CI/CD automation
@@ -129,6 +130,32 @@ uv run ruff check --fix .
129130
uv run mypy src/
130131
```
131132

133+
### clio-agentic-search (Standalone Service)
134+
135+
```bash
136+
# Setup
137+
cd clio-agentic-search
138+
uv sync --all-extras --dev
139+
140+
# Quality checks
141+
uv run ruff check .
142+
uv run ruff format --check .
143+
uv run mypy src/
144+
uv run pytest --ignore=tests/benchmarks -v
145+
146+
# Full quality gate (6 checks)
147+
uv run python -m clio_agentic_search.evals.quality_gate
148+
149+
# Run API server
150+
uv run uvicorn clio_agentic_search.api.app:app --reload
151+
152+
# CLI
153+
uv run clio query --namespace local_fs --q "pressure between 190 and 360 kPa"
154+
uv run clio index --namespace local_fs
155+
```
156+
157+
**Note**: clio-agentic-search is NOT an MCP server. It's a standalone FastAPI service with its own CI jobs in `quality_control.yml`. The launcher does not discover it.
158+
132159
## Architecture Patterns
133160

134161
### Standard MCP Server Structure

README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,12 @@ See [Claude Desktop MCP docs](https://modelcontextprotocol.io/quickstart/user) f
207207

208208
</div>
209209

210+
### Standalone Services
211+
212+
| **Service** | **Description** |
213+
|:---|:---|
214+
| **[`clio-agentic-search`](clio-agentic-search/)** | Hybrid retrieval engine with lexical, vector, and scientific search over namespaced document corpora |
215+
210216
---
211217

212218
## 📖 Usage Examples

clio-agentic-search/CLOUD_CONTINUE_HERE.md

Lines changed: 0 additions & 91 deletions
This file was deleted.

0 commit comments

Comments
 (0)