@openfinclaw/openfinclaw-strategy 2026.3.275 → 2026.3.310

package/index.test.ts

@@ -77,7 +77,7 @@ describe("openfinclaw plugin", () => {
       expect.objectContaining({
         path: "/plugins/openfinclaw",
         match: "prefix",
-        auth: "gateway",
+        auth: "plugin",
       }),
     );
   });
@@ -86,10 +86,12 @@ describe("openfinclaw plugin", () => {
     const { api, tools } = createFakeApi({});
     plugin.register(api);
 
-    expect(tools.size).toBeGreaterThanOrEqual(7);
+    expect(tools.size).toBeGreaterThanOrEqual(9);
     expect(tools.has("skill_publish")).toBe(true);
     expect(tools.has("skill_publish_verify")).toBe(true);
     expect(tools.has("skill_validate")).toBe(true);
+    expect(tools.has("strategy_price_monitor")).toBe(true);
+    expect(tools.has("strategy_periodic_report")).toBe(true);
   });
 
   it("skill_publish_verify returns success when API returns 200 with submissionId", async () => {

package/index.ts

@@ -8,7 +8,7 @@ import type { Command } from "commander";
  * - Dashboard: embedded HTTP server at http://127.0.0.1:<httpPort> (default 18792)
  * Supports FEP v2.0 protocol for strategy packages.
  */
-import type { OpenClawPluginApi } from "openclaw/plugin-sdk/core";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 import { registerStrategyCli } from "./src/cli.js";
 import { resolvePluginConfig } from "./src/config.js";
 import { registerDatahubTools } from "./src/datahub/tools.js";
@@ -20,15 +20,18 @@ 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";
+import { setupTournamentCronJob } from "./src/tournament/cron-setup.js";
+import { TournamentDb } from "./src/tournament/db.js";
+import { buildOrchestratorPrompt } from "./src/tournament/prompts.js";
+import { registerTournamentTools } from "./src/tournament/tools.js";
 
-const openfinclawPlugin = {
+export default definePluginEntry({
   id: "openfinclaw-strategy",
   name: "OpenFinClaw",
   description:
     "Unified financial tools: strategy publishing/fork/validation, market data (price/K-line/crypto/compare/search). Single API key for Hub and DataHub.",
-  kind: "financial" as const,
 
-  register(api: OpenClawPluginApi) {
+  register(api) {
     const config = resolvePluginConfig(api);
 
     // Register DataHub market data tools (fin_price, fin_kline, fin_crypto, fin_compare, fin_slim_search)
@@ -38,7 +41,7 @@ const openfinclawPlugin = {
     // Register strategy tools (skill_publish, skill_validate, skill_fork, skill_leaderboard, etc.)
     registerStrategyTools(api, config, getDb);
 
-    // Register scheduler tools (strategy_daily_scan, strategy_scan_history)
+    // Register scheduler tools (strategy_daily_scan, strategy_price_monitor, strategy_scan_history, strategy_periodic_report)
     const newsProviders = createNewsProviders(config);
     const newsProvider = new AggregatedNewsProvider(newsProviders);
     registerSchedulerTools(api, config, getDb, newsProvider);
@@ -69,30 +72,48 @@ const openfinclawPlugin = {
       handler: createOpenFinclawGatewayProxy({ port: config.httpPort, logger: api.logger }),
     });
 
+    // Register tournament tools (tournament_pick, tournament_leaderboard, tournament_result)
+    const getTournamentDb = () => new TournamentDb(getDb());
+    registerTournamentTools(api.registerTool.bind(api), getTournamentDb);
+
     // Inject agent system prompt: prioritise tool calls so data lands in SQLite
+    const tournamentPrompt = buildOrchestratorPrompt();
     api.on("before_prompt_build", async () => ({
-      prependSystemContext: OPENFINCLAW_AGENT_GUIDANCE,
+      prependSystemContext: `${OPENFINCLAW_AGENT_GUIDANCE}\n\n${tournamentPrompt}`,
     }));
 
     // ── Gateway Cron registration ──
-    // Register cron jobs on gateway_start (writes to ~/.openclaw/cron/jobs.json)
+    // 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) {
-      api.on("gateway_start", async () => {
-        try {
-          const result = await setupOpenfinclawCronJobs(config);
+      setupOpenfinclawCronJobs(config)
+        .then((result) => {
           if (result.created > 0) {
             api.logger.info(
               `[OpenFinClaw] Cron jobs registered: ${result.created} created, ${result.existing} existing`,
             );
           }
-        } catch (err) {
+        })
+        .catch((err) => {
           api.logger.info(
             `[OpenFinClaw] Cron setup failed: ${err instanceof Error ? err.message : String(err)}`,
           );
-        }
-      });
+        });
+
+      // Register tournament cron job
+      setupTournamentCronJob()
+        .then((result) => {
+          if (result.created) {
+            api.logger.info("[OpenFinClaw] Tournament cron job registered");
+          }
+        })
+        .catch((err) => {
+          api.logger.info(
+            `[OpenFinClaw] Tournament cron setup failed: ${err instanceof Error ? err.message : String(err)}`,
+          );
+        });
     }
   },
-};
-
-export default openfinclawPlugin;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/openfinclaw-strategy",
-  "version": "2026.3.275",
+  "version": "2026.3.310",
   "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/config.ts

@@ -101,7 +101,9 @@ export function resolvePluginConfig(api: OpenClawPluginApi): UnifiedPluginConfig
     (typeof raw?.newsProvider === "string" ? raw.newsProvider : undefined) ??
     readEnv(["OPENFINCLAW_NEWS_PROVIDER"]) ??
     "coingecko";
-  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(newsProviderRaw as NewsProviderType)
+  const newsProvider: NewsProviderType = VALID_NEWS_PROVIDERS.has(
+    newsProviderRaw as NewsProviderType,
+  )
     ? (newsProviderRaw as NewsProviderType)
     : "coingecko";
 

package/src/db/repositories.ts

@@ -325,7 +325,18 @@ export function insertScanHistory(db: DatabaseSync, entry: ScanHistoryEntry): vo
 export function updateScanHistory(
   db: DatabaseSync,
   id: string,
-  patch: Partial<Pick<ScanHistoryEntry, "completed_at" | "status" | "strategies_scanned" | "news_found" | "actions_taken" | "summary" | "detail_json">>,
+  patch: Partial<
+    Pick<
+      ScanHistoryEntry,
+      | "completed_at"
+      | "status"
+      | "strategies_scanned"
+      | "news_found"
+      | "actions_taken"
+      | "summary"
+      | "detail_json"
+    >
+  >,
 ): void {
   try {
     const sets: string[] = [];
@@ -342,20 +353,51 @@ export function updateScanHistory(
   }
 }
 
-/** Query scan history, newest first. Optionally filter by scan_type. */
+/** Query scan history, newest first. Optionally filter by scan_type and started_at lower bound (ISO 8601). */
 export function queryScanHistory(
   db: DatabaseSync,
-  opts: { scanType?: string; limit?: number; offset?: number } = {},
+  opts: {
+    scanType?: string;
+    startedAfter?: string;
+    limit?: number;
+    offset?: number;
+  } = {},
 ): ScanHistoryEntry[] {
-  const { limit = 20, offset = 0, scanType } = opts;
+  const { limit = 20, offset = 0, scanType, startedAfter } = opts;
+  const conditions: string[] = [];
+  const params: unknown[] = [];
   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[];
+    conditions.push("scan_type = ?");
+    params.push(scanType);
   }
+  if (startedAfter) {
+    conditions.push("started_at >= ?");
+    params.push(startedAfter);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  params.push(limit, offset);
   return db
-    .prepare(`SELECT * FROM scan_history ORDER BY started_at DESC LIMIT ? OFFSET ?`)
-    .all(limit, offset) as ScanHistoryEntry[];
+    .prepare(`SELECT * FROM scan_history ${where} ORDER BY started_at DESC LIMIT ? OFFSET ?`)
+    .all(...params) as ScanHistoryEntry[];
+}
+
+/**
+ * Count scan_history rows grouped by scan_type since an inclusive time bound (ISO 8601 started_at).
+ */
+export function countScanHistoryByTypeSince(
+  db: DatabaseSync,
+  startedAfter: string,
+): Map<string, number> {
+  const rows = db
+    .prepare(
+      `SELECT scan_type, COUNT(*) AS cnt FROM scan_history WHERE started_at >= ? GROUP BY scan_type`,
+    )
+    .all(startedAfter) as Array<{ scan_type: string; cnt: number }>;
+  const map = new Map<string, number>();
+  for (const r of rows) {
+    map.set(r.scan_type, Number(r.cnt));
+  }
+  return map;
 }
 
 // ── Price Alerts ──────────────────────────────────────────────────────────
@@ -395,20 +437,40 @@ export function insertPriceAlert(db: DatabaseSync, alert: PriceAlertEntry): void
   }
 }
 
-/** Query price alerts, newest first. */
+/** Query price alerts, newest first. Optionally filter by strategy and created_at lower bound (ISO 8601). */
 export function queryPriceAlerts(
   db: DatabaseSync,
-  opts: { strategyId?: string; limit?: number; offset?: number } = {},
+  opts: {
+    strategyId?: string;
+    createdAfter?: string;
+    limit?: number;
+    offset?: number;
+  } = {},
 ): PriceAlertEntry[] {
-  const { limit = 50, offset = 0, strategyId } = opts;
+  const { limit = 50, offset = 0, strategyId, createdAfter } = opts;
+  const conditions: string[] = [];
+  const params: unknown[] = [];
   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[];
+    conditions.push("strategy_id = ?");
+    params.push(strategyId);
+  }
+  if (createdAfter) {
+    conditions.push("created_at >= ?");
+    params.push(createdAfter);
   }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  params.push(limit, offset);
   return db
-    .prepare(`SELECT * FROM price_alerts ORDER BY created_at DESC LIMIT ? OFFSET ?`)
-    .all(limit, offset) as PriceAlertEntry[];
+    .prepare(`SELECT * FROM price_alerts ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`)
+    .all(...params) as PriceAlertEntry[];
+}
+
+/** Count price_alerts rows since an inclusive time bound (ISO 8601 created_at). */
+export function countPriceAlertsSince(db: DatabaseSync, createdAfter: string): number {
+  const row = db
+    .prepare(`SELECT COUNT(*) AS cnt FROM price_alerts WHERE created_at >= ?`)
+    .get(createdAfter) as { cnt: number } | undefined;
+  return Number(row?.cnt ?? 0);
 }
 
 /** Mark a price alert as acknowledged. */

package/src/db/schema.ts

@@ -1,8 +1,9 @@
 /**
  * SQLite schema for OpenFinClaw plugin (MVP 4 tables).
- * Based on ER diagram v0.3 — openfinclaw-opc-fund-plugin.
+ * Based on ER diagram v0.3.
  */
 import type { DatabaseSync } from "node:sqlite";
+import { ensureTournamentSchema } from "../tournament/db.js";
 
 /**
  * Create (or migrate) all MVP tables.
@@ -134,6 +135,9 @@ export function ensureSchema(db: DatabaseSync): void {
   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);`);
 
+  // ── tournament tables ──────────────────────────────────────────────────
+  ensureTournamentSchema(db);
+
   // ── migrations (add columns to existing databases) ──────────────────────
 }
 

package/src/scheduler/news-provider.ts

@@ -1,3 +1,4 @@
+import { guessMarket } from "../datahub/client.js";
 /**
  * External news providers for strategy symbol monitoring.
  *
@@ -10,7 +11,6 @@
  */
 import type { MarketType } from "../types.js";
 import type { NewsItem, NewsProvider, SymbolNewsResult } from "./types.js";
-import { guessMarket } from "../datahub/client.js";
 
 // ── CoinGecko Trending (no key required) ─────────────────────────────────
 

package/src/scheduler/periodic-report-builder.ts

@@ -0,0 +1,71 @@
+/**
+ * Markdown builder for `strategy_periodic_report` (weekly / monthly rolling windows).
+ */
+
+/** One row for the performance ranking table. */
+export interface StrategyRankRow {
+  strategyId: string;
+  strategyName: string;
+  totalReturn: number | null;
+  sharpe: number | null;
+  maxDrawdown: number | null;
+}
+
+/** Inputs collected by the tool before formatting. */
+export interface PeriodicReportPayload {
+  period: "weekly" | "monthly";
+  windowStartIso: string;
+  windowEndIso: string;
+  scanCountsByType: Map<string, number>;
+  priceAlertCount: number;
+  rankRows: StrategyRankRow[];
+}
+
+/**
+ * Format a periodic performance report as Markdown for the agent.
+ *
+ * @param payload - Aggregated stats and ranking rows for the reporting window.
+ * @returns Markdown string (zh headings, decimal returns as percent like daily scan).
+ */
+export function formatPeriodicReportMarkdown(payload: PeriodicReportPayload): string {
+  const periodLabel = payload.period === "weekly" ? "周报" : "月报";
+  const start = payload.windowStartIso.slice(0, 10);
+  const end = payload.windowEndIso.slice(0, 10);
+  const lines: string[] = [];
+
+  lines.push(`## 策略绩效${periodLabel} — ${start} ~ ${end}`);
+  lines.push("");
+
+  lines.push("### 绩效排名");
+  lines.push("");
+  lines.push("| 排名 | 策略 | 总收益 | 夏普 | 最大回撤 |");
+  lines.push("|------|------|--------|------|----------|");
+
+  const sorted = [...payload.rankRows].sort((a, b) => {
+    const ar = a.totalReturn ?? Number.NEGATIVE_INFINITY;
+    const br = b.totalReturn ?? Number.NEGATIVE_INFINITY;
+    return br - ar;
+  });
+
+  sorted.forEach((row, i) => {
+    const ret = row.totalReturn == null ? "—" : `${(row.totalReturn * 100).toFixed(2)}%`;
+    const sharpe = row.sharpe == null ? "—" : row.sharpe.toFixed(2);
+    const dd = row.maxDrawdown == null ? "—" : `${(row.maxDrawdown * 100).toFixed(2)}%`;
+    lines.push(`| ${i + 1} | ${row.strategyName} | ${ret} | ${sharpe} | ${dd} |`);
+  });
+
+  lines.push("");
+  lines.push("### 活动统计");
+  const keys = [...payload.scanCountsByType.keys()].sort();
+  if (keys.length === 0) {
+    lines.push("- （窗口内无扫描记录）");
+  } else {
+    for (const k of keys) {
+      lines.push(`- ${k}: ${payload.scanCountsByType.get(k)} 次`);
+    }
+  }
+  lines.push(`- 价格告警: ${payload.priceAlertCount} 条`);
+  lines.push("");
+
+  return lines.join("\n");
+}

package/src/scheduler/scan-report-builder.ts

@@ -101,7 +101,9 @@ export function formatScanReportMarkdown(report: ScanReport): string {
     for (const sd of entry.symbolData) {
       if (sd.currentPrice != null) {
         const change =
-          sd.priceChange24h != null ? ` (24h ${sd.priceChange24h >= 0 ? "+" : ""}${sd.priceChange24h.toFixed(1)}%)` : "";
+          sd.priceChange24h != null
+            ? ` (24h ${sd.priceChange24h >= 0 ? "+" : ""}${sd.priceChange24h.toFixed(1)}%)`
+            : "";
         lines.push(`- ${sd.symbol} 当前价格: $${sd.currentPrice.toFixed(2)}${change}`);
       }
 
@@ -127,7 +129,9 @@ export function formatScanReportMarkdown(report: ScanReport): string {
   if (strategiesWithNews.length > 0) {
     lines.push("### 需要关注的策略");
     for (const e of strategiesWithNews) {
-      lines.push(`- ${e.strategyName}: ${e.significantNewsCount} 条相关新闻，建议分析影响并考虑是否需要优化`);
+      lines.push(
+        `- ${e.strategyName}: ${e.significantNewsCount} 条相关新闻，建议分析影响并考虑是否需要优化`,
+      );
     }
   } else {
     lines.push("### 汇总");