feat: initialize Hypothesis Machine Pi extension

2026-07-31 22:36:16 +03:00
commit 528983ee50
57 changed files with 7790 additions and 0 deletions
@@ -0,0 +1,35 @@
+# 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.