hypothesis-machine/docs/development.md

Development

Requirements: Node.js 22.19+, npm, Pi credentials for live model tests, Docker with Compose for local web services and experiments.

npm install
npm run typecheck
npm test
npm run build
npm run smoke
docker compose -f infra/compose.yaml config

The automated suite does not call a model or paid service. Integration tests use AgentRuntimeFactory fakes and cover child/grandchild lineage, parallel work, steering, cancellation, crash recovery, structured results, and findings.

Manual extension smoke without a model call:

printf '%s\n' '{"type":"get_commands"}' | \
  PI_OFFLINE=1 npx pi --mode rpc --no-session --no-extensions \
  --extension ./src/index.ts --approve

To inspect web health inside Pi, ask the agent to use a web tool or test the local endpoints directly. SearXNG JSON must be enabled by infra/searxng/settings.yml. Firecrawl v2 endpoints are used (/v2/scrape, /v2/crawl). SearXNG binds to host port 8888 by default; override it with SEARXNG_PORT and match searxng_url.

To reset only the derived search index, stop Pi and delete .hypothesis-machine/index.sqlite*; ResearchMemory.rebuildIndex() reconstructs it from Markdown. Never delete runs/, sources/, or experiments/ unless their loss is intended.