okf-dashboard

Build an OKF dashboard (explore + ask)

Stand up the "use the brain" layer over an existing OKF bundle. Two halves — a graph explorer to see the brain and an ask-the-brain Q&A to query it. This skill is domain-agnostic: it works over any OKF bundle (gardening, academic, a company wiki), not one project.

A dashboard is a real piece of software — treat it as a build track, not a one-liner. But both halves read the same inputs the bundle already has: the typed markdown nodes, their frontmatter, and the markdown links between them. No database, no embedding store required.

Inputs (what both halves read)

• Nodes — the *.md files under concepts/ entities/ playbooks/ references/ systems/. Each carries frontmatter (type, title, description, tags, provenance, …).
• Edges — the bundle-relative markdown links in each node's body ([Title](/concepts/concept-x.md)). This is the same edge source lint/graph use. (Legacy [[wikilinks]] may also be parsed if present.)
• index.md — the curated navigation layer; the retrieval spine for ask-the-brain.

---

Part A — Graph explorer (see the brain)

If the bundle already has a generator, use it

If okf_tools.py is present, python okf_tools.py graph already writes a self-contained interactive okf-graph.html (force-directed, coloured by type). That is the reference implementation — run it, or copy/adapt it for a new bundle. okf_tools.py all also refreshes the index the graph relies on.

Building one from scratch (a bundle with no tooling)

Produce a single self-contained HTML file (inline the JS/CSS — no external CDN, so it stays as portable as the bundle itself). Two steps:

1. Extract the graph data. Walk the node files; for each, emit a node record and parse its body for markdown links to build edges:

   {
     "nodes": [
       {"id": "/concepts/concept-companion-planting.md", "label": "Companion planting",
        "type": "concept", "tags": ["pest-control"], "in_degree": 5, "out_degree": 2,
        "description": "…", "human_verified": false}
     ],
     "edges": [
       {"source": "/concepts/concept-companion-planting.md", "target": "/concepts/concept-crop-rotation.md"}
     ]
   }
   

2. Render it as a force-directed graph in one HTML file, colouring nodes by type, sizing them by centrality, and drawing edges directed (an arrow from the linking node to the node it links).