@vdpeijl/kb-mcp 0.1.2

package/dist/src/commands/stats.js

@@ -0,0 +1,48 @@
+import { defineCommand } from 'citty';
+import { getDatabase, getDatabaseStats } from '../db/index.js';
+import { getSourcesWithStats } from '../db/sources.js';
+import { exitWithError } from '../utils/errors.js';
+export default defineCommand({
+    meta: {
+        name: 'stats',
+        description: 'Show database statistics',
+    },
+    async run() {
+        try {
+            const db = await getDatabase();
+            const stats = await getDatabaseStats();
+            const sources = getSourcesWithStats(db);
+            console.log('\n📊 Database Statistics\n');
+            console.log(`Sources: ${stats.sources}`);
+            console.log(`Articles: ${stats.articles}`);
+            console.log(`Chunks: ${stats.chunks}`);
+            console.log(`Database Size: ${formatBytes(stats.databaseSize)}`);
+            if (sources.length > 0) {
+                console.log('\n📚 Sources:\n');
+                for (const source of sources) {
+                    const status = source.enabled ? '✓' : '✗';
+                    const lastSynced = source.lastSyncedAt
+                        ? source.lastSyncedAt.toLocaleString()
+                        : 'Never';
+                    console.log(`${status} ${source.name} (${source.id})`);
+                    console.log(`  Articles: ${source.articleCount}`);
+                    console.log(`  Chunks: ${source.chunkCount}`);
+                    console.log(`  Last Synced: ${lastSynced}`);
+                    console.log();
+                }
+            }
+        }
+        catch (error) {
+            exitWithError(error);
+        }
+    },
+});
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
+}
+//# sourceMappingURL=stats.js.map

package/dist/src/commands/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,eAAe,aAAa,CAAC;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0BAA0B;KACxC;IACD,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAExC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAEjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY;wBACpC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE;wBACtC,CAAC,CAAC,OAAO,CAAC;oBAEZ,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;oBACvD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;oBAClD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;oBAC9C,OAAO,CAAC,GAAG,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAC;oBAC5C,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/commands/sync.d.ts

@@ -0,0 +1,13 @@
+declare const _default: import("citty").CommandDef<{
+    source: {
+        type: "string";
+        description: string;
+    };
+    full: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export default _default;
+//# sourceMappingURL=sync.d.ts.map

package/dist/src/commands/sync.d.ts.map

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

package/dist/src/commands/sync.js

@@ -0,0 +1,106 @@
+import { defineCommand } from 'citty';
+import { loadConfig } from '../config/index.js';
+import { getDatabase } from '../db/index.js';
+import { getEnabledSources, getSource } from '../db/sources.js';
+import { syncSource } from '../sync/index.js';
+import { exitWithError } from '../utils/errors.js';
+export default defineCommand({
+    meta: {
+        name: 'sync',
+        description: 'Sync knowledge bases',
+    },
+    args: {
+        source: {
+            type: 'string',
+            description: 'Sync specific source only',
+        },
+        full: {
+            type: 'boolean',
+            description: 'Full re-sync (re-embed everything)',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        try {
+            const config = await loadConfig();
+            const db = await getDatabase();
+            // Sync sources from config to database
+            const { upsertSource } = await import('../db/sources.js');
+            for (const source of config.sources) {
+                upsertSource(db, source);
+            }
+            let sources;
+            if (args.source) {
+                const source = getSource(db, args.source);
+                if (!source) {
+                    console.error(`\n✗ Source not found: ${args.source}\n`);
+                    process.exit(1);
+                }
+                sources = [source];
+            }
+            else {
+                sources = getEnabledSources(db);
+                if (sources.length === 0) {
+                    console.log('\nNo enabled sources to sync.\n');
+                    console.log('Add a source with:');
+                    console.log('  kb-mcp sources add\n');
+                    return;
+                }
+            }
+            const fullResync = args.full === true;
+            if (fullResync) {
+                console.log('\n🔄 Running full re-sync (all articles will be re-processed)\n');
+            }
+            else {
+                console.log('\n🔄 Running incremental sync\n');
+            }
+            for (const source of sources) {
+                console.log(`\n📚 Syncing: ${source.name}`);
+                console.log('─'.repeat(50));
+                const startTime = Date.now();
+                let lastMessage = '';
+                const result = await syncSource(db, source, config, (progress) => {
+                    const message = formatProgress(progress);
+                    if (message !== lastMessage) {
+                        // Clear previous line
+                        if (lastMessage) {
+                            process.stdout.write('\r\x1b[K');
+                        }
+                        process.stdout.write(message);
+                        lastMessage = message;
+                    }
+                }, fullResync);
+                // Clear progress line
+                if (lastMessage) {
+                    process.stdout.write('\r\x1b[K');
+                }
+                const duration = (result.timeElapsed / 1000).toFixed(1);
+                console.log(`✓ Sync complete in ${duration}s`);
+                console.log(`  Articles fetched: ${result.articlesFetched}`);
+                console.log(`  Articles processed: ${result.articlesProcessed}`);
+                console.log(`  Chunks created: ${result.chunksCreated}`);
+            }
+            console.log('\n✅ Sync completed successfully\n');
+        }
+        catch (error) {
+            exitWithError(error);
+        }
+    },
+});
+function formatProgress(progress) {
+    const { phase, current, total, message } = progress;
+    const phaseEmojis = {
+        fetching: '📥',
+        parsing: '📝',
+        chunking: '✂️',
+        embedding: '🔢',
+        storing: '💾',
+    };
+    const emoji = phaseEmojis[phase];
+    const percent = total > 0 ? Math.round((current / total) * 100) : 0;
+    if (total > 0 && current > 0) {
+        return `${emoji} ${message} (${percent}%)`;
+    }
+    return `${emoji} ${message}`;
+}
+//# sourceMappingURL=sync.js.map

package/dist/src/commands/sync.js.map

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

package/dist/src/config/index.d.ts

@@ -0,0 +1,18 @@
+import { type Config } from './schema.js';
+/**
+ * Load configuration from disk
+ */
+export declare function loadConfig(): Promise<Config>;
+/**
+ * Save configuration to disk
+ */
+export declare function saveConfig(config: Config): Promise<void>;
+/**
+ * Check if configuration exists
+ */
+export declare function configExists(): boolean;
+/**
+ * Get a default configuration
+ */
+export declare function getDefaultConfig(): Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CA0ClD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/src/config/index.js

@@ -0,0 +1,67 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { ZodError } from 'zod';
+import { getXDGPaths, ensureDirectories } from './paths.js';
+import { ConfigSchema } from './schema.js';
+/**
+ * Load configuration from disk
+ */
+export async function loadConfig() {
+    const paths = await ensureDirectories();
+    const configPath = paths.configFile;
+    // Check if config exists
+    if (!existsSync(configPath)) {
+        throw new Error(`Configuration file not found at ${configPath}\n\n` +
+            `Run 'kb-mcp init' to create a configuration file.`);
+    }
+    // Read and parse config file
+    const configData = await readFile(configPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(configData);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in configuration file: ${configPath}\n\n` +
+            `Please check the file for syntax errors.`);
+    }
+    // Validate with Zod
+    try {
+        return ConfigSchema.parse(parsed);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues.map(issue => {
+                const path = issue.path.join('.');
+                return `  • ${path}: ${issue.message}`;
+            }).join('\n');
+            throw new Error(`Invalid configuration at ${configPath}\n\n${issues}\n\n` +
+                `Run 'kb-mcp init' to reconfigure, or edit the file manually.`);
+        }
+        throw error;
+    }
+}
+/**
+ * Save configuration to disk
+ */
+export async function saveConfig(config) {
+    const paths = await ensureDirectories();
+    const configPath = paths.configFile;
+    // Validate before saving
+    const validated = ConfigSchema.parse(config);
+    // Write to file with pretty formatting
+    await writeFile(configPath, JSON.stringify(validated, null, 2), 'utf-8');
+}
+/**
+ * Check if configuration exists
+ */
+export function configExists() {
+    const paths = getXDGPaths();
+    return existsSync(paths.configFile);
+}
+/**
+ * Get a default configuration
+ */
+export function getDefaultConfig() {
+    return ConfigSchema.parse({});
+}
+//# sourceMappingURL=index.js.map

package/dist/src/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEpC,yBAAyB;IACzB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,mCAAmC,UAAU,MAAM;YACnD,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uCAAuC,UAAU,MAAM;YACvD,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClC,OAAO,OAAO,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YACzC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,OAAO,MAAM,MAAM;gBACzD,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc;IAC7C,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEpC,yBAAyB;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE7C,uCAAuC;IACvC,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,OAAO,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/config/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Get XDG Base Directory paths or fallback to platform defaults
+ */
+export declare function getXDGPaths(): {
+    config: string;
+    data: string;
+    configFile: string;
+    database: string;
+    logs: string;
+};
+/**
+ * Ensure all necessary directories exist
+ */
+export declare function ensureDirectories(): Promise<{
+    config: string;
+    data: string;
+    configFile: string;
+    database: string;
+    logs: string;
+}>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/config/paths.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,WAAW;;;;;;EAuB1B;AAED;;GAEG;AACH,wBAAsB,iBAAiB;;;;;;GAQtC"}

package/dist/src/config/paths.js

@@ -0,0 +1,38 @@
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { mkdir } from 'node:fs/promises';
+/**
+ * Get XDG Base Directory paths or fallback to platform defaults
+ */
+export function getXDGPaths() {
+    const home = homedir();
+    const isWindows = platform() === 'win32';
+    // Config directory
+    const configHome = process.env.XDG_CONFIG_HOME ||
+        (isWindows
+            ? join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'kb-mcp')
+            : join(home, '.config', 'kb-mcp'));
+    // Data directory
+    const dataHome = process.env.XDG_DATA_HOME ||
+        (isWindows
+            ? join(process.env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'kb-mcp')
+            : join(home, '.local', 'share', 'kb-mcp'));
+    return {
+        config: configHome,
+        data: dataHome,
+        configFile: join(configHome, 'config.json'),
+        database: join(dataHome, 'kb.sqlite'),
+        logs: join(dataHome, 'logs'),
+    };
+}
+/**
+ * Ensure all necessary directories exist
+ */
+export async function ensureDirectories() {
+    const paths = getXDGPaths();
+    await mkdir(paths.config, { recursive: true });
+    await mkdir(paths.data, { recursive: true });
+    await mkdir(paths.logs, { recursive: true });
+    return paths;
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC;IAEzC,mBAAmB;IACnB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe;QAC5C,CAAC,SAAS;YACR,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC;YACzE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvC,iBAAiB;IACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa;QACxC,CAAC,SAAS;YACR,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/C,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;QAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAE5B,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/config/schema.d.ts

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+/**
+ * Zod schema for Ollama configuration
+ */
+export declare const OllamaConfigSchema: z.ZodObject<{
+    baseUrl: z.ZodDefault<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    baseUrl: string;
+    model: string;
+}, {
+    baseUrl?: string | undefined;
+    model?: string | undefined;
+}>;
+/**
+ * Zod schema for sync configuration
+ */
+export declare const SyncConfigSchema: z.ZodObject<{
+    chunkSize: z.ZodDefault<z.ZodNumber>;
+    chunkOverlap: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    chunkSize: number;
+    chunkOverlap: number;
+}, {
+    chunkSize?: number | undefined;
+    chunkOverlap?: number | undefined;
+}>;
+/**
+ * Zod schema for a knowledge base source
+ */
+export declare const SourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    baseUrl: z.ZodString;
+    locale: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    baseUrl: string;
+    id: string;
+    name: string;
+    locale: string;
+    enabled: boolean;
+}, {
+    baseUrl: string;
+    id: string;
+    name: string;
+    locale: string;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Zod schema for the complete configuration
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    ollama: z.ZodDefault<z.ZodObject<{
+        baseUrl: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        baseUrl: string;
+        model: string;
+    }, {
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+    }>>;
+    sync: z.ZodDefault<z.ZodObject<{
+        chunkSize: z.ZodDefault<z.ZodNumber>;
+        chunkOverlap: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        chunkSize: number;
+        chunkOverlap: number;
+    }, {
+        chunkSize?: number | undefined;
+        chunkOverlap?: number | undefined;
+    }>>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        baseUrl: z.ZodString;
+        locale: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        baseUrl: string;
+        id: string;
+        name: string;
+        locale: string;
+        enabled: boolean;
+    }, {
+        baseUrl: string;
+        id: string;
+        name: string;
+        locale: string;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    ollama: {
+        baseUrl: string;
+        model: string;
+    };
+    sync: {
+        chunkSize: number;
+        chunkOverlap: number;
+    };
+    sources: {
+        baseUrl: string;
+        id: string;
+        name: string;
+        locale: string;
+        enabled: boolean;
+    }[];
+}, {
+    ollama?: {
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+    } | undefined;
+    sync?: {
+        chunkSize?: number | undefined;
+        chunkOverlap?: number | undefined;
+    } | undefined;
+    sources?: {
+        baseUrl: string;
+        id: string;
+        name: string;
+        locale: string;
+        enabled?: boolean | undefined;
+    }[] | undefined;
+}>;
+/**
+ * TypeScript types inferred from schemas
+ */
+export type OllamaConfig = z.infer<typeof OllamaConfigSchema>;
+export type SyncConfig = z.infer<typeof SyncConfigSchema>;
+export type Source = z.infer<typeof SourceSchema>;
+export type Config = z.infer<typeof ConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAMvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIvB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/src/config/schema.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * Zod schema for Ollama configuration
+ */
+export const OllamaConfigSchema = z.object({
+    baseUrl: z.string().url().default('http://localhost:11434'),
+    model: z.string().default('nomic-embed-text'),
+});
+/**
+ * Zod schema for sync configuration
+ */
+export const SyncConfigSchema = z.object({
+    chunkSize: z.number().int().positive().default(500),
+    chunkOverlap: z.number().int().nonnegative().default(50),
+});
+/**
+ * Zod schema for a knowledge base source
+ */
+export const SourceSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    baseUrl: z.string().url(),
+    locale: z.string().min(2),
+    enabled: z.boolean().default(true),
+});
+/**
+ * Zod schema for the complete configuration
+ */
+export const ConfigSchema = z.object({
+    ollama: OllamaConfigSchema.default({}),
+    sync: SyncConfigSchema.default({}),
+    sources: z.array(SourceSchema).default([]),
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC;CAC9C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACnD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACzD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3C,CAAC,CAAC"}

package/dist/src/db/articles.d.ts

@@ -0,0 +1,39 @@
+import type Database from 'better-sqlite3';
+export interface Article {
+    id: number;
+    sourceId: string;
+    title: string;
+    url: string;
+    sectionName?: string;
+    categoryName?: string;
+    updatedAt: Date;
+}
+/**
+ * Insert or update an article
+ */
+export declare function upsertArticle(db: Database.Database, article: Article): void;
+/**
+ * Get an article by ID and source
+ */
+export declare function getArticle(db: Database.Database, id: number, sourceId: string): Article | null;
+/**
+ * Get all articles for a source
+ */
+export declare function getArticlesBySource(db: Database.Database, sourceId: string): Article[];
+/**
+ * Get articles that have been updated since last sync
+ * Returns articles from Zendesk that are newer than what we have
+ */
+export declare function getStaleArticleIds(db: Database.Database, sourceId: string, freshArticles: Array<{
+    id: number;
+    updated_at: string;
+}>): Set<number>;
+/**
+ * Delete an article and its chunks
+ */
+export declare function deleteArticle(db: Database.Database, id: number, sourceId: string): void;
+/**
+ * Delete articles that no longer exist in Zendesk
+ */
+export declare function deleteOrphanedArticles(db: Database.Database, sourceId: string, validArticleIds: number[]): void;
+//# sourceMappingURL=articles.d.ts.map

package/dist/src/db/articles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"articles.d.ts","sourceRoot":"","sources":["../../../src/db/articles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;CACjB;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAiB9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAatF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACvD,GAAG,CAAC,MAAM,CAAC,CA8Bb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIvF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EAAE,GACxB,IAAI,CAcN"}