leankg 0.12.2

Lightweight Knowledge Graph for AI-Assisted Development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

# Tech Stack

| Component | Technology |
|-----------|------------|
| Language | Rust |
| Database | CozoDB (embedded relational-graph, Datalog queries) |
| Parsing | tree-sitter |
| CLI | Clap |
| Web Server | Axum |

# Project Structure

```
src/
  main.rs       - CLI entry point (28+ commands)
  lib.rs        - Library exports
  cli/          - CLI commands (Clap)
  config/       - Project configuration
  db/           - CozoDB persistence layer (models, schema, operations)
  doc/          - Documentation generator + wiki generation
  doc_indexer/  - Documentation indexer (docs/ → documented_by edges)
  graph/        - Graph query engine (queries, traversal, context, clustering, cache, export)
  indexer/      - Code parser (tree-sitter, 13 parsers, extractors, git analysis, Terraform, CI/CD)
  mcp/          - MCP protocol handler (35 tools, rmcp)
  orchestrator/ - Query orchestration with intent parsing and persistent cache
  compress/     - RTK-style compression (8 read modes, response/shell/cargo/git compressors, entropy)
  web/          - Web UI server (Axum, 20+ routes)
  api/          - REST API handlers, auth middleware
  watcher/      - File change watcher (notify)
  hooks/        - Git hooks (pre-commit, post-commit, post-checkout, GitWatcher)
  benchmark/    - Benchmark runner (vs OpenCode, Gemini, Kilo)
  registry.rs   - Global repository registry (multi-repo)
  runtime.rs    - Tokio runtime utilities

docs/
  prd.md        - Product Requirements Document
  erd.md        - Engineering Requirements / High Level Design
  mcp-tools.md  - MCP tools reference
  cli-reference.md - CLI commands reference
  roadmap.md    - Feature roadmap
  analysis/     - Analysis documents
```

# Supported Languages

LeanKG supports indexing and analysis for the following languages:

| Language | Extensions | Support Level |
|----------|------------|---------------|
| Go | `.go` | Full - functions, structs, interfaces, imports, calls |
| TypeScript | `.ts`, `.tsx` | Full - functions, classes, imports, calls |
| JavaScript | `.js`, `.jsx` | Full - functions, classes, imports, calls |
| Python | `.py` | Full - functions, classes, imports, calls |
| Rust | `.rs` | Full - functions, structs, traits, imports, calls |
| Java | `.java` | Full - classes, interfaces, methods, constructors, enums, imports, calls |
| Kotlin | `.kt`, `.kts` | Full - classes, objects, companion objects, functions, constructors, imports, calls |
| Terraform | `.tf` | Full - resources, variables, outputs, modules |
| YAML | `.yaml`, `.yml` | Full - CI/CD pipelines, configurations |
| Markdown | `.md` | Full - documentation sections, code references |
| C/C++ | `.cpp`, `.cxx`, `.cc`, `.hpp`, `.h`, `.c` | Full - functions, classes, structs, imports, calls |
| C# | `.cs` | Full - classes, methods, imports, calls |
| Ruby | `.rb` | Full - classes, modules, methods, imports, calls |
| PHP | `.php` | Full - classes, functions, imports, calls |
| Dart | `.dart` | Parser only (no extraction) |
| Swift | `.swift` | Parser only (no extraction) |

# Architecture

```mermaid
graph TB
    subgraph "AI Tools"
        Claude[Claude Code]
        Open[OpenCode]
        Cursor[Cursor]
        Antigravity[Google Antigravity]
    end

    subgraph "LeanKG"
        CLI[CLI Interface]
        MCP[MCP Server]
        Watcher[File Watcher]
        Hooks[Git Hooks]
        Bench[Benchmark]
        Registry[Registry]
        API[REST API]

        subgraph "Core"
            Indexer[tree-sitter Parser]
            Graph[Graph Engine]
            Cache[Query Cache]
            Orch[Orchestrator]
            Compress[Compress]
        end

        subgraph "Storage"
            CozoDB[(CozoDB)]
        end
    end

    Claude --> MCP
    Open --> MCP
    Cursor --> MCP
    Antigravity --> MCP
    CLI --> Indexer
    CLI --> Graph
    Watcher --> Indexer
    Hooks --> Indexer
    Indexer --> CozoDB
    Graph --> CozoDB
    Graph --> Cache
    Orch --> Graph
    Orch --> CozoDB
    Compress --> Orch
    Bench --> Graph
    Registry --> CozoDB
    API --> Graph
```