@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.1

package/dist/plugins/drive/ooxml.d.ts

@@ -0,0 +1,17 @@
+/** Read the named entries (exact names) as UTF-8 text. Missing names are left out. */
+export declare function readZipTexts(buf: Buffer, wanted: (name: string) => boolean): Map<string, string>;
+export declare function decodeXml(s: string): string;
+/**
+ * Paragraph texts of one XML part. `ns` is the text namespace prefix: "w" for Word, "a" for DrawingML.
+ * Inside a paragraph: <ns:t> text, <ns:tab/> → tab, <ns:br/> and <w:cr/> → newline. Empty paragraphs are kept
+ * as "" so callers can decide how to join them.
+ */
+export declare function paragraphs(xml: string, ns: 'w' | 'a'): string[];
+/** .docx → plain text, paragraphs separated by a blank line. */
+export declare function docxText(buf: Buffer): string;
+/**
+ * .pptx → "## Slide N" sections: the slide's text, then text of SmartArt diagrams and charts on that slide,
+ * then speaker notes. Diagrams, charts and notes are found through the slide's relationship file
+ * (ppt/slides/_rels/slideN.xml.rels), so they stay with the right slide even when numbering differs.
+ */
+export declare function pptxText(buf: Buffer): string;

package/dist/plugins/drive/ooxml.js

@@ -0,0 +1,152 @@
+/**
+ * Word(.docx), PowerPoint(.pptx) 본문 텍스트 추출 — 의존성 없이 zip 과 XML 만 읽는다.
+ *
+ * 왜 직접: 예전엔 docx 는 mammoth, pptx 는 officeparser 를 썼다. mammoth 최신판도 argparse → sprintf-js
+ * (보안 권고)를, officeparser 7 은 취약한 pdfjs-dist 를, 8 은 OCR 엔진(tesseract.js)까지 끌어와 설치마다
+ * 경고가 났다. 색인에 필요한 건 본문 텍스트뿐이라 zip 목록과 XML 의 글자 노드만 읽으면 된다.
+ *
+ *   docx: word/document.xml 의 문단(<w:p>)마다 글자(<w:t>), 탭, 줄바꿈 → 문단 사이 빈 줄 (mammoth extractRawText 와 같은 모양)
+ *   pptx: ppt/slides/slideN.xml 을 번호 순으로, 문단(<a:p>)마다 글자(<a:t>). 그 슬라이드의 SmartArt, 차트 글자와
+ *         발표자 노트를 관계 파일(_rels)로 찾아 뒤에 붙인다
+ *
+ * 압축 폭탄 방어: 항목 하나 MAX_ENTRY_BYTES, 합계 MAX_TOTAL_BYTES 를 넘으면 멈춘다.
+ */
+import { inflateRawSync } from 'node:zlib';
+const MAX_ENTRY_BYTES = 64 * 1024 * 1024;
+const MAX_TOTAL_BYTES = 256 * 1024 * 1024;
+/** Central directory 목록. ZIP64 는 Office 문서에 쓰이지 않아(4GB 미만) 다루지 않는다. */
+function listEntries(buf) {
+    // End of central directory: 0x06054b50, 파일 끝에서 최대 64KB(주석) + 22바이트 안에 있다.
+    const min = Math.max(0, buf.length - 65_557);
+    let eocd = -1;
+    for (let i = buf.length - 22; i >= min; i--) {
+        if (buf.readUInt32LE(i) === 0x06054b50) {
+            eocd = i;
+            break;
+        }
+    }
+    if (eocd < 0)
+        throw new Error('not a zip file (no end of central directory)');
+    const count = buf.readUInt16LE(eocd + 10);
+    let p = buf.readUInt32LE(eocd + 16);
+    const out = [];
+    for (let n = 0; n < count; n++) {
+        if (p + 46 > buf.length || buf.readUInt32LE(p) !== 0x02014b50)
+            throw new Error('corrupt zip central directory');
+        const nameLen = buf.readUInt16LE(p + 28);
+        const extraLen = buf.readUInt16LE(p + 30);
+        const commentLen = buf.readUInt16LE(p + 32);
+        out.push({
+            method: buf.readUInt16LE(p + 10),
+            compressedSize: buf.readUInt32LE(p + 20),
+            size: buf.readUInt32LE(p + 24),
+            localOffset: buf.readUInt32LE(p + 42),
+            name: buf.toString('utf8', p + 46, p + 46 + nameLen),
+        });
+        p += 46 + nameLen + extraLen + commentLen;
+    }
+    return out;
+}
+function readEntry(buf, e) {
+    const p = e.localOffset;
+    if (p + 30 > buf.length || buf.readUInt32LE(p) !== 0x04034b50)
+        throw new Error(`corrupt zip entry ${e.name}`);
+    const start = p + 30 + buf.readUInt16LE(p + 26) + buf.readUInt16LE(p + 28);
+    const data = buf.subarray(start, start + e.compressedSize);
+    if (e.size > MAX_ENTRY_BYTES)
+        throw new Error(`zip entry too large: ${e.name}`);
+    if (e.method === 0)
+        return data;
+    if (e.method === 8)
+        return inflateRawSync(data, { maxOutputLength: MAX_ENTRY_BYTES });
+    throw new Error(`unsupported zip compression ${e.method} in ${e.name}`);
+}
+/** Read the named entries (exact names) as UTF-8 text. Missing names are left out. */
+export function readZipTexts(buf, wanted) {
+    const out = new Map();
+    let total = 0;
+    for (const e of listEntries(buf)) {
+        if (!wanted(e.name))
+            continue;
+        const data = readEntry(buf, e);
+        total += data.length;
+        if (total > MAX_TOTAL_BYTES)
+            throw new Error('zip content too large');
+        out.set(e.name, data.toString('utf8'));
+    }
+    return out;
+}
+const ENTITIES = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'" };
+export function decodeXml(s) {
+    return s.replace(/&(#x[0-9a-fA-F]+|#\d+|[a-z]+);/g, (m, ent) => {
+        if (ent[0] === '#') {
+            const code = ent[1] === 'x' ? parseInt(ent.slice(2), 16) : parseInt(ent.slice(1), 10);
+            return Number.isFinite(code) && code <= 0x10ffff ? String.fromCodePoint(code) : m;
+        }
+        return ENTITIES[ent] ?? m;
+    });
+}
+/**
+ * Paragraph texts of one XML part. `ns` is the text namespace prefix: "w" for Word, "a" for DrawingML.
+ * Inside a paragraph: <ns:t> text, <ns:tab/> → tab, <ns:br/> and <w:cr/> → newline. Empty paragraphs are kept
+ * as "" so callers can decide how to join them.
+ */
+export function paragraphs(xml, ns) {
+    const out = [];
+    const paraRe = new RegExp(`<${ns}:p[\\s>][\\s\\S]*?</${ns}:p>|<${ns}:p/>`, 'g');
+    const tokenRe = new RegExp(`<${ns}:t(?:\\s[^>]*)?>([\\s\\S]*?)</${ns}:t>|<${ns}:t(?:\\s[^>]*)?/>|<${ns}:tab/>|<${ns}:br(?:\\s[^>]*)?/?>|<w:cr/>`, 'g');
+    for (const para of xml.match(paraRe) ?? []) {
+        let text = '';
+        for (const m of para.matchAll(tokenRe)) {
+            if (m[1] !== undefined)
+                text += decodeXml(m[1]);
+            else if (m[0].startsWith(`<${ns}:tab`))
+                text += '\t';
+            else if (m[0].startsWith(`<${ns}:br`) || m[0] === '<w:cr/>')
+                text += '\n';
+        }
+        out.push(text);
+    }
+    return out;
+}
+/** .docx → plain text, paragraphs separated by a blank line. */
+export function docxText(buf) {
+    const xml = readZipTexts(buf, (n) => n === 'word/document.xml').get('word/document.xml');
+    if (xml === undefined)
+        throw new Error('word/document.xml not found (not a .docx?)');
+    return paragraphs(xml, 'w')
+        .filter((p) => p.trim())
+        .join('\n\n');
+}
+const slideNo = (name) => Number(/(\d+)\.xml$/.exec(name)?.[1] ?? 0);
+/** Non-empty paragraph lines of one DrawingML part. */
+const lines = (xml) => (xml ? paragraphs(xml, 'a').filter((p) => p.trim()) : []);
+/**
+ * .pptx → "## Slide N" sections: the slide's text, then text of SmartArt diagrams and charts on that slide,
+ * then speaker notes. Diagrams, charts and notes are found through the slide's relationship file
+ * (ppt/slides/_rels/slideN.xml.rels), so they stay with the right slide even when numbering differs.
+ */
+export function pptxText(buf) {
+    const parts = readZipTexts(buf, (n) => /^ppt\/(slides\/slide\d+\.xml|slides\/_rels\/slide\d+\.xml\.rels|notesSlides\/notesSlide\d+\.xml|diagrams\/data\d+\.xml|charts\/chart\d+\.xml)$/.test(n));
+    const slides = [...parts.keys()].filter((n) => /^ppt\/slides\/slide\d+\.xml$/.test(n)).sort((a, b) => slideNo(a) - slideNo(b));
+    if (!slides.length)
+        throw new Error('no slides found (not a .pptx?)');
+    return slides
+        .map((name) => {
+        const n = slideNo(name);
+        const rels = parts.get(`ppt/slides/_rels/slide${n}.xml.rels`) ?? '';
+        const targets = [...rels.matchAll(/Target="\.\.\/((?:diagrams\/data|charts\/chart|notesSlides\/notesSlide)\d+\.xml)"/g)].map((m) => `ppt/${m[1]}`);
+        const notesPart = targets.find((t) => t.includes('notesSlides/')) ?? `ppt/notesSlides/notesSlide${n}.xml`;
+        const body = [
+            ...lines(parts.get(name)),
+            ...targets.filter((t) => !t.includes('notesSlides/')).flatMap((t) => lines(parts.get(t))),
+        ].join('\n');
+        // 노트 틀의 슬라이드 번호 자리(숫자만 있는 문단)는 뺀다
+        const notes = lines(parts.get(notesPart))
+            .filter((p) => !/^\d+$/.test(p.trim()))
+            .join('\n');
+        return [`## Slide ${n}`, body, notes ? `Notes:\n${notes}` : ''].filter(Boolean).join('\n\n');
+    })
+        .join('\n\n');
+}
+//# sourceMappingURL=ooxml.js.map

package/dist/plugins/drive/ooxml.js.map

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

package/dist/plugins/drive/path.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Drive 파일의 부모 체인 분류 — search_drive 가 민감/제외 폴더를 응답에서 거르는 데 사용.
+ *
+ * 왜: semantic 색인은 `06_증빙_PII`·`02_계약_법무`·`07_채용_HR`·deprecated 를 제외(exclude.ts)하지만,
+ * search_drive 는 Drive API 를 직접 때려 service account 가 공유받은 전체를 노출했다 → 계약·PII·HR 유출 위험.
+ * 이 모듈로 검색 결과를 "dev/biz root 하위 + 제외 폴더 미경유"로 한정한다.
+ *
+ * 성능: 폴더 메타(id→name,parent)는 거의 변하지 않으므로 프로세스 캐시 → 부모 walk 가 warmup 후 캐시 hit.
+ */
+import type { DriveClient } from './client.js';
+export declare function getFolderMeta(drive: DriveClient, id: string): Promise<{
+    name: string;
+    parent: string | undefined;
+}>;
+export type SearchClass = 'ok' | 'excluded' | 'outside';
+/**
+ * 파일의 immediate parents 에서 root 까지 올라가며 분류:
+ *   - 'excluded' : 제외 폴더(PII/계약/HR/deprecated/node_modules 등)를 경유 → 응답에서 제거
+ *   - 'ok'       : dev/biz root 하위 + 제외 미경유 → 노출
+ *   - 'outside'  : root 에 닿지 못함(색인 대상 밖) → 보수적으로 제거
+ * resolvePathAndSource(drive_sync) 와 동일하게 parents[0] 만 따라간다(최대 12 hop).
+ */
+export declare function classifyForSearch(drive: DriveClient, parents: string[] | undefined): Promise<SearchClass>;
+/**
+ * classifyForSearch + 폴더 경로(root 하위) 반환 — 직원별 Drive 폴더 scope 필터용.
+ * path 는 폴더만(파일명 제외), root 바로 아래부터, 예: "01_고객사/Acme". cls!=='ok' 면 path 무의미.
+ */
+export declare function classifyAndPath(drive: DriveClient, parents: string[] | undefined): Promise<{
+    cls: SearchClass;
+    path: string;
+}>;
+/**
+ * 폴더 자신을 분류 — list_drive_folder 의 시작 폴더 검사용.
+ * root 폴더면 'ok'(path ''), 그 밖에는 자기 이름이 제외 대상인지 본 뒤 부모 체인을 classifyAndPath 로 분류한다.
+ * path 는 root 바로 아래부터 이 폴더까지(자기 이름 포함). 예: root/01_고객사/Acme → "01_고객사/Acme".
+ */
+export declare function classifyFolder(drive: DriveClient, folderId: string): Promise<{
+    cls: SearchClass;
+    path: string;
+}>;

package/dist/plugins/drive/path.js

@@ -0,0 +1,87 @@
+import { DRIVE_ROOTS } from './settings.js';
+import { isExcludedName } from './exclude.js';
+const ROOT_IDS = new Set(DRIVE_ROOTS.map((r) => r.id));
+// 폴더 메타 캐시 (id → {name, parent}). TTL 부여 — 영구 캐시면 폴더를 민감 분류(`06_증빙_PII` 등)로
+// rename 하거나 제외 폴더로 move 해도 옛 이름으로 분류돼 새로 민감해진 폴더가 재배포 전까지
+// 노출(under-exclude)된다. 짧은 TTL(기본 10분)로 분류 변경을 반영. rename/move 는 드물어 캐시 효과는 유지.
+const FOLDER_META_TTL_MS = Number(process.env.FOLDER_META_TTL_MS ?? 600_000);
+const _folderMeta = new Map();
+export async function getFolderMeta(drive, id) {
+    const now = Date.now();
+    const cached = _folderMeta.get(id);
+    if (cached && cached.expiresAt > now)
+        return { name: cached.name, parent: cached.parent };
+    try {
+        const d = (await drive.files.get({ fileId: id, fields: 'name,parents', supportsAllDrives: true }))
+            .data;
+        const meta = { name: d.name ?? '', parent: d.parents?.[0], expiresAt: now + FOLDER_META_TTL_MS };
+        _folderMeta.set(id, meta);
+        return { name: meta.name, parent: meta.parent };
+    }
+    catch {
+        return { name: '', parent: undefined };
+    }
+}
+/**
+ * 파일의 immediate parents 에서 root 까지 올라가며 분류:
+ *   - 'excluded' : 제외 폴더(PII/계약/HR/deprecated/node_modules 등)를 경유 → 응답에서 제거
+ *   - 'ok'       : dev/biz root 하위 + 제외 미경유 → 노출
+ *   - 'outside'  : root 에 닿지 못함(색인 대상 밖) → 보수적으로 제거
+ * resolvePathAndSource(drive_sync) 와 동일하게 parents[0] 만 따라간다(최대 12 hop).
+ */
+export async function classifyForSearch(drive, parents) {
+    let chain = parents;
+    for (let hop = 0; hop < 12 && chain && chain.length > 0; hop++) {
+        const pid = chain[0];
+        if (ROOT_IDS.has(pid))
+            return 'ok';
+        const meta = await getFolderMeta(drive, pid);
+        if (isExcludedName(meta.name))
+            return 'excluded';
+        chain = meta.parent ? [meta.parent] : undefined;
+    }
+    return 'outside';
+}
+/**
+ * classifyForSearch + 폴더 경로(root 하위) 반환 — 직원별 Drive 폴더 scope 필터용.
+ * path 는 폴더만(파일명 제외), root 바로 아래부터, 예: "01_고객사/Acme". cls!=='ok' 면 path 무의미.
+ */
+export async function classifyAndPath(drive, parents) {
+    const names = [];
+    let chain = parents;
+    for (let hop = 0; hop < 12 && chain && chain.length > 0; hop++) {
+        const pid = chain[0];
+        if (ROOT_IDS.has(pid))
+            return { cls: 'ok', path: names.reverse().join('/') };
+        const meta = await getFolderMeta(drive, pid);
+        if (isExcludedName(meta.name))
+            return { cls: 'excluded', path: '' };
+        if (meta.name)
+            names.push(meta.name);
+        chain = meta.parent ? [meta.parent] : undefined;
+    }
+    return { cls: 'outside', path: '' };
+}
+/**
+ * 폴더 자신을 분류 — list_drive_folder 의 시작 폴더 검사용.
+ * root 폴더면 'ok'(path ''), 그 밖에는 자기 이름이 제외 대상인지 본 뒤 부모 체인을 classifyAndPath 로 분류한다.
+ * path 는 root 바로 아래부터 이 폴더까지(자기 이름 포함). 예: root/01_고객사/Acme → "01_고객사/Acme".
+ */
+export async function classifyFolder(drive, folderId) {
+    if (ROOT_IDS.has(folderId))
+        return { cls: 'ok', path: '' };
+    let d;
+    try {
+        d = (await drive.files.get({ fileId: folderId, fields: 'name,parents', supportsAllDrives: true })).data;
+    }
+    catch {
+        return { cls: 'outside', path: '' };
+    }
+    if (isExcludedName(d.name))
+        return { cls: 'excluded', path: '' };
+    const parent = await classifyAndPath(drive, d.parents ?? undefined);
+    if (parent.cls !== 'ok')
+        return { cls: parent.cls, path: '' };
+    return { cls: 'ok', path: parent.path ? `${parent.path}/${d.name ?? ''}` : d.name ?? '' };
+}
+//# sourceMappingURL=path.js.map

package/dist/plugins/drive/path.js.map

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

package/dist/plugins/drive/qdrant.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Qdrant REST client + collection 관리.
+ *
+ * Collection: config.qdrant.collection (default knowledge_v1), or env QDRANT_COLLECTION.
+ * Vector size: 1536 (text-embedding-3-small)
+ * Distance: Cosine
+ *
+ * @qdrant/js-client-rest 대신 Node 내장 fetch 로 REST API 를 부른다. 그 라이브러리는 최신판(1.19)도 취약한
+ * undici 7.29 를 고정 의존성으로 끌어와, 이 패키지를 설치하는 모든 사람에게 npm audit 경고를 남겼다.
+ * 쓰는 엔드포인트가 9개뿐이라 직접 부르는 편이 가볍다. 메서드 이름과 반환 모양은 그 라이브러리와 같게 뒀다.
+ */
+import { EMBEDDING_DIM } from './embeddings.js';
+export type PointId = string | number;
+export type QdrantFilter = {
+    must?: unknown[];
+    should?: unknown[];
+    must_not?: unknown[];
+};
+export interface QdrantPoint {
+    id: PointId;
+    vector?: number[];
+    payload?: Record<string, unknown> | null;
+}
+export interface ScoredPoint extends QdrantPoint {
+    score: number;
+    version?: number;
+}
+export declare class QdrantError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare class QdrantClient {
+    private readonly apiKey?;
+    private readonly base;
+    constructor(url: string, apiKey?: string | undefined);
+    private call;
+    private col;
+    getCollections(): Promise<{
+        collections: Array<{
+            name: string;
+        }>;
+    }>;
+    createCollection(name: string, body: Record<string, unknown>): Promise<boolean>;
+    deleteCollection(name: string): Promise<boolean>;
+    createPayloadIndex(name: string, body: {
+        field_name: string;
+        field_schema: string;
+        wait?: boolean;
+    }): Promise<unknown>;
+    upsert(name: string, body: {
+        points: QdrantPoint[];
+        wait?: boolean;
+    }): Promise<unknown>;
+    /** Delete by point ids or by filter. Waits by default, like the official client. */
+    delete(name: string, body: {
+        points?: PointId[];
+        filter?: QdrantFilter;
+        wait?: boolean;
+    }): Promise<unknown>;
+    retrieve(name: string, body: {
+        ids: PointId[];
+        with_payload?: boolean | string[];
+        with_vector?: boolean;
+    }): Promise<QdrantPoint[]>;
+    scroll(name: string, body: {
+        filter?: QdrantFilter;
+        limit?: number;
+        offset?: PointId;
+        with_payload?: boolean | string[];
+        with_vector?: boolean;
+    }): Promise<{
+        points: QdrantPoint[];
+        next_page_offset?: PointId | null;
+    }>;
+    search(name: string, body: {
+        vector: number[];
+        limit: number;
+        filter?: QdrantFilter;
+        with_payload?: boolean | string[];
+        score_threshold?: number;
+    }): Promise<ScoredPoint[]>;
+}
+export declare const DRIVE_COLLECTION: string;
+export { EMBEDDING_DIM };
+/** Qdrant 클라이언트(프로세스당 하나). */
+export declare function getQdrantClient(): Promise<QdrantClient>;
+/**
+ * Collection 이 없으면 생성. Idempotent.
+ * Payload field 중 자주 filter 하는 것은 indexed payload 로 등록.
+ */
+export declare function ensureCollection(): Promise<void>;
+export type ChunkPayload = {
+    chunk_id: string;
+    file_id: string;
+    file_name: string;
+    file_path: string;
+    heading: string;
+    chunk_index: number;
+    chunk_count: number;
+    content: string;
+    modified_time: string;
+    content_hash: string;
+    file_type: 'dev_log' | 'decision' | 'rule' | 'template' | 'biz' | 'other';
+    cluster: string | null;
+    source: 'dev' | 'biz';
+    image_urls: string[];
+    has_image: boolean;
+    table_count: number;
+    has_code_block: boolean;
+    doc_status: string | null;
+    doc_tier: string | null;
+    doc_date: string | null;
+    doc_authors: string[];
+    doc_related: string[];
+    doc_tags: string[];
+    doc_source_refs: string[];
+    doc_affects: string[];
+    doc_products: string[];
+    doc_type: string | null;
+    doc_confidence: string | null;
+    doc_category: string | null;
+    doc_customer: string | null;
+};

package/dist/plugins/drive/qdrant.js

@@ -0,0 +1,148 @@
+/**
+ * Qdrant REST client + collection 관리.
+ *
+ * Collection: config.qdrant.collection (default knowledge_v1), or env QDRANT_COLLECTION.
+ * Vector size: 1536 (text-embedding-3-small)
+ * Distance: Cosine
+ *
+ * @qdrant/js-client-rest 대신 Node 내장 fetch 로 REST API 를 부른다. 그 라이브러리는 최신판(1.19)도 취약한
+ * undici 7.29 를 고정 의존성으로 끌어와, 이 패키지를 설치하는 모든 사람에게 npm audit 경고를 남겼다.
+ * 쓰는 엔드포인트가 9개뿐이라 직접 부르는 편이 가볍다. 메서드 이름과 반환 모양은 그 라이브러리와 같게 뒀다.
+ */
+import { EMBEDDING_DIM } from './embeddings.js';
+import { getConfig } from '../../core/config.js';
+const QDRANT_TIMEOUT_MS = 10_000; // 짧은 timeout 으로 cold-start hang 회피
+export class QdrantError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'QdrantError';
+    }
+}
+export class QdrantClient {
+    apiKey;
+    base;
+    constructor(url, apiKey) {
+        this.apiKey = apiKey;
+        this.base = url.replace(/\/+$/, '');
+    }
+    async call(method, path, body) {
+        const headers = { Accept: 'application/json' };
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        if (this.apiKey)
+            headers['api-key'] = this.apiKey;
+        let res;
+        try {
+            res = await fetch(`${this.base}${path}`, {
+                method,
+                headers,
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal: AbortSignal.timeout(QDRANT_TIMEOUT_MS),
+            });
+        }
+        catch (e) {
+            const reason = e instanceof Error && e.name === 'TimeoutError' ? `timeout ${QDRANT_TIMEOUT_MS}ms` : String(e);
+            throw new QdrantError(`[qdrant] ${method} ${path} failed: ${reason}`, 0);
+        }
+        const text = await res.text();
+        let json = null;
+        try {
+            json = text ? JSON.parse(text) : null;
+        }
+        catch {
+            /* non-JSON error page */
+        }
+        if (!res.ok) {
+            const detail = json?.status?.error ?? text.slice(0, 200);
+            throw new QdrantError(`[qdrant] ${method} ${path} ${res.status}: ${detail}`, res.status);
+        }
+        return json?.result;
+    }
+    col(name) {
+        return `/collections/${encodeURIComponent(name)}`;
+    }
+    getCollections() {
+        return this.call('GET', '/collections');
+    }
+    createCollection(name, body) {
+        return this.call('PUT', this.col(name), body);
+    }
+    deleteCollection(name) {
+        return this.call('DELETE', this.col(name));
+    }
+    createPayloadIndex(name, body) {
+        const { wait = true, ...rest } = body;
+        return this.call('PUT', `${this.col(name)}/index?wait=${wait}`, rest);
+    }
+    upsert(name, body) {
+        const { wait = true, ...rest } = body;
+        return this.call('PUT', `${this.col(name)}/points?wait=${wait}`, rest);
+    }
+    /** Delete by point ids or by filter. Waits by default, like the official client. */
+    delete(name, body) {
+        const { wait = true, ...rest } = body;
+        return this.call('POST', `${this.col(name)}/points/delete?wait=${wait}`, rest);
+    }
+    retrieve(name, body) {
+        return this.call('POST', `${this.col(name)}/points`, body);
+    }
+    scroll(name, body) {
+        return this.call('POST', `${this.col(name)}/points/scroll`, body);
+    }
+    search(name, body) {
+        return this.call('POST', `${this.col(name)}/points/search`, body);
+    }
+}
+let _client = null;
+// Zero-downtime reindex: env QDRANT_COLLECTION overrides (index into a new collection, then swap the
+// env var -> 0 downtime; remove it to roll back). Falls back to config.qdrant.collection.
+export const DRIVE_COLLECTION = process.env.QDRANT_COLLECTION || getConfig().qdrant.collection;
+// 차원 SSOT = embeddings.ts (모델 출력 차원). collection size 가 임베딩 차원과 항상 일치하도록 재노출.
+export { EMBEDDING_DIM };
+/** Qdrant 클라이언트(프로세스당 하나). */
+export async function getQdrantClient() {
+    if (_client)
+        return _client;
+    const url = process.env.QDRANT_URL;
+    if (!url)
+        throw new Error('[qdrant] QDRANT_URL env missing');
+    _client = new QdrantClient(url, process.env.QDRANT_API_KEY || undefined);
+    return _client;
+}
+/**
+ * Collection 이 없으면 생성. Idempotent.
+ * Payload field 중 자주 filter 하는 것은 indexed payload 로 등록.
+ */
+export async function ensureCollection() {
+    const client = await getQdrantClient();
+    const collections = await client.getCollections();
+    const exists = collections.collections.some((c) => c.name === DRIVE_COLLECTION);
+    if (exists)
+        return;
+    await client.createCollection(DRIVE_COLLECTION, {
+        vectors: {
+            size: EMBEDDING_DIM,
+            distance: 'Cosine',
+        },
+        // HNSW 기본 (m=16, ef_construct=100) — 1만 vec 까지 충분
+        optimizers_config: {
+            default_segment_number: 2,
+        },
+    });
+    // 자주 filter 하는 payload field 에 index (검색 빠름)
+    for (const fieldName of [
+        'file_type', 'cluster', 'file_id', 'source',
+        // 이미지 유무 / frontmatter 메타 filter
+        'has_image', 'doc_status', 'doc_tier',
+        // 신규 — 태그·모드·경로 파생 filter (배열 doc_tags 는 원소 단위 keyword 매칭)
+        'doc_tags', 'doc_type', 'doc_category', 'doc_customer',
+    ]) {
+        await client.createPayloadIndex(DRIVE_COLLECTION, {
+            field_name: fieldName,
+            field_schema: fieldName === 'has_image' ? 'bool' : 'keyword',
+        });
+    }
+}
+//# sourceMappingURL=qdrant.js.map

package/dist/plugins/drive/qdrant.js.map

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

package/dist/plugins/drive/reindex.d.ts

@@ -0,0 +1,2 @@
+/** `knowledge-mcp drive reindex [--root ID | --dev-only | --biz-only] [--dry-run] [--recreate]` */
+export declare function runReindex(argv: string[]): Promise<void>;