typosaurus 808d6b4f83 test(sveta): Write unit and pipeline tests for the research engine
Outcome: done
Changed: tests/test_research_engine.py:1-198 (new), tests/test_research_pipeline.py:1-276 (new), tests/test_research_scheduling.py:7,366-380, tests/test_research_integration.py:1-112
Verified by: make verify -> exit_code 0, "Ran 219 tests OK verification passed" (baseline 199); only pre-existing StarletteDeprecationWarning from fastapi/testclient.py:1, none introduced
Findings:
- tests/test_research_engine.py (5 tests, mocked FakeResearchClient, no network): single-round closure; two-round discovery-then-closure with web/images/chat/describe items and round-2 describe of round-1 URL; new-content-alone does not prevent closure (engine.py:196 closure = new_urls==0 and new_queries==0); report/round to_dict serialisable; empty-subject ValueError with zero client calls.
- tests/test_research_pipeline.py (13 tests): extract_response web/ai/deep/chat/describe (pipeline.py:69), apply_extraction counts (pipeline.py:133), per-kind cache probes (pipeline.py:170), chat cached=True marks outcome cache_hit, RsearchError 503 failure outcome with pool survival, all-four-content-types drained through one run().
- tests/test_research_scheduling.py: +2 cache-TTL expiry tests with mocked time.monotonic (post-TTL and exact-TTL boundary, cache.py:20-44).
- tests/test_research_integration.py: converted from live-rsearch probe to offline mocked transport (patched urllib.request.urlopen, canned fixture); all original assertions preserved (second run cache_hit=True with zero additional r

Typosaurus-Run: 4e2afb673c7f4578a12276d9181b982d
Typosaurus-Node: 6aefb4137b954477a4b31e00ca0e91f7
Typosaurus-Agent: @sveta
Refs: #31
2026-08-07 23:39:53 +00:00

retoor retoor@molodetz.nl

typosaurus-sandbox

Sandbox for Typosaurus end-to-end verification.

A FastAPI application serving arithmetic operations over HTTP with JSON request/response bodies.

Configuration

The application uses a single .env.json file at the project root as its central point of truth for configuration. Defaults are plug-and-play and require no setup:

{
    "host": "127.0.0.1",
    "port": 8000
}

When no .env.json is present, the application starts with these defaults. To customise, create .env.json in the project root and populate only the keys that differ.

Usage

Start the server

python -m typosaurus_sandbox

The server listens on http://127.0.0.1:8000 by default.

Health check

GET /health

Response:

{"status": "ok"}

API endpoints

All calculator endpoints accept POST requests with a JSON body and return a JSON response.

POST /api/v1/calculator/add

Add two integers.

Request:

{"left": 3, "right": 5}

Response:

{"result": 8}

POST /api/v1/calculator/subtract

Subtract the right integer from the left.

Request:

{"left": 10, "right": 3}

Response:

{"result": 7}

POST /api/v1/calculator/clamp

Clamp a value between a low and high bound.

Request:

{"value": 15, "low": 0, "high": 10}

Response:

{"result": 10}

Boundaries are inclusive. A low > high combination produces a 422 validation response.

POST /api/v1/calculator/clamp-to-byte

Clamp an integer to the byte range [0, 255].

Request:

{"value": 300}

Response:

{"result": 255}

POST /api/v1/calculator/average

Compute the arithmetic mean of a list of values.

Request:

{"values": [1, 2, 3, 4, 5]}

Response:

{"result": 3.0}

An empty list produces a 422 validation response.

POST /api/v1/calculator/median

Compute the median of a list of values. Values are sorted internally; an even-length list returns the average of the two middle values as a float.

Request:

{"values": [1, 3, 5]}

Response:

{"result": 3.0}

Request (even length):

{"values": [1, 2, 3, 4]}

Response:

{"result": 2.5}

An empty list produces a 422 validation response.

POST /api/v1/calculator/variance

Compute the population variance of a list of values.

Request:

{"values": [1, 2, 3, 4, 5]}

Response:

{"result": 2.0}

An empty list produces a 422 validation response.

POST /api/v1/calculator/percentage

Compute what percentage value is of total.

Request:

{"value": 50, "total": 100}

Response:

{"result": 50.0}

A zero total produces a 422 validation response.

Verification

make verify

Runs compile-all checks against all source and test files, then executes the full test suite. Zero warnings are tolerated.

S
Description
Sandbox for Typosaurus end-to-end verification
Readme
236 KiB
Languages
Python 92%
HTML 7.3%
Makefile 0.7%