docs-hub-mcp 1.0.14

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAc5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/utils/fs.js

@@ -0,0 +1,43 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+export function readFile(path) {
+    return readFileSync(path, 'utf-8');
+}
+export function readFileSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+export function writeFile(path, content) {
+    writeFileSync(path, content, 'utf-8');
+}
+export function ensureDir(path) {
+    if (!existsSync(path))
+        mkdirSync(path, { recursive: true });
+}
+export function fileExists(path) {
+    return existsSync(path);
+}
+export function listFiles(dir, ext) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    for (const entry of readdirSync(dir)) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            results.push(...listFiles(fullPath, ext));
+        }
+        else if (entry.endsWith(ext)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+export function getRelativePath(fullPath, base) {
+    return relative(base, fullPath);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QAAC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACrD,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAW;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAC5D,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,7 @@
+import { SimpleGit } from 'simple-git';
+export declare function getGit(cwd: string): SimpleGit;
+export declare function resetGit(): void;
+export declare function hasChanges(cwd: string): Promise<boolean>;
+export declare function autoCommit(cwd: string, message: string): Promise<void>;
+export declare function initRepo(cwd: string): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAKlD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAG7C;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI9D;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5E;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzD"}

package/dist/utils/git.js

@@ -0,0 +1,39 @@
+import { simpleGit } from 'simple-git';
+import { logger } from './logger.js';
+let git = null;
+export function getGit(cwd) {
+    if (!git)
+        git = simpleGit(cwd);
+    return git;
+}
+export function resetGit() {
+    git = null;
+}
+export async function hasChanges(cwd) {
+    const g = getGit(cwd);
+    const status = await g.status();
+    return !status.isClean();
+}
+export async function autoCommit(cwd, message) {
+    const g = getGit(cwd);
+    try {
+        await g.add('.');
+        await g.commit(message);
+        logger.info('git auto-commit', { message });
+    }
+    catch (err) {
+        logger.warn('git commit skipped', { error: String(err) });
+    }
+}
+export async function initRepo(cwd) {
+    const g = getGit(cwd);
+    try {
+        await g.init();
+        logger.info('git repo initialized', { cwd });
+    }
+    catch (err) {
+        logger.error('git init failed', { error: String(err) });
+        throw err;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,IAAI,GAAG,GAAqB,IAAI,CAAC;AAEjC,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,CAAC,GAAG;QAAE,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,GAAG,GAAG,IAAI,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,OAAe;IAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,16 @@
+declare const LOG_LEVELS: {
+    readonly debug: 0;
+    readonly info: 1;
+    readonly warn: 2;
+    readonly error: 3;
+};
+type LogLevel = keyof typeof LOG_LEVELS;
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (msg: string, data?: Record<string, unknown>) => void;
+    info: (msg: string, data?: Record<string, unknown>) => void;
+    warn: (msg: string, data?: Record<string, unknown>) => void;
+    error: (msg: string, data?: Record<string, unknown>) => void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,UAAU;;;;;CAAoD,CAAC;AACrE,KAAK,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAIxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAE1C;AASD,eAAO,MAAM,MAAM;iBACJ,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACvC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACtC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACrC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACpD,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,21 @@
+const LOG_LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+let currentLevel = 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function log(level, msg, data) {
+    if (LOG_LEVELS[level] < LOG_LEVELS[currentLevel])
+        return;
+    const entry = { ts: new Date().toISOString(), level, msg, ...data };
+    if (level === 'error')
+        console.error(JSON.stringify(entry));
+    else
+        console.log(JSON.stringify(entry));
+}
+export const logger = {
+    debug: (msg, data) => log('debug', msg, data),
+    info: (msg, data) => log('info', msg, data),
+    warn: (msg, data) => log('warn', msg, data),
+    error: (msg, data) => log('error', msg, data),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAGrE,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW,EAAE,IAA8B;IACvE,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO;IACzD,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IACpE,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;;QACvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;IAC/E,IAAI,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7E,IAAI,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7E,KAAK,EAAE,CAAC,GAAW,EAAE,IAA8B,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;CAChF,CAAC"}

package/dist/web/server.d.ts

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

package/dist/web/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAmBA,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuE/D"}

package/dist/web/server.js

@@ -0,0 +1,82 @@
+import express from 'express';
+import { resolve } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../utils/logger.js';
+import { SearchPipeline } from '../search/pipeline.js';
+import { loadConfig, resolveKbPath } from '../cli/config.js';
+import { readFileSafe, listFiles } from '../utils/fs.js';
+import { loadSyncState } from '../sync/state.js';
+import { cmdSync } from '../cli/commands.js';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+function renderHtml() {
+    return readFileSync(resolve(__dirname, 'ui.html'), 'utf-8');
+}
+export async function startWebServer(cwd) {
+    const config = loadConfig(cwd);
+    const kbPath = resolveKbPath(config, cwd);
+    const pipeline = new SearchPipeline(kbPath, config);
+    const app = express();
+    app.use(express.json());
+    // UI
+    app.get('/', (_req, res) => {
+        res.type('html').send(renderHtml());
+    });
+    // Search
+    app.get('/api/search', async (req, res) => {
+        const q = String(req.query.q || '');
+        const max = Number(req.query.max) || 10;
+        try {
+            const result = await pipeline.search(q, { maxResults: max });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Read document
+    app.get('/api/document', (req, res) => {
+        const path = String(req.query.path || '');
+        const fullPath = resolve(kbPath, path);
+        const content = readFileSafe(fullPath);
+        if (content === null)
+            return res.status(404).json({ error: 'Not found' });
+        res.json({ path, content });
+    });
+    // File tree
+    app.get('/api/structure', (_req, res) => {
+        const files = listFiles(kbPath, '.md').map(f => ({
+            path: f.replace(kbPath + '/', ''),
+            name: f.split('/').pop() || f,
+        }));
+        const sources = config.sources.map(s => ({ name: s.name, type: s.type, enabled: s.enabled ?? true }));
+        res.json({ files, sources, kbPath });
+    });
+    // Sync status
+    app.get('/api/sync-status', (_req, res) => {
+        const state = loadSyncState(kbPath);
+        res.json(state);
+    });
+    // Trigger sync
+    app.post('/api/sync', async (req, res) => {
+        const incremental = req.body?.incremental ?? false;
+        try {
+            await cmdSync(cwd, incremental);
+            // Reload config
+            const freshConfig = loadConfig(cwd);
+            const freshKbPath = resolveKbPath(freshConfig, cwd);
+            const freshPipeline = new SearchPipeline(freshKbPath, freshConfig);
+            // Update pipeline reference
+            app.locals.pipeline = freshPipeline;
+            res.json({ ok: true, incremental });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    const port = parseInt(process.env.DHM_PORT || '3456', 10);
+    app.listen(port, () => {
+        logger.info('Web UI started', { url: `http://localhost:${port}` });
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/web/server.js.map

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

package/dist/web/ui.html

@@ -0,0 +1,210 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>doc-hub-mcp</title>
+<style>
+*{box-sizing:border-box;margin:0;padding:0}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0d1117;color:#c9d1d9;display:flex;height:100vh}
+nav{width:260px;background:#161b22;border-right:1px solid #30363d;padding:16px;overflow-y:auto;flex-shrink:0}
+nav h2{font-size:14px;color:#58a6ff;margin-bottom:16px;text-transform:uppercase;letter-spacing:.5px}
+nav .section{margin-bottom:20px}
+nav .section-title{font-size:11px;color:#8b949e;text-transform:uppercase;margin-bottom:8px;letter-spacing:.5px}
+nav a,nav button{display:block;padding:6px 12px;color:#c9d1d9;text-decoration:none;border-radius:6px;font-size:13px;cursor:pointer;border:none;background:none;text-align:left;width:100%}
+nav a:hover,nav button:hover{background:#1f242e}
+nav a.active{background:#1f6feb22;color:#58a6ff}
+nav .file{font-size:12px;color:#8b949e;font-family:monospace}
+main{flex:1;display:flex;flex-direction:column;overflow:hidden}
+header{background:#161b22;border-bottom:1px solid #30363d;padding:12px 20px;display:flex;align-items:center;gap:12px}
+header input{flex:1;background:#0d1117;border:1px solid #30363d;border-radius:6px;padding:8px 16px;color:#c9d1d9;font-size:14px;outline:none}
+header input:focus{border-color:#58a6ff}
+header button{background:#238636;color:white;border:none;padding:8px 16px;border-radius:6px;font-size:13px;cursor:pointer;white-space:nowrap}
+header button.sync-btn{background:#1f6feb}
+.content{flex:1;overflow-y:auto;padding:24px}
+.result-item{background:#161b22;border:1px solid #30363d;border-radius:8px;padding:16px;margin-bottom:12px}
+.result-item h3{font-size:14px;color:#58a6ff;margin-bottom:4px}
+.result-item .meta{font-size:11px;color:#8b949e;margin-bottom:8px}
+.result-item .meta span{display:inline-block;margin-right:12px}
+.result-item pre{background:#0d1117;border-radius:4px;padding:12px;font-size:12px;color:#c9d1d9;overflow-x:auto;max-height:200px;overflow-y:auto}
+.doc-content{line-height:1.6}
+.doc-content h1{font-size:24px;border-bottom:1px solid #30363d;padding-bottom:8px;margin-bottom:16px}
+.doc-content h2{font-size:18px;margin:16px 0 8px}
+.doc-content code{background:#161b22;padding:2px 6px;border-radius:3px;font-size:12px}
+.doc-content pre{background:#161b22;padding:12px;border-radius:6px;overflow-x:auto;margin:8px 0}
+.doc-content a{color:#58a6ff}
+.empty{text-align:center;color:#8b949e;padding:60px 20px}
+.empty h3{font-size:16px;margin-bottom:8px}
+.badge{display:inline-block;padding:2px 6px;border-radius:4px;font-size:10px;font-weight:600}
+.badge-tier1{background:#23863622;color:#3fb950}
+.badge-tier2{background:#d2992222;color:#d29922}
+.badge-tier3{background:#1f6feb22;color:#58a6ff}
+.sync-panel{margin-bottom:16px}
+.sync-source{display:flex;align-items:center;justify-content:space-between;padding:8px 12px;background:#161b22;border:1px solid #30363d;border-radius:6px;margin-bottom:8px}
+.sync-source .name{font-weight:600}
+.sync-source .info{font-size:11px;color:#8b949e}
+.sync-source button{font-size:11px;padding:4px 8px;margin-left:8px}
+.stats{display:flex;gap:16px;margin-bottom:20px}
+.stat-card{flex:1;background:#161b22;border:1px solid #30363d;border-radius:8px;padding:16px;text-align:center}
+.stat-card .num{font-size:28px;font-weight:700;color:#58a6ff}
+.stat-card .label{font-size:11px;color:#8b949e;margin-top:4px}
+.search-info{margin-bottom:16px;font-size:12px;color:#8b949e}
+.spinner{display:inline-block;width:16px;height:16px;border:2px solid #30363d;border-top-color:#58a6ff;border-radius:50%;animation:spin .6s linear infinite;margin-right:8px}
+@keyframes spin{to{transform:rotate(360deg)}}
+</style>
+</head>
+<body>
+<nav>
+  <h2>doc-hub-mcp</h2>
+  <div class="section">
+    <div class="section-title">Menu</div>
+    <a href="#" data-page="search" class="active">Search</a>
+    <a href="#" data-page="sync">Sync Status</a>
+  </div>
+  <div class="section">
+    <div class="section-title">Knowledge Base</div>
+    <div id="file-tree">Loading...</div>
+  </div>
+</nav>
+<main>
+  <header>
+    <input type="text" id="search-input" placeholder="Search knowledge base (e.g., deploy, architecture, how to...)">
+    <button onclick="doSearch()">Search</button>
+    <button class="sync-btn" onclick="triggerSync(false)">Sync All</button>
+    <button class="sync-btn" onclick="triggerSync(true)">Sync (Incremental)</button>
+  </header>
+  <div class="content" id="content">
+    <div class="empty"><h3>Start searching</h3><p>Type a query to search the knowledge base</p></div>
+  </div>
+</main>
+<script>
+let currentPage = 'search';
+let files = [];
+
+async function api(url, opts) {
+  const res = await fetch(url, opts);
+  if (!res.ok) return { error: res.statusText };
+  return res.json();
+}
+
+async function loadFiles() {
+  const data = await api('/api/structure');
+  if (data.files) {
+    files = data.files;
+    const tree = document.getElementById('file-tree');
+    tree.innerHTML = files.map(f => `<a href="#" class="file" onclick="viewDoc('${f.path}')">${f.path}</a>`).join('') || '<span class="file">No files</span>';
+  }
+}
+
+async function doSearch() {
+  const q = document.getElementById('search-input').value.trim();
+  if (!q) return;
+  setPage('search');
+  const content = document.getElementById('content');
+  content.innerHTML = '<div class="search-info"><span class="spinner"></span>Searching...</div>';
+  const data = await api(`/api/search?q=${encodeURIComponent(q)}&max=20`);
+  if (data.error) { content.innerHTML = `<div class="empty"><h3>Error</h3><p>${data.error}</p></div>`; return; }
+  if (!data.results || data.results.length === 0) {
+    content.innerHTML = '<div class="empty"><h3>No results</h3><p>Try a different query</p></div>';
+    return;
+  }
+  content.innerHTML = `<div class="search-info">${data.results.length} results in ${data.totalTime.toFixed(1)}ms (Tier ${data.tierUsed})</div>` +
+    data.results.map(r => `
+      <div class="result-item">
+        <h3><a href="#" onclick="viewDoc('${r.path}')">${r.path}</a></h3>
+        <div class="meta">
+          <span>Score: ${r.score.toFixed(2)}</span>
+          <span>Match: ${r.matchType}</span>
+          <span class="badge badge-tier${r.tier}">Tier ${r.tier}</span>
+        </div>
+        <pre>${escapeHtml(r.snippet)}</pre>
+      </div>`).join('');
+}
+
+async function viewDoc(path) {
+  setPage('');
+  const content = document.getElementById('content');
+  content.innerHTML = '<div class="search-info"><span class="spinner"></span>Loading...</div>';
+  const data = await api(`/api/document?path=${encodeURIComponent(path)}`);
+  if (data.error) { content.innerHTML = `<div class="empty"><h3>Not Found</h3><p>${data.error}</p></div>`; return; }
+  content.innerHTML = `<div class="doc-content">${renderMd(data.content)}</div>`;
+}
+
+function renderMd(text) {
+  return text
+    .replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;')
+    .replace(/^### (.+)$/gm,'<h3>$1</h3>')
+    .replace(/^## (.+)$/gm,'<h2>$1</h2>')
+    .replace(/^# (.+)$/gm,'<h1>$1</h1>')
+    .replace(/```(\w*)\n([\s\S]*?)```/g,'<pre><code>$2</code></pre>')
+    .replace(/`([^`]+)`/g,'<code>$1</code>')
+    .replace(/\*\*(.+?)\*\*/g,'<strong>$1</strong>')
+    .replace(/\*(.+?)\*/g,'<em>$1</em>')
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g,'<a href="$2">$1</a>')
+    .replace(/\n/g,'<br>');
+}
+
+function escapeHtml(s) {
+  return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+}
+
+async function loadSyncPanel() {
+  const content = document.getElementById('content');
+  content.innerHTML = '<div class="search-info"><span class="spinner"></span>Loading...</div>';
+  const state = await api('/api/sync-status');
+  const sources = await api('/api/structure');
+  const statsHtml = sources.sources ? `
+    <div class="stats">
+      <div class="stat-card"><div class="num">${sources.files?.length || 0}</div><div class="label">Documents</div></div>
+      <div class="stat-card"><div class="num">${sources.sources?.length || 0}</div><div class="label">Sources</div></div>
+      <div class="stat-card"><div class="num">${state.updated ? new Date(state.updated).toLocaleDateString() : '-'}</div><div class="label">Last Sync</div></div>
+    </div>` : '';
+  const sourcesHtml = (sources.sources || []).map(s => {
+    const ss = state.sources?.[s.name];
+    return `<div class="sync-source">
+      <div><div class="name">${s.name}</div><div class="info">Type: ${s.type} | Synced: ${ss?.totalSynced || 0} files | Last: ${ss?.lastSync ? new Date(ss.lastSync).toLocaleString() : 'never'}</div></div>
+      <div><button onclick="triggerSingleSync('${s.name}')" class="sync-btn">Sync Now</button></div>
+    </div>`;
+  }).join('');
+  content.innerHTML = statsHtml + '<h3 style="margin-bottom:12px">Sources</h3>' + (sourcesHtml || '<p class="empty">No sources configured</p>');
+}
+
+async function triggerSync(incremental) {
+  const btn = event?.target;
+  if (btn) { btn.disabled = true; btn.textContent = 'Syncing...'; }
+  const data = await api('/api/sync', { method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({incremental}) });
+  if (btn) { btn.disabled = false; btn.textContent = incremental ? 'Sync (Incremental)' : 'Sync All'; }
+  if (data.ok) { loadFiles(); alert(`Sync complete (${incremental ? 'incremental' : 'full'})`); }
+  else alert(`Sync failed: ${data.error}`);
+}
+
+async function triggerSingleSync(sourceName) {
+  // Trigger sync for a single source via full sync call
+  const data = await api('/api/sync', { method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify({incremental:false}) });
+  if (data.ok) { loadFiles(); alert(`Sync of ${sourceName} complete`); }
+  else alert(`Sync failed: ${data.error}`);
+}
+
+function setPage(name) {
+  currentPage = name;
+  document.querySelectorAll('nav a').forEach(a => a.classList.remove('active'));
+  if (name) document.querySelector(`[data-page="${name}"]`)?.classList.add('active');
+}
+
+document.addEventListener('DOMContentLoaded', () => {
+  loadFiles();
+  document.addEventListener('click', e => {
+    const page = e.target.dataset.page;
+    if (page) {
+      e.preventDefault();
+      if (page === 'sync') loadSyncPanel();
+      else { setPage(page); document.getElementById('content').innerHTML = '<div class="empty"><h3>Search</h3><p>Type a query above</p></div>'; }
+    }
+  });
+  document.getElementById('search-input').addEventListener('keydown', e => {
+    if (e.key === 'Enter') doSearch();
+  });
+});
+</script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "docs-hub-mcp",
+  "version": "1.0.14",
+  "description": "MCP server for documentation hub — sync from Wiki, Slack, Google Docs, Notion, Confluence to .md, git versioned, with 3-tier search",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "dhm": "./dhm.js"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"const fs=require('fs');fs.mkdirSync('dist/web',{recursive:true});fs.cpSync('src/web/ui.html','dist/web/ui.html')\"",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "serve": "node dist/index.js serve",
+    "sync": "node dist/index.js sync",
+    "index": "node dist/index.js index",
+    "search": "node dist/index.js search",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@types/express": "^5.0.6",
+    "express": "^5.2.1",
+    "js-yaml": "^4.1.0",
+    "simple-git": "^3.27.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}