@kernel.chat/kbot 3.35.1 → 3.37.0

package/dist/collective-learning.js

@@ -0,0 +1,315 @@
+// kbot Collective Learning — Anonymized Pattern Sharing
+//
+// The core thesis: user #1000 is smarter than user #1.
+// Every kbot contributes anonymized patterns. Every kbot benefits from all.
+//
+// What gets shared (anonymized):
+//   - Pattern type, language, framework, success rate, tool used, agent used
+//
+// What NEVER gets shared:
+//   - File paths, usernames, project names, source code, API keys
+//   - Conversation content, personal identifiers
+//
+// Privacy: device fingerprint is a one-way SHA-256 hash — not reversible.
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+const KBOT_DIR = join(homedir(), '.kbot');
+const MEMORY_DIR = join(KBOT_DIR, 'memory');
+const COLLECTIVE_DIR = join(KBOT_DIR, 'collective');
+const PATTERNS_FILE = join(MEMORY_DIR, 'patterns.json');
+const COLLECTIVE_PATTERNS_FILE = join(COLLECTIVE_DIR, 'learned-patterns.json');
+const SYNC_STATE_FILE = join(COLLECTIVE_DIR, 'learning-sync.json');
+const COLLECTIVE_URL = process.env.KBOT_COLLECTIVE_URL || 'https://kernel.chat/api/collective';
+// ── Helpers ──
+function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function loadJSON(path, fallback) {
+    try {
+        if (existsSync(path)) {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+    }
+    catch {
+        // Corrupt file — return fallback
+    }
+    return fallback;
+}
+function saveJSON(path, data) {
+    const dir = join(path, '..');
+    ensureDir(dir);
+    writeFileSync(path, JSON.stringify(data, null, 2));
+}
+function loadSyncState() {
+    return loadJSON(SYNC_STATE_FILE, {
+        lastContribute: null,
+        lastFetch: null,
+        totalContributed: 0,
+        totalGained: 0,
+    });
+}
+function saveSyncState(state) {
+    ensureDir(COLLECTIVE_DIR);
+    writeFileSync(SYNC_STATE_FILE, JSON.stringify(state, null, 2));
+}
+// ── PII Stripping ──
+/** Patterns that look like file paths, usernames, or project-specific identifiers */
+const PII_PATTERNS = [
+    /\/[Uu]sers\/[^/\s]+/g, // /Users/username
+    /\/home\/[^/\s]+/g, // /home/username
+    /[Cc]:\\[Uu]sers\\[^\\s]+/g, // C:\Users\username (Windows)
+    /~\/[^\s]+/g, // ~/path/to/something
+    /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g, // emails
+    /\b[A-Z][a-z]+(?:[A-Z][a-z]+){1,}\b/g, // CamelCase project names (heuristic)
+];
+/** Strip PII from a string — removes paths, usernames, project names */
+function stripPII(text) {
+    let cleaned = text;
+    for (const pattern of PII_PATTERNS) {
+        cleaned = cleaned.replace(pattern, '[REDACTED]');
+    }
+    return cleaned;
+}
+/** Strip PII from keywords — only keep generic tech terms */
+const SAFE_KEYWORDS = new Set([
+    'react', 'typescript', 'node', 'python', 'rust', 'go', 'docker',
+    'api', 'database', 'test', 'deploy', 'build', 'fix', 'bug', 'error',
+    'component', 'function', 'class', 'import', 'export', 'async', 'await',
+    'fetch', 'route', 'auth', 'css', 'html', 'json', 'sql', 'git', 'npm',
+    'install', 'config', 'server', 'client', 'hook', 'state', 'redux',
+    'zustand', 'supabase', 'stripe', 'vite', 'webpack', 'nextjs', 'express',
+    'fastify', 'django', 'flask', 'rails', 'spring', 'vue', 'angular',
+    'svelte', 'tailwind', 'prisma', 'drizzle', 'postgres', 'mysql', 'redis',
+    'mongodb', 'graphql', 'rest', 'websocket', 'grpc', 'terraform', 'kubernetes',
+    'aws', 'gcp', 'azure', 'vercel', 'netlify', 'cloudflare', 'deno', 'bun',
+]);
+function sanitizeKeywords(keywords) {
+    return keywords
+        .map(k => k.toLowerCase().trim())
+        .filter(k => SAFE_KEYWORDS.has(k));
+}
+/** Only keep tool names — no args or paths */
+function sanitizeToolNames(tools) {
+    return tools
+        .map(t => t.replace(/[^a-z0-9_-]/gi, '').slice(0, 50))
+        .filter(Boolean);
+}
+// ── Device Fingerprint ──
+/** Generate a non-identifiable device fingerprint for dedup.
+ *  Hashes hostname + homedir path + platform — not reversible. */
+function getDeviceFingerprint() {
+    const os = require('node:os');
+    const raw = `${os.hostname()}:${os.homedir()}:${os.platform()}:${os.arch()}`;
+    return createHash('sha256').update(raw).digest('hex').slice(0, 16);
+}
+// ── Detect Language & Framework from Keywords ──
+const LANGUAGE_MAP = {
+    typescript: 'TypeScript', javascript: 'JavaScript', python: 'Python',
+    rust: 'Rust', go: 'Go', java: 'Java', ruby: 'Ruby', php: 'PHP',
+    swift: 'Swift', kotlin: 'Kotlin', csharp: 'C#', cpp: 'C++',
+};
+const FRAMEWORK_MAP = {
+    react: 'React', nextjs: 'Next.js', vue: 'Vue', angular: 'Angular',
+    svelte: 'Svelte', express: 'Express', fastify: 'Fastify', django: 'Django',
+    flask: 'Flask', rails: 'Rails', spring: 'Spring', prisma: 'Prisma',
+    drizzle: 'Drizzle', tailwind: 'Tailwind', vite: 'Vite', webpack: 'Webpack',
+};
+function detectLanguage(keywords) {
+    for (const kw of keywords) {
+        const lang = LANGUAGE_MAP[kw.toLowerCase()];
+        if (lang)
+            return lang;
+    }
+    return null;
+}
+function detectFramework(keywords) {
+    for (const kw of keywords) {
+        const fw = FRAMEWORK_MAP[kw.toLowerCase()];
+        if (fw)
+            return fw;
+    }
+    return null;
+}
+// ── Core API ──
+/** Read ~/.kbot/memory/patterns.json, strip PII, keep only safe fields.
+ *  Returns an anonymized array suitable for sharing. */
+export function collectAnonymizedPatterns() {
+    ensureDir(MEMORY_DIR);
+    const raw = loadJSON(PATTERNS_FILE, []);
+    if (!Array.isArray(raw) || raw.length === 0)
+        return [];
+    return raw.map(p => {
+        const keywords = Array.isArray(p.keywords) ? sanitizeKeywords(p.keywords) : [];
+        const toolSequence = Array.isArray(p.toolSequence) ? sanitizeToolNames(p.toolSequence) : [];
+        const intent = typeof p.intent === 'string' ? stripPII(p.intent) : '';
+        return {
+            type: intent ? 'intent_match' : 'unknown',
+            language: detectLanguage(keywords),
+            framework: detectFramework(keywords),
+            successRate: typeof p.successRate === 'number' ? Math.round(p.successRate * 100) / 100 : 0,
+            toolsUsed: toolSequence,
+            agentUsed: typeof p.agentUsed === 'string' ? p.agentUsed : null,
+            hits: typeof p.hits === 'number' ? p.hits : 1,
+            keywords,
+        };
+    }).filter(p => p.keywords.length > 0 || p.toolsUsed.length > 0);
+}
+/** POST anonymized patterns to the collective endpoint.
+ *  Includes a device fingerprint hash for dedup (not identifiable).
+ *  Returns count of patterns contributed. */
+export async function contributePatterns() {
+    const patterns = collectAnonymizedPatterns();
+    if (patterns.length === 0)
+        return 0;
+    const fingerprint = getDeviceFingerprint();
+    try {
+        const res = await fetch(`${COLLECTIVE_URL}/contribute`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                device_fingerprint: fingerprint,
+                patterns,
+                version: '1.0.0',
+                timestamp: new Date().toISOString(),
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            if (process.env.KBOT_DEBUG) {
+                console.error(`[collective-learning] contribute failed: ${res.status}`);
+            }
+            return 0;
+        }
+        const data = await res.json();
+        return data.accepted ?? patterns.length;
+    }
+    catch (err) {
+        if (process.env.KBOT_DEBUG) {
+            console.error('[collective-learning] contribute error:', err.message);
+        }
+        return 0;
+    }
+}
+/** GET patterns from the collective endpoint.
+ *  Merges with local patterns, preferring higher-confidence entries.
+ *  Returns count of new patterns gained. */
+export async function fetchCollectivePatterns() {
+    ensureDir(COLLECTIVE_DIR);
+    try {
+        const res = await fetch(`${COLLECTIVE_URL}/patterns`, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            if (process.env.KBOT_DEBUG) {
+                console.error(`[collective-learning] fetch failed: ${res.status}`);
+            }
+            return 0;
+        }
+        const data = await res.json();
+        const remote = data.patterns;
+        if (!Array.isArray(remote) || remote.length === 0)
+            return 0;
+        // Load existing collective patterns cache
+        const existing = loadJSON(COLLECTIVE_PATTERNS_FILE, []);
+        const existingMap = new Map();
+        for (const p of existing) {
+            const key = patternKey(p);
+            existingMap.set(key, p);
+        }
+        let gained = 0;
+        for (const p of remote) {
+            const key = patternKey(p);
+            const local = existingMap.get(key);
+            if (!local) {
+                // New pattern — add it
+                existingMap.set(key, p);
+                gained++;
+            }
+            else if (p.confidence > local.confidence) {
+                // Higher confidence from collective — update
+                existingMap.set(key, p);
+                gained++;
+            }
+            // Otherwise keep local (already same or better confidence)
+        }
+        // Save merged collective patterns
+        const merged = Array.from(existingMap.values())
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, 500); // Cap at 500 patterns to keep file reasonable
+        saveJSON(COLLECTIVE_PATTERNS_FILE, merged);
+        return gained;
+    }
+    catch (err) {
+        if (process.env.KBOT_DEBUG) {
+            console.error('[collective-learning] fetch error:', err.message);
+        }
+        return 0;
+    }
+}
+/** Generate a stable key for pattern dedup */
+function patternKey(p) {
+    const parts = [
+        p.type,
+        p.language || '',
+        p.framework || '',
+        ...(p.toolsUsed || []).sort(),
+        ...(p.keywords || []).sort(),
+    ];
+    return parts.join(':').toLowerCase();
+}
+/** Orchestrate the full collective sync cycle:
+ *  collect -> contribute -> fetch -> merge.
+ *  Returns a human-readable summary. */
+export async function runCollectiveSync() {
+    const localPatterns = collectAnonymizedPatterns();
+    const localCount = localPatterns.length;
+    // Load existing collective patterns for baseline
+    const beforeCount = loadJSON(COLLECTIVE_PATTERNS_FILE, []).length;
+    // Contribute our patterns
+    const contributed = await contributePatterns();
+    // Fetch patterns from the collective
+    const gained = await fetchCollectivePatterns();
+    // Calculate "smarter" percentage: ratio of collective patterns to local
+    const afterCount = loadJSON(COLLECTIVE_PATTERNS_FILE, []).length;
+    const totalKnowledge = localCount + afterCount;
+    const smarterPct = totalKnowledge > 0
+        ? Math.round((afterCount / totalKnowledge) * 100)
+        : 0;
+    // Update sync state
+    const state = loadSyncState();
+    state.lastContribute = new Date().toISOString();
+    state.lastFetch = new Date().toISOString();
+    state.totalContributed += contributed;
+    state.totalGained += gained;
+    saveSyncState(state);
+    return [
+        `Contributed ${contributed} patterns.`,
+        `Gained ${gained} new patterns from the collective.`,
+        `kbot is now ${smarterPct}% smarter.`,
+        `(${localCount} local + ${afterCount} collective = ${totalKnowledge} total patterns)`,
+    ].join(' ');
+}
+/** Get collective learning stats for display */
+export function getCollectiveLearningStats() {
+    const state = loadSyncState();
+    const collectivePatterns = loadJSON(COLLECTIVE_PATTERNS_FILE, []);
+    const localPatterns = loadJSON(PATTERNS_FILE, []);
+    return [
+        `Collective learning:`,
+        `  Local patterns: ${localPatterns.length}`,
+        `  Collective patterns: ${collectivePatterns.length}`,
+        `  Total contributed: ${state.totalContributed}`,
+        `  Total gained: ${state.totalGained}`,
+        `  Last sync: ${state.lastFetch || 'never'}`,
+    ].join('\n');
+}
+/** Load cached collective patterns for use by the routing/agent system */
+export function getCachedCollectivePatterns() {
+    return loadJSON(COLLECTIVE_PATTERNS_FILE, []);
+}
+//# sourceMappingURL=collective-learning.js.map

package/dist/collective-learning.js.map

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

package/dist/community-manager.d.ts

@@ -0,0 +1,60 @@
+export interface CommunityConfig {
+    /** Discord webhook URL for posting digests/notifications */
+    discord_webhook?: string;
+    /** GitHub repo in "owner/repo" format */
+    github_repo: string;
+    /** Email addresses for digest distribution */
+    email_list?: string[];
+}
+export interface FAQEntry {
+    question: string;
+    answer: string;
+    keywords: string[];
+}
+export interface TriageResult {
+    issue: number;
+    title: string;
+    label: string;
+    response: string;
+    url: string;
+}
+export interface CommunityDigest {
+    generatedAt: string;
+    repo: string;
+    openIssues: number;
+    openPRs: number;
+    newIssuesThisWeek: number;
+    newPRsThisWeek: number;
+    mergedPRsThisWeek: number;
+    stargazers: number;
+    npmDownloadsWeekly: number;
+    newContributors: string[];
+    markdown: string;
+}
+/**
+ * Fuzzy-match a question against the FAQ knowledge base.
+ * Returns the best matching answer or a polite fallback.
+ */
+export declare function answerFAQ(question: string): string;
+/**
+ * Generate a personalized welcome message for a new contributor.
+ */
+export declare function welcomeContributor(username: string, platform: 'github' | 'discord' | 'email'): string;
+/**
+ * Generate a formatted community digest from GitHub and npm data.
+ */
+export declare function generateDigest(repo?: string): Promise<string>;
+/**
+ * Run the community manager cycle.
+ *
+ * - Checks GitHub for new issues/PRs and triages them
+ * - Generates a daily community digest
+ * - Welcomes new contributors
+ * - Answers common questions from FAQ
+ */
+export declare function runCommunityManager(config: CommunityConfig): Promise<{
+    triaged: TriageResult[];
+    digest: string;
+    welcomed: string[];
+}>;
+//# sourceMappingURL=community-manager.d.ts.map

package/dist/community-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community-manager.d.ts","sourceRoot":"","sources":["../src/community-manager.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AA+BD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAkID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8ClD;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAQrG;AAID;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2HnE;AAyBD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAC1E,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAC,CAgHD"}