@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.0

package/dist/plugins/drive/indexer.js

@@ -0,0 +1,204 @@
+import { createHash } from 'crypto';
+import { chunkMarkdown } from './chunker.js';
+import { embedTexts } from './embeddings.js';
+import { extractText } from './extract_text.js';
+import { getQdrantClient, DRIVE_COLLECTION } from './qdrant.js';
+import { DRIVE_ROOTS, MAX_FILE_BYTES } from './settings.js';
+export { DRIVE_ROOTS, MAX_FILE_BYTES };
+/** 추출 지원 mimeType (extract_text.ts 와 일치). 스캔 PDF/이미지는 Mathpix OCR. 풀 reindex·증분 sync 공용 SSOT. */
+export const SUPPORTED_MIMES = new Set([
+    'text/markdown',
+    'text/plain',
+    'application/vnd.google-apps.document',
+    'application/vnd.google-apps.spreadsheet',
+    'application/vnd.google-apps.presentation',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document', // .docx
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation', // .pptx
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', // .xlsx
+    'application/pdf',
+    'image/png',
+    'image/jpeg',
+    'image/jpg',
+    'image/webp',
+]);
+/** 점진적 chunk ID — file_id + index 면 항상 같은 ID (idempotent upsert). 색인 전 경로 공용. */
+export function makeChunkId(fileId, chunkIndex) {
+    const hash = createHash('md5').update(`${fileId}:${chunkIndex}`).digest();
+    return Number(hash.readBigUInt64BE(0) & 0x7fffffffffffffffn);
+}
+/** path + source -> file_type / cluster. cluster = top-level folder (generic). */
+export function classifyFile(path, source) {
+    const m = path.match(/^([^/]+)\//);
+    const topFolder = m ? m[1] : null;
+    return { type: source === 'biz' ? 'biz' : 'other', cluster: topFolder };
+}
+/**
+ * 청크의 임베딩 입력 텍스트 — heading breadcrumb(상위>하위 섹션 맥락)를 본문 앞에 붙인다.
+ * (contextual chunk header) 부모 heading 은 청크 본문에 없어(다른 섹션) 벡터가 섹션 맥락을 잃는데,
+ * 이를 임베딩에 포함하면 recall 이 오른다. 저장·표시용 content(payload)는 그대로 두고 임베딩 입력에만 적용.
+ * '문서 시작'(첫 heading 이전 placeholder)은 의미 없어 skip. ★증분(indexFile)·전체(reindex.ts) 공용 SSOT —
+ * 두 경로가 반드시 같은 입력을 임베딩해야 같은 청크가 같은 벡터를 가진다(벡터 공간 정합).
+ */
+export function embedInputForChunk(chunk) {
+    const h = chunk.heading?.trim();
+    if (!h || h === '문서 시작')
+        return chunk.content;
+    return `${h}\n\n${chunk.content}`;
+}
+/** 추출 텍스트 → sha256 (무변경 재색인 skip 판정용). */
+export function contentHash(text) {
+    return createHash('sha256').update(text).digest('hex');
+}
+// 폴더/파일명 앞 번호 prefix("01_", "06_", "0316_") 제거용.
+const NN_PREFIX = /^\d{1,4}[_-]/;
+/**
+ * biz 소스(PDF/docx — frontmatter 없음)의 경로/파일명에서 메타 파생.
+ * EXTRACTED — 사람이 폴더로 분류한 사실(LLM 추론 아님). dev 소스는 frontmatter 가 SSOT 라 빈 값.
+ *   doc_category : 최상위 폴더(NN_ 제거)  예) "01_고객사/…" → "고객사"
+ *   doc_customer : 01_고객사/{name}      예) "01_고객사/Acme/…" → "Acme"
+ *   path_tags    : 폴더 세그먼트(NN_ 제거) + 파일명 토큰 (검색 태그)
+ */
+export function deriveBizMeta(path, source) {
+    if (source !== 'biz')
+        return { doc_category: null, doc_customer: null, path_tags: [] };
+    const segs = path.split('/').filter(Boolean);
+    const folders = segs.slice(0, -1); // 마지막 = 파일명
+    const fileName = segs[segs.length - 1] ?? '';
+    const strip = (s) => s.replace(NN_PREFIX, '');
+    const category = folders[0] ? strip(folders[0]) : null;
+    const customer = folders[0] && folders[0].includes('고객사') && folders[1] ? folders[1] : null;
+    const folderTags = folders.map(strip);
+    const nameTokens = fileName
+        .replace(/\.[a-z0-9]+$/i, '') // 확장자 제거
+        .split(/[_\-\s]+/)
+        .map((t) => t.trim())
+        .filter((t) => t.length >= 2);
+    const path_tags = [...new Set([...folderTags, ...nameTokens])].filter(Boolean);
+    return { doc_category: category, doc_customer: customer, path_tags };
+}
+/**
+ * chunk + 파일/분류/경로 메타 → ChunkPayload. reindex(reindex.ts)·증분(indexFile) 공유 SSOT.
+ * dev 메타는 chunk(frontmatter 파싱)에, biz 메타는 bizMeta(경로 파싱)에 담겨 들어온다.
+ */
+export function buildChunkPayload(chunk, file, idx, chunkCount, classification, bizMeta, hash) {
+    const tags = [...new Set([...chunk.doc_tags, ...bizMeta.path_tags])];
+    return {
+        chunk_id: `${file.id}_${idx}`,
+        file_id: file.id,
+        file_name: file.name,
+        file_path: file.path,
+        heading: chunk.heading,
+        chunk_index: idx,
+        chunk_count: chunkCount,
+        content: chunk.content,
+        modified_time: file.modifiedTime,
+        content_hash: hash,
+        file_type: classification.type,
+        cluster: classification.cluster,
+        source: file.source,
+        image_urls: chunk.image_urls,
+        has_image: chunk.image_urls.length > 0,
+        table_count: chunk.table_count,
+        has_code_block: chunk.has_code_block,
+        doc_status: chunk.doc_status,
+        doc_tier: chunk.doc_tier,
+        doc_date: chunk.doc_date,
+        doc_authors: chunk.doc_authors,
+        doc_related: chunk.doc_related,
+        doc_source_refs: chunk.doc_source_refs,
+        doc_affects: chunk.doc_affects,
+        doc_products: chunk.doc_products,
+        doc_type: chunk.doc_type,
+        doc_confidence: chunk.doc_confidence,
+        doc_tags: tags,
+        doc_category: bizMeta.doc_category,
+        doc_customer: bizMeta.doc_customer,
+    };
+}
+/**
+ * 파일의 기존 색인 상태(청크0 payload) 조회 — content_hash·청크 수.
+ * 못 찾으면 null (미색인). 조회 실패 시 null 취급(안전 — 재색인 진행).
+ */
+async function getIndexedState(fileId) {
+    try {
+        const got = await (await getQdrantClient()).retrieve(DRIVE_COLLECTION, {
+            ids: [makeChunkId(fileId, 0)],
+            with_payload: true,
+            with_vector: false,
+        });
+        if (!got || got.length === 0)
+            return null;
+        const p = got[0].payload;
+        return {
+            content_hash: p?.content_hash ?? null,
+            chunk_count: typeof p?.chunk_count === 'number' ? p.chunk_count : 0,
+            file_path: String(p?.file_path ?? ''),
+            file_name: String(p?.file_name ?? ''),
+            source: String(p?.source ?? ''),
+        };
+    }
+    catch {
+        return null; // 조회 실패 = 미확인 → 재색인 진행(안전)
+    }
+}
+/**
+ * 파일 1개 형식별 추출 → chunk → embed → Qdrant upsert. 색인된 chunk 수 반환 (skip 시 0).
+ *
+ * - EFF-1: 추출 텍스트 sha256 이 기존 색인과 동일하면 embed/upsert 생략(무변경 skip).
+ * - B-1: 재색인 시 청크 수가 줄면 옛 청크(chunk_index >= 새 수)를 삭제해 유령 청크(폐기된 사실) 잔류 방지.
+ * - B-9: 증분 경로는 wait:true 로 색인 직후 검색 가시성 + 실패 인지.
+ */
+export async function indexFile(drive, file) {
+    if (file.size && file.size > MAX_FILE_BYTES) {
+        console.error(`[index] skip (too large: ${file.size}B > ${MAX_FILE_BYTES}B): ${file.path}`);
+        return 0;
+    }
+    const { text, needsOcr } = await extractText(drive, file.id, file.mimeType);
+    // needsOcr=true 는 이제 미지원 형식만 (PDF 스캔본·이미지는 extract_text 가 Mathpix 로 처리).
+    // 미지원 또는 추출 결과 빈 파일 → 색인 skip.
+    if (needsOcr || text.trim().length === 0)
+        return 0;
+    const hash = contentHash(text);
+    // EFF-1: 본문·경로·이름이 모두 그대로면 embed/upsert 생략 (sharing 등 메타 change 비용 차단).
+    // 옮기거나 이름만 바꾼 파일은 다시 색인한다 — payload 의 file_path 가 직원별 폴더 scope 판정 기준이라
+    // 옛 경로가 남으면 옮긴 뒤에도 옛 폴더 권한자에게 검색된다. 경로 태그(doc_tags)도 청크마다 다시 만든다.
+    const prev = await getIndexedState(file.id);
+    if (prev &&
+        prev.content_hash === hash &&
+        prev.file_path === file.path &&
+        prev.file_name === file.name &&
+        prev.source === file.source) {
+        return 0;
+    }
+    const chunks = chunkMarkdown(text);
+    if (chunks.length === 0)
+        return 0;
+    const classification = classifyFile(file.path, file.source);
+    const bizMeta = deriveBizMeta(file.path, file.source);
+    // heading breadcrumb 포함 임베딩(embedInputForChunk) — 저장 content 는 그대로, 임베딩 입력만 섹션 맥락 부여.
+    const vectors = await embedTexts(chunks.map(embedInputForChunk), 'RETRIEVAL_DOCUMENT');
+    const points = chunks.map((c, idx) => ({
+        id: makeChunkId(file.id, idx),
+        vector: vectors[idx],
+        payload: buildChunkPayload(c, file, idx, chunks.length, classification, bizMeta, hash),
+    }));
+    const client = await getQdrantClient();
+    // 새 청크 0..M-1 upsert (wait:true — 단일 파일이라 비용 작고, 직후 검색 가시성·실패 인지 확보)
+    await client.upsert(DRIVE_COLLECTION, { wait: true, points });
+    // B-1: 줄어든 경우 옛 청크(index >= M)를 결정적 chunk ID 로 직접 삭제.
+    //      (Qdrant range 필터는 비인덱싱 payload 에서 400 Bad Request → ID 삭제로 우회. upsert 와 disjoint 집합)
+    if (prev && prev.chunk_count > chunks.length) {
+        const orphanIds = [];
+        for (let i = chunks.length; i < prev.chunk_count; i++)
+            orphanIds.push(makeChunkId(file.id, i));
+        await client.delete(DRIVE_COLLECTION, { wait: true, points: orphanIds });
+    }
+    return chunks.length;
+}
+/** 특정 파일의 모든 chunk 를 Qdrant 에서 삭제 (파일 삭제·trashed 시). */
+export async function deleteFileVectors(fileId) {
+    await (await getQdrantClient()).delete(DRIVE_COLLECTION, {
+        filter: { must: [{ key: 'file_id', match: { value: fileId } }] },
+    });
+}
+//# sourceMappingURL=indexer.js.map

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

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

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

@@ -0,0 +1,4 @@
+/** PDF (스캔본) → markdown. async upload + poll + .md 다운로드. */
+export declare function mathpixPdfToMarkdown(buffer: Buffer, maxWaitSec?: number): Promise<string>;
+/** 단일 이미지 → markdown. v3/text (즉시). */
+export declare function mathpixImageToMarkdown(buffer: Buffer, mimeType: string): Promise<string>;

package/dist/plugins/drive/mathpix.js

@@ -0,0 +1,102 @@
+/**
+ * Mathpix OCR — 스캔 PDF / 이미지 → markdown.
+ *
+ * 키: MATHPIX_APP_ID / MATHPIX_APP_KEY.
+ *
+ * - PDF (스캔본): v3/pdf (async) — upload → poll → /pdf/{id}.md
+ * - 이미지: v3/text (즉시)
+ *
+ * 수식·표 구조 보존 (Mathpix Markdown) → chunk 시 표 안 깨짐 → 검색 품질 ↑.
+ */
+const MATHPIX_API = 'https://api.mathpix.com/v3';
+function mathpixHeaders() {
+    const appId = process.env.MATHPIX_APP_ID;
+    const appKey = process.env.MATHPIX_APP_KEY;
+    if (!appId || !appKey)
+        throw new Error('[mathpix] MATHPIX_APP_ID / MATHPIX_APP_KEY 미설정');
+    return { app_id: appId, app_key: appKey };
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * timeout·재시도 감싼 fetch. 예전엔 어떤 fetch 도 timeout·재시도가 없어, status 폴링이 네트워크
+ * 정체 시 deadline 까지 매달리고 일시 5xx 에 전체 OCR 이 실패했다. AbortSignal.timeout + 5xx/네트워크
+ * 짧은 재시도로 안정화(OCR 은 유저 대기 경로).
+ */
+async function mpFetch(url, init, timeoutMs = 30_000, retries = 2) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            const resp = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+            if (resp.status >= 500 && resp.status <= 599 && attempt < retries) {
+                await sleep(1000 * (attempt + 1));
+                continue;
+            }
+            return resp;
+        }
+        catch (e) {
+            // timeout(TimeoutError)·네트워크 오류 — 재시도, 소진 시 throw
+            if (attempt < retries) {
+                await sleep(1000 * (attempt + 1));
+                continue;
+            }
+            throw new Error(`[mathpix] fetch 실패(${url.split('/').slice(-1)[0]}): ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+}
+/** PDF (스캔본) → markdown. async upload + poll + .md 다운로드. */
+export async function mathpixPdfToMarkdown(buffer, maxWaitSec = 180) {
+    const headers = mathpixHeaders();
+    // 1. Upload
+    const form = new FormData();
+    form.append('file', new Blob([buffer], { type: 'application/pdf' }), 'doc.pdf');
+    form.append('options_json', JSON.stringify({
+        conversion_formats: { md: true },
+        math_inline_delimiters: ['$', '$'],
+        rm_spaces: false,
+        enable_tables_fallback: true,
+        include_diagram_text: true, // 다이어그램 내부 텍스트도 OCR (figure URL 은 .md 에 기본 포함)
+    }));
+    const upResp = await mpFetch(`${MATHPIX_API}/pdf`, { method: 'POST', headers, body: form }, 60_000);
+    if (!upResp.ok)
+        throw new Error(`[mathpix] upload 실패 HTTP ${upResp.status}: ${(await upResp.text()).slice(0, 200)}`);
+    const { pdf_id } = (await upResp.json());
+    if (!pdf_id)
+        throw new Error('[mathpix] pdf_id 없음');
+    // 2. Poll (2s 간격)
+    const deadline = Date.now() + maxWaitSec * 1000;
+    while (Date.now() < deadline) {
+        await sleep(2000);
+        const stResp = await mpFetch(`${MATHPIX_API}/pdf/${pdf_id}`, { headers });
+        const stData = (await stResp.json());
+        if (stData.status === 'completed') {
+            // 3. .md 다운로드
+            const mdResp = await mpFetch(`${MATHPIX_API}/pdf/${pdf_id}.md`, { headers });
+            const md = await mdResp.text();
+            if (!md.trim())
+                throw new Error('[mathpix] completed but empty markdown');
+            return md;
+        }
+        if (stData.status === 'error')
+            throw new Error('[mathpix] 처리 error');
+    }
+    throw new Error(`[mathpix] timeout ${maxWaitSec}s (pdf_id=${pdf_id})`);
+}
+/** 단일 이미지 → markdown. v3/text (즉시). */
+export async function mathpixImageToMarkdown(buffer, mimeType) {
+    const headers = { ...mathpixHeaders(), 'Content-Type': 'application/json' };
+    const b64 = buffer.toString('base64');
+    const resp = await mpFetch(`${MATHPIX_API}/text`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({
+            src: `data:${mimeType};base64,${b64}`,
+            formats: ['text', 'data'],
+            math_inline_delimiters: ['$', '$'],
+            rm_spaces: false,
+        }),
+    });
+    if (!resp.ok)
+        throw new Error(`[mathpix] image 실패 HTTP ${resp.status}`);
+    const data = (await resp.json());
+    return data.text ?? '';
+}
+//# sourceMappingURL=mathpix.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mathpix.js","sourceRoot":"","sources":["../../../src/plugins/drive/mathpix.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 drive_v3 } from 'googleapis';
+export declare function getFolderMeta(drive: drive_v3.Drive, 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: drive_v3.Drive, parents: string[] | undefined): Promise<SearchClass>;
+/**
+ * classifyForSearch + 폴더 경로(root 하위) 반환 — 직원별 Drive 폴더 scope 필터용.
+ * path 는 폴더만(파일명 제외), root 바로 아래부터, 예: "01_고객사/Acme". cls!=='ok' 면 path 무의미.
+ */
+export declare function classifyAndPath(drive: drive_v3.Drive, 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: drive_v3.Drive, 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,50 @@
+/**
+ * Qdrant client singleton + collection 관리.
+ *
+ * Collection: config.qdrant.collection (default knowledge_v1), or env QDRANT_COLLECTION.
+ * Vector size: 1536 (text-embedding-3-small)
+ * Distance: Cosine
+ */
+import type { QdrantClient } from '@qdrant/js-client-rest';
+import { EMBEDDING_DIM } from './embeddings.js';
+export declare const DRIVE_COLLECTION: string;
+export { EMBEDDING_DIM };
+/** Qdrant 클라이언트. 라이브러리는 처음 쓸 때 불러온다(서버와 CLI 시작 시간 단축 — client.ts 와 같은 이유). */
+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,61 @@
+import { EMBEDDING_DIM } from './embeddings.js';
+import { getConfig } from '../../core/config.js';
+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 클라이언트. 라이브러리는 처음 쓸 때 불러온다(서버와 CLI 시작 시간 단축 — client.ts 와 같은 이유). */
+export async function getQdrantClient() {
+    if (_client)
+        return _client;
+    const { QdrantClient } = await import('@qdrant/js-client-rest');
+    const url = process.env.QDRANT_URL;
+    const apiKey = process.env.QDRANT_API_KEY;
+    if (!url) {
+        throw new Error('[qdrant] QDRANT_URL env missing');
+    }
+    _client = new QdrantClient({
+        url,
+        apiKey: apiKey || undefined,
+        // production: 짧은 timeout 으로 cold-start hang 회피
+        timeout: 10_000,
+    });
+    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":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,IAAI,OAAO,GAAwB,IAAI,CAAC;AAExC,qGAAqG;AACrG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;AAC/F,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAE1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,GAAG,IAAI,YAAY,CAAC;QACzB,GAAG;QACH,MAAM,EAAE,MAAM,IAAI,SAAS;QAC3B,+CAA+C;QAC/C,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;IAEhF,IAAI,MAAM;QAAE,OAAO;IAEnB,MAAM,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,EAAE;QAC9C,OAAO,EAAE;YACP,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,QAAQ;SACnB;QACD,kDAAkD;QAClD,iBAAiB,EAAE;YACjB,sBAAsB,EAAE,CAAC;SAC1B;KACF,CAAC,CAAC;IAEH,6CAA6C;IAC7C,KAAK,MAAM,SAAS,IAAI;QACtB,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ;QAC3C,iCAAiC;QACjC,WAAW,EAAE,YAAY,EAAE,UAAU;QACrC,2DAA2D;QAC3D,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc;KAC9C,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,EAAE;YAChD,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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>;