docs-hub-mcp 1.0.14

package/dist/search/exact.js

@@ -0,0 +1,56 @@
+import { execSync } from 'node:child_process';
+import { relative } from 'node:path';
+export function searchExact(query, kbPath, maxResults = 10) {
+    if (!query.trim())
+        return [];
+    try {
+        const safeQuery = query.replace(/"/g, '\\"');
+        const output = execSync(`rg --ignore-case --max-count=${maxResults} --line-number --context=1 --no-heading "${safeQuery}" "${kbPath}"`, { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024, timeout: 10000 });
+        return parseRgOutput(output, kbPath, maxResults);
+    }
+    catch (err) {
+        const status = err.status;
+        if (status === 1)
+            return [];
+        throw err;
+    }
+}
+function parseRgOutput(output, kbPath, maxResults) {
+    const results = [];
+    const seen = new Set();
+    for (const block of output.split('--\n')) {
+        if (results.length >= maxResults)
+            break;
+        const lines = block.trim().split('\n');
+        if (lines.length === 0)
+            continue;
+        const mainMatch = lines.find(l => !l.startsWith('--') && /^.+?[-:]\d+[-:]/.test(l));
+        if (!mainMatch)
+            continue;
+        const parsed = parseRgLine(mainMatch);
+        if (!parsed || seen.has(parsed.file))
+            continue;
+        seen.add(parsed.file);
+        const relPath = relative(kbPath, parsed.file);
+        results.push({
+            path: relPath,
+            score: 0.95,
+            matchType: 'exact',
+            tier: 1,
+            snippet: block.trim(),
+        });
+    }
+    return results;
+}
+function parseRgLine(line) {
+    // Format: "file.md:42:content" or "file.md-42-content"
+    const match = line.match(/^(.+?)[:-](\d+)[:-](.+)$/);
+    if (!match)
+        return null;
+    return {
+        file: match[1],
+        line: parseInt(match[2], 10),
+        content: match[3],
+    };
+}
+//# sourceMappingURL=exact.js.map

package/dist/search/exact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact.js","sourceRoot":"","sources":["../../src/search/exact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AASrC,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,UAAU,GAAG,EAAE;IACxE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,QAAQ,CACrB,gCAAgC,UAAU,4CAA4C,SAAS,MAAM,MAAM,GAAG,EAC9G,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CACnE,CAAC;QAEF,OAAO,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,MAAM,GAAI,GAA2B,CAAC,MAAM,CAAC;QACnD,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,MAAc,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;QAExC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEjC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEtB,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAE9C,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,OAAO;YAClB,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,uDAAuD;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/search/graph.d.ts

@@ -0,0 +1,6 @@
+import type { KnowledgeGraph } from '../index/builder.js';
+import type { SearchResult } from '../mcp/tools.js';
+export declare function loadGraph(kbPath: string): KnowledgeGraph | null;
+export declare function clearGraphCache(): void;
+export declare function searchGraph(query: string, kbPath: string, maxResults?: number): SearchResult[];
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/search/graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAsB/D;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAkCD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,YAAY,EAAE,CAmF1F"}

package/dist/search/graph.js

@@ -0,0 +1,137 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import * as yaml from 'js-yaml';
+import { logger } from '../utils/logger.js';
+let cachedGraph = null;
+let cachedGraphPath = null;
+export function loadGraph(kbPath) {
+    const indexPath = resolve(kbPath, '.dhm-index.yaml');
+    if (cachedGraph && cachedGraphPath === indexPath) {
+        return cachedGraph;
+    }
+    if (!existsSync(indexPath)) {
+        logger.debug('No .dhm-index.yaml found, skipping graph search');
+        return null;
+    }
+    try {
+        const content = readFileSync(indexPath, 'utf-8');
+        const graph = yaml.load(content);
+        cachedGraph = graph;
+        cachedGraphPath = indexPath;
+        return graph;
+    }
+    catch {
+        logger.warn('Failed to load .dhm-index.yaml');
+        return null;
+    }
+}
+export function clearGraphCache() {
+    cachedGraph = null;
+    cachedGraphPath = null;
+}
+function tokenize(query) {
+    return query
+        .toLowerCase()
+        .replace(/[?#*_`\[\]()]/g, '')
+        .split(/\s+/)
+        .filter(t => t.length > 1);
+}
+function matchTags(tokens, tags) {
+    let score = 0;
+    for (const token of tokens) {
+        for (const tag of tags) {
+            if (tag.includes(token) || token.includes(tag)) {
+                score += 1;
+            }
+        }
+    }
+    return score;
+}
+function matchKeywords(tokens, keywords) {
+    let score = 0;
+    for (const token of tokens) {
+        for (const kw of keywords) {
+            if (kw.includes(token) || token.includes(kw)) {
+                score += 1;
+            }
+        }
+    }
+    return score;
+}
+export function searchGraph(query, kbPath, maxResults = 10) {
+    const graph = loadGraph(kbPath);
+    if (!graph || graph.documents.length === 0)
+        return [];
+    const tokens = tokenize(query);
+    if (tokens.length === 0)
+        return [];
+    const results = new Map();
+    for (const doc of graph.documents) {
+        const tagScore = matchTags(tokens, doc.tags);
+        const kwScore = matchKeywords(tokens, doc.keywords);
+        const totalScore = tagScore * 1.5 + kwScore * 1.2;
+        if (totalScore > 0) {
+            const normalized = totalScore / (tokens.length * 2);
+            results.set(doc.path, {
+                path: doc.path,
+                score: Math.min(normalized, 0.9),
+                matchType: tagScore > 0 ? 'tag' : 'keyword',
+                tier: 2,
+                snippet: doc.title,
+            });
+        }
+        // Section-level match bonus
+        for (const section of doc.sections) {
+            const secScore = matchKeywords(tokens, section.keywords);
+            if (secScore > 0) {
+                const existing = results.get(doc.path);
+                if (existing) {
+                    existing.score = Math.min(existing.score + 0.1, 0.95);
+                    existing.snippet += ` > ${section.title}`;
+                }
+                else {
+                    results.set(doc.path, {
+                        path: doc.path,
+                        score: Math.min(secScore / tokens.length, 0.85),
+                        matchType: 'keyword',
+                        tier: 2,
+                        snippet: `${doc.title} > ${section.title}`,
+                    });
+                }
+            }
+        }
+    }
+    // Expand related documents from top matches
+    const topPaths = [...results.entries()]
+        .sort((a, b) => b[1].score - a[1].score)
+        .slice(0, 3)
+        .map(([path]) => path);
+    for (const path of topPaths) {
+        const doc = graph.documents.find(d => d.path === path);
+        if (!doc)
+            continue;
+        for (const { path: relPath, relation } of doc.related) {
+            if (!results.has(relPath)) {
+                // Normalize the related path
+                const dir = path.split('/').slice(0, -1).join('/');
+                const resolved = dir ? `${dir}/${relPath}` : relPath;
+                const clean = resolved.replace(/\.\//g, '');
+                // Check if the related doc exists in graph
+                const relDoc = graph.documents.find(d => d.path === clean || d.path.endsWith(relPath));
+                if (relDoc && !results.has(relDoc.path)) {
+                    results.set(relDoc.path, {
+                        path: relDoc.path,
+                        score: 0.4,
+                        matchType: 'related',
+                        tier: 2,
+                        snippet: `${relation} (related to ${path})`,
+                    });
+                }
+            }
+        }
+    }
+    return [...results.values()]
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults);
+}
+//# sourceMappingURL=graph.js.map

package/dist/search/graph.js.map

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

package/dist/search/pipeline.d.ts

@@ -0,0 +1,18 @@
+import type { SearchResponse } from '../mcp/tools.js';
+import type { AppConfig } from '../cli/config.js';
+export interface SearchOptions {
+    maxResults?: number;
+    minResults?: number;
+    tier?: 1 | 2 | 3;
+}
+export declare class SearchPipeline {
+    private kbPath;
+    private cache;
+    private maxResults;
+    private minResults;
+    constructor(kbPath: string, config: AppConfig);
+    search(query: string, opts?: SearchOptions): Promise<SearchResponse>;
+    prewarm(queries: string[]): void;
+    clearCache(): void;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/search/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAClB;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IAOvC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA6D1E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAUhC,UAAU,IAAI,IAAI;CAGnB"}

package/dist/search/pipeline.js

@@ -0,0 +1,99 @@
+import { searchExact } from './exact.js';
+import { searchGraph } from './graph.js';
+import { searchSemantic } from './semantic.js';
+import { SearchCache } from './cache.js';
+import { logger } from '../utils/logger.js';
+const TIER_WEIGHTS = { 1: 1.0, 2: 0.8, 3: 0.5 };
+export class SearchPipeline {
+    kbPath;
+    cache;
+    maxResults;
+    minResults;
+    constructor(kbPath, config) {
+        this.kbPath = kbPath;
+        this.maxResults = config.maxResults;
+        this.minResults = config.minResults;
+        this.cache = new SearchCache(config.cache.maxSize, config.cache.ttl);
+    }
+    async search(query, opts) {
+        const maxR = opts?.maxResults ?? this.maxResults;
+        const minR = opts?.minResults ?? this.minResults;
+        const startTime = performance.now();
+        // Check cache first
+        const cached = this.cache.get(query);
+        if (cached) {
+            logger.debug('cache hit', { query });
+            return {
+                results: cached.slice(0, maxR),
+                totalTime: performance.now() - startTime,
+                tierUsed: 0,
+            };
+        }
+        const allResults = [];
+        let tierUsed = 0;
+        // Tier 1: Exact match
+        if (!opts?.tier || opts.tier >= 1) {
+            const exactResults = searchExact(query, this.kbPath, maxR);
+            allResults.push(...exactResults.map(r => ({ ...r, score: r.score * TIER_WEIGHTS[1] })));
+            tierUsed = 1;
+        }
+        // Tier 2: Knowledge graph
+        if ((!opts?.tier || opts.tier >= 2) && (!opts?.tier || opts.tier === 2 || allResults.length < minR)) {
+            const graphResults = searchGraph(query, this.kbPath, maxR);
+            allResults.push(...graphResults.map(r => ({ ...r, score: r.score * TIER_WEIGHTS[2] })));
+            if (graphResults.length > 0)
+                tierUsed = Math.max(tierUsed, 2);
+        }
+        // Tier 3: AI Semantic fallback
+        if ((!opts?.tier || opts.tier >= 3) && allResults.length < minR) {
+            const semanticResults = searchSemantic(query, this.kbPath, maxR);
+            allResults.push(...semanticResults.map(r => ({ ...r, score: r.score * TIER_WEIGHTS[3] })));
+            if (semanticResults.length > 0)
+                tierUsed = Math.max(tierUsed, 3);
+        }
+        const final = deduplicateAndRank(allResults).slice(0, maxR);
+        // Cache results
+        if (final.length > 0) {
+            this.cache.set(query, final);
+        }
+        logger.info('search complete', {
+            query,
+            totalResults: final.length,
+            tierUsed,
+            totalTime: Math.round(performance.now() - startTime),
+        });
+        return {
+            results: final,
+            totalTime: performance.now() - startTime,
+            tierUsed,
+        };
+    }
+    prewarm(queries) {
+        for (const query of queries) {
+            const results = searchExact(query, this.kbPath, 10);
+            if (results.length > 0) {
+                this.cache.set(query, results);
+            }
+        }
+        logger.info('prewarm complete', { queries: queries.length, cacheSize: this.cache.size });
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+}
+function deduplicateAndRank(results) {
+    const merged = new Map();
+    for (const r of results) {
+        const existing = merged.get(r.path);
+        if (existing) {
+            existing.score = Math.max(existing.score, r.score);
+            if (r.tier < existing.tier)
+                existing.tier = r.tier;
+        }
+        else {
+            merged.set(r.path, { ...r });
+        }
+    }
+    return [...merged.values()].sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/search/pipeline.js.map

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

package/dist/search/semantic.d.ts

@@ -0,0 +1,4 @@
+import type { SearchResult } from '../mcp/tools.js';
+export declare function clearSemanticCache(): void;
+export declare function searchSemantic(query: string, kbPath: string, maxResults?: number): SearchResult[];
+//# sourceMappingURL=semantic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/search/semantic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmEpD,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AA0BD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,YAAY,EAAE,CA6C7F"}

package/dist/search/semantic.js

@@ -0,0 +1,120 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseAllDocuments } from '../index/parser.js';
+import { logger } from '../utils/logger.js';
+let summariesCache = null;
+let summariesCachePath = null;
+function tokenizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[#*_`\[\]()\n\r]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 1);
+}
+function buildTokenFreq(tokens) {
+    const freq = new Map();
+    for (const t of tokens) {
+        freq.set(t, (freq.get(t) || 0) + 1);
+    }
+    return freq;
+}
+function loadSummaries(kbPath) {
+    if (summariesCache && summariesCachePath === kbPath) {
+        return summariesCache;
+    }
+    const docs = parseAllDocuments(kbPath);
+    const summaries = [];
+    for (const doc of docs) {
+        // Read first paragraph from the file
+        let firstPara = '';
+        try {
+            const content = readFileSync(resolve(kbPath, doc.path), 'utf-8');
+            const lines = content.split('\n');
+            const textStart = lines.findIndex(l => l.trim() && !l.startsWith('#'));
+            if (textStart >= 0) {
+                firstPara = lines[textStart].trim();
+            }
+        }
+        catch {
+            // skip
+        }
+        const text = `${doc.title} ${firstPara} ${doc.keywords.join(' ')}`;
+        const tokens = tokenizeText(text);
+        summaries.push({
+            path: doc.path,
+            title: doc.title,
+            tokens: buildTokenFreq(tokens),
+        });
+    }
+    summariesCache = summaries;
+    summariesCachePath = kbPath;
+    logger.debug('Summaries loaded', { count: summaries.length });
+    return summaries;
+}
+export function clearSemanticCache() {
+    summariesCache = null;
+    summariesCachePath = null;
+}
+/**
+ * TF-IDF inspired similarity using word overlap with IDF-like weighting.
+ * Words that appear in fewer documents get higher weight (simple IDF).
+ */
+function computeSimilarity(queryTokens, docTokens, totalDocs, docFreq) {
+    let score = 0;
+    const queryFreq = buildTokenFreq(queryTokens);
+    for (const [token, qf] of queryFreq) {
+        const df = docFreq.get(token) || 0;
+        if (df === 0)
+            continue;
+        const idf = Math.log(totalDocs / df);
+        const tf = docTokens.get(token) || 0;
+        // TF-IDF cosine component
+        score += qf * tf * idf;
+    }
+    // Normalize by query length
+    const norm = Math.sqrt(queryTokens.length * Math.log(totalDocs));
+    return norm > 0 ? score / norm : 0;
+}
+export function searchSemantic(query, kbPath, maxResults = 10) {
+    if (!query.trim())
+        return [];
+    const summaries = loadSummaries(kbPath);
+    if (summaries.length === 0)
+        return [];
+    const queryTokens = tokenizeText(query);
+    if (queryTokens.length === 0)
+        return [];
+    // Compute document frequencies across all summaries
+    const totalDocs = summaries.length;
+    const docFreq = new Map();
+    for (const s of summaries) {
+        for (const token of s.tokens.keys()) {
+            docFreq.set(token, (docFreq.get(token) || 0) + 1);
+        }
+    }
+    // Score each document
+    const scored = summaries.map(doc => ({
+        path: doc.path,
+        score: computeSimilarity(queryTokens, doc.tokens, totalDocs, docFreq),
+        title: doc.title,
+    }));
+    // Filter and rank
+    const results = scored
+        .filter(s => s.score > 0.05)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults)
+        .map(s => ({
+        path: s.path,
+        score: Math.min(s.score * 0.7, 0.8), // Scale down — semantic is less precise
+        matchType: 'semantic',
+        tier: 3,
+        snippet: s.title,
+    }));
+    logger.debug('semantic search', {
+        query,
+        candidates: scored.length,
+        results: results.length,
+    });
+    return results;
+}
+//# sourceMappingURL=semantic.js.map

package/dist/search/semantic.js.map

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

package/dist/sync/base.d.ts

@@ -0,0 +1,21 @@
+import type { SourceConfig } from '../cli/config.js';
+export interface SyncResult {
+    sourceName: string;
+    sourceType: string;
+    filesWritten: number;
+    filesUpdated: number;
+    filesDeleted: number;
+    errors: SyncError[];
+    duration: number;
+    incremental: boolean;
+}
+export interface SyncError {
+    message: string;
+    details?: string;
+}
+export interface SyncAdapter {
+    name: string;
+    sync(config: SourceConfig, kbPath: string, cwd: string, incremental?: boolean): Promise<SyncResult>;
+}
+export declare function createSyncResult(sourceName: string, sourceType: string): SyncResult;
+//# sourceMappingURL=base.d.ts.map

package/dist/sync/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/sync/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrG;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAMnF"}

package/dist/sync/base.js

@@ -0,0 +1,8 @@
+export function createSyncResult(sourceName, sourceType) {
+    return {
+        sourceName, sourceType,
+        filesWritten: 0, filesUpdated: 0, filesDeleted: 0,
+        errors: [], duration: 0, incremental: false,
+    };
+}
+//# sourceMappingURL=base.js.map

package/dist/sync/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/sync/base.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,UAAkB;IACrE,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;QACjD,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK;KAC5C,CAAC;AACJ,CAAC"}

package/dist/sync/confluence.d.ts

@@ -0,0 +1,3 @@
+import { type SyncAdapter } from './base.js';
+export declare const confluenceAdapter: SyncAdapter;
+//# sourceMappingURL=confluence.d.ts.map

package/dist/sync/confluence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence.d.ts","sourceRoot":"","sources":["../../src/sync/confluence.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AA4C/D,eAAO,MAAM,iBAAiB,EAAE,WAqF/B,CAAC"}

package/dist/sync/confluence.js

@@ -0,0 +1,111 @@
+import { resolve, join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { ensureDir, writeFile, fileExists } from '../utils/fs.js';
+import { createSyncResult } from './base.js';
+import { getSourceState, updateSourceState, buildFilesSnapshot } from './state.js';
+function convertHtmlToMd(html) {
+    return html
+        .replace(/<h([1-4])[^>]*>/gi, (_, n) => '\n' + '#'.repeat(Number(n)) + ' ')
+        .replace(/<\/h[1-6]>/gi, '\n')
+        .replace(/<p[^>]*>/gi, '\n').replace(/<\/p>/gi, '\n')
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<strong[^>]*>/gi, '**').replace(/<\/strong>/gi, '**')
+        .replace(/<em[^>]*>/gi, '*').replace(/<\/em>/gi, '*')
+        .replace(/<code[^>]*>/gi, '`').replace(/<\/code>/gi, '`')
+        .replace(/<pre[^>]*>/gi, '\n```\n').replace(/<\/pre>/gi, '\n```\n')
+        .replace(/<a[^>]*href="([^"]*)"[^>]*>/gi, '[$1](').replace(/<\/a>/gi, ')')
+        .replace(/<li[^>]*>/gi, '- ').replace(/<\/li>/gi, '\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&nbsp;/g, ' ')
+        .replace(/\n{3,}/g, '\n\n').trim();
+}
+function sanitizeFilename(name) {
+    return name.replace(/[<>:"/\\|?*]/g, '-').replace(/\s+/g, '-').slice(0, 100);
+}
+export const confluenceAdapter = {
+    name: 'confluence',
+    async sync(config, kbPath, cwd, incremental) {
+        const result = createSyncResult(config.name, config.type);
+        result.incremental = !!incremental;
+        const startTime = performance.now();
+        const baseUrl = config.url || process.env.CONFLUENCE_URL;
+        const username = process.env.CONFLUENCE_USERNAME || process.env.CONFLUENCE_EMAIL;
+        const apiToken = process.env.CONFLUENCE_API_TOKEN || process.env.CONFLUENCE_TOKEN;
+        if (!baseUrl) {
+            result.errors.push({ message: 'Set CONFLUENCE_URL env var or "url" in config.' });
+            result.duration = performance.now() - startTime;
+            return result;
+        }
+        if (!apiToken) {
+            result.errors.push({ message: 'Set CONFLUENCE_API_TOKEN env var.' });
+            result.duration = performance.now() - startTime;
+            return result;
+        }
+        const prevState = getSourceState(kbPath, config.name);
+        try {
+            const auth = Buffer.from(`${username || 'api'}:${apiToken}`).toString('base64');
+            const headers = { Authorization: `Basic ${auth}`, Accept: 'application/json' };
+            const sourceDir = resolve(kbPath, config.name);
+            ensureDir(sourceDir);
+            let cql = `space=${config.folderId || 'currentSpace()'} and type=page`;
+            if (incremental && prevState.lastSync) {
+                cql += ` and lastModified > "${prevState.lastSync}"`;
+            }
+            let searchUrl = `${baseUrl}/wiki/rest/api/content/search?cql=${encodeURIComponent(cql)}&limit=50&expand=version`;
+            while (searchUrl) {
+                const searchResponse = await fetch(searchUrl, { headers });
+                if (!searchResponse.ok)
+                    throw new Error(`Confluence API error: ${searchResponse.status}`);
+                const searchData = (await searchResponse.json());
+                if (searchData.results.length === 0 && incremental) {
+                    logger.info('No modified pages', { source: config.name });
+                    break;
+                }
+                for (const page of searchData.results) {
+                    try {
+                        const pageUrl = `${baseUrl}/wiki/rest/api/content/${page.id}?expand=body.storage,version,space`;
+                        const pageResponse = await fetch(pageUrl, { headers });
+                        if (!pageResponse.ok) {
+                            result.errors.push({ message: `Page failed: ${page.title}` });
+                            continue;
+                        }
+                        const pageData = (await pageResponse.json());
+                        const mdContent = convertHtmlToMd(pageData.body?.storage?.value || '');
+                        const lines = [
+                            `# ${pageData.title}\n`,
+                            `> Source: ${pageData._links.base}${pageData._links.webui}\n`,
+                            `> Space: ${pageData.space?.key || 'unknown'}\n`,
+                            `> Last updated: ${pageData.version.when}\n\n`,
+                            mdContent,
+                        ];
+                        const filePath = join(sourceDir, `${sanitizeFilename(pageData.title)}.md`);
+                        const existed = fileExists(filePath);
+                        writeFile(filePath, lines.join('\n'));
+                        if (existed)
+                            result.filesUpdated++;
+                        else
+                            result.filesWritten++;
+                    }
+                    catch (err) {
+                        result.errors.push({ message: `Page process failed: ${page.title}`, details: String(err) });
+                    }
+                }
+                searchUrl = searchData._links.next ? `${baseUrl}/wiki${searchData._links.next}` : '';
+            }
+            const snapshot = buildFilesSnapshot(sourceDir);
+            updateSourceState(kbPath, config.name, config.type, {
+                filesSnapshot: snapshot,
+                totalSynced: result.filesWritten + result.filesUpdated,
+                totalErrors: result.errors.length,
+            });
+            logger.info('Confluence sync complete', { source: config.name, written: result.filesWritten, updated: result.filesUpdated });
+        }
+        catch (err) {
+            result.errors.push({ message: 'Confluence sync failed', details: String(err) });
+        }
+        result.duration = performance.now() - startTime;
+        return result;
+    },
+};
+//# sourceMappingURL=confluence.js.map