bernard-agent 0.4.0 → 0.5.0

package/dist/cron/store.d.ts

@@ -1,20 +1,52 @@
 import type { CronJob, CronAlert } from './types.js';
+/**
+ * Disk-backed store for cron jobs and alerts.
+ *
+ * Jobs are persisted as a single `jobs.json` array; alerts are individual
+ * JSON files inside `alerts/`. All writes use atomic rename to prevent
+ * partial-read corruption when the daemon `fs.watch`es for changes.
+ */
 export declare class CronStore {
+    /** Ensures the cron and alerts directories and `jobs.json` exist on disk. */
     constructor();
+    /** Absolute path to the cron data directory. */
     static get cronDir(): string;
+    /** Absolute path to the cron jobs file. */
     static get jobsFile(): string;
+    /** Absolute path to the cron alerts directory. */
     static get alertsDir(): string;
+    /** Absolute path to the daemon PID file. */
     static get pidFile(): string;
+    /** Absolute path to the daemon log file. */
     static get logFile(): string;
+    /** Reads and parses all jobs from `jobs.json`, returning an empty array on missing or corrupt file. */
     loadJobs(): CronJob[];
+    /** Atomically writes the full jobs array to `jobs.json`. */
     saveJobs(jobs: CronJob[]): void;
+    /** Returns a single job by ID, or `undefined` if not found. */
     getJob(id: string): CronJob | undefined;
+    /**
+     * Creates a new cron job and persists it.
+     *
+     * @throws {Error} If the maximum number of jobs ({@link MAX_JOBS}) has been reached.
+     */
     createJob(name: string, schedule: string, prompt: string): CronJob;
+    /**
+     * Applies partial updates to an existing job and persists the result.
+     *
+     * @returns The updated job, or `undefined` if the ID was not found.
+     */
     updateJob(id: string, updates: Partial<Pick<CronJob, 'name' | 'schedule' | 'prompt' | 'enabled' | 'lastRun' | 'lastRunStatus' | 'lastResult'>>): CronJob | undefined;
+    /** Removes a job by ID. Returns `true` if the job existed and was deleted. */
     deleteJob(id: string): boolean;
+    /** Creates a new alert file in the alerts directory with auto-generated ID and timestamp. */
     createAlert(alert: Omit<CronAlert, 'id' | 'timestamp' | 'acknowledged'>): CronAlert;
+    /** Returns a single alert by ID, or `undefined` if not found or corrupt. */
     getAlert(id: string): CronAlert | undefined;
+    /** Returns all alerts sorted newest-first, skipping any corrupt files. */
     listAlerts(): CronAlert[];
+    /** Marks an alert as acknowledged. Returns `false` if the alert was not found. */
     acknowledgeAlert(id: string): boolean;
+    /** Writes data to a `.tmp` file then renames it into place for crash-safe persistence. */
     private atomicWrite;
 }

package/dist/cron/store.js

@@ -36,44 +36,53 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CronStore = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const os = __importStar(require("node:os"));
 const crypto = __importStar(require("node:crypto"));
-const CRON_DIR = path.join(os.homedir(), '.bernard', 'cron');
-const JOBS_FILE = path.join(CRON_DIR, 'jobs.json');
-const ALERTS_DIR = path.join(CRON_DIR, 'alerts');
-const PID_FILE = path.join(CRON_DIR, 'daemon.pid');
-const LOG_FILE = path.join(CRON_DIR, 'daemon.log');
+const paths_js_1 = require("../paths.js");
 const MAX_JOBS = 50;
+/**
+ * Disk-backed store for cron jobs and alerts.
+ *
+ * Jobs are persisted as a single `jobs.json` array; alerts are individual
+ * JSON files inside `alerts/`. All writes use atomic rename to prevent
+ * partial-read corruption when the daemon `fs.watch`es for changes.
+ */
 class CronStore {
+    /** Ensures the cron and alerts directories and `jobs.json` exist on disk. */
     constructor() {
-        fs.mkdirSync(CRON_DIR, { recursive: true });
-        fs.mkdirSync(ALERTS_DIR, { recursive: true });
+        fs.mkdirSync(paths_js_1.CRON_DIR, { recursive: true });
+        fs.mkdirSync(paths_js_1.CRON_ALERTS_DIR, { recursive: true });
         // Ensure jobs.json exists so daemon can fs.watch it
-        if (!fs.existsSync(JOBS_FILE)) {
-            this.atomicWrite(JOBS_FILE, '[]');
+        if (!fs.existsSync(paths_js_1.CRON_JOBS_FILE)) {
+            this.atomicWrite(paths_js_1.CRON_JOBS_FILE, '[]');
         }
     }
     // --- Paths ---
+    /** Absolute path to the cron data directory. */
     static get cronDir() {
-        return CRON_DIR;
+        return paths_js_1.CRON_DIR;
     }
+    /** Absolute path to the cron jobs file. */
     static get jobsFile() {
-        return JOBS_FILE;
+        return paths_js_1.CRON_JOBS_FILE;
     }
+    /** Absolute path to the cron alerts directory. */
     static get alertsDir() {
-        return ALERTS_DIR;
+        return paths_js_1.CRON_ALERTS_DIR;
     }
+    /** Absolute path to the daemon PID file. */
     static get pidFile() {
-        return PID_FILE;
+        return paths_js_1.CRON_PID_FILE;
     }
+    /** Absolute path to the daemon log file. */
     static get logFile() {
-        return LOG_FILE;
+        return paths_js_1.CRON_LOG_FILE;
     }
     // --- Jobs ---
+    /** Reads and parses all jobs from `jobs.json`, returning an empty array on missing or corrupt file. */
     loadJobs() {
-        if (!fs.existsSync(JOBS_FILE))
+        if (!fs.existsSync(paths_js_1.CRON_JOBS_FILE))
             return [];
-        const raw = fs.readFileSync(JOBS_FILE, 'utf-8');
+        const raw = fs.readFileSync(paths_js_1.CRON_JOBS_FILE, 'utf-8');
         try {
             return JSON.parse(raw);
         }
@@ -81,12 +90,19 @@ class CronStore {
             return [];
         }
     }
+    /** Atomically writes the full jobs array to `jobs.json`. */
     saveJobs(jobs) {
-        this.atomicWrite(JOBS_FILE, JSON.stringify(jobs, null, 2));
+        this.atomicWrite(paths_js_1.CRON_JOBS_FILE, JSON.stringify(jobs, null, 2));
     }
+    /** Returns a single job by ID, or `undefined` if not found. */
     getJob(id) {
         return this.loadJobs().find((j) => j.id === id);
     }
+    /**
+     * Creates a new cron job and persists it.
+     *
+     * @throws {Error} If the maximum number of jobs ({@link MAX_JOBS}) has been reached.
+     */
     createJob(name, schedule, prompt) {
         const jobs = this.loadJobs();
         if (jobs.length >= MAX_JOBS) {
@@ -104,6 +120,11 @@ class CronStore {
         this.saveJobs(jobs);
         return job;
     }
+    /**
+     * Applies partial updates to an existing job and persists the result.
+     *
+     * @returns The updated job, or `undefined` if the ID was not found.
+     */
     updateJob(id, updates) {
         const jobs = this.loadJobs();
         const idx = jobs.findIndex((j) => j.id === id);
@@ -113,6 +134,7 @@ class CronStore {
         this.saveJobs(jobs);
         return jobs[idx];
     }
+    /** Removes a job by ID. Returns `true` if the job existed and was deleted. */
     deleteJob(id) {
         const jobs = this.loadJobs();
         const filtered = jobs.filter((j) => j.id !== id);
@@ -122,6 +144,7 @@ class CronStore {
         return true;
     }
     // --- Alerts ---
+    /** Creates a new alert file in the alerts directory with auto-generated ID and timestamp. */
     createAlert(alert) {
         const full = {
             ...alert,
@@ -129,12 +152,13 @@ class CronStore {
             timestamp: new Date().toISOString(),
             acknowledged: false,
         };
-        const filePath = path.join(ALERTS_DIR, `${full.id}.json`);
+        const filePath = path.join(paths_js_1.CRON_ALERTS_DIR, `${full.id}.json`);
         this.atomicWrite(filePath, JSON.stringify(full, null, 2));
         return full;
     }
+    /** Returns a single alert by ID, or `undefined` if not found or corrupt. */
     getAlert(id) {
-        const filePath = path.join(ALERTS_DIR, `${id}.json`);
+        const filePath = path.join(paths_js_1.CRON_ALERTS_DIR, `${id}.json`);
         if (!fs.existsSync(filePath))
             return undefined;
         try {
@@ -144,14 +168,15 @@ class CronStore {
             return undefined;
         }
     }
+    /** Returns all alerts sorted newest-first, skipping any corrupt files. */
     listAlerts() {
-        if (!fs.existsSync(ALERTS_DIR))
+        if (!fs.existsSync(paths_js_1.CRON_ALERTS_DIR))
             return [];
-        const files = fs.readdirSync(ALERTS_DIR).filter((f) => f.endsWith('.json'));
+        const files = fs.readdirSync(paths_js_1.CRON_ALERTS_DIR).filter((f) => f.endsWith('.json'));
         const alerts = [];
         for (const file of files) {
             try {
-                const raw = fs.readFileSync(path.join(ALERTS_DIR, file), 'utf-8');
+                const raw = fs.readFileSync(path.join(paths_js_1.CRON_ALERTS_DIR, file), 'utf-8');
                 alerts.push(JSON.parse(raw));
             }
             catch {
@@ -160,16 +185,18 @@ class CronStore {
         }
         return alerts.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
     }
+    /** Marks an alert as acknowledged. Returns `false` if the alert was not found. */
     acknowledgeAlert(id) {
         const alert = this.getAlert(id);
         if (!alert)
             return false;
         alert.acknowledged = true;
-        const filePath = path.join(ALERTS_DIR, `${id}.json`);
+        const filePath = path.join(paths_js_1.CRON_ALERTS_DIR, `${id}.json`);
         this.atomicWrite(filePath, JSON.stringify(alert, null, 2));
         return true;
     }
     // --- Utility ---
+    /** Writes data to a `.tmp` file then renames it into place for crash-safe persistence. */
     atomicWrite(filePath, data) {
         const tmp = filePath + '.tmp';
         fs.writeFileSync(tmp, data, 'utf-8');

package/dist/cron/store.js.map

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

package/dist/cron/types.d.ts

@@ -1,21 +1,40 @@
+/** A recurring task that Bernard executes on a cron schedule. */
 export interface CronJob {
+    /** Unique identifier (UUID). */
     id: string;
+    /** Human-readable label for the job. */
     name: string;
+    /** Cron expression (e.g. "0 * * * *") defining when the job runs. */
     schedule: string;
+    /** The prompt sent to the agent when the job fires. */
     prompt: string;
+    /** Whether the job is active; disabled jobs are skipped by the scheduler. */
     enabled: boolean;
+    /** ISO-8601 timestamp of when the job was created. */
     createdAt: string;
+    /** ISO-8601 timestamp of the most recent execution, if any. */
     lastRun?: string;
+    /** Outcome of the most recent execution. */
     lastRunStatus?: 'success' | 'error' | 'running';
+    /** Truncated agent response from the most recent execution. */
     lastResult?: string;
 }
+/** A notification generated when a cron job completes and produces output. */
 export interface CronAlert {
+    /** Unique identifier (UUID). */
     id: string;
+    /** ID of the {@link CronJob} that triggered this alert. */
     jobId: string;
+    /** Snapshot of the job's name at the time the alert was created. */
     jobName: string;
+    /** Short summary of what happened. */
     message: string;
+    /** ISO-8601 timestamp of when the alert was created. */
     timestamp: string;
+    /** The prompt that was executed. */
     prompt: string;
+    /** Full agent response text. */
     response: string;
+    /** Whether the user has dismissed this alert. */
     acknowledged: boolean;
 }

package/dist/domains.d.ts

@@ -1,10 +1,25 @@
+/**
+ * Describes a RAG memory domain — a category of facts with its own extraction prompt.
+ */
 export interface MemoryDomain {
+    /** Unique identifier used as the storage key (e.g. `"tool-usage"`). */
     id: string;
+    /** Human-readable display name shown in `/rag` and `/facts` output. */
     name: string;
+    /** Short summary of what facts this domain captures. */
     description: string;
+    /** Full LLM system prompt used to extract facts for this domain from a conversation. */
     extractionPrompt: string;
 }
+/** Domain ID used as the fallback when a requested domain is not found in the registry. */
 export declare const DEFAULT_DOMAIN = "general";
+/** Registry of all known memory domains, keyed by domain ID. */
 export declare const DOMAIN_REGISTRY: Record<string, MemoryDomain>;
+/** Return the IDs of all registered memory domains. */
 export declare function getDomainIds(): string[];
+/**
+ * Look up a memory domain by ID, falling back to `DEFAULT_DOMAIN` if not found.
+ * @param id - Domain identifier to look up.
+ * @returns The matching {@link MemoryDomain}, or the `general` domain if `id` is unknown.
+ */
 export declare function getDomain(id: string): MemoryDomain;

package/dist/domains.js

@@ -3,13 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DOMAIN_REGISTRY = exports.DEFAULT_DOMAIN = void 0;
 exports.getDomainIds = getDomainIds;
 exports.getDomain = getDomain;
+/** Domain ID used as the fallback when a requested domain is not found in the registry. */
 exports.DEFAULT_DOMAIN = 'general';
+/** Shared preamble describing the serialized tool interaction formats found in conversations. */
+const TOOL_FORMAT_PREAMBLE = `
+The conversation may contain serialized tool interactions in these formats:
+- "Assistant [tool call]: toolName(args)" — an AI assistant invoking a tool
+- "Tool [name]: result" — the tool's response/output`;
+/** Registry of all known memory domains, keyed by domain ID. */
 exports.DOMAIN_REGISTRY = {
     'tool-usage': {
         id: 'tool-usage',
         name: 'Tool Usage Patterns',
         description: 'Command sequences, tool interaction patterns, error resolutions, build/deploy workflows',
         extractionPrompt: `You are a tool-usage pattern extractor. Extract durable, reusable facts about how tools, commands, and workflows are used in the conversation below. Focus on lessons learned and patterns that would be useful in future sessions.
+${TOOL_FORMAT_PREAMBLE}
+Use tool call/result pairs as primary evidence for command sequences, error resolutions, and workflow patterns.
 
 Extract:
 - Shell command sequences and pipelines that accomplished a task
@@ -45,6 +54,8 @@ Return a JSON array of strings. Each string should be a self-contained fact (und
         name: 'User Preferences',
         description: 'Communication style, workflow conventions, repeated instructions, naming preferences',
         extractionPrompt: `You are a user preference extractor. Extract durable, long-term facts about the user's preferences, habits, and conventions from the conversation below. Only extract preferences that would apply across multiple sessions and tasks.
+${TOOL_FORMAT_PREAMBLE}
+Tool outputs may reveal user preferences such as preferred editors, package managers, shell configurations, and workflow habits.
 
 Extract:
 - Communication style preferences (verbosity, tone, format)
@@ -78,6 +89,8 @@ Return a JSON array of strings. Each string should be a self-contained fact (und
         name: 'General Knowledge',
         description: 'Project structure, architecture decisions, environment info, team context',
         extractionPrompt: `You are a general knowledge extractor. Extract durable, long-term facts about the project, environment, people, and context from the conversation below. Focus on knowledge that remains true across sessions — not ephemeral task state.
+${TOOL_FORMAT_PREAMBLE}
+Tool results may contain project structure, environment details, configuration values, and other durable facts worth extracting.
 
 Extract:
 - Project structure, architecture, and design decisions
@@ -109,9 +122,15 @@ Examples:
 Return a JSON array of strings. Each string should be a self-contained fact (understandable without the original conversation). Maximum 500 characters per fact. If there are no notable facts, return an empty array [].`,
     },
 };
+/** Return the IDs of all registered memory domains. */
 function getDomainIds() {
     return Object.keys(exports.DOMAIN_REGISTRY);
 }
+/**
+ * Look up a memory domain by ID, falling back to `DEFAULT_DOMAIN` if not found.
+ * @param id - Domain identifier to look up.
+ * @returns The matching {@link MemoryDomain}, or the `general` domain if `id` is unknown.
+ */
 function getDomain(id) {
     return exports.DOMAIN_REGISTRY[id] ?? exports.DOMAIN_REGISTRY[exports.DEFAULT_DOMAIN];
 }

package/dist/domains.js.map

@@ -1 +1 @@
-{"version":3,"file":"domains.js","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":";;;AAuHA,oCAEC;AAED,8BAEC;AAtHY,QAAA,cAAc,GAAG,SAAS,CAAC;AAE3B,QAAA,eAAe,GAAiC;IAC3D,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,yFAAyF;QAC3F,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA6BoM;KACvN;IAED,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,sFAAsF;QACxF,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA2BoM;KACvN;IAED,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,2EAA2E;QACxF,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA6BoM;KACvN;CACF,CAAC;AAEF,SAAgB,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,SAAS,CAAC,EAAU;IAClC,OAAO,uBAAe,CAAC,EAAE,CAAC,IAAI,uBAAe,CAAC,sBAAc,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":";;;AA6IA,oCAEC;AAOD,8BAEC;AA1ID,2FAA2F;AAC9E,QAAA,cAAc,GAAG,SAAS,CAAC;AAExC,iGAAiG;AACjG,MAAM,oBAAoB,GAAG;;;qDAGwB,CAAC;AAEtD,gEAAgE;AACnD,QAAA,eAAe,GAAiC;IAC3D,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,yFAAyF;QAC3F,gBAAgB,EAAE;EACpB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA8BoM;KACvN;IAED,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,sFAAsF;QACxF,gBAAgB,EAAE;EACpB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA4BoM;KACvN;IAED,OAAO,EAAE;QACP,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,2EAA2E;QACxF,gBAAgB,EAAE;EACpB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0NA8BoM;KACvN;CACF,CAAC;AAEF,uDAAuD;AACvD,SAAgB,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,EAAU;IAClC,OAAO,uBAAe,CAAC,EAAE,CAAC,IAAI,uBAAe,CAAC,sBAAc,CAAC,CAAC;AAChE,CAAC"}

package/dist/embeddings.d.ts

@@ -1,5 +1,8 @@
+/** Abstraction over a text embedding model used by the RAG subsystem. */
 export interface EmbeddingProvider {
+    /** Compute embedding vectors for one or more text strings. */
     embed(texts: string[]): Promise<number[][]>;
+    /** Return the dimensionality of the embedding vectors produced by this provider. */
     dimensions(): number;
 }
 /**
@@ -10,5 +13,8 @@ export interface EmbeddingProvider {
 export declare function getEmbeddingProvider(): Promise<EmbeddingProvider | null>;
 /** Cosine similarity between two vectors. Returns 0 for zero-length vectors. */
 export declare function cosineSimilarity(a: number[], b: number[]): number;
-/** Reset cached provider — for testing only. */
+/**
+ * Reset cached provider — for testing only.
+ * @internal
+ */
 export declare function _resetEmbeddingProvider(): void;

package/dist/embeddings.js

@@ -1,9 +1,44 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEmbeddingProvider = getEmbeddingProvider;
 exports.cosineSimilarity = cosineSimilarity;
 exports._resetEmbeddingProvider = _resetEmbeddingProvider;
+const fs = __importStar(require("node:fs"));
 const logger_js_1 = require("./logger.js");
+const paths_js_1 = require("./paths.js");
 let cachedProvider;
 /**
  * Lazily load fastembed and return an EmbeddingProvider.
@@ -15,8 +50,12 @@ async function getEmbeddingProvider() {
         return cachedProvider;
     try {
         const { EmbeddingModel, FlagEmbedding } = await import('fastembed');
+        fs.mkdirSync(paths_js_1.MODELS_DIR, { recursive: true });
+        (0, logger_js_1.debugLog)('embeddings:init', 'Loading embedding model (may download on first run)...');
         const model = await FlagEmbedding.init({
             model: EmbeddingModel.AllMiniLML6V2,
+            cacheDir: paths_js_1.MODELS_DIR,
+            showDownloadProgress: false,
         });
         cachedProvider = {
             async embed(texts) {
@@ -54,7 +93,10 @@ function cosineSimilarity(a, b) {
         return 0;
     return dot / (Math.sqrt(normA) * Math.sqrt(normB));
 }
-/** Reset cached provider — for testing only. */
+/**
+ * Reset cached provider — for testing only.
+ * @internal
+ */
 function _resetEmbeddingProvider() {
     cachedProvider = undefined;
 }

package/dist/embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":";;AAcA,oDA+BC;AAGD,4CAeC;AAGD,0DAEC;AApED,2CAAuC;AAOvC,IAAI,cAAoD,CAAC;AAEzD;;;;GAIG;AACI,KAAK,UAAU,oBAAoB;IACxC,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC;YACrC,KAAK,EAAE,cAAc,CAAC,aAAa;SACpC,CAAC,CAAC;QAEH,cAAc,GAAG;YACf,KAAK,CAAC,KAAK,CAAC,KAAe;gBACzB,MAAM,OAAO,GAAe,EAAE,CAAC;gBAC/B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,UAAU;gBACR,OAAO,GAAG,CAAC;YACb,CAAC;SACF,CAAC;QAEF,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,oBAAQ,EACN,iBAAiB,EACjB,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;QACF,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,gDAAgD;AAChD,SAAgB,uBAAuB;IACrC,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,oDAmCC;AAGD,4CAeC;AAMD,0DAEC;AAhFD,4CAA8B;AAC9B,2CAAuC;AACvC,yCAAwC;AAUxC,IAAI,cAAoD,CAAC;AAEzD;;;;GAIG;AACI,KAAK,UAAU,oBAAoB;IACxC,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACpE,EAAE,CAAC,SAAS,CAAC,qBAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAA,oBAAQ,EAAC,iBAAiB,EAAE,wDAAwD,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC;YACrC,KAAK,EAAE,cAAc,CAAC,aAAa;YACnC,QAAQ,EAAE,qBAAU;YACpB,oBAAoB,EAAE,KAAK;SAC5B,CAAC,CAAC;QAEH,cAAc,GAAG;YACf,KAAK,CAAC,KAAK,CAAC,KAAe;gBACzB,MAAM,OAAO,GAAe,EAAE,CAAC;gBAC/B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBACzB,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,UAAU;gBACR,OAAO,GAAG,CAAC;YACb,CAAC;SACF,CAAC;QAEF,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,oBAAQ,EACN,iBAAiB,EACjB,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;QACF,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB;IACrC,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC"}

package/dist/facts-cli.d.ts

@@ -3,5 +3,19 @@
  * Returns sorted deduplicated 1-based indices, or null if invalid.
  */
 export declare function parseSelection(input: string, max: number): number[] | null;
+/**
+ * List all stored RAG facts grouped by domain and optionally delete selected entries.
+ * Used by the `bernard facts` CLI command (no query argument).
+ */
 export declare function factsList(): Promise<void>;
+/**
+ * Permanently delete all RAG facts after interactive confirmation.
+ * Requires the user to type an exact confirmation phrase.
+ */
+export declare function clearFacts(): Promise<void>;
+/**
+ * Search RAG facts by semantic similarity and optionally delete selected results.
+ * If `query` is a path to an existing file, its contents are used as the search text.
+ * @param query - Free-text search string or path to a file whose contents serve as the query.
+ */
 export declare function factsSearch(query: string): Promise<void>;

package/dist/facts-cli.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseSelection = parseSelection;
 exports.factsList = factsList;
+exports.clearFacts = clearFacts;
 exports.factsSearch = factsSearch;
 const fs = __importStar(require("node:fs"));
 const readline = __importStar(require("node:readline"));
@@ -42,6 +43,7 @@ const rag_js_1 = require("./rag.js");
 const domains_js_1 = require("./domains.js");
 const config_js_1 = require("./config.js");
 const output_js_1 = require("./output.js");
+const paths_js_1 = require("./paths.js");
 const MAX_FILE_QUERY_LENGTH = 10000;
 function confirm(prompt) {
     return new Promise((resolve) => {
@@ -152,6 +154,10 @@ async function promptDelete(results, ragStore) {
     const deleted = ragStore.deleteByIds(ids);
     (0, output_js_1.printInfo)(`Deleted ${deleted} fact(s).`);
 }
+/**
+ * List all stored RAG facts grouped by domain and optionally delete selected entries.
+ * Used by the `bernard facts` CLI command (no query argument).
+ */
 async function factsList() {
     const config = (0, config_js_1.loadConfig)();
     if (!config.ragEnabled) {
@@ -167,6 +173,51 @@ async function factsList() {
     displayResults(results, false);
     await promptDelete(results, ragStore);
 }
+/**
+ * Permanently delete all RAG facts after interactive confirmation.
+ * Requires the user to type an exact confirmation phrase.
+ */
+async function clearFacts() {
+    const config = (0, config_js_1.loadConfig)();
+    if (!config.ragEnabled) {
+        (0, output_js_1.printInfo)('RAG is disabled. Set BERNARD_RAG_ENABLED=true to enable.');
+        return;
+    }
+    const ragStore = new rag_js_1.RAGStore();
+    const total = ragStore.count();
+    if (total === 0) {
+        (0, output_js_1.printInfo)('No facts stored. Nothing to clear.');
+        return;
+    }
+    const counts = ragStore.countByDomain();
+    (0, output_js_1.printInfo)('');
+    (0, output_js_1.printInfo)('\u26a0\ufe0f  This will permanently delete ALL learned RAG facts.');
+    (0, output_js_1.printInfo)('');
+    const entries = Object.entries(counts);
+    const maxLen = Math.max(...entries.map(([d]) => d.length), 'Total:'.length);
+    (0, output_js_1.printInfo)('  Current facts:');
+    for (const [domain, count] of entries) {
+        (0, output_js_1.printInfo)(`    ${domain.padEnd(maxLen)}  ${String(count).padStart(6)} facts`);
+    }
+    (0, output_js_1.printInfo)(`    ${'Total:'.padEnd(maxLen)}  ${String(total).padStart(6)} facts`);
+    (0, output_js_1.printInfo)('');
+    (0, output_js_1.printInfo)(`  Storage: ${paths_js_1.MEMORIES_FILE}`);
+    (0, output_js_1.printInfo)('');
+    const answer = await promptLine('  Type "yes, delete all facts" to confirm: ');
+    if (answer !== 'yes, delete all facts') {
+        (0, output_js_1.printInfo)('Cancelled.');
+        return;
+    }
+    ragStore.clear();
+    (0, output_js_1.printInfo)('');
+    const parts = Object.entries(counts).map(([d, c]) => `${c} ${d}`);
+    (0, output_js_1.printInfo)(`\u2713 Deleted ${total} facts (${parts.join(', ')}). RAG memory is now empty.`);
+}
+/**
+ * Search RAG facts by semantic similarity and optionally delete selected results.
+ * If `query` is a path to an existing file, its contents are used as the search text.
+ * @param query - Free-text search string or path to a file whose contents serve as the query.
+ */
 async function factsSearch(query) {
     const config = (0, config_js_1.loadConfig)();
     if (!config.ragEnabled) {

package/dist/facts-cli.js.map

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

package/dist/history.d.ts

@@ -1,6 +1,14 @@
 import type { CoreMessage } from 'ai';
+/**
+ * Manages persistence of conversation history.
+ *
+ * Uses atomic writes (write-to-temp then rename) to prevent corruption on unexpected exit.
+ */
 export declare class HistoryStore {
+    /** Loads and validates saved conversation history, returning an empty array if the file is missing or malformed. */
     load(): CoreMessage[];
+    /** Atomically writes the conversation history to disk. */
     save(messages: CoreMessage[]): void;
+    /** Deletes the saved history file. Silently succeeds if the file does not exist. */
     clear(): void;
 }