@kernel.chat/kbot 3.40.0 → 3.42.0

package/dist/memory-hotswap.js

@@ -0,0 +1,288 @@
+// kbot Memory Hot-Swap — Swap learning modules at runtime
+//
+// Load different expertise profiles for different projects
+// without restarting kbot. Profiles contain patterns, solutions,
+// user profile, and routing data.
+//
+// Stored at ~/.kbot/memory-profiles/{name}/
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, cpSync, rmSync, statSync, } from 'node:fs';
+const KBOT_DIR = join(homedir(), '.kbot');
+const MEMORY_DIR = join(KBOT_DIR, 'memory');
+const PROFILES_DIR = join(KBOT_DIR, 'memory-profiles');
+const ACTIVE_PROFILE_FILE = join(MEMORY_DIR, 'active-profile.json');
+const BACKUP_NAME = '_backup';
+/** Files that constitute a memory profile */
+const PROFILE_FILES = [
+    'patterns.json',
+    'solutions.json',
+    'profile.json',
+    'routing-history.json',
+    'knowledge.json',
+    'corrections.json',
+    'context.md',
+];
+function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function ensureProfilesDir() {
+    ensureDir(PROFILES_DIR);
+}
+function ensureMemoryDir() {
+    ensureDir(MEMORY_DIR);
+}
+function profileDir(name) {
+    return join(PROFILES_DIR, name);
+}
+function loadJSON(path, fallback) {
+    if (!existsSync(path))
+        return fallback;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+function countPatterns(dir) {
+    const patternsPath = join(dir, 'patterns.json');
+    const patterns = loadJSON(patternsPath, []);
+    return Array.isArray(patterns) ? patterns.length : 0;
+}
+/** Copy memory files from source directory to target directory */
+function copyMemoryFiles(sourceDir, targetDir) {
+    ensureDir(targetDir);
+    let copied = 0;
+    for (const file of PROFILE_FILES) {
+        const src = join(sourceDir, file);
+        if (existsSync(src)) {
+            cpSync(src, join(targetDir, file));
+            copied++;
+        }
+    }
+    return copied;
+}
+/**
+ * Scan ~/.kbot/memory-profiles/ for saved profiles.
+ * Returns array of profile metadata.
+ */
+export function listMemoryProfiles() {
+    ensureProfilesDir();
+    const entries = readdirSync(PROFILES_DIR, { withFileTypes: true });
+    const profiles = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        // Skip the internal backup directory
+        if (entry.name === BACKUP_NAME)
+            continue;
+        const dir = profileDir(entry.name);
+        const metaPath = join(dir, 'metadata.json');
+        const meta = loadJSON(metaPath, {
+            name: entry.name,
+            description: '',
+            expertise: '',
+            created_at: '',
+            updated_at: '',
+        });
+        // If no created_at in metadata, use directory stat
+        let createdAt = meta.created_at;
+        if (!createdAt) {
+            try {
+                const stat = statSync(dir);
+                createdAt = stat.birthtime.toISOString();
+            }
+            catch {
+                createdAt = new Date().toISOString();
+            }
+        }
+        profiles.push({
+            name: meta.name || entry.name,
+            description: meta.description || '',
+            patterns_count: countPatterns(dir),
+            created_at: createdAt,
+        });
+    }
+    return profiles.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+}
+/**
+ * Snapshot current ~/.kbot/memory/ into a named profile.
+ * Saves all learning data (patterns, solutions, profile, routing).
+ */
+export function saveCurrentAsProfile(name, description) {
+    ensureMemoryDir();
+    ensureProfilesDir();
+    const sanitized = name.toLowerCase().replace(/[^a-z0-9_-]/g, '-').slice(0, 60);
+    const targetDir = profileDir(sanitized);
+    // Copy current memory files into the profile directory
+    copyMemoryFiles(MEMORY_DIR, targetDir);
+    // Count patterns in the snapshot
+    const patternsCount = countPatterns(targetDir);
+    // Write metadata
+    const meta = {
+        name: sanitized,
+        description: description || `Profile snapshot of ${name}`,
+        expertise: '',
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    writeFileSync(join(targetDir, 'metadata.json'), JSON.stringify(meta, null, 2));
+    return { name: sanitized, patterns_saved: patternsCount };
+}
+/**
+ * Load a named profile into ~/.kbot/memory/.
+ * Backs up current memory to _backup first.
+ */
+export function loadProfile(name) {
+    ensureProfilesDir();
+    ensureMemoryDir();
+    const sanitized = name.toLowerCase().replace(/[^a-z0-9_-]/g, '-').slice(0, 60);
+    const sourceDir = profileDir(sanitized);
+    if (!existsSync(sourceDir)) {
+        throw new Error(`Profile "${sanitized}" not found in ${PROFILES_DIR}`);
+    }
+    // Backup current memory
+    const backupDir = profileDir(BACKUP_NAME);
+    copyMemoryFiles(MEMORY_DIR, backupDir);
+    // Write backup metadata
+    const backupMeta = {
+        name: BACKUP_NAME,
+        description: 'Auto-backup before profile load',
+        expertise: '',
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    writeFileSync(join(backupDir, 'metadata.json'), JSON.stringify(backupMeta, null, 2));
+    // Copy profile files into memory directory
+    copyMemoryFiles(sourceDir, MEMORY_DIR);
+    const patternsLoaded = countPatterns(MEMORY_DIR);
+    // Mark the active profile
+    const marker = {
+        name: sanitized,
+        loaded_at: new Date().toISOString(),
+        previous_backup: BACKUP_NAME,
+    };
+    writeFileSync(ACTIVE_PROFILE_FILE, JSON.stringify(marker, null, 2));
+    return {
+        name: sanitized,
+        patterns_loaded: patternsLoaded,
+        previous_backup: BACKUP_NAME,
+    };
+}
+/**
+ * Unload the current profile, restoring from _backup.
+ * Returns to the previous state before loadProfile was called.
+ */
+export function unloadProfile() {
+    ensureMemoryDir();
+    ensureProfilesDir();
+    const active = getActiveProfile();
+    if (!active) {
+        return { restored: false, previous_profile: null };
+    }
+    const backupDir = profileDir(BACKUP_NAME);
+    if (!existsSync(backupDir)) {
+        throw new Error('No backup found. Cannot unload profile without a previous backup.');
+    }
+    const previousName = active.name;
+    // Restore backup into memory
+    copyMemoryFiles(backupDir, MEMORY_DIR);
+    // Remove the active profile marker
+    if (existsSync(ACTIVE_PROFILE_FILE)) {
+        rmSync(ACTIVE_PROFILE_FILE);
+    }
+    // Clean up backup
+    rmSync(backupDir, { recursive: true, force: true });
+    return { restored: true, previous_profile: previousName };
+}
+/**
+ * Create a new empty profile with metadata.
+ * Seeds initial routing preferences based on expertise string.
+ */
+export function createProfile(name, description, expertise) {
+    ensureProfilesDir();
+    const sanitized = name.toLowerCase().replace(/[^a-z0-9_-]/g, '-').slice(0, 60);
+    const targetDir = profileDir(sanitized);
+    if (existsSync(targetDir)) {
+        throw new Error(`Profile "${sanitized}" already exists`);
+    }
+    ensureDir(targetDir);
+    // Write metadata
+    const meta = {
+        name: sanitized,
+        description,
+        expertise,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+    writeFileSync(join(targetDir, 'metadata.json'), JSON.stringify(meta, null, 2));
+    // Seed empty patterns and solutions
+    writeFileSync(join(targetDir, 'patterns.json'), JSON.stringify([], null, 2));
+    writeFileSync(join(targetDir, 'solutions.json'), JSON.stringify([], null, 2));
+    // Seed routing preferences based on expertise
+    const routingPrefs = buildRoutingPreferences(expertise);
+    writeFileSync(join(targetDir, 'routing-history.json'), JSON.stringify(routingPrefs, null, 2));
+    // Seed profile with expertise info
+    const userProfile = {
+        expertise,
+        preferred_languages: [expertise],
+        created_at: new Date().toISOString(),
+    };
+    writeFileSync(join(targetDir, 'profile.json'), JSON.stringify(userProfile, null, 2));
+    return { name: sanitized, created: true };
+}
+/**
+ * Returns which profile is currently loaded.
+ * Reads ~/.kbot/memory/active-profile.json.
+ */
+export function getActiveProfile() {
+    ensureMemoryDir();
+    if (!existsSync(ACTIVE_PROFILE_FILE))
+        return null;
+    try {
+        return JSON.parse(readFileSync(ACTIVE_PROFILE_FILE, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Build initial routing preferences from an expertise keyword */
+function buildRoutingPreferences(expertise) {
+    const agentMap = {
+        python: 'coder',
+        react: 'coder',
+        typescript: 'coder',
+        rust: 'coder',
+        go: 'coder',
+        java: 'coder',
+        swift: 'coder',
+        ruby: 'coder',
+        devops: 'infrastructure',
+        docker: 'infrastructure',
+        terraform: 'infrastructure',
+        kubernetes: 'infrastructure',
+        security: 'guardian',
+        design: 'aesthete',
+        writing: 'writer',
+        research: 'researcher',
+        data: 'quant',
+        trading: 'quant',
+        strategy: 'strategist',
+    };
+    const agent = agentMap[expertise.toLowerCase()] || 'coder';
+    const now = new Date().toISOString();
+    return [
+        {
+            intent: expertise.toLowerCase(),
+            keywords: [expertise.toLowerCase()],
+            agent,
+            method: 'category',
+            success: true,
+            count: 1,
+            lastUsed: now,
+        },
+    ];
+}
+//# sourceMappingURL=memory-hotswap.js.map

package/dist/memory-hotswap.js.map

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

package/dist/personal-security.d.ts

@@ -0,0 +1,142 @@
+export type Severity = 'critical' | 'high' | 'medium' | 'low';
+export interface SecurityFinding {
+    category: string;
+    title: string;
+    severity: Severity;
+    description: string;
+    remediation: string;
+    location?: string;
+}
+export interface SecurityReport {
+    timestamp: string;
+    score: number;
+    findings: SecurityFinding[];
+    criticalCount: number;
+    highCount: number;
+    mediumCount: number;
+    lowCount: number;
+    goodPractices: string[];
+    summary: string;
+}
+export interface BreachResult {
+    email: string;
+    breached: boolean;
+    breachCount: number;
+    breaches: Array<{
+        name: string;
+        domain: string;
+        breachDate: string;
+        dataClasses: string[];
+    }>;
+}
+export interface MonitorEvent {
+    timestamp: string;
+    path: string;
+    eventType: string;
+    filename: string | null;
+}
+export interface ScanHistoryEntry {
+    timestamp: string;
+    score: number;
+    criticalCount: number;
+    highCount: number;
+    mediumCount: number;
+    lowCount: number;
+    totalFindings: number;
+}
+export interface SecretFinding {
+    file: string;
+    line: number;
+    type: string;
+    preview: string;
+}
+/**
+ * Recursively scan a directory for leaked secrets (API keys, tokens, passwords).
+ * NEVER reads or displays actual secret values.
+ */
+export declare function scanForSecrets(scanPath?: string): SecretFinding[];
+export interface SSHAudit {
+    findings: SecurityFinding[];
+    keysFound: Array<{
+        name: string;
+        type: string;
+        hasPassphrase: boolean | null;
+    }>;
+    authorizedKeysCount: number;
+    configIssues: string[];
+}
+/**
+ * Audit SSH configuration and keys.
+ * Checks for password-protected keys, authorized_keys cleanliness, and config issues.
+ */
+export declare function checkSSHSecurity(): SSHAudit;
+export interface PortResult {
+    port: number;
+    service: string;
+    open: boolean;
+}
+/**
+ * Scan common ports on localhost to check for exposed services.
+ * Uses TCP connect probes via the net module.
+ */
+export declare function checkPortExposure(): Promise<{
+    ports: PortResult[];
+    findings: SecurityFinding[];
+}>;
+export interface PermissionCheck {
+    path: string;
+    exists: boolean;
+    mode: string | null;
+    isWorldReadable: boolean;
+    isWorldWritable: boolean;
+    finding: SecurityFinding | null;
+}
+/**
+ * Verify that sensitive files and directories are not world-readable or world-writable.
+ */
+export declare function checkFilePermissions(paths?: string[]): PermissionCheck[];
+export interface ScanOptions {
+    /** Directory to scan for secrets (default: cwd) */
+    secretsScanPath?: string;
+    /** Skip port scanning */
+    skipPorts?: boolean;
+    /** Skip npm global check */
+    skipNpm?: boolean;
+    /** Skip browser data check */
+    skipBrowser?: boolean;
+}
+/**
+ * Full personal security audit.
+ * Checks: secrets, SSH, permissions, ports, firewall, git, browser, npm globals.
+ */
+export declare function runSecurityScan(options?: ScanOptions): Promise<SecurityReport>;
+/**
+ * Watch sensitive directories for unexpected changes.
+ * Logs all change events to ~/.kbot/security/monitor-log.jsonl.
+ * Returns a dispose function to stop watching.
+ */
+export declare function monitorFileChanges(paths?: string[]): {
+    dispose: () => void;
+};
+/**
+ * Check if email addresses appear in known data breaches using the Have I Been Pwned API.
+ * Uses the free, public, unauthenticated breach search endpoint.
+ */
+export declare function checkBreachedEmails(emails: string[]): Promise<BreachResult[]>;
+/**
+ * Run a full scan and format it into a human-readable report.
+ */
+export declare function generateSecurityReport(options?: ScanOptions): Promise<string>;
+/**
+ * Set up recurring security scans.
+ * Results saved to ~/.kbot/security/scan-history.json.
+ * Sends Discord webhook alert if critical findings detected.
+ */
+export declare function scheduleSecurityScan(intervalHours: number, discordWebhookUrl?: string): {
+    stop: () => void;
+};
+/**
+ * Get the scan history for trend analysis.
+ */
+export declare function getScanHistory(limit?: number): ScanHistoryEntry[];
+//# sourceMappingURL=personal-security.d.ts.map

package/dist/personal-security.d.ts.map

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