evnict-kit 0.2.2 → 0.2.4

package/templates/wiki/README.md

@@ -1,35 +1,272 @@
-# LLM Wiki — Knowledge Base
-# Source: https://github.com/mduongvandinh/llm-wiki (MIT License)
-
-Hệ thống quản lý kiến thức cho AI-assisted development.
-
-## Cấu trúc
-```
-raw/notes/       ← Viết notes ở đây (markdown + frontmatter)
-processed/       ← Auto-generated sau ingest
-scripts/         ← Ingest, query scripts
-```
-
-## Sử dụng
-
-### Push note
-Tạo file `raw/notes/{domain}-{slug}.md` với frontmatter:
-```markdown
----
-title: "Tiêu đề"
-domain: "module-name"
-type: feature | bugfix | architecture
-date: 2026-01-01
-tags: [tag1, tag2]
----
-
-Nội dung...
-```
-
-### Ingest
-```bash
-npm run ingest
-```
-
-### Query
-Search trong `processed/index.json` hoặc grep files.
+# LLM Wiki
+
+Hệ thống knowledge base cá nhân hoàn toàn tự động, vận hành bởi LLM. Dựa trên pattern [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) của Andrej Karpathy.
+
+LLM tự tìm nguồn, tự tổng hợp thành wiki có cấu trúc, tự duy trì cross-references, phát hiện mâu thuẫn, và giữ mọi thứ cập nhật — bạn chỉ cần đọc và hỏi.
+
+> **Hỗ trợ:** [Claude Code](https://claude.ai/code) | [Antigravity](https://antigravity.codes) / Codex | [GitHub Copilot](https://github.com/features/copilot)
+>
+> Mỗi tool tự đọc file config riêng: `CLAUDE.md` | `AGENTS.md` | `.github/copilot-instructions.md` — cùng nội dung, không conflict.
+
+## Khác gì so với RAG?
+
+| | RAG truyền thống | LLM Wiki |
+|---|---|---|
+| Kiến thức | Tìm lại từ đầu mỗi lần hỏi | Biên dịch 1 lần, duy trì liên tục |
+| Cross-references | Không có | Tự động tạo và duy trì |
+| Mâu thuẫn | Không phát hiện | Đánh dấu ngay khi ingest |
+| Tích lũy | Không | Compound theo thời gian |
+| Hạ tầng | Vector DB + embeddings | Chỉ cần folders + markdown |
+
+## Bắt đầu nhanh
+
+### 1. Clone & Cài đặt
+
+```bash
+git clone https://github.com/mduongvandinh/llm-wiki.git
+cd llm-wiki
+
+# Copy file cấu hình mẫu
+cp config.example.yaml config.yaml
+
+# Cài skill vào Claude Code
+cp -r skills/llm-wiki ~/.claude/skills/llm-wiki
+```
+
+### 2. Cấu hình chủ đề quan tâm
+
+Sửa `config.yaml` — thêm topics, keywords, và nguồn theo dõi:
+
+```yaml
+topics:
+  - name: "Chủ đề của bạn"
+    keywords: ["từ khóa 1", "từ khóa 2"]
+    priority: high
+```
+
+### 3. Chạy
+
+Tùy tool bạn dùng:
+
+**Claude Code** (slash command):
+```bash
+/llm-wiki run          # Chạy full cycle
+/llm-wiki query "..."  # Hỏi đáp
+/llm-wiki status       # Xem trạng thái
+```
+
+**Antigravity** (slash command hoặc chat):
+```
+@llm-wiki run
+# hoặc chat: "chạy llm-wiki full cycle"
+```
+
+**GitHub Copilot** (chat tự nhiên — tự đọc .github/copilot-instructions.md):
+```
+"Đọc CLAUDE.md rồi chạy discover, ingest, lint cho wiki này"
+"Tìm nguồn mới về AI agents rồi tổng hợp vào wiki"
+"Hỏi dựa trên wiki: so sánh RAG vs LLM Wiki"
+```
+
+**Codex CLI**:
+```bash
+codex "Đọc AGENTS.md và chạy full cycle: discover → ingest → lint"
+```
+
+**Cursor** (chat trong IDE):
+```
+"Follow AGENTS.md. Chạy discover tìm nguồn mới, ingest vào wiki, rồi lint kiểm tra"
+```
+
+### Tóm tắt cách gọi theo tool
+
+| Tool | Cách gọi | File config | Cài skill |
+|------|----------|-------------|-----------|
+| Claude Code | `/llm-wiki run` | `CLAUDE.md` | `cp -r skills/llm-wiki ~/.claude/skills/` |
+| Antigravity | `@llm-wiki run` | `AGENTS.md` | `cp -r skills/llm-wiki ~/.antigravity/skills/` |
+| GitHub Copilot | Chat tự nhiên | `.github/copilot-instructions.md` | Không cần — tự đọc khi mở project |
+| Codex CLI | `codex "..."` | `AGENTS.md` | Không cần — đọc AGENTS.md ở root |
+| Cursor | Chat trong IDE | `AGENTS.md` hoặc `.cursorrules` | Không cần — đọc AGENTS.md ở root |
+
+> **Lưu ý:**
+> - Chỉ Claude Code và Antigravity có slash command (`/llm-wiki`). Các tool khác bạn chat bằng ngôn ngữ tự nhiên.
+> - `/loop` chỉ có ở Claude Code. Các tool khác muốn chạy tự động thì dùng Task Scheduler (Windows) hoặc crontab (macOS/Linux).
+
+### Chạy tự động theo tool
+
+| Tool | Cách chạy tự động |
+|------|-------------------|
+| Claude Code | `/loop 1h /llm-wiki run` (trong session) |
+| Antigravity | Task Scheduler / crontab |
+| Codex CLI | crontab gọi `codex "Đọc AGENTS.md và chạy discover → ingest → lint"` |
+| GitHub Copilot | Không hỗ trợ — chỉ chat trong IDE |
+| Cursor | Không hỗ trợ — chỉ chat trong IDE |
+
+Xem thêm phần [Chạy tự động](#chạy-tự-động) bên dưới để cấu hình Task Scheduler / crontab.
+
+### 4. Xem wiki
+
+- **Obsidian**: File → Open vault → chọn folder `llm-wiki` → Graph View
+- **Browser**: mở `wiki-viewer.html` để xem dashboard + graph (hỗ trợ mobile)
+
+---
+
+## Danh sách lệnh
+
+| Lệnh | Mô tả |
+|-------|--------|
+| `/llm-wiki init "Topic"` | Thêm chủ đề mới |
+| `/llm-wiki ingest` | Xử lý nguồn mới trong `raw/` |
+| `/llm-wiki query "..."` | Hỏi đáp dựa trên wiki, tự lưu kết quả |
+| `/llm-wiki lint` | Kiểm tra sức khỏe: mâu thuẫn, orphans, gaps |
+| `/llm-wiki discover` | Tự tìm nguồn mới từ internet |
+| `/llm-wiki run` | Full cycle: discover → ingest → lint |
+| `/llm-wiki status` | Xem trạng thái tổng quan |
+| `/llm-wiki digest` | Bản tin hàng ngày: nguồn mới, insights, pain points |
+| `/llm-wiki pain-rank` | Xếp hạng pain points theo tiềm năng kinh doanh |
+
+---
+
+## Chạy tự động
+
+### Cách 1: `/loop` trong Claude Code (khuyến nghị)
+
+```bash
+/loop 1h /llm-wiki run    # Mỗi 1 giờ
+/loop 30m /llm-wiki run   # Mỗi 30 phút
+/loop 2h /llm-wiki run    # Mỗi 2 giờ
+```
+
+Chạy trong session hiện tại. Không tốn thêm chi phí. Dừng khi đóng session.
+
+### Cách 2: Lập lịch hệ thống (chạy nền, không cần mở Claude Code)
+
+**Windows** (PowerShell, chạy với quyền Admin):
+```powershell
+powershell -ExecutionPolicy Bypass -File "scripts/setup-scheduler.ps1"
+```
+
+**macOS/Linux** (crontab):
+```bash
+# Thêm vào crontab -e:
+0 */2 * * * cd /path/to/llm-wiki && claude --print "/llm-wiki run" >> outputs/auto-run.log 2>&1
+```
+
+### So sánh
+
+| | `/loop` (trong session) | Lập lịch hệ thống |
+|---|---|---|
+| Khi nào chạy | Khi mở Claude Code/VS Code | Bất cứ lúc nào máy bật |
+| Tần suất | Linh hoạt (10 phút đến 2 giờ) | Cố định (VD: mỗi 2 giờ) |
+| Chi phí token | Thấp (cùng session) | Cao hơn (mỗi lần = session mới) |
+| Cài đặt | Gõ lệnh là xong | Chạy script 1 lần (quyền admin) |
+
+---
+
+## Thêm nguồn
+
+### Thủ công
+
+Tạo file markdown rồi bỏ vào `raw/articles/`, `raw/reddit/`, hoặc `raw/notes/`:
+
+```markdown
+---
+title: "Tiêu đề bài viết"
+url: "https://example.com/article"
+author: "Tên tác giả"
+discovered: 2026-04-07
+topic: "Tên chủ đề"
+---
+
+Nội dung bài viết ở đây...
+```
+
+Sau đó chạy `/llm-wiki ingest`.
+
+### Qua Obsidian Web Clipper
+
+1. Cài extension [Obsidian Web Clipper](https://obsidian.md/clipper)
+2. Thấy bài hay → click icon clipper → lưu vào `raw/articles/`
+3. Chạy `/llm-wiki ingest`
+
+---
+
+## Cấu trúc thư mục
+
+```
+llm-wiki/
+├── CLAUDE.md              ← Schema cho Claude Code
+├── AGENTS.md              ← Schema cho Antigravity / Codex
+├── .github/
+│   └── copilot-instructions.md  ← Schema cho GitHub Copilot
+├── config.yaml            ← Cấu hình chủ đề, nguồn, lịch chạy
+├── config.example.yaml    ← File mẫu cho người dùng mới
+├── wiki-viewer.html       ← Trình xem wiki (mobile-first, dark theme, graph)
+├── raw/                   ← Nguồn thô (LLM KHÔNG ĐƯỢC SỬA)
+│   ├── articles/          ← Bài viết, papers
+│   ├── reddit/            ← Pain points, use cases từ Reddit
+│   ├── twitter/           ← Tweets (follow-builders + Web Clipper)
+│   ├── notes/             ← Ghi chú cá nhân
+│   └── media/             ← Ảnh chụp, sơ đồ
+├── wiki/                  ← Wiki do LLM viết & duy trì
+│   ├── INDEX.md           ← Danh mục tất cả trang wiki
+│   ├── LOG.md             ← Nhật ký hoạt động
+│   ├── entities/          ← Người, tổ chức, công cụ, dự án
+│   ├── concepts/          ← Khái niệm, pattern, phương pháp
+│   ├── sources/           ← Tóm tắt từng nguồn thô
+│   └── syntheses/         ← Phân tích tổng hợp, so sánh
+├── outputs/               ← Kết quả hỏi đáp, báo cáo, xếp hạng
+├── .discoveries/          ← Metadata cho auto-discovery
+├── scripts/               ← Scripts tự động
+│   ├── run-wiki.sh        ← Cho lập lịch hệ thống
+│   └── setup-scheduler.ps1
+├── skills/                ← Claude Code skill (copy vào ~/.claude/skills/)
+│   └── llm-wiki/
+│       └── SKILL.md
+└── docs/plans/            ← Tài liệu thiết kế
+```
+
+---
+
+## Kiến trúc
+
+```
+┌──────────────────────────────────────────────────────┐
+│                  BẠN (đọc & hỏi)                      │
+├──────────────────────────────────────────────────────┤
+│  wiki/          │  outputs/        │  wiki-viewer     │
+│  (Obsidian)     │  (bản tin, rank) │  (.html)         │
+├──────────────────────────────────────────────────────┤
+│                  LLM (viết & duy trì)                 │
+├──────────┬───────────┬──────────┬────────────────────┤
+│ discover │  ingest   │  query   │  lint              │
+│ (tìm)    │ (xử lý)   │ (đáp)    │ (kiểm tra)        │
+├──────────┴───────────┴──────────┴────────────────────┤
+│  raw/           │  config.yaml     │  CLAUDE.md       │
+│  (nguồn thô)    │  (cấu hình)      │  (quy tắc)       │
+└──────────────────────────────────────────────────────┘
+```
+
+**Luồng chính:** discover → raw/ → ingest → wiki/ → query → outputs/
+
+**Vòng lặp tự cải thiện:** lint phát hiện gaps → discover tìm nguồn → ingest lấp đầy → wiki ngày càng giàu
+
+---
+
+## Câu hỏi thường gặp
+
+Xem [FAQ.md](FAQ.md) — bao gồm: wiki phình to truy vấn thế nào, versioning schema, dùng cho tài liệu nội bộ (Confluence), chi phí token, dùng cho team, dùng model khác, hallucination.
+
+---
+
+## Tác giả & Nguồn cảm hứng
+
+- Pattern gốc: [Andrej Karpathy — LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)
+- Hướng dẫn thực hành: [Nick Spisak — How to Build Your Second Brain](https://x.com/NickSpisak_/status/2040448463540830705)
+- Engine: [Claude Code](https://claude.ai/code) (Anthropic)
+- Xem wiki: [Obsidian](https://obsidian.md/)
+- Bản tin Twitter: [follow-builders](https://github.com/zarazhangrui/follow-builders)
+
+## Giấy phép
+
+MIT

package/templates/wiki/config.example.yaml

@@ -1,17 +1,145 @@
-# LLM Wiki Configuration
-project: "{{PROJECT_NAME}}"
-raw_path: "raw/notes"
-processed_path: "processed"
-index_path: "processed/index.json"
-
-# Ingest settings
-ingest:
-  auto: true
-  on_push: true
-  format: markdown
-  frontmatter: required
-
-# Query settings
-query:
-  search_type: keyword
-  max_results: 10
+# LLM Wiki — Configuration Template
+# Copy this file to config.yaml and customize for your needs:
+#   cp config.example.yaml config.yaml
+
+# ============================================================
+# Wiki Info
+# ============================================================
+wiki:
+  name: "My LLM Wiki"
+  description: "Personal knowledge base — change this to your focus area"
+  language: "en"  # en | vi | zh | ja | ...
+  max_pages_per_ingest: 15
+
+# ============================================================
+# Topics — what you want to learn about
+# The system auto-discovers sources based on these keywords
+# ============================================================
+topics:
+  - name: "Your Topic 1"
+    keywords: ["keyword1", "keyword2", "keyword3"]
+    priority: high  # high | medium | low
+
+  - name: "Your Topic 2"
+    keywords: ["keyword1", "keyword2"]
+    priority: medium
+
+  # Add more topics:
+  # - name: "Topic Name"
+  #   keywords: ["keyword1", "keyword2"]
+  #   priority: medium
+
+# ============================================================
+# Feeds — automated source collection
+# ============================================================
+feeds:
+  # GitHub Trending
+  github_trending:
+    enabled: true
+    languages: ["python", "typescript", "rust", "go"]
+    since: "daily"
+    min_stars: 100
+    topics_filter: ["ai", "llm", "agent"]
+
+  # GitHub Orgs to watch
+  github_orgs: []
+    # - org: "anthropics"
+    #   watch: ["new_repos", "releases"]
+    #   note: "Anthropic"
+
+  # GitHub People to follow
+  github_people: []
+    # - user: "karpathy"
+    #   watch: ["new_repos", "releases", "stars"]
+    #   note: "Andrej Karpathy"
+
+  # GitHub Repos to track
+  github_repos: []
+    # - repo: "owner/repo-name"
+    #   watch: ["releases", "readme"]
+
+  # Reddit — pain points & use cases
+  reddit:
+    enabled: false  # Set to true and configure subreddits below
+    sort: "hot"
+    time_filter: "week"
+    min_upvotes: 20
+    max_posts_per_sub: 3
+    subreddits_pain_points: []
+      # - sub: "r/SaaS"
+      #   search: ["pain point", "need a tool", "frustrated with"]
+      #   note: "SaaS pain points"
+
+  # RSS feeds
+  rss: []
+    # - url: "https://blog.example.com/rss"
+    #   name: "Example Blog"
+
+  # Hacker News
+  hackernews:
+    enabled: true
+    min_score: 50
+    keywords: []  # Empty = use keywords from topics
+
+  # Twitter/X accounts
+  twitter_accounts: []
+    # - handle: "username"
+    #   note: "Description"
+
+# ============================================================
+# Schedule
+# ============================================================
+schedule:
+  run:
+    loop_interval: "1h"      # For /loop when using Claude Code
+    fallback_interval: "2h"  # For Windows Task Scheduler (CLI)
+    max_sources: 5
+
+  ingest:
+    trigger: "on_new_file"
+    batch_size: 5
+
+  lint:
+    interval: "6h"
+    auto_fix: false
+
+  recompile:
+    interval: "weekly"
+    cron: "0 10 * * 0"
+
+# ============================================================
+# Discovery Settings
+# ============================================================
+discovery:
+  strategies:
+    - web_search
+    - feed_poll
+    - gap_fill
+    # - reddit_scan      # Enable after configuring reddit feeds
+    # - github_trending
+    # - github_watch
+    # - snowball
+
+  web_search:
+    engine: "websearch"
+    max_results_per_topic: 5
+    recency: "month"
+
+  scraping:
+    tool: "webfetch"
+    save_images: true
+    max_article_length: 50000
+
+  dedup:
+    check_url: true
+    check_title: true
+    similarity_threshold: 0.9
+
+# ============================================================
+# Output Formats
+# ============================================================
+outputs:
+  formats:
+    - markdown
+  save_queries: true
+  save_syntheses: true

package/templates/wiki/scripts/run-wiki.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# LLM Wiki — Auto Run Script
+# Called by system scheduler (Task Scheduler / cron)
+# Edit WIKI_ROOT below to match your installation path
+
+WIKI_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+LOG_FILE="$WIKI_ROOT/outputs/auto-run.log"
+
+mkdir -p "$WIKI_ROOT/outputs"
+echo "$(date '+%Y-%m-%d %H:%M:%S') — Starting /llm-wiki run" >> "$LOG_FILE"
+
+cd "$WIKI_ROOT" || exit 1
+
+claude --print --dangerously-skip-permissions "/llm-wiki run" 2>>"$LOG_FILE" | tail -20 >> "$LOG_FILE"
+
+echo "$(date '+%Y-%m-%d %H:%M:%S') — Completed /llm-wiki run" >> "$LOG_FILE"
+echo "---" >> "$LOG_FILE"

package/templates/wiki/scripts/setup-scheduler.ps1

@@ -0,0 +1,29 @@
+# LLM Wiki - Windows Task Scheduler Setup
+# Run: powershell -ExecutionPolicy Bypass -File "scripts/setup-scheduler.ps1"
+
+$taskName = "LLM-Wiki-AutoRun"
+$bashPath = "C:\Program Files\Git\bin\bash.exe"
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$projectDir = Split-Path -Parent $scriptDir
+$scriptPath = Join-Path $scriptDir "run-wiki.sh"
+
+# Remove old task
+Unregister-ScheduledTask -TaskName $taskName -Confirm:$false -ErrorAction SilentlyContinue
+
+# Trigger: every 2 hours, repeat for 365 days
+$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Hours 2) -RepetitionDuration (New-TimeSpan -Days 365)
+
+# Action: run bash script
+$action = New-ScheduledTaskAction -Execute $bashPath -Argument $scriptPath -WorkingDirectory $projectDir
+
+# Settings
+$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -RunOnlyIfNetworkAvailable
+
+# Register task
+Register-ScheduledTask -TaskName $taskName -Trigger $trigger -Action $action -Settings $settings -Description "LLM Wiki auto run every 2 hours" -RunLevel Limited
+
+Write-Host "OK - Task '$taskName' created!"
+Write-Host "Project: $projectDir"
+Write-Host "Check: Get-ScheduledTask -TaskName '$taskName'"
+Write-Host "Run now: Start-ScheduledTask -TaskName '$taskName'"
+Write-Host "Delete: Unregister-ScheduledTask -TaskName '$taskName'"