zenn-rag 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SoraKumo
+
+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,221 @@
+# zenn-rag
+
+Zenn 記事リポジトリのための **Vector DB & RAG（検索・執筆支援）ツールキット**。
+Markdown記事を見出し単位でベクトル化し、CLI検索および **Model Context Protocol (MCP)** サーバー経由でエディタやAIアシスタント（Cursor、Claude、Antigravityなど）と連携できます。
+
+---
+
+## 主な機能
+
+- **コードブロック保護付き階層チャンキング**: Frontmatterメタデータ（タイトル・トピック）と見出し（H1〜H3）の階層構造を保持し、コードブロックを途中で切断せずにベクトル化
+- **Zenn 記事（Articles）＆ 本（Books）の双方に対応**: `articles/*.md` に加え、`books/<book-slug>/*.md` の各チャプターも自動認識してインデックス
+- **自動同期（ウォッチモード）**: `index --watch` でファイル保存時にバックグラウンドで即時差分同期
+- **マルチプロバイダー対応**:
+  - **OpenAI / LM Studio / LocalAI**: 高速バッチEmbedding（`text-embedding-bge-m3`, `text-embedding-3-small` など）
+  - **Google Gemini**: レートリミット制御・自動リトライ付き（`gemini-embedding-001`）
+  - **Ollama**: ローカルオフライン実行（`bge-m3` など）
+- **高速・サーバーレスVector DB**: Apache Arrowベースの **LanceDB** を採用し、コサイン類似度で高精度検索
+- **スマート差分同期**: ファイルのMD5ハッシュで変更を検知し、新規・更新された記事・本チャプターのみを数秒で同期
+- **モデル変更の自動検知**: モデルや次元数が変わった場合は自動でテーブルをリセット＆再構築
+- **MCP サーバー標準搭載**: `zenn-rag mcp` でAIエディタから過去記事を参照・引用・リンク推薦・インデックス更新が可能
+
+---
+
+## インストール
+
+```bash
+# グローバルインストール
+pnpm add -g zenn-rag
+# またはプロジェクトに追加
+pnpm add -D zenn-rag
+```
+
+または `npx` で即座に実行できます：
+
+```bash
+npx zenn-rag --help
+```
+
+---
+
+## 設定（.env）
+
+Zenn プロジェクトのルートディレクトリに `.env` を配置します（`.env.example` 参照）。
+本ツールではプロバイダを切り替えても同じ環境変数名（`BASE_URL`, `EMBEDDING_MODEL`, `API_KEY`）で直感的に設定できます。
+
+### 共通環境変数一覧
+
+| 環境変数名           |  必須  | デフォルト値                          | 説明                                                                    |
+| :------------------- | :----: | :------------------------------------ | :---------------------------------------------------------------------- |
+| `EMBEDDING_PROVIDER` |  任意  | `gemini` または APIキー等から自動判別 | 使用するプロバイダ (`openai` \| `ollama` \| `gemini`)                   |
+| `BASE_URL`           |  任意  | プロバイダ依存                        | エンドポイントURL（LM Studio や Ollama 利用時に指定）                   |
+| `EMBEDDING_MODEL`    |  任意  | プロバイダ依存                        | 使用する埋め込みモデル名                                                |
+| `API_KEY`            | 条件付 | -                                     | APIキー（Gemini, OpenAI利用時に必須。LM Studio等は任意文字列で可）      |
+| `ZENN_USERNAME`      |  任意  | -                                     | 記事URL生成用ユーザー名 (`https://zenn.dev/[username]/articles/[slug]`) |
+| `VECTOR_DB_DIR`      |  任意  | `.vectordb`                           | Vector DB (LanceDB) のデータ保存ディレクトリ                            |
+
+> 💡 **Tip**: 従来の `OPENAI_BASE_URL` や `GEMINI_API_KEY`, `OLLAMA_EMBEDDING_MODEL` などのプロバイダ別環境変数もそのまま利用可能です（個別設定がある場合はそちらが優先されます）。
+
+---
+
+### 代表的なプロバイダ設定例
+
+#### 1. LM Studio（OpenAI 互換ローカルサーバー / 推奨）
+
+完全ローカルで高速・無料にベクトル化できます。
+
+```env
+EMBEDDING_PROVIDER=openai
+BASE_URL=http://localhost:1234/v1
+EMBEDDING_MODEL=text-embedding-bge-m3
+API_KEY=lm-studio
+
+ZENN_USERNAME=your_zenn_id
+VECTOR_DB_DIR=.vectordb
+```
+
+#### 2. Ollama（完全ローカル・オフライン）
+
+```env
+EMBEDDING_PROVIDER=ollama
+BASE_URL=http://localhost:11434
+EMBEDDING_MODEL=bge-m3
+
+ZENN_USERNAME=your_zenn_id
+VECTOR_DB_DIR=.vectordb
+```
+
+#### 3. Google Gemini（クラウド）
+
+Google AI Studio で取得した無料〜従量課金の API キーを使用します。
+
+```env
+EMBEDDING_PROVIDER=gemini
+API_KEY=AIzaSy...
+EMBEDDING_MODEL=gemini-embedding-001
+
+ZENN_USERNAME=your_zenn_id
+```
+
+#### 4. OpenAI API（クラウド）
+
+```env
+EMBEDDING_PROVIDER=openai
+API_KEY=sk-...
+EMBEDDING_MODEL=text-embedding-3-small
+
+ZENN_USERNAME=your_zenn_id
+```
+
+---
+
+## コマンド一覧
+
+### 1. インデックス同期（差分更新・自動同期）
+
+```bash
+# 変更・新規コンテンツのみ差分同期
+npx zenn-rag index
+
+# ファイルを監視し、保存時に自動で差分同期（ウォッチモード）
+npx zenn-rag index --watch
+
+# 全記事・本を強制再同期
+npx zenn-rag index --force
+
+# 対象ディレクトリを指定する場合
+npx zenn-rag index --dir /path/to/zenn-repo
+```
+
+### 2. 過去記事・本の検索（CLI）
+
+```bash
+# 基本検索
+npx zenn-rag search "Cloudflare Workers WASM"
+
+# 取得件数とトピック絞り込み
+npx zenn-rag search "App Router キャッシュ" --limit 3 --topic nextjs
+```
+
+### 3. 進捗・トピック統計の確認
+
+```bash
+npx zenn-rag status
+```
+
+### 4. MCPサーバー起動
+
+```bash
+npx zenn-rag mcp
+```
+
+---
+
+## MCP（AIエディタ連携）設定
+
+Antigravity、Claude Desktop、Cursor などのMCP設定ファイルに以下を追加します：
+
+```json
+{
+  "mcpServers": {
+    "zenn-rag": {
+      "command": "npx",
+      "args": ["-y", "zenn-rag", "mcp"],
+      "cwd": "/path/to/your/zenn-repo"
+    }
+  }
+}
+```
+
+### 提供ツール
+
+- **`search_articles`**: 自然言語でクエリに類似する過去記事・本チャプターのセクション・スコア・URLを検索
+- **`suggest_related_links`**: 執筆中の文章やメモから、引用・内部リンクすべき関連記事や本をMarkdownリンク形式で推薦
+- **`get_article`**: スラッグを指定して記事・チャプター全体の構成や内容を取得
+- **`list_topics`**: 蓄積されたコンテンツの全トピックと件数を集計
+- **`sync_index`**: AIエディタ内から直接インデックスの差分更新を実行
+
+---
+
+## ライブラリとしての利用
+
+```typescript
+import {
+  searchArticles,
+  syncIndex,
+  ArticleVectorStore,
+  initContext,
+} from "zenn-rag";
+
+// コンテキストの初期化
+initContext("/path/to/zenn-repo");
+
+// 検索実行
+const results = await searchArticles("React Server Actions", { limit: 3 });
+console.log(results);
+```
+
+---
+
+## 開発
+
+```bash
+# 依存パッケージのインストール
+pnpm install
+
+# ビルド（TypeScript 公式コンパイラ tsc で dist/ に出力）
+pnpm run build
+
+# テスト実行
+pnpm test
+
+# ウォッチモード（ビルド / テスト）
+pnpm run dev
+pnpm run test:watch
+```
+
+---
+
+## ライセンス
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { initContext } from "./config.js";
+import { syncIndex } from "./commands/index.js";
+import { searchCli } from "./commands/search.js";
+import { showStatus } from "./commands/status.js";
+import { runMcpServer } from "./commands/mcp.js";
+import { getLogger } from "./logger.js";
+const program = new Command();
+const logger = getLogger();
+function handleCliAction(action) {
+    return async () => {
+        try {
+            await action();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.error(`\n[エラー発生]: ${message}`);
+            process.exit(1);
+        }
+    };
+}
+program
+    .name("zenn-rag")
+    .description("Zenn articles Vector DB & RAG toolkit with MCP server")
+    .version("0.1.0");
+// 1. index
+program
+    .command("index")
+    .description("Zenn記事をベクトル化してVector DBに同期します（差分更新対応）")
+    .option("-f, --force", "既存のインデックスを破棄して全件再同期する")
+    .option("-w, --watch", "ファイルを監視して変更時に自動で差分同期する")
+    .option("-d, --dir <path>", "Zennプロジェクトのルートディレクトリ（デフォルト: カレントディレクトリ）")
+    .action((options) => handleCliAction(async () => {
+    initContext(options.dir);
+    await syncIndex({ force: options.force, watch: options.watch });
+})());
+// 2. search
+program
+    .command("search <query>")
+    .description("過去記事から類似セクションをベクトル検索します")
+    .option("-l, --limit <number>", "取得件数", (val) => parseInt(val, 10), 5)
+    .option("-t, --topic <topic>", "特定のトピック（タグ）で絞り込み")
+    .option("-d, --dir <path>", "Zennプロジェクトのルートディレクトリ")
+    .action((query, options) => handleCliAction(async () => {
+    initContext(options.dir);
+    await searchCli(query, { limit: options.limit, topic: options.topic });
+})());
+// 3. status
+program
+    .command("status")
+    .description("現在のインデックス状況や登録済みトピック統計を表示します")
+    .option("-d, --dir <path>", "Zennプロジェクトのルートディレクトリ")
+    .action((options) => handleCliAction(async () => {
+    initContext(options.dir);
+    await showStatus();
+})());
+// 4. mcp
+program
+    .command("mcp")
+    .description("Model Context Protocol (MCP) サーバーを起動します（Stdio通信）")
+    .option("-d, --dir <path>", "Zennプロジェクトのルートディレクトリ")
+    .action((options) => handleCliAction(async () => {
+    initContext(options.dir);
+    await runMcpServer();
+})());
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,6 @@
+import { type SyncOptions } from "../services/sync-service.js";
+export interface CliSyncOptions extends SyncOptions {
+    watch?: boolean;
+}
+export declare function syncIndex(options?: CliSyncOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE5E,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}

package/dist/commands/index.js

@@ -0,0 +1,11 @@
+import { SyncService } from "../services/sync-service.js";
+export async function syncIndex(options = {}) {
+    const service = new SyncService(options.logger);
+    if (options.watch) {
+        await service.watch(options);
+    }
+    else {
+        await service.sync(options);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,6BAA6B,CAAC;AAM5E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAO,GAAmB,EAAE;IAC1D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,2 @@
+export declare function runMcpServer(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAOA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAuRlD"}

package/dist/commands/mcp.js

@@ -0,0 +1,245 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getEmbedding } from "../embedder.js";
+import { McpLogger, setLogger } from "../logger.js";
+import { ArticleVectorStore } from "../store.js";
+export async function runMcpServer() {
+    setLogger(new McpLogger());
+    const server = new McpServer({
+        name: "zenn-rag",
+        version: "0.1.0",
+    });
+    const store = new ArticleVectorStore();
+    // 1. 過去記事の類似セクション検索ツール
+    server.tool("search_articles", "Zennの過去記事からクエリに関連するセクションをベクトル検索します。新しい記事の執筆時に、過去の知見やコード例、関連記事のURLを探すために使用します。", {
+        query: z
+            .string()
+            .describe("検索したい内容（例: 'Next.js App RouterのServer Actions実装例', 'Cloudflare Workers WASM'）"),
+        limit: z
+            .number()
+            .optional()
+            .default(5)
+            .describe("取得件数（デフォルト: 5）"),
+        topic: z
+            .string()
+            .optional()
+            .describe("トピック名による絞り込み（例: 'nextjs', 'cloudflare'）"),
+    }, async ({ query, limit, topic }) => {
+        try {
+            const queryVector = await getEmbedding(query);
+            const results = await store.search(queryVector, { limit, topic });
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "関連する記事は見つかりませんでした。まだインデックスを作成していない場合は `zenn-rag index` を実行してください。",
+                        },
+                    ],
+                };
+            }
+            const formatted = results
+                .map((r, i) => {
+                const score = (r.score * 100).toFixed(1);
+                return [
+                    `### [${i + 1}] ${r.title} (類似度: ${score}%)`,
+                    `- **見出し**: ${r.heading}`,
+                    `- **URL**: ${r.url}`,
+                    `- **トピック**: ${r.topics.join(", ") || "なし"}`,
+                    "",
+                    "```markdown",
+                    r.text,
+                    "```",
+                ].join("\n");
+            })
+                .join("\n\n---\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# 過去記事の検索結果 (クエリ: "${query}")\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    { type: "text", text: `検索中にエラーが発生しました: ${msg}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 2. 指定スラッグの記事セクション一覧取得ツール
+    server.tool("get_article", "指定したスラッグ（ファイル名）の記事の全セクションと内容を取得します。", {
+        slug: z.string().describe("記事のスラッグ（例: 'cloudflare-scale-up'）"),
+    }, async ({ slug }) => {
+        try {
+            const chunks = await store.getArticleChunks(slug);
+            if (chunks.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `記事 '${slug}' のデータが見つかりませんでした。`,
+                        },
+                    ],
+                };
+            }
+            const title = chunks[0].title;
+            const url = chunks[0].url;
+            const topics = chunks[0].topics.join(", ");
+            const body = chunks
+                .map((c) => `## ${c.heading}\n\n${c.text}`)
+                .join("\n\n---\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# ${title}\n- URL: ${url}\n- トピック: ${topics}\n\n${body}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `記事の取得中にエラーが発生しました: ${msg}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 3. 登録済みトピック一覧取得ツール
+    server.tool("list_topics", "蓄積されている過去記事の全トピック（タグ）と各トピックの記事数を取得します。", {}, async () => {
+        try {
+            const topicCounts = await store.getAllTopics();
+            const sorted = Object.entries(topicCounts).sort((a, b) => b[1] - a[1]);
+            if (sorted.length === 0) {
+                return {
+                    content: [
+                        { type: "text", text: "登録されているトピックがありません。" },
+                    ],
+                };
+            }
+            const list = sorted
+                .map(([topic, count]) => `- **${topic}**: ${count} 記事`)
+                .join("\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# 過去記事のトピック一覧 (全 ${sorted.length} 種類)\n\n${list}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `トピック取得中にエラーが発生しました: ${msg}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 4. 執筆支援: 関連記事・本の推薦リンク生成ツール
+    server.tool("suggest_related_links", "執筆中の記事テキストや構想メモから、関連記事や本チャプターを推薦し、Markdownリンク形式で提示します。記事の内部リンクや引用の作成に便利です。", {
+        text: z.string().describe("執筆中の文章、段落、または構想メモ"),
+        limit: z
+            .number()
+            .optional()
+            .default(3)
+            .describe("提案するリンクの最大件数（デフォルト: 3）"),
+    }, async ({ text, limit }) => {
+        try {
+            const queryVector = await getEmbedding(text);
+            const results = await store.search(queryVector, { limit });
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "関連する過去記事または本が見つかりませんでした。",
+                        },
+                    ],
+                };
+            }
+            const links = results
+                .map((r) => {
+                const score = (r.score * 100).toFixed(1);
+                const excerpt = r.text.slice(0, 120).replace(/\n+/g, " ");
+                return `- [${r.title} - ${r.heading}](${r.url}) (類似度: ${score}%)\n  > 関連箇所: ${excerpt}...`;
+            })
+                .join("\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `### 執筆支援: 推薦リンク一覧\n\n${links}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `リンク提案中にエラーが発生しました: ${msg}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // 5. インデックス同期実行ツール
+    server.tool("sync_index", "Zenn記事および本のインデックスを差分同期（再ベクトル化）します。執筆直後の記事を即座にAIエディタの検索対象に反映させるために使用します。", {
+        force: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("trueを指定すると全件強制再同期"),
+    }, async ({ force }) => {
+        try {
+            const { SyncService } = await import("../services/sync-service.js");
+            const syncService = new SyncService(new McpLogger());
+            const result = await syncService.sync({ force });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `インデックス同期が正常に完了しました。\n- 全体ファイル数: ${result.totalFiles}\n- 更新ファイル数: ${result.processedArticles}\n- 総チャンク数: ${result.totalChunks}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `インデックス同期中にエラーが発生しました: ${msg}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/search.d.ts

@@ -0,0 +1,10 @@
+import type { SearchResult } from "../types.js";
+export declare function searchArticles(query: string, options?: {
+    limit?: number;
+    topic?: string;
+}): Promise<SearchResult[]>;
+export declare function searchCli(query: string, options?: {
+    limit?: number;
+    topic?: string;
+}): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,OAAO,CAAC,IAAI,CAAC,CAqCf"}