wikimem 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+All notable changes to llmwiki will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-04-07
+
+### Added
+
+- **CLI commands:** `init`, `ingest`, `query`, `lint`, `watch`, `scrape`, `improve`, `status`
+- **Three-layer architecture:** `raw/` (immutable sources), `wiki/` (LLM-generated), `AGENTS.md` (schema)
+- **Three automations:** ingest pipeline (A1), external scraping (A2), self-improvement (A3)
+- **Multi-model support:** Claude (Anthropic), OpenAI (GPT), Ollama (local)
+- **Multi-format processing:**
+  - Text: `.md`, `.txt`, `.csv`, `.json`, `.html`
+  - PDF: built-in text extraction from PDF binary format
+  - Audio: `.mp3`, `.wav`, `.m4a`, `.ogg`, `.flac`, `.aac` via Whisper or Deepgram
+  - Video: `.mp4`, `.mov`, `.avi`, `.mkv`, `.webm` via ffmpeg + Whisper
+  - Image: `.jpg`, `.png`, `.gif`, `.webp` via Claude Vision
+  - URL: web pages via Firecrawl API or native fetch fallback
+  - Office: `.docx`, `.pptx`, `.xlsx` basic reference extraction
+- **BM25 search engine:** zero-dependency full-text search with title boosting
+- **Semantic dedup:** Jaccard similarity check prevents near-duplicate ingestion
+- **Watch mode:** `chokidar`-based file watcher auto-ingests new files in `raw/`
+- **External scraping:** RSS feeds, GitHub trending repos, plain URL scraping
+- **Self-improvement cycle:** 5-dimension scoring (coverage, consistency, cross-linking, freshness, organization) with configurable threshold and dry-run mode
+- **Wiki health checks:** orphan detection, broken wikilink detection, missing summary detection, empty page detection
+- **Auto-maintained files:** `wiki/index.md` (content catalog) and `wiki/log.md` (operation log)
+- **Obsidian compatibility:** YAML frontmatter, `[[wikilinks]]`, section-based organization
+- **Domain templates:** personal, research, business, codebase
+- **File-back queries:** optionally save query answers as synthesis pages
+- **AGENTS.md schema:** co-evolving wiki structure document
+- **YAML configuration:** `config.yaml` for provider, sources, schedules, processing options
+
+[0.1.0]: https://github.com/naman10parikh/llmwiki/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Naman Parikh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,398 @@
+# llmwiki
+
+[![npm version](https://img.shields.io/npm/v/llmwiki.svg)](https://www.npmjs.com/package/llmwiki)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](#tests)
+
+**Build self-improving knowledge bases with LLMs.**
+
+Drop files in. Get a structured, interlinked wiki out. It improves itself while you sleep.
+
+```bash
+npx llmwiki init my-wiki
+```
+
+```
+raw/                        wiki/
+  2026-04-07/                 index.md ........... content catalog
+    paper.pdf     ──LLM──>   sources/paper.md ... summary + citations
+    podcast.mp3               entities/openai.md . people, orgs, tools
+    screenshot.png            concepts/rag.md .... ideas + frameworks
+    blog-url                  syntheses/ ......... cross-cutting analysis
+```
+
+llmwiki processes any source (text, PDF, audio, video, images, URLs), compiles it into an interlinked markdown wiki with frontmatter and `[[wikilinks]]`, and opens directly in Obsidian.
+
+Works with **Claude, OpenAI, or Ollama** (local). Your data stays on your machine.
+
+Inspired by [Andrej Karpathy's LLM Wiki pattern](https://x.com/karpathy/status/1908625766490001799).
+
+## Install
+
+```bash
+npm install -g llmwiki
+```
+
+**Requirements:** Node.js >= 18 · An LLM API key (or Ollama running locally)
+
+## Quick Start
+
+```bash
+# 1. Create a vault
+llmwiki init my-wiki
+cd my-wiki
+
+# 2. Ingest something
+llmwiki ingest https://en.wikipedia.org/wiki/Large_language_model
+llmwiki ingest ~/Documents/research-paper.pdf
+
+# 3. Ask questions
+llmwiki query "What are the key differences between RAG and compiled knowledge?"
+```
+
+That's it. Your wiki is now a folder of markdown files you can open in Obsidian, VS Code, or any text editor.
+
+## Why llmwiki?
+
+**The problem:** You have dozens of sources — papers, podcasts, articles, screenshots, meeting recordings. They sit in folders. You forget what's in them. When you need something, you search and re-read.
+
+**RAG approach:** Chunk documents, embed them, retrieve at query time. Lossy, opaque, and the "knowledge" lives in a vector database you can't read.
+
+**llmwiki approach:** Compile sources into structured markdown pages with summaries, cross-references, and citations. The knowledge is readable, editable, version-controlled, and improves itself over time.
+
+| | RAG | llmwiki |
+|---|---|---|
+| **Storage** | Vector embeddings | Plain markdown files |
+| **Readable?** | No (opaque vectors) | Yes (open in any editor) |
+| **Editable?** | Rebuild index | Edit any page |
+| **Version control** | Difficult | `git diff` |
+| **Self-improving** | No | Yes (LLM Council) |
+| **Works offline** | Depends | Yes (with Ollama) |
+| **Obsidian** | Plugin required | Native (`[[wikilinks]]`) |
+
+## Features
+
+- [x] **Multi-format ingestion** — text, PDF, audio, video, images, URLs, Office docs
+- [x] **Multi-model support** — Claude, OpenAI, Ollama (local)
+- [x] **Obsidian-native** — `[[wikilinks]]`, YAML frontmatter, opens directly as vault
+- [x] **Semantic dedup** — rejects near-duplicate sources automatically
+- [x] **BM25 search** — zero-dependency full-text search, no external services
+- [x] **Auto-indexing** — `index.md` + `log.md` maintained automatically
+- [x] **Watch mode** — drop files into `raw/`, auto-ingested
+- [x] **Self-improvement** — LLM Council scores your wiki and fixes issues
+- [x] **External scraping** — pull from RSS, GitHub, URLs on a schedule
+- [x] **Health checks** — find orphan pages, broken links, missing summaries
+- [x] **File-back answers** — query results saved as synthesis pages
+- [x] **Schema co-evolution** — AGENTS.md evolves with your wiki
+- [x] **Domain templates** — personal, research, business, codebase
+- [x] **Local-first** — everything is files. No database. No cloud dependency.
+
+## Architecture
+
+```
+┌────────────────────────────────────────────────────┐
+│                    llmwiki CLI                      │
+│                                                    │
+│  llmwiki init         Create a new vault           │
+│  llmwiki ingest       Process source → wiki pages  │
+│  llmwiki query        Ask questions with citations  │
+│  llmwiki lint         Health-check the wiki        │
+│  llmwiki watch        Auto-ingest on file drop     │
+│  llmwiki scrape       Fetch from external sources  │
+│  llmwiki improve      Self-improvement cycle       │
+│  llmwiki status       Vault statistics             │
+├──────────────────────┬─────────────────────────────┤
+│   Three Layers       │   Three Automations         │
+│                      │                             │
+│   raw/               │   A1: Ingest & Process      │
+│   (immutable)   <────│   file/URL → markdown       │
+│                      │   → place in wiki/          │
+│   wiki/              │                             │
+│   (LLM-owned)   <────│   A2: External Scrape       │
+│                      │   RSS, GitHub, web → raw/   │
+│   AGENTS.md          │                             │
+│   (schema)      <────│   A3: Self-Improve          │
+│                      │   LLM Council → score → fix │
+├──────────────────────┴─────────────────────────────┤
+│                  LLM Providers                     │
+│   Claude (Anthropic) · OpenAI (GPT) · Ollama      │
+├────────────────────────────────────────────────────┤
+│                  Processors                        │
+│   Text · PDF · Audio · Video · Image · URL · HTML  │
+└────────────────────────────────────────────────────┘
+```
+
+### Three Layers
+
+1. **`raw/`** &mdash; Immutable source documents. Date-stamped subdirectories. Never modified by the LLM.
+2. **`wiki/`** &mdash; LLM-generated markdown. Source summaries, entity pages, concept pages, synthesis pages. The LLM owns this entirely.
+3. **`AGENTS.md`** &mdash; Schema file. Tells the LLM how the wiki is structured, what conventions to follow, how to process sources. Co-evolved by you and the LLM.
+
+### Three Automations
+
+- **A1: Ingest & Process** &mdash; Detects file type, runs the appropriate processor (Whisper for audio, ffmpeg+Whisper for video, Claude Vision for images, text extraction for PDF), asks the LLM to produce wiki pages with cross-references.
+- **A2: External Scrape** &mdash; Fetches from RSS feeds, GitHub trending, web URLs. Deposits results in `raw/` and triggers A1 automatically.
+- **A3: Self-Improve** &mdash; LLM Council evaluates wiki quality across 5 dimensions (coverage, consistency, cross-linking, freshness, organization), proposes improvements, and applies them if below a configurable threshold.
+
+## All Commands
+
+### `llmwiki init [directory]`
+
+Create a new vault with the standard directory structure.
+
+```bash
+llmwiki init my-wiki                    # Create in my-wiki/
+llmwiki init .                          # Initialize current directory
+llmwiki init my-wiki --template research   # Use research template
+llmwiki init my-wiki --force            # Overwrite existing
+```
+
+Templates: `personal` (default), `research`, `business`, `codebase`
+
+### `llmwiki ingest <source>`
+
+Process a file or URL into wiki pages.
+
+```bash
+llmwiki ingest paper.pdf                # PDF → extract text → wiki pages
+llmwiki ingest podcast.mp3              # Audio → Whisper transcription → wiki
+llmwiki ingest screenshot.png           # Image → Claude Vision description → wiki
+llmwiki ingest lecture.mp4              # Video → ffmpeg → Whisper → wiki
+llmwiki ingest article.md               # Markdown → wiki pages
+llmwiki ingest data.json                # JSON → code block in wiki
+llmwiki ingest page.html                # HTML → strip tags → wiki
+llmwiki ingest report.docx              # Office → basic extraction → wiki
+llmwiki ingest https://example.com/post # URL → Firecrawl/fetch → wiki
+llmwiki ingest raw/2026-04-07/file.md   # Re-ingest from raw/
+```
+
+Each source is auto-detected by file type, copied to `raw/{date}/`, checked for duplicates, compiled into wiki pages by the LLM, and indexed. Use `-p` to pick a provider, `-m` for a specific model, `--verbose` for detailed output.
+
+### `llmwiki query <question>`
+
+Ask a question and get an answer synthesized from your wiki.
+
+```bash
+llmwiki query "What are the main themes across my sources?"
+llmwiki query "Compare approaches to knowledge management" --file
+llmwiki query "Who is mentioned most frequently?" -p openai
+```
+
+Use `--file` to save the answer as a synthesis page in `wiki/syntheses/`. The query engine uses BM25 search to find relevant pages, reads the top 10, and synthesizes an answer with `[[wikilink]]` citations.
+
+### `llmwiki lint`
+
+Health-check the wiki for structural issues.
+
+```bash
+llmwiki lint                  # Check for issues
+llmwiki lint --fix            # Auto-fix where possible
+```
+
+Checks for:
+- Orphan pages (no inbound `[[wikilinks]]`)
+- Broken wikilinks (links to non-existent pages)
+- Pages missing frontmatter summaries
+- Near-empty pages (< 10 words)
+
+Reports a quality score out of 100.
+
+### `llmwiki watch`
+
+Watch the `raw/` directory and auto-ingest new files.
+
+```bash
+llmwiki watch                 # Watch current vault
+llmwiki watch -v ./my-wiki    # Watch a specific vault
+```
+
+Uses `chokidar` for reliable cross-platform file watching. Waits for writes to stabilize before ingesting (2-second debounce). Press `Ctrl+C` to stop.
+
+### `llmwiki scrape`
+
+Fetch content from configured external sources and deposit in `raw/`.
+
+```bash
+llmwiki scrape                # Run all configured sources
+llmwiki scrape -s "HN Top"   # Run a specific source
+```
+
+Sources are configured in `config.yaml`:
+
+```yaml
+sources:
+  - name: "HN Top Stories"
+    type: rss
+    url: "https://hnrss.org/frontpage"
+
+  - name: "GitHub Trending TS"
+    type: github
+    query: "stars:>100 created:>7d language:typescript"
+
+  - name: "Company Blog"
+    type: url
+    url: "https://example.com/blog"
+```
+
+Supported source types: `rss`, `github`, `url`
+
+### `llmwiki improve`
+
+Run the self-improvement cycle (Automation 3).
+
+```bash
+llmwiki improve                   # Evaluate and improve
+llmwiki improve --dry-run         # Show what would change
+llmwiki improve --threshold 90    # Stricter quality bar
+```
+
+The improvement cycle:
+
+1. **Score** &mdash; Evaluates 5 quality dimensions (coverage, consistency, cross-linking, freshness, organization)
+2. **Decide** &mdash; If score < threshold (default 80), improvements are needed
+3. **Improve** &mdash; Proposes actions: add cross-links, create missing pages, expand stubs, flag contradictions
+4. **Log** &mdash; Records what changed and why in `log.md`
+
+### `llmwiki status`
+
+Show vault statistics at a glance.
+
+```bash
+llmwiki status
+```
+
+```
+llmwiki vault status
+────────────────────────────────────
+  Pages:        42
+  Words:        18,340
+  Sources:      15
+  Wiki links:   127
+  Orphan pages: 2
+  Last updated: 2026-04-07
+```
+
+## Configuration
+
+After `llmwiki init`, your vault contains a `config.yaml` where you set the LLM provider, external sources, self-improvement schedule, and processing options.
+
+See [docs/configuration.md](docs/configuration.md) for the full reference.
+
+### Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `ANTHROPIC_API_KEY` | Claude API access (default provider) |
+| `OPENAI_API_KEY` | OpenAI API access |
+| `OLLAMA_BASE_URL` | Ollama server URL (default: `http://localhost:11434`) |
+| `FIRECRAWL_API_KEY` | Enhanced URL-to-markdown (optional, falls back to fetch) |
+| `DEEPGRAM_API_KEY` | Audio transcription API (optional, falls back to Whisper) |
+
+## Multi-Model Support
+
+llmwiki works with any major LLM provider. Choose at init time or per-command.
+
+| Provider | Flag | Default Model | Env Variable |
+|----------|------|---------------|-------------|
+| **Claude** | `-p claude` | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` |
+| **OpenAI** | `-p openai` | `gpt-4o` | `OPENAI_API_KEY` |
+| **Ollama** | `-p ollama` | `llama3.2` | `OLLAMA_BASE_URL` |
+
+```bash
+# Use Claude (default)
+llmwiki ingest paper.pdf
+
+# Use OpenAI
+llmwiki ingest paper.pdf -p openai -m gpt-4o-mini
+
+# Use Ollama (fully local, no API keys)
+llmwiki ingest paper.pdf -p ollama -m llama3.2
+```
+
+## Multi-Format Support
+
+| Format | Extensions | Processor | Requirements |
+|--------|-----------|-----------|-------------|
+| **Text** | `.md`, `.txt`, `.csv` | Direct read | None |
+| **PDF** | `.pdf` | Built-in text extraction | None |
+| **Audio** | `.mp3`, `.wav`, `.m4a`, `.ogg`, `.flac`, `.aac` | Whisper / Deepgram | `whisper` CLI or `DEEPGRAM_API_KEY` |
+| **Video** | `.mp4`, `.mov`, `.avi`, `.mkv`, `.webm` | ffmpeg + Whisper | `ffmpeg` + `whisper` |
+| **Image** | `.jpg`, `.png`, `.gif`, `.webp` | Claude Vision | `ANTHROPIC_API_KEY` |
+| **HTML** | `.html`, `.htm` | Tag stripping | None |
+| **JSON** | `.json` | Code block wrapping | None |
+| **Office** | `.docx`, `.pptx`, `.xlsx` | Basic extraction | None (enhanced coming) |
+| **URL** | `https://...` | Firecrawl / fetch | Optional `FIRECRAWL_API_KEY` |
+
+When a processor's requirements are not met (e.g., Whisper not installed for audio), llmwiki creates a reference page noting the source file and suggests installing the missing tool. The raw file is always preserved.
+
+## Obsidian Integration
+
+llmwiki vaults are Obsidian vaults. Open any llmwiki directory in Obsidian and you get:
+
+- **Graph view** showing all pages and their `[[wikilinks]]`
+- **YAML frontmatter** rendered as page metadata
+- **Backlinks** panel showing what links to each page
+- **Search** across all wiki content
+- **Tag view** from frontmatter `tags:` arrays
+
+No plugins required. No configuration. Just `Open folder as vault` in Obsidian.
+
+```
+# Every wiki page has frontmatter like this:
+---
+title: "Attention Is All You Need"
+type: source
+created: "2026-04-07"
+updated: "2026-04-07"
+tags: [transformers, attention, nlp]
+sources: ["raw/2026-04-07/attention-paper.pdf"]
+summary: "Foundational transformer architecture paper introducing self-attention"
+---
+```
+
+## Vault Structure
+
+```
+my-wiki/
+├── AGENTS.md             # Schema — wiki structure + conventions
+├── config.yaml           # Configuration — provider, sources, schedules
+├── .gitignore
+├── raw/                  # Immutable source archive
+│   ├── 2026-04-07/
+│   │   ├── paper.pdf
+│   │   ├── podcast.mp3
+│   │   └── blog-post.md
+│   └── 2026-04-08/
+│       └── meeting-notes.md
+└── wiki/                 # LLM-generated knowledge base
+    ├── index.md          # Auto-maintained content catalog
+    ├── log.md            # Chronological operation record
+    ├── sources/          # One summary per ingested source
+    ├── entities/         # People, organizations, tools
+    ├── concepts/         # Ideas, frameworks, patterns
+    └── syntheses/        # Cross-cutting analyses, query results
+```
+
+## Tests
+
+```bash
+cd /path/to/llmwiki && pnpm test
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## See Also
+
+- **[agentgrid](https://github.com/naman10parikh/agentgrid)** &mdash; Manage grids of AI coding agents in tmux
+- **[agentdial](https://github.com/naman10parikh/Energy)** &mdash; Universal agent identity protocol across 8 messaging channels
+
+## Credits
+
+Inspired by [Andrej Karpathy's LLM Wiki pattern](https://x.com/karpathy/status/1908625766490001799) &mdash; the idea that LLMs should compile knowledge into structured, interlinked wikis rather than just answering questions from raw chunks.
+
+## License
+
+MIT &mdash; see [LICENSE](LICENSE).

package/dist/cli/commands/duplicates.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerDuplicatesCommand(program: Command): void;
+//# sourceMappingURL=duplicates.d.ts.map

package/dist/cli/commands/duplicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/duplicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqChE"}

package/dist/cli/commands/duplicates.js

@@ -0,0 +1,38 @@
+import chalk from 'chalk';
+import { resolve } from 'node:path';
+import { getVaultConfig } from '../../core/vault.js';
+import { listDuplicates } from '../../core/ingest.js';
+export function registerDuplicatesCommand(program) {
+    program
+        .command('duplicates')
+        .description('List all files rejected as duplicates during ingestion')
+        .option('-v, --vault <path>', 'Vault root directory', '.')
+        .option('--json', 'Output as JSON')
+        .action((options) => {
+        const vaultRoot = resolve(options.vault ?? '.');
+        const config = getVaultConfig(vaultRoot);
+        const duplicates = listDuplicates(config.rawDir);
+        if (duplicates.length === 0) {
+            console.log(chalk.dim('No rejected duplicates found.'));
+            return;
+        }
+        if (options.json) {
+            console.log(JSON.stringify(duplicates, null, 2));
+            return;
+        }
+        console.log(chalk.cyan(`\nFound ${duplicates.length} rejected duplicate(s):\n`));
+        for (const dup of duplicates) {
+            console.log(chalk.white(`  ${dup.title}`));
+            console.log(chalk.dim(`    File:     ${dup.file}`));
+            console.log(chalk.yellow(`    Reason:   ${dup.reason}`));
+            console.log(chalk.dim(`    Similar:  ${dup.similarTo}`));
+            console.log(chalk.dim(`    Score:    ${Math.round(dup.score * 100)}%`));
+            if (dup.date) {
+                console.log(chalk.dim(`    Date:     ${dup.date}`));
+            }
+            console.log('');
+        }
+        console.log(chalk.dim(`Tip: Use ${chalk.white('llmwiki ingest <file> --force')} to override a rejection.\n`));
+    });
+}
+//# sourceMappingURL=duplicates.js.map

package/dist/cli/commands/duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.js","sourceRoot":"","sources":["../../../src/cli/commands/duplicates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOtD,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,CAAC,OAA0B,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,MAAM,2BAA2B,CAAC,CAAC,CAAC;QAEjF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAChH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/improve.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerImproveCommand(program: Command): void;
+//# sourceMappingURL=improve.d.ts.map

package/dist/cli/commands/improve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/improve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkE7D"}

package/dist/cli/commands/improve.js

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { getVaultConfig } from '../../core/vault.js';
+import { createProvider } from '../../providers/index.js';
+import { loadConfig } from '../../core/config.js';
+import { improveWiki } from '../../core/improve.js';
+export function registerImproveCommand(program) {
+    program
+        .command('improve')
+        .description('Self-improve the wiki using LLM Council review (Automation 3)')
+        .option('-v, --vault <path>', 'Vault root directory', '.')
+        .option('-p, --provider <provider>', 'LLM provider')
+        .option('--threshold <score>', 'Quality threshold (0-100, default 80)', '80')
+        .option('--dry-run', 'Show what would be changed without modifying')
+        .action(async (options) => {
+        const vaultRoot = resolve(options.vault ?? '.');
+        const config = getVaultConfig(vaultRoot);
+        const userConfig = loadConfig(config.configPath);
+        if (!existsSync(config.schemaPath)) {
+            console.error(chalk.red('Not a llmwiki vault. Run `llmwiki init` first.'));
+            process.exit(1);
+        }
+        const providerName = options.provider ?? userConfig.provider ?? 'claude';
+        const provider = createProvider(providerName);
+        const threshold = parseInt(options.threshold ?? '80', 10);
+        const spinner = ora('Evaluating wiki quality...').start();
+        try {
+            const result = await improveWiki(config, provider, {
+                threshold,
+                dryRun: options.dryRun ?? false,
+            });
+            spinner.stop();
+            console.log();
+            console.log(chalk.bold(`Wiki Quality Score: ${result.score}/100`));
+            console.log();
+            // Show dimension scores
+            for (const [dim, score] of Object.entries(result.dimensions)) {
+                const color = score >= 80 ? chalk.green : score >= 60 ? chalk.yellow : chalk.red;
+                console.log(`  ${dim}: ${color(String(score))}/100`);
+            }
+            console.log();
+            if (result.score >= threshold) {
+                console.log(chalk.green(`Score ${result.score} >= threshold ${threshold}. Wiki is healthy!`));
+            }
+            else {
+                console.log(chalk.yellow(`Score ${result.score} < threshold ${threshold}. Improvements needed.`));
+                console.log();
+                if (options.dryRun) {
+                    console.log(chalk.dim('Dry run — showing proposed changes:'));
+                }
+                else {
+                    console.log(chalk.blue('Applying improvements:'));
+                }
+                for (const action of result.actions) {
+                    const prefix = options.dryRun ? chalk.dim('[dry-run]') : chalk.green('[applied]');
+                    console.log(`  ${prefix} ${action.type}: ${action.description}`);
+                }
+            }
+        }
+        catch (error) {
+            spinner.fail(chalk.red('Improvement cycle failed'));
+            console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=improve.js.map

package/dist/cli/commands/improve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve.js","sourceRoot":"","sources":["../../../src/cli/commands/improve.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ingest.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerIngestCommand(program: Command): void;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/cli/commands/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiEpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwJ5D"}