grisuno · grisuno · Jul 31, 2026
diff --git a/KNOWLEDGE_BASE.md b/KNOWLEDGE_BASE.md
@@ -0,0 +1,193 @@
+# Polyglot Codebase Knowledge Graph
+
+> Generated offline by **readmenator**. Supports C, C++, Python, Go, Rust, JS/TS, Java, C#, Shell, PHP, Dart, GDScript, Nim, ASM, Ruby, Swift, Kotlin, Scala, Lua, Elixir.
+> No LLMs. No tokens. Pure static analysis. See more [here](https://github.com/grisuno/ReadMenator)
+
+**Total Files Parsed:** 2 | **Total Symbols Extracted:** 0 | **Total Imports:** 0
+
+<!-- ranking_model: v1.0 | weights: {ppr:0.45,auth:0.2,test:0.15,doc:0.1,fresh:0.1} | alpha:0.85 | commit:e63a2e6 | date:2026-07-18 -->
+
+
+## Table of Contents
+
+1. [Statistics Dashboard](#statistics-dashboard)
+2. [Architectural Layers](#architectural-layers)
+3. [Ranked Context](#ranked-context)
+4. [God Nodes](#god-nodes)
+5. [Suggested Questions](#suggested-questions)
+6. [Hotspot Analysis](#hotspot-analysis)
+7. [Change Impact Analysis](#change-impact-analysis)
+8. [Orphans](#orphans)
+9. [Query Recipes](#query-recipes)
+10. [Structural Knowledge Map](#structural-knowledge-map)
+11. [Code Property Graph](#code-property-graph)
+12. [Architecture Reference](#architecture-reference)
+    - [PY (1 files)](#py-1-files)
+    - [SH (1 files)](#sh-1-files)
+
+---
+
+## Statistics Dashboard
+
+| Metric | Value |
+|--------|-------|
+| Total Files | 2 |
+| Total Symbols | 0 |
+| Total Imports | 0 |
+| Call Edges | 0 |
+| Inheritance Edges | 0 |
+| Languages | 2 |
+| Avg Symbols/File | 0.0 |
+| Avg Imports/File | 0.0 |
+
+---
+
+## Architectural Layers
+
+Auto-detected from path patterns, naming conventions, and imported frameworks.
+
+| Layer | Files |
+|-------|-------|
+| utility | 2 |
+
+### utility
+
+- `app.py` (py, 0 symbols)
+- `install.sh` (sh, 0 symbols)
+
+---
+
+## Ranked Context
+
+Files ranked by composite score for the current query context. The ranking combines Personalized PageRank (query relevance), global authority, test coverage, documentation coverage, and code freshness. Model: v1.0.
+
+| Rank | File | Composite | PPR | Authority | Test | Doc |
+|------|------|-----------|-----|-----------|------|-----|
+| 1 | `app.py` | 0.1000 | 0.0000 | 0.0000 | 0.00 | 1.00 |
+| 2 | `install.sh` | 0.0000 | 0.0000 | 0.0000 | 0.00 | 0.00 |
+
+---
+
+## God Nodes
+
+Most architecturally central files ranked by combined import/export degree and symbol richness.
+
+| File | Score | Connections | PageRank |
+|------|-------|-------------|----------|
+| `app.py` | 0.0 | | 0.0000 |
+| `install.sh` | 0.0 | | 0.0000 |
+
+---
+
+## Suggested Questions
+
+Auto-generated exploration prompts based on graph structure:
+
+- What does app.py depend on, and what depends on it? (0 connections)
+- What does install.sh depend on, and what depends on it? (0 connections)
+- What is the overall architecture of this codebase?
+
+---
+
+## Hotspot Analysis
+
+Files ranked by combined complexity (symbol count) and centrality (connection count). High-scoring files are architecturally critical and may need refactoring attention.
+
+| File | Complexity | Centrality | Combined | Symbols | Connections |
+|------|-----------|------------|----------|---------|-------------|
+| `app.py` | 0.000 | 0.000 | 0.000 | 0 | 0 |
+| `install.sh` | 0.000 | 0.000 | 0.000 | 0 | 0 |
+
+---
+
+## Change Impact Analysis
+
+Files sorted by how many other files would be affected if they changed. High-impact files should be changed with caution.
+
+| File | Direct Dependents | Transitive Dependents | Total Impact |
+|------|------------------|----------------------|--------------|
+| `app.py` | 0 | 0 | 0 |
+| `install.sh` | 0 | 0 | 0 |
+
+---
+
+## Orphans
+
+Files with no documentation or low connectivity. These are candidates for documentation investment or cleanup.
+
+- `install.sh` (0 symbols, no doc)
+
+---
+
+## Query Recipes
+
+Example queries you can run against this knowledge base using the ranking engine:
+
+```
+# Find files most relevant to a concept
+readmenator query "Where is the import resolver implemented?"
+
+# Rank files by relevance to a topic
+readmenator query "How does documentation generation work?"
+
+# Explain why a file ranks highly
+readmenator query "explain readmenator/_documentation.py"
+
+# Trace dependency paths with ranked context
+readmenator query "path from CLI to exporter"
+```
+
+The ranking model uses the following signals:
+
+- **Personalized PageRank** (45% weight): query-specific relevance via seed propagation
+- **Global Authority** (20% weight): structural importance via standard PageRank
+- **Test Coverage** (15% weight): fraction of symbols referenced in test files
+- **Doc Coverage** (10% weight): presence of docstrings and file-level docs
+- **Freshness** (10% weight): recent modification activity
+
+Results include score decomposition and justification paths for each ranked item.
+
+---
+
+## Structural Knowledge Map
+
+```mermaid
+graph TD
+    classDef mod fill:#1e1e1e,stroke:#ff6666,stroke-width:2px,color:#fff;
+    classDef cls fill:#2d2d2d,stroke:#4ec9b0,stroke-width:2px,color:#fff;
+    classDef fn fill:#333,stroke:#dcdcaa,stroke-width:1px,color:#dcdcaa;
+    classDef ext fill:#111,stroke:#666,stroke-dasharray:5 5,color:#aaa;
+    app_py["app.py (py)"]
+    class app_py mod;
+    install_sh["install.sh (sh)"]
+    class install_sh mod;
+```
+
+---
+
+## Code Property Graph
+
+Machine-readable Code Property Graph (CPG) in JSON-LD format. This block allows AI agents to parse the full structural graph without additional file reads. Compatible with GraphRAG pipelines.
+
+```json
+{"@context": "https://readmenator.dev/cpg/v1", "analysis": {"communities": [], "god_nodes": [{"node_id": "app.py", "score": 0.0}, {"node_id": "install.sh", "score": 0.0}], "surprising_connections": []}, "edges": [], "generator": "readmenator", "metadata": {"edge_count": 0, "file_count": 2, "language_count": 2, "symbol_count": 0}, "nodes": [{"doc": "_*_ coding: utf8 _*_", "id": "app.py", "kind": "module", "label": "app.py", "language": "py", "sha256": "57b21bdb023585b8", "symbol_count": 0, "symbols": []}, {"id": "install.sh", "kind": "module", "label": "install.sh", "language": "sh", "sha256": "c907d80fd6734993", "symbol_count": 0, "symbols": []}], "type": "CodePropertyGraph", "version": "1.0"}
+```
+
+---
+
+## Architecture Reference
+
+### PY (1 files)
+
+#### `app.py`
+**Path:** `app.py`
+**File Doc:** *_*_ coding: utf8 _*_*
+
+*No symbols extracted*
+
+### SH (1 files)
+
+#### `install.sh`
+**Path:** `install.sh`
+
+*No symbols extracted*
diff --git a/docs/KNOWLEDGE_BASE.md b/docs/KNOWLEDGE_BASE.md
@@ -0,0 +1,193 @@
+# Polyglot Codebase Knowledge Graph
+
+> Generated offline by **readmenator**. Supports C, C++, Python, Go, Rust, JS/TS, Java, C#, Shell, PHP, Dart, GDScript, Nim, ASM, Ruby, Swift, Kotlin, Scala, Lua, Elixir.
+> No LLMs. No tokens. Pure static analysis. See more [here](https://github.com/grisuno/ReadMenator)
+
+**Total Files Parsed:** 2 | **Total Symbols Extracted:** 0 | **Total Imports:** 0
+
+<!-- ranking_model: v1.0 | weights: {ppr:0.45,auth:0.2,test:0.15,doc:0.1,fresh:0.1} | alpha:0.85 | commit:e63a2e6 | date:2026-07-18 -->
+
+
+## Table of Contents
+
+1. [Statistics Dashboard](#statistics-dashboard)
+2. [Architectural Layers](#architectural-layers)
+3. [Ranked Context](#ranked-context)
+4. [God Nodes](#god-nodes)
+5. [Suggested Questions](#suggested-questions)
+6. [Hotspot Analysis](#hotspot-analysis)
+7. [Change Impact Analysis](#change-impact-analysis)
+8. [Orphans](#orphans)
+9. [Query Recipes](#query-recipes)
+10. [Structural Knowledge Map](#structural-knowledge-map)
+11. [Code Property Graph](#code-property-graph)
+12. [Architecture Reference](#architecture-reference)
+    - [PY (1 files)](#py-1-files)
+    - [SH (1 files)](#sh-1-files)
+
+---
+
+## Statistics Dashboard
+
+| Metric | Value |
+|--------|-------|
+| Total Files | 2 |
+| Total Symbols | 0 |
+| Total Imports | 0 |
+| Call Edges | 0 |
+| Inheritance Edges | 0 |
+| Languages | 2 |
+| Avg Symbols/File | 0.0 |
+| Avg Imports/File | 0.0 |
+
+---
+
+## Architectural Layers
+
+Auto-detected from path patterns, naming conventions, and imported frameworks.
+
+| Layer | Files |
+|-------|-------|
+| utility | 2 |
+
+### utility
+
+- `app.py` (py, 0 symbols)
+- `install.sh` (sh, 0 symbols)
+
+---
+
+## Ranked Context
+
+Files ranked by composite score for the current query context. The ranking combines Personalized PageRank (query relevance), global authority, test coverage, documentation coverage, and code freshness. Model: v1.0.
+
+| Rank | File | Composite | PPR | Authority | Test | Doc |
+|------|------|-----------|-----|-----------|------|-----|
+| 1 | `app.py` | 0.1000 | 0.0000 | 0.0000 | 0.00 | 1.00 |
+| 2 | `install.sh` | 0.0000 | 0.0000 | 0.0000 | 0.00 | 0.00 |
+
+---
+
+## God Nodes
+
+Most architecturally central files ranked by combined import/export degree and symbol richness.
+
+| File | Score | Connections | PageRank |
+|------|-------|-------------|----------|
+| `app.py` | 0.0 | | 0.0000 |
+| `install.sh` | 0.0 | | 0.0000 |
+
+---
+
+## Suggested Questions
+
+Auto-generated exploration prompts based on graph structure:
+
+- What does app.py depend on, and what depends on it? (0 connections)
+- What does install.sh depend on, and what depends on it? (0 connections)
+- What is the overall architecture of this codebase?
+
+---
+
+## Hotspot Analysis
+
+Files ranked by combined complexity (symbol count) and centrality (connection count). High-scoring files are architecturally critical and may need refactoring attention.
+
+| File | Complexity | Centrality | Combined | Symbols | Connections |
+|------|-----------|------------|----------|---------|-------------|
+| `app.py` | 0.000 | 0.000 | 0.000 | 0 | 0 |
+| `install.sh` | 0.000 | 0.000 | 0.000 | 0 | 0 |
+
+---
+
+## Change Impact Analysis
+
+Files sorted by how many other files would be affected if they changed. High-impact files should be changed with caution.
+
+| File | Direct Dependents | Transitive Dependents | Total Impact |
+|------|------------------|----------------------|--------------|
+| `app.py` | 0 | 0 | 0 |
+| `install.sh` | 0 | 0 | 0 |
+
+---
+
+## Orphans
+
+Files with no documentation or low connectivity. These are candidates for documentation investment or cleanup.
+
+- `install.sh` (0 symbols, no doc)
+
+---
+
+## Query Recipes
+
+Example queries you can run against this knowledge base using the ranking engine:
+
+```
+# Find files most relevant to a concept
+readmenator query "Where is the import resolver implemented?"
+
+# Rank files by relevance to a topic
+readmenator query "How does documentation generation work?"
+
+# Explain why a file ranks highly
+readmenator query "explain readmenator/_documentation.py"
+
+# Trace dependency paths with ranked context
+readmenator query "path from CLI to exporter"
+```
+
+The ranking model uses the following signals:
+
+- **Personalized PageRank** (45% weight): query-specific relevance via seed propagation
+- **Global Authority** (20% weight): structural importance via standard PageRank
+- **Test Coverage** (15% weight): fraction of symbols referenced in test files
+- **Doc Coverage** (10% weight): presence of docstrings and file-level docs
+- **Freshness** (10% weight): recent modification activity
+
+Results include score decomposition and justification paths for each ranked item.
+
+---
+
+## Structural Knowledge Map
+
+```mermaid
+graph TD
+    classDef mod fill:#1e1e1e,stroke:#ff6666,stroke-width:2px,color:#fff;
+    classDef cls fill:#2d2d2d,stroke:#4ec9b0,stroke-width:2px,color:#fff;
+    classDef fn fill:#333,stroke:#dcdcaa,stroke-width:1px,color:#dcdcaa;
+    classDef ext fill:#111,stroke:#666,stroke-dasharray:5 5,color:#aaa;
+    app_py["app.py (py)"]
+    class app_py mod;
+    install_sh["install.sh (sh)"]
+    class install_sh mod;
+```
+
+---
+
+## Code Property Graph
+
+Machine-readable Code Property Graph (CPG) in JSON-LD format. This block allows AI agents to parse the full structural graph without additional file reads. Compatible with GraphRAG pipelines.
+
+```json
+{"@context": "https://readmenator.dev/cpg/v1", "analysis": {"communities": [], "god_nodes": [{"node_id": "app.py", "score": 0.0}, {"node_id": "install.sh", "score": 0.0}], "surprising_connections": []}, "edges": [], "generator": "readmenator", "metadata": {"edge_count": 0, "file_count": 2, "language_count": 2, "symbol_count": 0}, "nodes": [{"doc": "_*_ coding: utf8 _*_", "id": "app.py", "kind": "module", "label": "app.py", "language": "py", "sha256": "57b21bdb023585b8", "symbol_count": 0, "symbols": []}, {"id": "install.sh", "kind": "module", "label": "install.sh", "language": "sh", "sha256": "c907d80fd6734993", "symbol_count": 0, "symbols": []}], "type": "CodePropertyGraph", "version": "1.0"}
+```
+
+---
+
+## Architecture Reference
+
+### PY (1 files)
+
+#### `app.py`
+**Path:** `app.py`
+**File Doc:** *_*_ coding: utf8 _*_*
+
+*No symbols extracted*
+
+### SH (1 files)
+
+#### `install.sh`
+**Path:** `install.sh`
+
+*No symbols extracted*