eSlider/2dph

Fork 0

Files

T

eSliderandGitHub fc2723c39f

Tests / Test (push) Skipped

Tests / OCR (tesseract fixture) (push) Skipped

Tests / Release (semver) (push) Skipped

feat: D24 fact intervals (--as-of) and bin/stack assistant helpers. (#37 )

Store valid_from/valid_to on leafs and filter search by calendar day without
overloading D16 source staleness; stack start/start-assistant wires brain + PicoClaw.

2026-08-14 15:48:26 +01:00

3.2 KiB

Raw Blame History

type, status, related

type

status

howto

current

docs/README.md

PLAN.md

Run 2dph (portable)

No laptop-absolute paths. Config lives in env files under $HOME/.config/brain/ (mode 0600), not in git.

Toolchain

Go (see go.mod)
Python 3.12 + uv
Optional: Docker, Zig CGO via bin/cgo/zig (not gcc)
Optional: poppler (pdftotext/pdftoppm) + tesseract eng+deu for mail OCR

uv venv .venv
uv pip install -r requirements.lock.txt
eval "$(bin/cgo/zig env)"   # when compiling Ladybug read tools
go test ./...
uv run python -m unittest discover -s bin/tools -t .

Config

File / env	Purpose
`$BRAIN_SEARCH_ENV` (default `$HOME/.config/brain/search.env`)	`BRAIN_SEARCH_URL` (SearXNG). Optional Basic Auth.
`$HOME/.config/brain/db-profiles.yml`	read-only Postgres profiles (OnlyOffice via tunnel)

If the host already runs SearXNG, point BRAIN_SEARCH_URL at it. Do not start a second copy (D3). Optional Compose instance:

SEARXNG_SECRET=$(openssl rand -hex 32) docker compose --profile searxng up -d

That binds 127.0.0.1:8888. JSON format must stay enabled.

Index then search

Write path is bin/brain/add.go for a leaf (or POST /ingest). Bulk corpus rebuild remains bin/brain/index.go --rebuild (Compose profile index). Do not DROP INDEX on Ladybug 0.19.

bin/brain/add.go --text "arc-1 runs Matrix" --root facts --source "compose.yml x docker ps"
bin/brain/index.go --rebuild --with-facts --with-chats
bin/brain/search.go "LadybugDB vector index"     # facts → info → web (D17)
bin/brain/search.go "upstream flag" --no-web
bin/brain/search.go "who works where" --as-of 2025-01-01  # D24 intervals
source <(./bin/cli/complete.go bash)            # D23 flaggy complete
bin/brain/get.go <id> --body
bin/brain/stats.go

--hop N walks File → Commit → Person from each hit. --as-of YYYY-MM-DD keeps leafs whose valid_from/valid_to cover that day (empty interval = legacy always-on). Empty web results are throttled, not absence. Gap to v1: roadmap / epic #16.

Ladybug 0.19: never DROP INDEX FTS/VECTOR (ghost catalog). Fresh indexes = delete var/kb.lbug then --rebuild.

HTTP / MCP

bin/stack/start                 # brain :8630, wait until MCP search/get/audit
bin/stack/status                # YAML: brain / reasoner / picoclaw
bin/stack/start-assistant       # + qwen3.5:9b + PicoClaw agent (ask the brain)
bin/stack/start-assistant --no-attach
bin/stack/stop                  # compose stop; volumes kept

Same Compose services by hand:

docker compose up -d brain                       # :8630 Zig CGO serve
docker compose --profile index run --rm index    # rebuild
docker compose --profile picoclaw up brain-mcp   # MCP 127.0.0.1:8630

GET /openapi.json, POST /mcp. Agent tool order: search → get → audit. See picoclaw.md.

Reasoner (optional, D18)

CPU sidecar on 127.0.0.1:11435. Weights are not in the 2dph image.

docker compose --profile reasoner up -d reasoner
REASONER_BASE_URL=http://127.0.0.1:11435/v1 ./bin/reasoner/bakeoff.go --json

See reasoner.md.

3.2 KiB Raw Blame History