@openfinclaw/openfinclaw-strategy 2026.3.274 → 2026.3.276

package/index.ts

@@ -16,6 +16,9 @@ import { getDb } from "./src/db/db.js";
 import { createOpenFinclawGatewayProxy } from "./src/http/gateway-proxy.js";
 import { startHttpServer } from "./src/http/server.js";
 import { OPENFINCLAW_AGENT_GUIDANCE } from "./src/prompt-guidance.js";
+import { setupOpenfinclawCronJobs } from "./src/scheduler/cron-setup.js";
+import { AggregatedNewsProvider, createNewsProviders } from "./src/scheduler/news-provider.js";
+import { registerSchedulerTools } from "./src/scheduler/tools.js";
 import { registerStrategyTools } from "./src/strategy/tools.js";
 
 const openfinclawPlugin = {
@@ -28,14 +31,17 @@ const openfinclawPlugin = {
   register(api: OpenClawPluginApi) {
     const config = resolvePluginConfig(api);
 
-    // Initialise SQLite database (creates tables on first run)
-    const db = getDb();
-
     // Register DataHub market data tools (fin_price, fin_kline, fin_crypto, fin_compare, fin_slim_search)
-    registerDatahubTools(api, config, db);
+    // DB init is lazy — getDb is called at tool execution time, not here.
+    registerDatahubTools(api, config, getDb);
 
     // Register strategy tools (skill_publish, skill_validate, skill_fork, skill_leaderboard, etc.)
-    registerStrategyTools(api, config, db);
+    registerStrategyTools(api, config, getDb);
+
+    // Register scheduler tools (strategy_daily_scan, strategy_scan_history)
+    const newsProviders = createNewsProviders(config);
+    const newsProvider = new AggregatedNewsProvider(newsProviders);
+    registerSchedulerTools(api, config, getDb, newsProvider);
 
     // Register CLI commands
     api.registerCli(
@@ -44,7 +50,7 @@ const openfinclawPlugin = {
           program,
           config,
           logger: api.logger,
-          db,
+          getDb,
         }),
       { commands: ["strategy"] },
     );
@@ -67,6 +73,27 @@ const openfinclawPlugin = {
     api.on("before_prompt_build", async () => ({
       prependSystemContext: OPENFINCLAW_AGENT_GUIDANCE,
     }));
+
+    // ── Gateway Cron registration ──
+    // Write cron jobs directly to ~/.openclaw/cron/jobs.json during register().
+    // This ensures jobs are available immediately on both gateway startup AND
+    // hot-reload (plugin install without restart). The CronService picks up
+    // file changes on its next tick.
+    if (config.schedulerEnabled) {
+      setupOpenfinclawCronJobs(config)
+        .then((result) => {
+          if (result.created > 0) {
+            api.logger.info(
+              `[OpenFinClaw] Cron jobs registered: ${result.created} created, ${result.existing} existing`,
+            );
+          }
+        })
+        .catch((err) => {
+          api.logger.info(
+            `[OpenFinClaw] Cron setup failed: ${err instanceof Error ? err.message : String(err)}`,
+          );
+        });
+    }
   },
 };
 

package/openclaw.plugin.json

@@ -38,6 +38,53 @@
         "minimum": 1024,
         "maximum": 65535,
         "description": "Dashboard HTTP server port (loopback only)"
+      },
+      "schedulerEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable scheduled tasks (daily scan, price monitor, reports)"
+      },
+      "scanCronExpr": {
+        "type": "string",
+        "default": "0 8 * * *",
+        "description": "Cron expression for daily strategy scan"
+      },
+      "monitorCronExpr": {
+        "type": "string",
+        "default": "*/30 * * * *",
+        "description": "Cron expression for price monitoring"
+      },
+      "weeklyReportCronExpr": {
+        "type": "string",
+        "default": "0 20 * * 0",
+        "description": "Cron expression for weekly report"
+      },
+      "monthlyReportCronExpr": {
+        "type": "string",
+        "default": "0 20 1 * *",
+        "description": "Cron expression for monthly report"
+      },
+      "scanTimezone": {
+        "type": "string",
+        "default": "Asia/Shanghai",
+        "description": "Timezone for scheduled tasks"
+      },
+      "newsApiKey": {
+        "type": "string",
+        "description": "Optional API key for Finnhub or NewsAPI news provider",
+        "sensitive": true
+      },
+      "newsProvider": {
+        "type": "string",
+        "default": "coingecko",
+        "description": "News provider: coingecko (free, no key), finnhub, or newsapi"
+      },
+      "priceAlertThreshold": {
+        "type": "number",
+        "default": 5,
+        "minimum": 0.1,
+        "maximum": 100,
+        "description": "Price change alert threshold in percent"
       }
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.274",
+  "version": "2026.3.276",
   "description": "OpenFinClaw - Unified financial tools: market data (price/K-line/crypto/compare/search), strategy publishing, fork, and validation. Single API key for Hub and DataHub.",
   "keywords": [
     "backtest",

package/src/cli.ts

@@ -17,13 +17,13 @@ type Logger = {
 
 /** Log a CLI command execution to agent_activity_log. */
 function logCli(
-  db: DatabaseSync,
+  getDb: () => DatabaseSync,
   action: string,
   params: Record<string, unknown>,
   startMs: number,
   error?: string,
 ): void {
-  insertActivityLog(db, {
+  insertActivityLog(getDb(), {
     id: randomUUID(),
     timestamp: new Date().toISOString(),
     category: "strategy",
@@ -39,9 +39,9 @@ export function registerStrategyCli(params: {
   program: Command;
   config: UnifiedPluginConfig;
   logger: Logger;
-  db: DatabaseSync;
+  getDb: () => DatabaseSync;
 }) {
-  const { program, config, db } = params;
+  const { program, config, getDb } = params;
 
   const root = program
     .command("strategy")
@@ -72,7 +72,7 @@ export function registerStrategyCli(params: {
 
           if (!response.ok) {
             logCli(
-              db,
+              getDb,
               "leaderboard",
               { boardType, limit, offset },
               startMs,
@@ -124,9 +124,9 @@ export function registerStrategyCli(params: {
           console.log("");
           console.log("使用 openclaw strategy show <id> --remote 查看详情");
           console.log("使用 openclaw strategy fork <id> 下载策略（需要 API Key）");
-          logCli(db, "leaderboard", { boardType, limit, offset }, startMs);
+          logCli(getDb, "leaderboard", { boardType, limit, offset }, startMs);
         } catch (err) {
-          logCli(db, "leaderboard", { boardType, limit, offset }, startMs, String(err));
+          logCli(getDb, "leaderboard", { boardType, limit, offset }, startMs, String(err));
           console.error(`✗ 请求失败: ${err instanceof Error ? err.message : String(err)}`);
           process.exitCode = 1;
         }
@@ -149,7 +149,7 @@ export function registerStrategyCli(params: {
       });
 
       if (result.success) {
-        logCli(db, "fork", { strategyId }, startMs);
+        logCli(getDb, "fork", { strategyId }, startMs);
         console.log("✓ 策略 Fork 成功！");
         console.log("");
         console.log(`  名称: ${result.sourceName}`);
@@ -160,7 +160,7 @@ export function registerStrategyCli(params: {
         console.log(`  验证: openfinclaw strategy validate ${result.localPath}`);
         console.log(`  发布: openfinclaw strategy publish ${result.localPath}`);
       } else {
-        logCli(db, "fork", { strategyId }, startMs, result.error ?? "unknown");
+        logCli(getDb, "fork", { strategyId }, startMs, result.error ?? "unknown");
         console.error(`✗ Fork 失败: ${result.error}`);
         process.exitCode = 1;
       }
@@ -202,7 +202,7 @@ export function registerStrategyCli(params: {
           s.displayName.length > 20 ? s.displayName.slice(0, 17) + "..." : s.displayName;
         console.log(`  ${name.padEnd(40)} ${displayName.padEnd(20)} ${typeLabel}`);
       }
-      logCli(db, "list", { count: strategies.length }, startMs);
+      logCli(getDb, "list", { count: strategies.length }, startMs);
     });
 
   // ── strategy show ──
@@ -216,7 +216,7 @@ export function registerStrategyCli(params: {
       const local = await findLocalStrategy(nameOrId);
 
       if (!local && !options.remote) {
-        logCli(db, "show", { nameOrId }, startMs, "not found");
+        logCli(getDb, "show", { nameOrId }, startMs, "not found");
         console.error(`✗ 本地策略未找到: ${nameOrId}`);
         console.error("  使用 --remote 从 Hub 获取信息");
         process.exitCode = 1;
@@ -227,7 +227,7 @@ export function registerStrategyCli(params: {
         const infoResult = await fetchStrategyInfo(config, local.sourceId);
         if (infoResult.success && infoResult.data) {
           const info = infoResult.data;
-          logCli(db, "show", { nameOrId, remote: true }, startMs);
+          logCli(getDb, "show", { nameOrId, remote: true }, startMs);
           if (options.json) {
             console.log(JSON.stringify({ local, hub: info }, null, 2));
             return;
@@ -238,7 +238,7 @@ export function registerStrategyCli(params: {
       }
 
       if (local) {
-        logCli(db, "show", { nameOrId }, startMs);
+        logCli(getDb, "show", { nameOrId }, startMs);
         if (options.json) {
           console.log(JSON.stringify(local, null, 2));
           return;
@@ -247,7 +247,7 @@ export function registerStrategyCli(params: {
         return;
       }
 
-      logCli(db, "show", { nameOrId }, startMs, "not found");
+      logCli(getDb, "show", { nameOrId }, startMs, "not found");
       console.error(`✗ 策略未找到: ${nameOrId}`);
       process.exitCode = 1;
     });
@@ -262,7 +262,7 @@ export function registerStrategyCli(params: {
       const startMs = Date.now();
       const local = await findLocalStrategy(nameOrId);
       if (!local) {
-        logCli(db, "remove", { nameOrId }, startMs, "not found");
+        logCli(getDb, "remove", { nameOrId }, startMs, "not found");
         console.error(`✗ 策略未找到: ${nameOrId}`);
         process.exitCode = 1;
         return;
@@ -278,10 +278,10 @@ export function registerStrategyCli(params: {
 
       const result = await removeLocalStrategy(nameOrId);
       if (result.success) {
-        logCli(db, "remove", { nameOrId }, startMs);
+        logCli(getDb, "remove", { nameOrId }, startMs);
         console.log("✓ 策略已删除");
       } else {
-        logCli(db, "remove", { nameOrId }, startMs, result.error ?? "unknown");
+        logCli(getDb, "remove", { nameOrId }, startMs, result.error ?? "unknown");
         console.error(`✗ 删除失败: ${result.error}`);
         process.exitCode = 1;
       }

package/src/config.ts

@@ -3,12 +3,20 @@
  * Supports single API key for both Hub and DataHub services.
  */
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
-import type { UnifiedPluginConfig } from "./types.js";
+import type { NewsProviderType, UnifiedPluginConfig } from "./types.js";
 
 const DEFAULT_HUB_API_URL = "https://hub.openfinclaw.ai";
 const DEFAULT_DATAHUB_GATEWAY_URL = "http://43.134.61.136:9080";
 const DEFAULT_TIMEOUT_MS = 60_000;
 
+const DEFAULT_SCAN_CRON = "0 8 * * *";
+const DEFAULT_MONITOR_CRON = "*/30 * * * *";
+const DEFAULT_WEEKLY_CRON = "0 20 * * 0";
+const DEFAULT_MONTHLY_CRON = "0 20 1 * *";
+const DEFAULT_SCAN_TZ = "Asia/Shanghai";
+const DEFAULT_ALERT_THRESHOLD = 5;
+const VALID_NEWS_PROVIDERS = new Set<NewsProviderType>(["coingecko", "finnhub", "newsapi"]);
+
 function readEnv(keys: string[]): string | undefined {
   for (const key of keys) {
     const value = process.env[key]?.trim();
@@ -55,11 +63,69 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
       ? Math.floor(httpPortNum)
       : 18792;
 
+  // ── Scheduler config ──
+  const schedulerEnabled =
+    (raw?.schedulerEnabled ?? readEnv(["OPENFINCLAW_SCHEDULER_ENABLED"])) !== "false";
+
+  const scanCronExpr =
+    (typeof raw?.scanCronExpr === "string" ? raw.scanCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_SCAN_CRON"]) ??
+    DEFAULT_SCAN_CRON;
+
+  const monitorCronExpr =
+    (typeof raw?.monitorCronExpr === "string" ? raw.monitorCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_MONITOR_CRON"]) ??
+    DEFAULT_MONITOR_CRON;
+
+  const weeklyReportCronExpr =
+    (typeof raw?.weeklyReportCronExpr === "string" ? raw.weeklyReportCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_WEEKLY_CRON"]) ??
+    DEFAULT_WEEKLY_CRON;
+
+  const monthlyReportCronExpr =
+    (typeof raw?.monthlyReportCronExpr === "string" ? raw.monthlyReportCronExpr : undefined) ??
+    readEnv(["OPENFINCLAW_MONTHLY_CRON"]) ??
+    DEFAULT_MONTHLY_CRON;
+
+  const scanTimezone =
+    (typeof raw?.scanTimezone === "string" ? raw.scanTimezone : undefined) ??
+    readEnv(["OPENFINCLAW_SCAN_TZ"]) ??
+    DEFAULT_SCAN_TZ;
+
+  // ── News config ──
+  const newsApiKey =
+    (typeof raw?.newsApiKey === "string" ? raw.newsApiKey : undefined) ??
+    readEnv(["OPENFINCLAW_NEWS_API_KEY"]);
+
+  const newsProviderRaw =
+    (typeof raw?.newsProvider === "string" ? raw.newsProvider : undefined) ??
+    readEnv(["OPENFINCLAW_NEWS_PROVIDER"]) ??
+    "coingecko";
+  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(
+    newsProviderRaw as NewsProviderType,
+  )
+    ? (newsProviderRaw as NewsProviderType)
+    : "coingecko";
+
+  // ── Alert config ──
+  const alertThresholdRaw = raw?.priceAlertThreshold ?? readEnv(["OPENFINCLAW_ALERT_THRESHOLD"]);
+  const priceAlertThreshold =
+    Number(alertThresholdRaw) > 0 ? Number(alertThresholdRaw) : DEFAULT_ALERT_THRESHOLD;
+
   return {
     apiKey: apiKey && apiKey.length > 0 ? apiKey : undefined,
     hubApiUrl: hubApiUrl.replace(/\/$/, ""),
     datahubGatewayUrl: datahubGatewayUrl.replace(/\/+$/, ""),
     requestTimeoutMs,
     httpPort,
+    schedulerEnabled,
+    scanCronExpr,
+    monitorCronExpr,
+    weeklyReportCronExpr,
+    monthlyReportCronExpr,
+    scanTimezone,
+    newsApiKey: newsApiKey && newsApiKey.length > 0 ? newsApiKey : undefined,
+    newsProvider,
+    priceAlertThreshold,
   };
 }

package/src/datahub/tools.ts

@@ -1,8 +1,8 @@
-import type { DatabaseSync } from "node:sqlite";
 /**
  * DataHub market data tools registration.
  * Tools: fin_price, fin_kline, fin_crypto, fin_compare, fin_slim_search
  */
+import type { DatabaseSync } from "node:sqlite";
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
 import { withLogging } from "../middleware/with-logging.js";
@@ -31,12 +31,12 @@ const NO_KEY =
 
 /**
  * Register DataHub market data tools.
- * @param db - SQLite database for activity logging.
+ * @param getDb - Lazy database getter (called at execution time, not registration).
  */
 export function registerDatahubTools(
   api: OpenClawPluginApi,
   config: UnifiedPluginConfig,
-  db: DatabaseSync,
+  getDb: () => DatabaseSync,
 ): void {
   const datahubClient = config.apiKey
     ? new DataHubClient(config.datahubGatewayUrl, config.apiKey, config.requestTimeoutMs)
@@ -91,7 +91,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      execute: withLogging(db, "fin_price", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_price", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -135,7 +135,7 @@ export function registerDatahubTools(
           Type.Number({ description: "Number of bars to return (default: 30)" }),
         ),
       }),
-      execute: withLogging(db, "fin_kline", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_kline", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const symbol = String(params.symbol);
@@ -209,7 +209,7 @@ export function registerDatahubTools(
         end_date: Type.Optional(Type.String({ description: "End date (YYYY-MM-DD)" })),
         limit: Type.Optional(Type.Number({ description: "Max results (default: 20)" })),
       }),
-      execute: withLogging(db, "fin_crypto", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_crypto", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const endpoint = String(params.endpoint ?? "coin/market");
@@ -256,7 +256,7 @@ export function registerDatahubTools(
           description: "Comma-separated symbols (2-5). Example: BTC/USDT,ETH/USDT,600519.SH",
         }),
       }),
-      execute: withLogging(db, "fin_compare", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_compare", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const raw = String(params.symbols);
@@ -279,7 +279,7 @@ export function registerDatahubTools(
                 symbol: sym,
                 market,
                 price: ticker.last,
-                weekChange: Math.round(weekChange * 100) / 100,
+                weekChange: parseFloat(weekChange.toFixed(2)),
               };
             }),
           );
@@ -317,7 +317,7 @@ export function registerDatahubTools(
           }),
         ),
       }),
-      execute: withLogging(db, "fin_slim_search", "market-data", async (_id, params) => {
+      execute: withLogging(getDb, "fin_slim_search", "market-data", async (_id, params) => {
         try {
           if (!datahubClient) return json({ error: NO_KEY });
           const q = String(params.query);

package/src/db/db.ts

@@ -1,4 +1,4 @@
-import { mkdirSync } from "node:fs";
+import { mkdirSync, unlinkSync } from "node:fs";
 /**
  * SQLite database singleton for OpenFinClaw plugin.
  * Database path: ~/.openfinclaw/workspace/openfinclaw-plugin.db
@@ -9,15 +9,11 @@ import { mkdirSync } from "node:fs";
  * a second DatabaseSync connection while the old HTTP server still
  * holds a reference to the first one via the old module scope.
  */
-import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { DatabaseSync } from "node:sqlite";
+import { DatabaseSync } from "node:sqlite";
 import { ensureSchema } from "./schema.js";
 
-// Use createRequire to load the built-in node:sqlite in an ESM context.
-const _require = createRequire(import.meta.url);
-
 /** globalThis key — survives module hot-reloads within the same process. */
 const GLOBAL_DB_KEY = "__openfinclaw_db__" as const;
 
@@ -40,10 +36,21 @@ export function getDb(): DatabaseSync {
   if (existing) return existing;
 
   // node:sqlite is available in Node 22+
-  const { DatabaseSync } = _require("node:sqlite") as typeof import("node:sqlite");
   const dbPath = resolveDbPath();
-  const db = new DatabaseSync(dbPath);
-  ensureSchema(db);
+  let db: DatabaseSync;
+  try {
+    db = new DatabaseSync(dbPath);
+    ensureSchema(db);
+  } catch (err) {
+    // If the file is corrupted ("file is not a database"), delete and retry once.
+    try {
+      unlinkSync(dbPath);
+    } catch {
+      // File may already be gone — ignore.
+    }
+    db = new DatabaseSync(dbPath);
+    ensureSchema(db);
+  }
   (globalThis as Record<string, unknown>)[GLOBAL_DB_KEY] = db;
   return db;
 }

package/src/db/repositories.ts

@@ -281,6 +281,160 @@ export function updateStrategyLevel(db: DatabaseSync, id: string, level: Strateg
   }
 }
 
+// ── Scan History ──────────────────────────────────────────────────────────
+
+export interface ScanHistoryEntry {
+  id: string;
+  scan_type: string;
+  started_at: string;
+  completed_at?: string | null;
+  status: string;
+  strategies_scanned: number;
+  news_found: number;
+  actions_taken: number;
+  summary?: string | null;
+  detail_json?: string | null;
+}
+
+/** Insert a scan history entry. */
+export function insertScanHistory(db: DatabaseSync, entry: ScanHistoryEntry): void {
+  try {
+    db.prepare(`
+      INSERT INTO scan_history
+        (id, scan_type, started_at, completed_at, status,
+         strategies_scanned, news_found, actions_taken, summary, detail_json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+      entry.id,
+      entry.scan_type,
+      entry.started_at,
+      entry.completed_at ?? null,
+      entry.status,
+      entry.strategies_scanned,
+      entry.news_found,
+      entry.actions_taken,
+      entry.summary ?? null,
+      entry.detail_json ?? null,
+    );
+  } catch {
+    // Logging must never crash the calling tool
+  }
+}
+
+/** Update scan history entry after completion. */
+export function updateScanHistory(
+  db: DatabaseSync,
+  id: string,
+  patch: Partial<
+    Pick<
+      ScanHistoryEntry,
+      | "completed_at"
+      | "status"
+      | "strategies_scanned"
+      | "news_found"
+      | "actions_taken"
+      | "summary"
+      | "detail_json"
+    >
+  >,
+): void {
+  try {
+    const sets: string[] = [];
+    const values: unknown[] = [];
+    for (const [k, v] of Object.entries(patch)) {
+      sets.push(`${k} = ?`);
+      values.push(v ?? null);
+    }
+    if (sets.length === 0) return;
+    values.push(id);
+    db.prepare(`UPDATE scan_history SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+  } catch {
+    // Logging must never crash the calling tool
+  }
+}
+
+/** Query scan history, newest first. Optionally filter by scan_type. */
+export function queryScanHistory(
+  db: DatabaseSync,
+  opts: { scanType?: string; limit?: number; offset?: number } = {},
+): ScanHistoryEntry[] {
+  const { limit = 20, offset = 0, scanType } = opts;
+  if (scanType) {
+    return db
+      .prepare(
+        `SELECT * FROM scan_history WHERE scan_type = ? ORDER BY started_at DESC LIMIT ? OFFSET ?`,
+      )
+      .all(scanType, limit, offset) as ScanHistoryEntry[];
+  }
+  return db
+    .prepare(`SELECT * FROM scan_history ORDER BY started_at DESC LIMIT ? OFFSET ?`)
+    .all(limit, offset) as ScanHistoryEntry[];
+}
+
+// ── Price Alerts ──────────────────────────────────────────────────────────
+
+export interface PriceAlertEntry {
+  id: string;
+  strategy_id: string;
+  symbol: string;
+  alert_type: string;
+  trigger_value?: number | null;
+  threshold?: number | null;
+  message?: string | null;
+  created_at: string;
+  acknowledged: number;
+}
+
+/** Insert a price alert. */
+export function insertPriceAlert(db: DatabaseSync, alert: PriceAlertEntry): void {
+  try {
+    db.prepare(`
+      INSERT INTO price_alerts
+        (id, strategy_id, symbol, alert_type, trigger_value, threshold, message, created_at, acknowledged)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+      alert.id,
+      alert.strategy_id,
+      alert.symbol,
+      alert.alert_type,
+      alert.trigger_value ?? null,
+      alert.threshold ?? null,
+      alert.message ?? null,
+      alert.created_at,
+      alert.acknowledged,
+    );
+  } catch {
+    // Logging must never crash the calling tool
+  }
+}
+
+/** Query price alerts, newest first. */
+export function queryPriceAlerts(
+  db: DatabaseSync,
+  opts: { strategyId?: string; limit?: number; offset?: number } = {},
+): PriceAlertEntry[] {
+  const { limit = 50, offset = 0, strategyId } = opts;
+  if (strategyId) {
+    return db
+      .prepare(
+        `SELECT * FROM price_alerts WHERE strategy_id = ? ORDER BY created_at DESC LIMIT ? OFFSET ?`,
+      )
+      .all(strategyId, limit, offset) as PriceAlertEntry[];
+  }
+  return db
+    .prepare(`SELECT * FROM price_alerts ORDER BY created_at DESC LIMIT ? OFFSET ?`)
+    .all(limit, offset) as PriceAlertEntry[];
+}
+
+/** Mark a price alert as acknowledged. */
+export function acknowledgePriceAlert(db: DatabaseSync, id: string): void {
+  try {
+    db.prepare(`UPDATE price_alerts SET acknowledged = 1 WHERE id = ?`).run(id);
+  } catch {
+    // Logging must never crash the calling tool
+  }
+}
+
 // ── Reads ─────────────────────────────────────────────────────────────────
 
 /** Query agent_activity_log, newest first. */

package/src/db/schema.ts

@@ -99,6 +99,41 @@ export function ensureSchema(db: DatabaseSync): void {
   db.exec(`CREATE INDEX IF NOT EXISTS idx_ae_timestamp ON agent_events(timestamp);`);
   db.exec(`CREATE INDEX IF NOT EXISTS idx_ae_strategy_id ON agent_events(strategy_id);`);
 
+  // ── scan_history ─────────────────────────────────────────────────────────
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS scan_history (
+      id                  TEXT PRIMARY KEY,
+      scan_type           TEXT NOT NULL,
+      started_at          TEXT NOT NULL,
+      completed_at        TEXT,
+      status              TEXT NOT NULL DEFAULT 'running',
+      strategies_scanned  INTEGER DEFAULT 0,
+      news_found          INTEGER DEFAULT 0,
+      actions_taken       INTEGER DEFAULT 0,
+      summary             TEXT,
+      detail_json         TEXT
+    );
+  `);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_scan_history_started ON scan_history(started_at);`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_scan_history_type ON scan_history(scan_type);`);
+
+  // ── price_alerts ────────────────────────────────────────────────────────
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS price_alerts (
+      id              TEXT PRIMARY KEY,
+      strategy_id     TEXT NOT NULL,
+      symbol          TEXT NOT NULL,
+      alert_type      TEXT NOT NULL,
+      trigger_value   REAL,
+      threshold       REAL,
+      message         TEXT,
+      created_at      TEXT NOT NULL,
+      acknowledged    INTEGER DEFAULT 0
+    );
+  `);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_price_alerts_created ON price_alerts(created_at);`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_price_alerts_strategy ON price_alerts(strategy_id);`);
+
   // ── migrations (add columns to existing databases) ──────────────────────
 }