2.9 KiB

Raw Blame History

Central Brain — Graphify knowledge graph

One central, queryable brain that project graphs roll up into.

Topology (two brains)

Agentic-OS brain (WSL) — this folder. agentic-os.json + merged central-graph.json.
Windows central brain (device-wide, offline, standalone) — C:\Users\Austin\Brains\central\. Its own Python venv + Graphify, serves central-graph.json over HTTP MCP at http://127.0.0.1:8090/mcp from Windows. No WSL dependency at query time. WSL's sync-to-windows.sh pushes the merged graph into it hourly.

Per-project graphs: projects/<name>.json (linked via link-project.sh) roll up into central-graph.json here, which is then synced to Windows.

Commands (WSL side)

bash brain/graph/build-central.sh            # rebuild WSL central brain (code graph + merge linked projects)
bash brain/graph/link-project.sh <name> <graph.json>   # register a project's graph into the brain
bash brain/graph/sync-to-windows.sh          # rebuild + push merged graph to Windows central brain
bash brain/graph/serve-brain.sh             # serve WSL central brain over HTTP MCP (:8090)
bash brain/graph/serve-brain-wsl.sh         # redundant WSL serve (:8090, independent of Windows brain)
bash brain/graph/keepalive-brain-wsl.sh     # restart WSL serve if :8090 drops (fail-safe)

Set CENTRAL_BRAIN_PORT to override the serve port (default 8090).

Continuous learning

learn-loop.sh runs the self-improving pass (replaces the plain rebuild):

Rebuild code graph + cluster (edges + community labels).
If an LLM key is set (GEMINI/OPENAI/ANTHROPIC/GOOGLE), deep-extract brain/corpus/ (diagrams/designs/notes) into the graph.
Merge agentic-os + corpus + linked projects → central-graph.json.
Measure + heuristically optimize (offline learning): computes node/link counts, orphan rate, community-size balance, and file size; collapses tiny communities into _misc for tighter recall; records metrics to metrics.json and writes what it improved to learnings.md (the brain's own memory of improvements — compounds each run).
Sync to Windows brain (redundant).

Drop sources to learn from in brain/corpus/{diagrams,designs,notes}/. Without an LLM key, corpus files are stored but only become graph nodes via the semantic (keyed) path — code is always graphed offline.

Hourly cron agentic-os-brain-rebuild runs the learn-loop.

Notes

graphify's MCP HTTP serve requires the extra: pip install "graphifyy[mcp]" (done in the venv).
The write path for memory is still brain/*.md + audit + data/; graphify reads those, never writes them.
Rebuild is scheduled hourly by the agentic-os-brain-rebuild cron.
WSL serve is kept alive every 5 min by the agentic-os-brain-keepalive-wsl cron (fail-safe; mirrors Windows keepalive-brain.bat).
Two independent brain endpoints exist on :8090 — WSL (this tree) and Windows (C:\Users\Austin\Brains\central\). Either can answer if the other is down.

2.9 KiB Raw Blame History