Skip to content

Latest commit

 

History

History

README.md

type reference
status current
related
docs/runbook.md
docs/design.md
PLAN.md

2dph docs

Evidence-first knowledge graph. Facts need proof or they are (not confirmed).

Docs policy: only what is true and current — what works, or what is open (tracked as Gitea issues). Plans and historical proofs live as Gitea issue comments, not here.

Type Doc
howto (run) runbook — build, config, serve/search/index
explanation design — two roots, deduction, versioning, read path
reference brain/memory-adr — единая модель фактов/аудита/хранения, границы, карта потребителей (P-9.6)
reference PLAN.md — decisions D1–D25
howto (brain ops) brain/rebuild — parallel write, resume
reference brain/read-contract — search/get/stats/audit formats, versioning (P-9.4)
reference brain/contract — write contract, ContentHash, corpus adapters (P-9.2/P-9.3)
howto (facts) facts/audit-recipes — audit recipes
howto (agent) picoclaw — MCP gateway (scripts/stack/start-assistant)
howto (reasoner) reasoner — CPU bench (D18)
testing test/README.md — system / stress / integration tiers
config etc/{searxng,picoclaw} — operator config (FHS)

Historical: roadmap (gap to v1, closed epic #16) kept for context; load baseline 2026-08-11 → Gitea #58.

Quick start

bin/brain/search.go "query"          # deduction: facts → info → web
bin/brain/serve.go                   # HTTP + OpenAPI + MCP (:8630)
bin/brain/index.go --rebuild         # bulk rebuild (Zig CGO)

MCP surface: search / get / audit. Full OpenAPI: GET /openapi.json.

Work board

Gitea issues: epic #66 (import → brain + CRM, priority), #62 (cash sprint), #64 (conversations v2), milestone v2. PRs and CI: GitHub eSlider/2dph.