@zosmaai/pi-llm-wiki 0.1.0 → 0.1.1

package/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18, 20, 22]
+        node-version: [20, 22, 23]
 
     steps:
       - uses: actions/checkout@v4

package/README.md

@@ -159,6 +159,14 @@ The LLM answers from your wiki, not from general knowledge — giving you answer
 
 ## 🏗️ Architecture
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/screenshot.png" alt="LLM Wiki Architecture" width="90%">
+</p>
+
+<p align="center">
+  <em>Three-layer architecture: raw sources → LLM-managed wiki → Obsidian frontend</em>
+</p>
+
 The LLM Wiki follows a three-layer architecture:
 
 ```
@@ -234,6 +242,14 @@ These tools handle the scaffolding and bookkeeping so the LLM can focus on the a
 
 ## 📓 Using with Obsidian
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/zosmaai/pi-llm-wiki/main/assets/knowledge-graph.png" alt="Knowledge Graph" width="90%">
+</p>
+
+<p align="center">
+  <em>The LLM automatically connects entities, concepts, and sources with [[wikilinks]] — viewable in Obsidian's graph view</em>
+</p>
+
 1. Open the `wiki/` directory as an Obsidian vault
 2. Install these plugins:
    - [Dataview](https://github.com/blacksmithgu/obsidian-dataview) — Query pages by frontmatter

package/assets/architecture.md

@@ -0,0 +1,79 @@
+# @zosmaai/pi-llm-wiki — Architecture Diagram
+
+This Mermaid diagram shows the three-layer architecture of the LLM Wiki pattern.
+
+```mermaid
+flowchart TB
+    subgraph Human["👤 You (Curate & Ask)"]
+        direction LR
+        Sources["📄 Drop Sources"] --> Questions["❓ Ask Questions"]
+    end
+
+    subgraph LLM["🤖 LLM (Writes & Maintains)"]
+        direction TB
+        SKILL["📜 SKILL.md Schema"]
+        INGEST["📥 Ingest<br/>Read → Summarize → Cross-ref"]
+        QUERY["🔍 Query<br/>Index → Synthesize → Cite"]
+        LINT["🧹 Lint<br/>Contradictions → Orphans → Gaps"]
+        DISCOVER["🌐 Discover<br/>Search → Fetch → Save"]
+    end
+
+    subgraph Storage["💾 File System"]
+        direction LR
+        RAW["raw/<br/>(immutable sources)"]
+        WIKI["wiki/<br/>(LLM-managed markdown)"]
+        OUTPUTS["outputs/<br/>(reports, digests)"]
+    end
+
+    subgraph Obsidian["📓 Obsidian Integration"]
+        GRAPH["Graph View<br/>[[wikilinks]]"]
+        DATAVIEW["Dataview<br/>Frontmatter queries"]
+        DASHBOARD["Dashboard<br/>Analytics"]
+    end
+
+    Sources --> RAW
+    RAW --> INGEST
+    INGEST --> WIKI
+    SKILL --> INGEST
+    SKILL --> QUERY
+    SKILL --> LINT
+    SKILL --> DISCOVER
+    DISCOVER --> RAW
+    QUERY --> WIKI
+    QUERY --> OUTPUTS
+    LINT --> WIKI
+    LINT --> OUTPUTS
+    Questions --> QUERY
+    WIKI --> GRAPH
+    WIKI --> DATAVIEW
+    WIKI --> DASHBOARD
+```
+
+## Three-Layer Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    YOU (curate & ask)                     │
+├──────────────┬──────────────────────┬────────────────────┤
+│   wiki/      │     outputs/         │   Obsidian vault    │
+│  (read only) │  (reports, digests)  │  (graph view, UI)   │
+├──────────────┴──────────────────────┴────────────────────┤
+│              LLM (writes & maintains)                     │
+├──────────────────────┬───────────────────────────────────┤
+│      raw/            │         SKILL.md schema            │
+│  (immutable sources) │     (rules & conventions)          │
+└──────────────────────┴───────────────────────────────────┘
+```
+
+## Three Operations
+
+| Operation  | Trigger              | What Happens                                                                                |
+| ---------- | -------------------- | ------------------------------------------------------------------------------------------- |
+| **Ingest** | Add source to `raw/` | LLM reads, creates summary, updates 5-15 wiki pages, cross-references, flags contradictions |
+| **Query**  | Ask any question     | LLM searches index, reads relevant pages, synthesizes answer with `[[citations]]`           |
+| **Lint**   | `/wiki:lint`         | Health check: contradictions, orphans, missing pages, stale claims, knowledge gaps          |
+
+## Two Modes
+
+- **👤 Personal Wiki** — Learning, journaling, goals, book notes
+- **🏢 Company Wiki** — Competitive intel, change detection, battlecards

package/assets/architecture.mmd

@@ -0,0 +1,41 @@
+flowchart TB
+    subgraph Human["👤 You (Curate & Ask)"]
+        direction LR
+        Sources["📄 Drop Sources"] --> Questions["❓ Ask Questions"]
+    end
+
+    subgraph LLM["🤖 LLM Agent (Writes & Maintains)"]
+        direction TB
+        SKILL["📜 SKILL.md Schema<br/>Rules & Conventions"]
+        INGEST["📥 Ingest<br/>Read → Summarize → Cross-ref"]
+        QUERY["🔍 Query<br/>Index → Synthesize → Cite"]
+        LINT["🧹 Lint<br/>Contradictions → Orphans → Gaps"]
+        DISCOVER["🌐 Discover<br/>Search → Fetch → Save"]
+    end
+
+    subgraph Storage["💾 File System"]
+        direction LR
+        RAW["raw/<br/>Immutable Sources"]
+        WIKI["wiki/<br/>Interlinked Markdown"]
+        OUTPUTS["outputs/<br/>Reports & Digests"]
+    end
+
+    Sources --> RAW
+    RAW --> INGEST
+    SKILL --> INGEST
+    INGEST --> WIKI
+    DISCOVER --> RAW
+    SKILL --> QUERY
+    Questions --> QUERY
+    QUERY --> WIKI
+    QUERY --> OUTPUTS
+    SKILL --> LINT
+    LINT --> WIKI
+    LINT --> OUTPUTS
+    SKILL --> DISCOVER
+
+    style RAW fill:#f9f,stroke:#333,stroke-width:2px
+    style WIKI fill:#bbf,stroke:#333,stroke-width:2px
+    style SKILL fill:#bfb,stroke:#333,stroke-width:2px
+    style Human fill:#ffd,stroke:#333,stroke-width:2px
+    style LLM fill:#eff,stroke:#333,stroke-width:2px

package/assets/knowledge-graph.mmd

@@ -0,0 +1,34 @@
+graph LR
+    subgraph Entities["🧑 Entities"]
+        A["Andrej Karpathy"]
+        O["OpenAI"]
+        C["Claude"]
+    end
+    subgraph Concepts["💡 Concepts"]
+        LLM["LLM Wiki Pattern"]
+        RAG["RAG"]
+        MEMEX["Memex (1945)"]
+        OBS["Obsidian Integration"]
+    end
+    subgraph Sources["📄 Sources"]
+        S1["Karpathy's Gist"]
+        S2["Community Impl."]
+        S3["Pi Package"]
+    end
+
+    S1 --> LLM
+    S1 --> A
+    LLM --> RAG
+    LLM --> MEMEX
+    LLM --> OBS
+    S2 --> LLM
+    S3 --> LLM
+    S3 --> OBS
+    A --> O
+    A --> C
+    LLM --> O
+    LLM --> C
+
+    style Entities fill:#e1f5fe,stroke:#0288d1
+    style Concepts fill:#f3e5f5,stroke:#7b1fa2
+    style Sources fill:#fff3e0,stroke:#e65100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zosmaai/pi-llm-wiki",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "LLM Wiki for Pi — self-maintaining knowledge base following Karpathy's pattern. Obsidian-friendly, auto-updating, personal & company wiki.",
   "keywords": [
     "pi-package",
@@ -54,6 +54,7 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@mariozechner/pi-coding-agent": "^0.70.2",
+    "@mermaid-js/mermaid-cli": "^11.12.0",
     "typebox": "^1.1.34",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"