36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# Development
|
|
|
|
Requirements: Node.js 22.19+, npm, Pi credentials for live model tests, Docker with
|
|
Compose for local web services and experiments.
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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.
|