codewiki-mcp 1.0.0 → 1.0.1

package/.github/workflows/ci.yml

@@ -16,9 +16,9 @@ jobs:
       matrix:
         node-version: [18, 20, 22]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
           cache: npm
@@ -33,7 +33,7 @@ jobs:
     needs: test
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Build Docker image
         run: docker build -t codewiki-mcp .

package/.github/workflows/release.yml

@@ -14,12 +14,12 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           persist-credentials: false
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: 22
           cache: npm

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.0.1](https://github.com/izzzzzi/codewiki-mcp/compare/v1.0.0...v1.0.1) (2026-02-16)
+
+
+### Bug Fixes
+
+* **docs:** correct GitHub owner in badge URLs and clone links ([dbcaa48](https://github.com/izzzzzi/codewiki-mcp/commit/dbcaa48a8b3ebc99274fa8919ff1ee10ef89d4ac))
+
 # 1.0.0 (2026-02-16)
 
 

package/README.md

@@ -1,53 +1,49 @@
-# codewiki-mcp
+<div align="center">
 
-MCP server for [codewiki.google](https://codewiki.google) — search, fetch wiki docs, and ask questions about any open-source repository.
+# 📚 codewiki-mcp
 
-[Русская версия](README.ru.md)
+**MCP server for codewiki.google — search, fetch docs, and ask questions about any open-source repo**
 
-## Features
+[![CI](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/ci.yml)
+[![Release](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/release.yml)
+[![npm version](https://img.shields.io/npm/v/codewiki-mcp.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/codewiki-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/codewiki-mcp.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/codewiki-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat&colorA=18181B&colorB=28CF8D)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat&colorA=18181B&colorB=3178C6)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-ESM-green?style=flat&colorA=18181B&colorB=339933)](https://nodejs.org/)
 
-- **3 MCP tools**: search repos, fetch wiki content, ask questions with conversation history
-- **Multiple transports**: stdio (default), Streamable HTTP, SSE
-- **NLP repo resolution**: natural-language input → GitHub search → `owner/repo` (via wink-nlp)
-- **Retry with exponential backoff**: configurable retries for resilient API calls
-- **Structured errors**: typed error codes (`VALIDATION`, `RPC_FAIL`, `TIMEOUT`, `NLP_RESOLVE_FAIL`)
-- **Response metadata**: byte count and elapsed time on every response
-- **Docker support**: multi-stage Alpine build
-- **Claude Code skill**: prompt templates, workflow chains, error handling guide
+[🇷🇺 Русский](README.ru.md) | **🇬🇧 English**
 
-## Usage
+<br />
 
-Prompts you can use in any MCP-compatible client:
+*MCP server that connects any AI assistant to [codewiki.google](https://codewiki.google) — AI-generated wiki documentation for open-source repositories.*
 
-```
-codewiki fetch how routing works in Next.js
-```
+</div>
 
-```
-codewiki search state management libraries
-```
+---
 
-```
-codewiki ask how does React fiber reconciler work?
-```
+## 📖 Overview
 
-Fetch complete documentation:
-```
-codewiki fetch vercel/next.js
-codewiki fetch https://github.com/fastify/fastify
-```
+**codewiki-mcp** is a [Model Context Protocol](https://modelcontextprotocol.io/) server that gives AI assistants access to **codewiki.google** — a service that generates comprehensive wiki documentation for any GitHub repository. Search repos, fetch full docs, or ask natural-language questions — all through MCP.
 
-Get structured pages:
-```
-codewiki fetch pages tailwindlabs/tailwindcss
-```
+---
 
-Ask with natural language:
-```
-codewiki ask fastify how to add authentication?
-```
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔍 **Search Repos** | Find repositories indexed by codewiki.google |
+| 📄 **Fetch Wiki Docs** | Get full markdown or structured pages for any repo |
+| 💬 **Ask Questions** | Natural-language Q&A with conversation history |
+| 🧠 **NLP Repo Resolution** | Type naturally — wink-nlp extracts keywords and resolves to `owner/repo` |
+| 📡 **Multiple Transports** | stdio (default), Streamable HTTP, SSE |
+| 🔄 **Retry with Backoff** | Automatic retries with exponential backoff on 5xx errors |
+| 🐳 **Docker Support** | Multi-stage Alpine build |
+| 📊 **Response Metadata** | Byte count and elapsed time on every response |
 
-## Quick Start
+---
+
+## 🚀 Quick Start
 
 ### Using npx (no install)
 
@@ -58,31 +54,26 @@ npx -y codewiki-mcp@latest
 ### From source
 
 ```bash
-git clone https://github.com/nicholasxwang/codewiki-mcp.git
+git clone https://github.com/izzzzzi/codewiki-mcp.git
 cd codewiki-mcp
 npm install
 npm run build
 ```
 
-### stdio (default)
+### Transports
 
 ```bash
+# stdio (default)
 node dist/cli.js
-```
 
-### HTTP
-
-```bash
+# Streamable HTTP
 node dist/cli.js --http --port 3000
-```
 
-### SSE
-
-```bash
+# SSE
 node dist/cli.js --sse --port 3001
 ```
 
-### Docker
+### 🐳 Docker
 
 ```bash
 docker build -t codewiki-mcp .
@@ -101,11 +92,14 @@ docker run -p 3000:3000 \
   codewiki-mcp --http
 ```
 
-## MCP Client Configuration
+---
 
-### Cursor
+## 🔧 MCP Client Configuration
 
-Add to `.cursor/mcp.json` (or use the included one):
+<details>
+<summary><b>Cursor</b></summary>
+
+Add to `.cursor/mcp.json`:
 
 ```json
 {
@@ -118,7 +112,10 @@ Add to `.cursor/mcp.json` (or use the included one):
 }
 ```
 
-### Claude Desktop
+</details>
+
+<details>
+<summary><b>Claude Desktop</b></summary>
 
 Add to `claude_desktop_config.json`:
 
@@ -133,13 +130,19 @@ Add to `claude_desktop_config.json`:
 }
 ```
 
-### Claude Code
+</details>
+
+<details>
+<summary><b>Claude Code</b></summary>
 
 ```bash
 claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 ```
 
-### Windsurf
+</details>
+
+<details>
+<summary><b>Windsurf</b></summary>
 
 Add to your Windsurf MCP config:
 
@@ -154,7 +157,10 @@ Add to your Windsurf MCP config:
 }
 ```
 
-### VS Code (Copilot)
+</details>
+
+<details>
+<summary><b>VS Code (Copilot)</b></summary>
 
 Add to `.vscode/mcp.json`:
 
@@ -169,7 +175,10 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-### Local development config
+</details>
+
+<details>
+<summary><b>Local development</b></summary>
 
 ```json
 {
@@ -182,39 +191,83 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-## MCP Tools
+</details>
+
+---
+
+## 💡 Usage
+
+Prompts you can use in any MCP-compatible client:
+
+```
+codewiki fetch how routing works in Next.js
+```
+
+```
+codewiki search state management libraries
+```
+
+```
+codewiki ask how does React fiber reconciler work?
+```
+
+Fetch complete documentation:
+
+```
+codewiki fetch vercel/next.js
+codewiki fetch https://github.com/fastify/fastify
+```
+
+Get structured pages:
+
+```
+codewiki fetch pages tailwindlabs/tailwindcss
+```
+
+Ask with natural language:
+
+```
+codewiki ask fastify how to add authentication?
+```
+
+---
 
-### codewiki_search_repos
+## 🛠️ MCP Tools
+
+### 🔍 codewiki_search_repos
 
 Search repositories indexed by codewiki.google.
 
 | Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `query` | string | yes | — | Search query |
-| `limit` | number | no | 10 | Max results (1–50) |
+|-----------|------|:--------:|---------|-------------|
+| `query` | string | ✅ | — | Search query |
+| `limit` | number | — | 10 | Max results (1–50) |
 
-### codewiki_fetch_repo
+### 📄 codewiki_fetch_repo
 
 Fetch generated wiki content for a repository.
 
 | Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `repo` | string | yes | — | `owner/repo`, GitHub URL, or natural-language query |
-| `mode` | string | no | `"aggregate"` | `"aggregate"` — full markdown; `"pages"` — structured JSON |
+|-----------|------|:--------:|---------|-------------|
+| `repo` | string | ✅ | — | `owner/repo`, GitHub URL, or natural-language query |
+| `mode` | string | — | `"aggregate"` | `"aggregate"` — full markdown; `"pages"` — structured JSON |
 
-### codewiki_ask_repo
+### 💬 codewiki_ask_repo
 
 Ask a natural-language question about a repository.
 
 | Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| `repo` | string | yes | — | Repository identifier (same formats as fetch) |
-| `question` | string | yes | — | Question about the repo |
-| `history` | array | no | `[]` | Conversation history `[{role, content}]` (max 20) |
+|-----------|------|:--------:|---------|-------------|
+| `repo` | string | ✅ | — | Repository identifier (same formats as fetch) |
+| `question` | string | ✅ | — | Question about the repo |
+| `history` | array | — | `[]` | Conversation history `[{role, content}]` (max 20) |
+
+---
 
-## Response Format
+## 📊 Response Format
 
-### Success — Search
+<details>
+<summary><b>✅ Success — Search</b></summary>
 
 ```json
 {
@@ -236,7 +289,10 @@ Ask a natural-language question about a repository.
 }
 ```
 
-### Success — Fetch (pages mode)
+</details>
+
+<details>
+<summary><b>✅ Success — Fetch (pages mode)</b></summary>
 
 ```json
 {
@@ -259,7 +315,10 @@ Ask a natural-language question about a repository.
 }
 ```
 
-### Success — Ask
+</details>
+
+<details>
+<summary><b>✅ Success — Ask</b></summary>
 
 ```json
 {
@@ -271,7 +330,10 @@ Ask a natural-language question about a repository.
 }
 ```
 
-### Error Response
+</details>
+
+<details>
+<summary><b>❌ Error Response</b></summary>
 
 ```json
 {
@@ -284,47 +346,20 @@ Ask a natural-language question about a repository.
 }
 ```
 
-### Direct API Calls (HTTP transport)
+Error codes: `VALIDATION`, `RPC_FAIL`, `TIMEOUT`, `NLP_RESOLVE_FAIL`
 
-```bash
-# Start server
-node dist/cli.js --http --port 3000
+</details>
 
-# Search
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/call",
-    "params": {
-      "name": "codewiki_search_repos",
-      "arguments": { "query": "fastify", "limit": 5 }
-    }
-  }'
-
-# Fetch wiki
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 2,
-    "method": "tools/call",
-    "params": {
-      "name": "codewiki_fetch_repo",
-      "arguments": { "repo": "fastify/fastify", "mode": "pages" }
-    }
-  }'
-```
+---
 
-## How It Works
+## ⚙️ How It Works
 
 ### Data Flow
 
 ```
-Claude Code → MCP protocol → codewiki-mcp → HTTPS → codewiki.google
-                                                          ↓
-Claude Code ← MCP protocol ← codewiki-mcp ← JSON  ← Google RPC API
+AI Assistant → MCP protocol → codewiki-mcp → HTTPS → codewiki.google
+                                                            ↓
+AI Assistant ← MCP protocol ← codewiki-mcp ← JSON  ← Google RPC API
 ```
 
 ### Google Batchexecute RPC
@@ -337,11 +372,14 @@ codewiki.google uses Google's internal **batchexecute** RPC format (not REST, no
 4. Parses `wrb.fr` frames and extracts the typed payload
 
 Each tool maps to an RPC ID:
-- `vyWDAf` — search
-- `VSX6ub` — fetch wiki
-- `EgIxfe` — ask question
 
-### NLP Repo Resolution
+| Tool | RPC ID |
+|------|:------:|
+| 🔍 Search | `vyWDAf` |
+| 📄 Fetch | `VSX6ub` |
+| 💬 Ask | `EgIxfe` |
+
+### 🧠 NLP Repo Resolution
 
 Users can type natural language instead of `owner/repo`:
 
@@ -353,20 +391,20 @@ Users can type natural language instead of `owner/repo`:
   → normalizeRepoInput("fastify/fastify") → URL for codewiki
 ```
 
-### Retry with Exponential Backoff
+### 🔄 Retry with Exponential Backoff
 
-On 5xx errors or timeouts, the client retries automatically:
+| Attempt | Delay |
+|:-------:|------:|
+| 0 | immediate |
+| 1 | 250ms |
+| 2 | 500ms |
+| 3 | 1000ms |
 
-```
-Attempt 0: immediate
-Attempt 1: after 250ms
-Attempt 2: after 500ms
-Attempt 3: after 1000ms
-```
+> 4xx errors (client errors) are never retried.
 
-4xx errors (client errors) are never retried.
+---
 
-## CLI
+## 🖥️ CLI
 
 ```
 codewiki-mcp [options]
@@ -379,7 +417,9 @@ Options:
   --help, -h       Show help
 ```
 
-## Configuration
+---
+
+## ⚡ Configuration
 
 Environment variables:
 
@@ -399,19 +439,9 @@ CODEWIKI_MAX_RETRIES=5
 GITHUB_TOKEN=ghp_your_token
 ```
 
-## Development
+---
 
-```bash
-npm run dev          # stdio with tsx
-npm run dev:http     # HTTP with tsx
-npm run dev:sse      # SSE with tsx
-npm run typecheck    # type check
-npm run test         # run tests
-npm run test:watch   # tests in watch mode
-npm run build        # compile to dist/
-```
-
-## Project Structure
+## 📁 Project Structure
 
 ```
 src/
@@ -433,22 +463,31 @@ src/
     └── askRepo.ts          # codewiki_ask_repo
 ```
 
-## Troubleshooting
+---
 
-### Permission Denied
+## ❓ Troubleshooting
+
+<details>
+<summary><b>Permission Denied</b></summary>
 
 ```bash
 chmod +x ./node_modules/.bin/codewiki-mcp
 ```
 
-### Connection Refused (HTTP/SSE)
+</details>
+
+<details>
+<summary><b>Connection Refused (HTTP/SSE)</b></summary>
 
 ```bash
 # Check if port is in use
 lsof -i :3000
 ```
 
-### Timeout Errors
+</details>
+
+<details>
+<summary><b>Timeout Errors</b></summary>
 
 For large repositories, increase the timeout:
 
@@ -456,7 +495,10 @@ For large repositories, increase the timeout:
 CODEWIKI_REQUEST_TIMEOUT=60000 node dist/cli.js
 ```
 
-### NLP Resolution Fails
+</details>
+
+<details>
+<summary><b>NLP Resolution Fails</b></summary>
 
 If natural-language input doesn't resolve, use explicit format:
 
@@ -469,7 +511,25 @@ https://github.com/fastify/fastify
 
 Set `GITHUB_TOKEN` to avoid GitHub API rate limits for unauthenticated requests.
 
-## Contributing
+</details>
+
+---
+
+## 🧑‍💻 Development
+
+```bash
+npm run dev          # stdio with tsx
+npm run dev:http     # HTTP with tsx
+npm run dev:sse      # SSE with tsx
+npm run typecheck    # type check
+npm run test         # run tests
+npm run test:watch   # tests in watch mode
+npm run build        # compile to dist/
+```
+
+---
+
+## 🤝 Contributing
 
 Contributions are welcome! Please:
 
@@ -479,6 +539,8 @@ Contributions are welcome! Please:
 4. Run `npm run typecheck && npm run test` before submitting
 5. Open a Pull Request
 
-## License
+---
+
+## 📄 License
 
-MIT
+[MIT](LICENSE) © codewiki-mcp contributors

package/README.ru.md

@@ -1,53 +1,49 @@
-# codewiki-mcp
+<div align="center">
 
-MCP-сервер для [codewiki.google](https://codewiki.google) — поиск, получение wiki-документации и вопросы по любому open-source репозиторию.
+# 📚 codewiki-mcp
 
-[English version](README.md)
+**MCP-сервер для codewiki.google — поиск, документация и вопросы по любому open-source репозиторию**
 
-## Возможности
+[![CI](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/ci.yml)
+[![Release](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/izzzzzi/codewiki-mcp/actions/workflows/release.yml)
+[![npm version](https://img.shields.io/npm/v/codewiki-mcp.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/codewiki-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/codewiki-mcp.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/codewiki-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat&colorA=18181B&colorB=28CF8D)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat&colorA=18181B&colorB=3178C6)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-ESM-green?style=flat&colorA=18181B&colorB=339933)](https://nodejs.org/)
 
-- **3 MCP-инструмента**: поиск репозиториев, получение wiki-контента, вопросы с историей диалога
-- **Множественные транспорты**: stdio (по умолчанию), Streamable HTTP, SSE
-- **NLP-резолвинг репозиториев**: естественный язык → поиск по GitHub → `owner/repo` (через wink-nlp)
-- **Retry с exponential backoff**: настраиваемые повторные запросы
-- **Структурированные ошибки**: типизированные коды (`VALIDATION`, `RPC_FAIL`, `TIMEOUT`, `NLP_RESOLVE_FAIL`)
-- **Метаданные ответов**: размер в байтах и время выполнения в каждом ответе
-- **Docker**: multi-stage Alpine-сборка
-- **Claude Code skill**: промпт-шаблоны, воркфлоу-цепочки, гайд по обработке ошибок
+**🇷🇺 Русский** | [🇬🇧 English](README.md)
 
-## Использование
+<br />
 
-Промпты, которые можно использовать в любом MCP-совместимом клиенте:
+*MCP-сервер, подключающий любого AI-ассистента к [codewiki.google](https://codewiki.google) — сервису генерации wiki-документации для open-source репозиториев.*
 
-```
-codewiki fetch как устроен роутинг в Next.js
-```
+</div>
 
-```
-codewiki search библиотеки для управления состоянием
-```
+---
 
-```
-codewiki ask как работает fiber reconciler в React?
-```
+## 📖 Обзор
 
-Получить полную документацию:
-```
-codewiki fetch vercel/next.js
-codewiki fetch https://github.com/fastify/fastify
-```
+**codewiki-mcp** — это [Model Context Protocol](https://modelcontextprotocol.io/) сервер, который даёт AI-ассистентам доступ к **codewiki.google** — сервису, генерирующему подробную wiki-документацию для любого GitHub-репозитория. Ищите репозитории, получайте полную документацию или задавайте вопросы на естественном языке — всё через MCP.
 
-Получить структурированные страницы:
-```
-codewiki fetch pages tailwindlabs/tailwindcss
-```
+---
 
-Задать вопрос:
-```
-codewiki ask fastify как добавить аутентификацию?
-```
+## ✨ Возможности
 
-## Быстрый старт
+| Фича | Описание |
+|------|----------|
+| 🔍 **Поиск репозиториев** | Поиск по индексу codewiki.google |
+| 📄 **Получение wiki-документации** | Полный markdown или структурированные страницы |
+| 💬 **Вопросы по репозиторию** | Q&A на естественном языке с историей диалога |
+| 🧠 **NLP-резолвинг** | Пишите на естественном языке — wink-nlp извлечёт ключевые слова и найдёт `owner/repo` |
+| 📡 **Множественные транспорты** | stdio (по умолчанию), Streamable HTTP, SSE |
+| 🔄 **Retry с backoff** | Автоматические повторы с exponential backoff при 5xx ошибках |
+| 🐳 **Docker** | Multi-stage Alpine-сборка |
+| 📊 **Метаданные ответов** | Размер в байтах и время выполнения в каждом ответе |
+
+---
+
+## 🚀 Быстрый старт
 
 ### Через npx (без установки)
 
@@ -58,31 +54,26 @@ npx -y codewiki-mcp@latest
 ### Из исходников
 
 ```bash
-git clone https://github.com/nicholasxwang/codewiki-mcp.git
+git clone https://github.com/izzzzzi/codewiki-mcp.git
 cd codewiki-mcp
 npm install
 npm run build
 ```
 
-### stdio (по умолчанию)
+### Транспорты
 
 ```bash
+# stdio (по умолчанию)
 node dist/cli.js
-```
-
-### HTTP
 
-```bash
+# Streamable HTTP
 node dist/cli.js --http --port 3000
-```
-
-### SSE
 
-```bash
+# SSE
 node dist/cli.js --sse --port 3001
 ```
 
-### Docker
+### 🐳 Docker
 
 ```bash
 docker build -t codewiki-mcp .
@@ -101,11 +92,14 @@ docker run -p 3000:3000 \
   codewiki-mcp --http
 ```
 
-## Настройка MCP-клиентов
+---
+
+## 🔧 Настройка MCP-клиентов
 
-### Cursor
+<details>
+<summary><b>Cursor</b></summary>
 
-Добавьте в `.cursor/mcp.json` (или используйте встроенный):
+Добавьте в `.cursor/mcp.json`:
 
 ```json
 {
@@ -118,7 +112,10 @@ docker run -p 3000:3000 \
 }
 ```
 
-### Claude Desktop
+</details>
+
+<details>
+<summary><b>Claude Desktop</b></summary>
 
 Добавьте в `claude_desktop_config.json`:
 
@@ -133,13 +130,19 @@ docker run -p 3000:3000 \
 }
 ```
 
-### Claude Code
+</details>
+
+<details>
+<summary><b>Claude Code</b></summary>
 
 ```bash
 claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 ```
 
-### Windsurf
+</details>
+
+<details>
+<summary><b>Windsurf</b></summary>
 
 Добавьте в конфигурацию Windsurf MCP:
 
@@ -154,7 +157,10 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### VS Code (Copilot)
+</details>
+
+<details>
+<summary><b>VS Code (Copilot)</b></summary>
 
 Добавьте в `.vscode/mcp.json`:
 
@@ -169,7 +175,10 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### Локальная разработка
+</details>
+
+<details>
+<summary><b>Локальная разработка</b></summary>
 
 ```json
 {
@@ -182,39 +191,83 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-## MCP-инструменты
+</details>
+
+---
+
+## 💡 Использование
+
+Промпты для любого MCP-совместимого клиента:
+
+```
+codewiki fetch как устроен роутинг в Next.js
+```
+
+```
+codewiki search библиотеки для управления состоянием
+```
+
+```
+codewiki ask как работает fiber reconciler в React?
+```
+
+Получить полную документацию:
+
+```
+codewiki fetch vercel/next.js
+codewiki fetch https://github.com/fastify/fastify
+```
+
+Получить структурированные страницы:
+
+```
+codewiki fetch pages tailwindlabs/tailwindcss
+```
+
+Задать вопрос:
+
+```
+codewiki ask fastify как добавить аутентификацию?
+```
+
+---
+
+## 🛠️ MCP-инструменты
 
-### codewiki_search_repos
+### 🔍 codewiki_search_repos
 
 Поиск репозиториев, проиндексированных codewiki.google.
 
 | Параметр | Тип | Обязательный | По умолчанию | Описание |
-|----------|-----|--------------|--------------|----------|
-| `query` | string | да | — | Поисковый запрос |
-| `limit` | number | нет | 10 | Макс. результатов (1–50) |
+|----------|-----|:------------:|--------------|----------|
+| `query` | string | ✅ | — | Поисковый запрос |
+| `limit` | number | — | 10 | Макс. результатов (1–50) |
 
-### codewiki_fetch_repo
+### 📄 codewiki_fetch_repo
 
 Получение сгенерированного wiki-контента для репозитория.
 
 | Параметр | Тип | Обязательный | По умолчанию | Описание |
-|----------|-----|--------------|--------------|----------|
-| `repo` | string | да | — | `owner/repo`, URL на GitHub или запрос на естественном языке |
-| `mode` | string | нет | `"aggregate"` | `"aggregate"` — полный markdown; `"pages"` — структурированный JSON |
+|----------|-----|:------------:|--------------|----------|
+| `repo` | string | ✅ | — | `owner/repo`, URL на GitHub или запрос на естественном языке |
+| `mode` | string | — | `"aggregate"` | `"aggregate"` — полный markdown; `"pages"` — структурированный JSON |
 
-### codewiki_ask_repo
+### 💬 codewiki_ask_repo
 
 Вопрос на естественном языке о репозитории.
 
 | Параметр | Тип | Обязательный | По умолчанию | Описание |
-|----------|-----|--------------|--------------|----------|
-| `repo` | string | да | — | Идентификатор репозитория (те же форматы, что и fetch) |
-| `question` | string | да | — | Вопрос о репозитории |
-| `history` | array | нет | `[]` | История диалога `[{role, content}]` (макс. 20) |
+|----------|-----|:------------:|--------------|----------|
+| `repo` | string | ✅ | — | Идентификатор репозитория (те же форматы, что и fetch) |
+| `question` | string | ✅ | — | Вопрос о репозитории |
+| `history` | array | — | `[]` | История диалога `[{role, content}]` (макс. 20) |
 
-## Формат ответов
+---
 
-### Успех — Поиск
+## 📊 Формат ответов
+
+<details>
+<summary><b>✅ Успех — Поиск</b></summary>
 
 ```json
 {
@@ -236,7 +289,10 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### Успех — Fetch (режим pages)
+</details>
+
+<details>
+<summary><b>✅ Успех — Fetch (режим pages)</b></summary>
 
 ```json
 {
@@ -259,7 +315,10 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### Успех — Ask
+</details>
+
+<details>
+<summary><b>✅ Успех — Ask</b></summary>
 
 ```json
 {
@@ -271,7 +330,10 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### Ответ с ошибкой
+</details>
+
+<details>
+<summary><b>❌ Ответ с ошибкой</b></summary>
 
 ```json
 {
@@ -284,47 +346,20 @@ claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
 }
 ```
 
-### Прямые API-вызовы (HTTP-транспорт)
+Коды ошибок: `VALIDATION`, `RPC_FAIL`, `TIMEOUT`, `NLP_RESOLVE_FAIL`
 
-```bash
-# Запустить сервер
-node dist/cli.js --http --port 3000
+</details>
 
-# Поиск
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 1,
-    "method": "tools/call",
-    "params": {
-      "name": "codewiki_search_repos",
-      "arguments": { "query": "fastify", "limit": 5 }
-    }
-  }'
-
-# Получить wiki
-curl -X POST http://localhost:3000/mcp \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": 2,
-    "method": "tools/call",
-    "params": {
-      "name": "codewiki_fetch_repo",
-      "arguments": { "repo": "fastify/fastify", "mode": "pages" }
-    }
-  }'
-```
+---
 
-## Как это работает
+## ⚙️ Как это работает
 
 ### Поток данных
 
 ```
-Claude Code → MCP протокол → codewiki-mcp → HTTPS → codewiki.google
-                                                          ↓
-Claude Code ← MCP протокол ← codewiki-mcp ← JSON  ← Google RPC API
+AI-ассистент → MCP протокол → codewiki-mcp → HTTPS → codewiki.google
+                                                            ↓
+AI-ассистент ← MCP протокол ← codewiki-mcp ← JSON  ← Google RPC API
 ```
 
 ### Google Batchexecute RPC
@@ -337,11 +372,14 @@ codewiki.google использует внутренний Google-формат AP
 4. Парсит `wrb.fr`-фреймы и извлекает типизированный payload
 
 Каждый инструмент использует свой RPC ID:
-- `vyWDAf` — поиск
-- `VSX6ub` — получение wiki
-- `EgIxfe` — вопрос-ответ
 
-### NLP-резолвинг репозиториев
+| Инструмент | RPC ID |
+|------------|:------:|
+| 🔍 Поиск | `vyWDAf` |
+| 📄 Fetch | `VSX6ub` |
+| 💬 Вопрос | `EgIxfe` |
+
+### 🧠 NLP-резолвинг репозиториев
 
 Пользователь может написать не только `owner/repo`, но и текст на естественном языке:
 
@@ -353,20 +391,20 @@ codewiki.google использует внутренний Google-формат AP
   → normalizeRepoInput("fastify/fastify") → URL для codewiki
 ```
 
-### Retry с exponential backoff
+### 🔄 Retry с exponential backoff
 
-При 5xx ошибках или таймаутах клиент автоматически повторяет запрос:
+| Попытка | Задержка |
+|:-------:|---------:|
+| 0 | сразу |
+| 1 | 250мс |
+| 2 | 500мс |
+| 3 | 1000мс |
 
-```
-Попытка 0: сразу
-Попытка 1: через 250мс
-Попытка 2: через 500мс
-Попытка 3: через 1000мс
-```
+> На 4xx ошибки (клиентские) retry не делается — бессмысленно.
 
-На 4xx ошибки (клиентские) retry не делается — бессмысленно.
+---
 
-## CLI
+## 🖥️ CLI
 
 ```
 codewiki-mcp [опции]
@@ -379,7 +417,9 @@ codewiki-mcp [опции]
   --help, -h       Показать справку
 ```
 
-## Конфигурация
+---
+
+## ⚡ Конфигурация
 
 Переменные окружения:
 
@@ -399,19 +439,9 @@ CODEWIKI_MAX_RETRIES=5
 GITHUB_TOKEN=ghp_your_token
 ```
 
-## Разработка
+---
 
-```bash
-npm run dev          # stdio через tsx
-npm run dev:http     # HTTP через tsx
-npm run dev:sse      # SSE через tsx
-npm run typecheck    # проверка типов
-npm run test         # запуск тестов
-npm run test:watch   # тесты в watch-режиме
-npm run build        # сборка в dist/
-```
-
-## Структура проекта
+## 📁 Структура проекта
 
 ```
 src/
@@ -433,22 +463,31 @@ src/
     └── askRepo.ts          # codewiki_ask_repo
 ```
 
-## Решение проблем
+---
 
-### Permission Denied
+## ❓ Решение проблем
+
+<details>
+<summary><b>Permission Denied</b></summary>
 
 ```bash
 chmod +x ./node_modules/.bin/codewiki-mcp
 ```
 
-### Connection Refused (HTTP/SSE)
+</details>
+
+<details>
+<summary><b>Connection Refused (HTTP/SSE)</b></summary>
 
 ```bash
 # Проверить, занят ли порт
 lsof -i :3000
 ```
 
-### Ошибки таймаута
+</details>
+
+<details>
+<summary><b>Ошибки таймаута</b></summary>
 
 Для больших репозиториев увеличьте таймаут:
 
@@ -456,7 +495,10 @@ lsof -i :3000
 CODEWIKI_REQUEST_TIMEOUT=60000 node dist/cli.js
 ```
 
-### NLP-резолвинг не работает
+</details>
+
+<details>
+<summary><b>NLP-резолвинг не работает</b></summary>
 
 Если естественный язык не резолвится, используйте явный формат:
 
@@ -469,7 +511,25 @@ https://github.com/fastify/fastify
 
 Установите `GITHUB_TOKEN`, чтобы избежать лимитов GitHub API для неаутентифицированных запросов.
 
-## Участие в разработке
+</details>
+
+---
+
+## 🧑‍💻 Разработка
+
+```bash
+npm run dev          # stdio через tsx
+npm run dev:http     # HTTP через tsx
+npm run dev:sse      # SSE через tsx
+npm run typecheck    # проверка типов
+npm run test         # запуск тестов
+npm run test:watch   # тесты в watch-режиме
+npm run build        # сборка в dist/
+```
+
+---
+
+## 🤝 Участие в разработке
 
 Мы приветствуем вклад! Пожалуйста:
 
@@ -479,6 +539,8 @@ https://github.com/fastify/fastify
 4. Запустите `npm run typecheck && npm run test` перед отправкой
 5. Откройте Pull Request
 
-## Лицензия
+---
+
+## 📄 Лицензия
 
-MIT
+[MIT](LICENSE) © codewiki-mcp contributors

package/dist/schemas.d.ts

@@ -3,48 +3,22 @@ export type { ErrorEnvelope } from './lib/errors.js';
 export declare const SearchReposInput: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    query: string;
-    limit: number;
-}, {
-    query: string;
-    limit?: number | undefined;
-}>;
+}, z.core.$strip>;
 export declare const FetchRepoInput: z.ZodObject<{
     repo: z.ZodString;
-    mode: z.ZodDefault<z.ZodEnum<["aggregate", "pages"]>>;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-    mode: "aggregate" | "pages";
-}, {
-    repo: string;
-    mode?: "aggregate" | "pages" | undefined;
-}>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        aggregate: "aggregate";
+        pages: "pages";
+    }>>;
+}, z.core.$strip>;
 export declare const AskRepoInput: z.ZodObject<{
     repo: z.ZodString;
     question: z.ZodString;
     history: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        role: z.ZodEnum<["user", "assistant"]>;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+        }>;
         content: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        role: "user" | "assistant";
-        content: string;
-    }, {
-        role: "user" | "assistant";
-        content: string;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    repo: string;
-    question: string;
-    history?: {
-        role: "user" | "assistant";
-        content: string;
-    }[] | undefined;
-}, {
-    repo: string;
-    question: string;
-    history?: {
-        role: "user" | "assistant";
-        content: string;
-    }[] | undefined;
-}>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codewiki-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for codewiki.google",
   "type": "module",
   "bin": {
@@ -22,16 +22,16 @@
     "@modelcontextprotocol/sdk": "^1.19.0",
     "wink-eng-lite-web-model": "^1.8.1",
     "wink-nlp": "^2.4.0",
-    "zod": "^3.24.2"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^12.0.6",
-    "@types/node": "^22.13.9",
+    "@types/node": "^25.2.3",
     "semantic-release": "^25.0.3",
     "tsx": "^4.19.3",
     "typescript": "^5.8.2",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   }
 }