refactor: extract kb_framework package, build graph in memory

Scripts become thin CLIs over kb_framework (graph, query, query_tools, vault, instructions) so the hosted read-only connector shares one implementation with the stdio server. The MCP server builds the graph from Markdown on demand and invalidates it on writes; refresh_graph rebuilds in memory and reports validation problems. Pre-commit hook validates only; index/graph.json is no longer read, written or staged (generate-graph.py --write remains for operators). Golden fixtures pin graph and tool payloads to the previous output. Agent and skill docs updated to match. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-06 20:40:13 +02:00
parent 4fec637599
commit 96780317a7
37 changed files with 1858 additions and 899 deletions
@@ -0,0 +1,105 @@
+{
+  "version": 1,
+  "nodes": [
+    {
+      "id": "README",
+      "title": "README",
+      "path": "README.md",
+      "repo": "global",
+      "type": "note",
+      "status": "active",
+      "tags": [],
+      "last_reviewed": "",
+      "outbound_links": [],
+      "inbound_count": 0
+    },
+    {
+      "id": "area-ops",
+      "title": "Area Ops",
+      "path": "02_areas/ops.md",
+      "repo": "global",
+      "type": "area",
+      "status": "active",
+      "tags": [
+        "ops"
+      ],
+      "last_reviewed": "",
+      "outbound_links": [
+        "project-alpha"
+      ],
+      "inbound_count": 2
+    },
+    {
+      "id": "project-alpha",
+      "title": "Project Alpha",
+      "path": "01_projects/alpha.md",
+      "repo": "alpha",
+      "type": "project",
+      "status": "active",
+      "tags": [
+        "alpha",
+        "demo"
+      ],
+      "last_reviewed": "2026-01-01",
+      "outbound_links": [
+        "area-ops",
+        "resource-demo"
+      ],
+      "inbound_count": 1
+    },
+    {
+      "id": "resource-demo",
+      "title": "Demo Resource",
+      "path": "03_resources/demo/index.md",
+      "repo": "global",
+      "type": "reference",
+      "status": "active",
+      "tags": [
+        "demo"
+      ],
+      "last_reviewed": "",
+      "outbound_links": [
+        "area-ops"
+      ],
+      "inbound_count": 1
+    }
+  ],
+  "edges": [
+    {
+      "from": "area-ops",
+      "to": "project-alpha",
+      "kind": "markdown_link",
+      "type": "part-of",
+      "anchor_text": "Project Alpha",
+      "annotation": "",
+      "weight": 1.0
+    },
+    {
+      "from": "project-alpha",
+      "to": "area-ops",
+      "kind": "markdown_link",
+      "type": "depends-on",
+      "anchor_text": "Area Ops",
+      "annotation": "operations area",
+      "weight": 1.0
+    },
+    {
+      "from": "project-alpha",
+      "to": "resource-demo",
+      "kind": "markdown_link",
+      "type": "related",
+      "anchor_text": "the demo resource",
+      "annotation": "resource landing page.",
+      "weight": 1.0
+    },
+    {
+      "from": "resource-demo",
+      "to": "area-ops",
+      "kind": "markdown_link",
+      "type": "related",
+      "anchor_text": "Area Ops",
+      "annotation": "",
+      "weight": 1.0
+    }
+  ]
+}