create-yonderclaw 1.0.0

package/installer/templates/inbox-agent.ts.txt

@@ -0,0 +1,283 @@
+/**
+ * AI Inbox Agent — 8-category classification with conversation context
+ * Auto-generated by MetaClaw Installer
+ * Pattern: QIS Outreach Claw (field-tested, 10 days production)
+ *
+ * Categories: auto_reply, pushback_reply, hold_for_operator, suppress_unsubscribe,
+ *             suppress_bounce, suppress_not_interested, ignore_auto_reply, ignore_ooo
+ */
+
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import type { SDKAssistantMessage } from "@anthropic-ai/claude-agent-sdk";
+import { ImapFlow } from "imapflow";
+import { simpleParser } from "mailparser";
+import {
+  getDb, getContact, updateContactStatus, addToSuppressionList,
+  addConversation, getConversationHistory, isEmailProcessed, markEmailProcessed,
+  isPersonSuppressed, isSuppressed, getConfig,
+} from "./db.js";
+import { log } from "./observability.js";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Silent IMAP logger
+const silentLogger = { debug:()=>{}, info:()=>{}, warn:console.warn, error:console.error, trace:()=>{}, fatal:console.error };
+
+type InboxAction = "auto_reply" | "pushback_reply" | "hold_for_operator" | "suppress_unsubscribe" | "suppress_bounce" | "suppress_not_interested" | "ignore_auto_reply" | "ignore_ooo";
+
+// VIP list — loaded from data/vip-emails.json if exists
+function loadVIPs(): Set<string> {
+  const vips = new Set<string>();
+  try {
+    const vipFile = path.join(__dirname, "..", "data", "vip-emails.json");
+    if (fs.existsSync(vipFile)) {
+      const list = JSON.parse(fs.readFileSync(vipFile, "utf-8"));
+      for (const email of list) vips.add(email.toLowerCase());
+    }
+  } catch {}
+  return vips;
+}
+
+function getImapConfig() {
+  const db = getDb();
+  // Try mailbox_config table first, then config table
+  try {
+    const row = db.prepare("SELECT smtp_user, smtp_pass FROM mailbox_config LIMIT 1").get() as any;
+    if (row) return { host: "imap.gmail.com", port: 993, secure: true, auth: { user: row.smtp_user, pass: row.smtp_pass } };
+  } catch {}
+  const user = getConfig("imap_user");
+  const pass = getConfig("imap_pass");
+  if (user && pass) return { host: getConfig("imap_host") || "imap.gmail.com", port: 993, secure: true, auth: { user, pass } };
+  return null;
+}
+
+/**
+ * Classify an email using AI with full conversation context.
+ */
+async function classifyEmail(fromEmail: string, subject: string, body: string): Promise<{ action: InboxAction; reason: string }> {
+  const vips = loadVIPs();
+  const isVIP = vips.has(fromEmail.toLowerCase());
+
+  // VIP always goes to operator
+  if (isVIP) return { action: "hold_for_operator", reason: "VIP contact — human response only" };
+
+  // Load conversation history
+  const history = getConversationHistory(fromEmail);
+  const historyText = history.length > 0
+    ? history.map(h => `[${h.timestamp}] ${h.direction === "outbound" ? "WE SENT" : "THEY REPLIED"}: "${h.subject}" — ${(h.body || "").substring(0, 200)}`).join("\n")
+    : "No previous conversation";
+
+  const outboundCount = history.filter(h => h.direction === "outbound").length;
+  const inboundCount = history.filter(h => h.direction === "inbound").length;
+  const overMessaging = outboundCount > inboundCount + 1;
+
+  // Strip HTML to text
+  const cleanBody = body
+    .replace(/<[^>]*>/g, " ")
+    .replace(/&nbsp;/g, " ")
+    .replace(/\s+/g, " ")
+    .trim()
+    .substring(0, 2000);
+
+  // Strip email footers
+  const strippedBody = cleanBody
+    .replace(/^>.*$/gm, "")
+    .replace(/Get Outlook for.*/gi, "")
+    .replace(/Sent from.*/gi, "")
+    .replace(/^On .* wrote:.*$/gm, "")
+    .trim();
+
+  const prompt = `Classify this email reply. Return ONLY a JSON object with "action" and "reason".
+
+FROM: ${fromEmail}
+SUBJECT: ${subject}
+BODY: ${strippedBody}
+
+CONVERSATION HISTORY (${history.length} messages):
+${historyText}
+${overMessaging ? "\n⚠️ WARNING: We've sent more emails than they've replied to. Be cautious." : ""}
+
+CLASSIFICATION OPTIONS:
+- "auto_reply" — genuine interest, questions about product. Draft and send a reply.
+- "pushback_reply" — soft decline ("not interested", "looks similar"). Send ONE counter addressing their SPECIFIC objection, then stop. NEVER pushback if we already pushed back before.
+- "hold_for_operator" — ambiguous intent, financial requests, technical objections from domain experts, or anything you're not sure about. Better safe than sorry.
+- "suppress_unsubscribe" — hard stop ("stop", "unsubscribe", "remove me", "leave me alone", "do not contact")
+- "suppress_bounce" — mailer-daemon, delivery failure
+- "suppress_not_interested" — second decline after we already pushed back once
+- "ignore_auto_reply" — office auto-replies, transactional emails, newsletters
+- "ignore_ooo" — out-of-office with return date
+
+RULES:
+- If they make a SUBSTANTIVE TECHNICAL POINT (not a generic brush-off), classify as "hold_for_operator"
+- If we've already sent a pushback and they decline again, classify as "suppress_not_interested"
+- If ${overMessaging ? "we're over-messaging — lean toward hold_for_operator" : "conversation is balanced"}
+- When in doubt, "hold_for_operator" is always the safe choice
+
+Return: {"action": "...", "reason": "one sentence explanation"}`;
+
+  try {
+    let response = "";
+    const stream = query({
+      prompt,
+      options: { allowedTools: [], maxTurns: 1, model: "claude-sonnet-4-6" },
+    });
+
+    for await (const msg of stream) {
+      if (msg.type === "assistant") {
+        const a = msg as SDKAssistantMessage;
+        if (a.message?.content) {
+          for (const block of a.message.content) {
+            if (block.type === "text") response += (block as any).text;
+          }
+        }
+      }
+    }
+
+    // Parse JSON from response
+    const match = response.match(/\{[\s\S]*"action"[\s\S]*\}/);
+    if (match) {
+      const parsed = JSON.parse(match[0]);
+      return { action: parsed.action, reason: parsed.reason };
+    }
+  } catch (err) {
+    log("error", "inbox.classify_failed", { email: fromEmail, error: String(err) });
+  }
+
+  return { action: "hold_for_operator", reason: "Classification failed — defaulting to safe option" };
+}
+
+/**
+ * Check inbox, classify, take action.
+ */
+export async function checkInbox(): Promise<{ processed: number; actions: Record<string, number> }> {
+  const config = getImapConfig();
+  if (!config) {
+    console.log("No IMAP configured. Set up email in npm run setup.");
+    return { processed: 0, actions: {} };
+  }
+
+  const client = new ImapFlow({ ...config, logger: silentLogger });
+  const actions: Record<string, number> = {};
+  let processed = 0;
+
+  try {
+    await client.connect();
+    const lock = await client.getMailboxLock("INBOX");
+
+    try {
+      const uids = await client.search({ seen: false });
+      if (!uids || uids.length === 0) {
+        console.log("No unread emails.");
+        return { processed: 0, actions };
+      }
+
+      console.log(`Found ${uids.length} unread email(s).`);
+
+      for (const uid of uids) {
+        const uidStr = String(uid);
+
+        // Dedup check
+        if (isEmailProcessed(uidStr)) continue;
+
+        try {
+          const msg = await client.fetchOne(uidStr, { source: true, uid: true });
+          if (!msg?.source) continue;
+
+          const parsed = await simpleParser(msg.source);
+          const fromAddr = (parsed.from?.value?.[0]?.address || "").toLowerCase();
+          const subject = parsed.subject || "";
+          const body = parsed.text || parsed.html || "";
+
+          if (!fromAddr) continue;
+
+          // Skip if suppressed
+          if (isSuppressed(fromAddr) || isPersonSuppressed(fromAddr)) {
+            markEmailProcessed(uidStr, fromAddr, subject, "skipped_suppressed");
+            continue;
+          }
+
+          processed++;
+          console.log(`[${processed}] From: ${fromAddr} | Subject: ${subject}`);
+
+          // Check if active conversation (already replied to us)
+          const contact = getContact(fromAddr);
+          const isConversation = contact && (contact.status === "replied" || contact.status === "contacted");
+
+          let result: { action: InboxAction; reason: string };
+
+          if (isConversation) {
+            // Active conversation — only check for hard stops, otherwise auto-reply
+            const hardStops = /(stop|unsubscribe|remove me|leave me alone|do not contact)/i;
+            if (hardStops.test(body)) {
+              result = { action: "suppress_unsubscribe", reason: "Hard stop in active conversation" };
+            } else {
+              result = { action: "auto_reply", reason: "Active conversation continues" };
+            }
+          } else {
+            // First reply — full AI classification
+            result = await classifyEmail(fromAddr, subject, body);
+          }
+
+          console.log(`  → ${result.action}: ${result.reason}`);
+          actions[result.action] = (actions[result.action] || 0) + 1;
+
+          // Record conversation
+          addConversation(fromAddr, "inbound", subject, body.substring(0, 2000));
+
+          // Take action
+          switch (result.action) {
+            case "suppress_unsubscribe":
+            case "suppress_bounce":
+            case "suppress_not_interested":
+              addToSuppressionList(fromAddr, result.action);
+              if (contact) updateContactStatus(fromAddr, "suppressed");
+              break;
+            case "hold_for_operator":
+              if (contact) updateContactStatus(fromAddr, "needs_review");
+              log("warn", "inbox.hold_for_operator", { email: fromAddr, subject, reason: result.reason });
+              break;
+            case "auto_reply":
+              if (contact) updateContactStatus(fromAddr, "replied");
+              // TODO: Wire to auto-reply module
+              log("info", "inbox.auto_reply_queued", { email: fromAddr, subject });
+              break;
+            case "pushback_reply":
+              log("info", "inbox.pushback_queued", { email: fromAddr, subject });
+              break;
+          }
+
+          // Mark as processed
+          markEmailProcessed(uidStr, fromAddr, subject, result.action);
+
+          // Mark as read in IMAP
+          try { await client.messageFlagsAdd(uidStr, ["\\Seen"], { uid: true }); } catch {}
+
+        } catch (e) {
+          log("error", "inbox.process_error", { uid: uidStr, error: String(e) });
+        }
+      }
+    } finally {
+      lock.release();
+    }
+    await client.logout();
+  } catch (err) {
+    log("error", "inbox.connection_error", { error: String(err) });
+  }
+
+  return { processed, actions };
+}
+
+// CLI
+if (process.argv[1]?.includes("inbox-agent")) {
+  getDb();
+  console.log("__AGENT_NAME__ — Inbox Agent\n");
+  checkInbox().then(r => {
+    console.log(`\nProcessed: ${r.processed}`);
+    for (const [action, count] of Object.entries(r.actions)) {
+      console.log(`  ${action}: ${count}`);
+    }
+  });
+}

package/installer/templates/launch.bat.txt

@@ -0,0 +1,120 @@
+@echo off
+setlocal enabledelayedexpansion
+title MetaClaw: __AGENT_NAME__
+
+REM Ensure PATH includes Node.js and Claude
+set PATH=C:\Program Files\nodejs;%USERPROFILE%\AppData\Roaming\npm;%USERPROFILE%\.local\bin;%PATH%
+
+echo.
+echo   ==========================================
+echo   MetaClaw: __AGENT_NAME__
+echo   ==========================================
+echo.
+
+REM Set working directory
+cd /d "__PROJECT_DIR__"
+
+REM Find Claude executable (check npm install first, then .local)
+set "CLAUDE_CMD="
+if exist "%USERPROFILE%\AppData\Roaming\npm\claude.cmd" (
+    set "CLAUDE_CMD=%USERPROFILE%\AppData\Roaming\npm\claude.cmd"
+) else if exist "%USERPROFILE%\.local\bin\claude.exe" (
+    set "CLAUDE_CMD=%USERPROFILE%\.local\bin\claude.exe"
+) else (
+    where claude >nul 2>&1
+    if !ERRORLEVEL! equ 0 set "CLAUDE_CMD=claude"
+)
+
+if "!CLAUDE_CMD!"=="" (
+    echo   [ERROR] Claude Code not found.
+    echo   Install: https://claude.ai/download
+    pause
+    exit /b 1
+)
+
+REM Ensure authenticated
+if not exist "%USERPROFILE%\.claude\.credentials.json" (
+    echo   [!] Claude not logged in...
+    "!CLAUDE_CMD!" auth login
+    if not exist "%USERPROFILE%\.claude\.credentials.json" (
+        echo   [ERROR] Authentication failed.
+        pause
+        exit /b 1
+    )
+)
+
+echo   Directory: %CD%
+echo.
+
+REM === SESSION ID DETECTION ===
+REM Check if we have a saved session ID (most reliable)
+set "SESSION_ID="
+if exist "data\session-id.txt" (
+    set /p SESSION_ID=<"data\session-id.txt"
+    REM Trim whitespace
+    for /f "tokens=* delims= " %%a in ("!SESSION_ID!") do set "SESSION_ID=%%a"
+)
+
+if not "!SESSION_ID!"=="" (
+    echo   Resuming __AGENT_NAME__ (session: !SESSION_ID:~0,8!...)
+    echo.
+    "!CLAUDE_CMD!" --resume !SESSION_ID!
+    goto :post_session
+)
+
+REM No saved session — check if one exists in the project folder
+set "ENCODED_PATH=__ENCODED_PATH__"
+set "SESSION_DIR=%USERPROFILE%\.claude\projects\!ENCODED_PATH!"
+set "FOUND_SESSION="
+
+if exist "!SESSION_DIR!" (
+    for %%F in ("!SESSION_DIR!\*.jsonl") do (
+        set "FOUND_SESSION=%%~nF"
+    )
+)
+
+if not "!FOUND_SESSION!"=="" (
+    REM Save it for future launches
+    echo !FOUND_SESSION!> "data\session-id.txt"
+    echo   Resuming __AGENT_NAME__ (detected session: !FOUND_SESSION:~0,8!...)
+    echo.
+    "!CLAUDE_CMD!" --resume !FOUND_SESSION!
+    goto :post_session
+)
+
+REM No session at all — first launch
+echo   First launch - initializing __AGENT_NAME__...
+echo   Claude will read CLAUDE.md and SOUL.md for context.
+echo.
+"!CLAUDE_CMD!" --name "__AGENT_NAME__"
+
+REM After first launch, detect and save the session ID
+if exist "!SESSION_DIR!" (
+    for %%F in ("!SESSION_DIR!\*.jsonl") do (
+        set "FOUND_SESSION=%%~nF"
+    )
+    if not "!FOUND_SESSION!"=="" (
+        echo !FOUND_SESSION!> "data\session-id.txt"
+        echo   Session ID saved: !FOUND_SESSION:~0,8!...
+    )
+)
+
+:post_session
+echo.
+echo   __AGENT_NAME__ session ended.
+echo   Press any key to relaunch (Ctrl+C to quit)...
+pause >nul
+
+REM Re-read session ID (may have been updated)
+if exist "data\session-id.txt" (
+    set /p SESSION_ID=<"data\session-id.txt"
+    for /f "tokens=* delims= " %%a in ("!SESSION_ID!") do set "SESSION_ID=%%a"
+)
+
+if not "!SESSION_ID!"=="" (
+    echo   Resuming __AGENT_NAME__...
+    "!CLAUDE_CMD!" --resume !SESSION_ID!
+) else (
+    "!CLAUDE_CMD!" --continue
+)
+goto :post_session

package/installer/templates/morning-report.ts.txt

@@ -0,0 +1,124 @@
+/**
+ * Morning Report — sends daily briefing email to operator
+ * Auto-generated by MetaClaw Installer
+ * Pattern: AXIOM (field-tested — "Email is the lifeline")
+ *
+ * Sends: yesterday's metrics, health status, pending items, next priorities
+ * Schedule: daily via cron (recommended: 7-8 AM local)
+ */
+
+import nodemailer from "nodemailer";
+import { getDb, getTodayMetrics, getCircuitBreaker, getConfig } from "./db.js";
+import { log } from "./observability.js";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PROJECT_DIR = path.join(__dirname, "..");
+
+function getSmtpConfig(): { user: string; pass: string; host: string; port: number } | null {
+  const db = getDb();
+  try {
+    const row = db.prepare("SELECT smtp_user, smtp_pass, smtp_host, smtp_port FROM mailbox_config LIMIT 1").get() as any;
+    if (row) return { user: row.smtp_user, pass: row.smtp_pass, host: row.smtp_host || "smtp.gmail.com", port: row.smtp_port || 465 };
+  } catch {}
+  return null;
+}
+
+export async function sendMorningReport(operatorEmail?: string): Promise<boolean> {
+  const smtp = getSmtpConfig();
+  if (!smtp) { console.log("No SMTP configured. Skip morning report."); return false; }
+
+  const toEmail = operatorEmail || getConfig("operator_email") || smtp.user;
+  const agentName = getConfig("agent_name") || "__AGENT_NAME__";
+
+  // Gather data
+  const db = getDb();
+  const metrics = getTodayMetrics();
+  const cb = getCircuitBreaker("main");
+
+  // Last 7 days
+  const weekMetrics = db.prepare(`
+    SELECT SUM(actions_taken) as actions, SUM(actions_succeeded) as succeeded,
+           SUM(actions_failed) as failed, SUM(total_cost_usd) as cost, COUNT(*) as days
+    FROM daily_metrics WHERE date > date('now', '-7 days')
+  `).get() as any || {};
+
+  // Pending items
+  const pendingActions = db.prepare(
+    "SELECT COUNT(*) as cnt FROM action_log WHERE status = 'pending'"
+  ).get() as any;
+
+  // Recent errors
+  const recentErrors = db.prepare(
+    "SELECT action_type, target, details FROM action_log WHERE status = 'error' ORDER BY created_at DESC LIMIT 3"
+  ).all() as any[];
+
+  // State
+  let stateStr = "";
+  try {
+    const state = JSON.parse(fs.readFileSync(path.join(PROJECT_DIR, "data", "state.json"), "utf-8"));
+    stateStr = `Focus: ${state.current_focus || "None set"}\nNext: ${state.next_priority_action || "None set"}`;
+  } catch { stateStr = "state.json not found"; }
+
+  // Build email
+  const subject = `${agentName} — Morning Report ${new Date().toISOString().slice(0, 10)}`;
+
+  const body = [
+    `Good morning! Here's your ${agentName} daily briefing.`,
+    "",
+    "=== SYSTEM HEALTH ===",
+    `Circuit Breaker: ${(cb?.state || "closed").toUpperCase()}`,
+    cb?.reason ? `Reason: ${cb.reason}` : "",
+    "",
+    "=== LAST 7 DAYS ===",
+    `Actions: ${weekMetrics.actions || 0} (${weekMetrics.succeeded || 0} succeeded, ${weekMetrics.failed || 0} failed)`,
+    `Cost: $${(weekMetrics.cost || 0).toFixed(2)}`,
+    `Days active: ${weekMetrics.days || 0}`,
+    "",
+    "=== TODAY ===",
+    metrics ? `Actions: ${metrics.actions_taken}, Cost: $${(metrics.total_cost_usd || 0).toFixed(4)}` : "No activity yet",
+    "",
+    "=== CURRENT STATE ===",
+    stateStr,
+    "",
+    recentErrors.length > 0 ? "=== RECENT ERRORS ===" : "",
+    ...recentErrors.map(e => `- ${e.action_type}: ${e.details || e.target || "unknown"}`),
+    "",
+    `Pending items: ${pendingActions?.cnt || 0}`,
+    "",
+    "---",
+    `${agentName} — MetaClaw v3.3 — Yonder Zenith LLC`,
+  ].filter(Boolean).join("\n");
+
+  // Send
+  try {
+    const transporter = nodemailer.createTransport({
+      host: smtp.host, port: smtp.port, secure: smtp.port === 465,
+      auth: { user: smtp.user, pass: smtp.pass },
+    });
+
+    await transporter.sendMail({
+      from: `"${agentName}" <${smtp.user}>`,
+      to: toEmail,
+      subject,
+      text: body,
+    });
+
+    log("info", "morning_report.sent", { to: toEmail });
+    console.log(`Morning report sent to ${toEmail}`);
+    return true;
+  } catch (err) {
+    log("error", "morning_report.failed", { error: String(err) });
+    console.error("Morning report failed:", err);
+    return false;
+  }
+}
+
+// CLI
+if (process.argv[1]?.includes("morning-report")) {
+  getDb();
+  const recipient = process.argv[2];
+  sendMorningReport(recipient).then(() => process.exit(0));
+}

package/installer/templates/observability.ts.txt

@@ -0,0 +1,20 @@
+/**
+ * Core Observability — structured JSONL logging for all Claws
+ * Auto-generated by MetaClaw Installer
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const LOG_DIR = path.join(__dirname, "..", "data", "logs");
+if (!fs.existsSync(LOG_DIR)) fs.mkdirSync(LOG_DIR, { recursive: true });
+
+const LOG_FILE = path.join(LOG_DIR, "agent-" + new Date().toISOString().slice(0, 10) + ".jsonl");
+
+export function log(level: string, event: string, data?: Record<string, unknown>) {
+  const entry = { timestamp: new Date().toISOString(), level, event, ...data };
+  fs.appendFileSync(LOG_FILE, JSON.stringify(entry) + "\n");
+  if (level === "error" || level === "warn") console.error("[" + level.toUpperCase() + "] " + event, data || "");
+}

package/installer/templates/safety.ts.txt

@@ -0,0 +1,26 @@
+/**
+ * Core Safety Layer — universal for all Claws
+ * Auto-generated by MetaClaw Installer
+ */
+
+import { getCircuitBreaker, tripCircuitBreaker, isSuppressed, getTodayMetrics } from "./db.js";
+
+export const SAFETY_CONFIG = __SAFETY_CONFIG__;
+
+export function checkCanAct(target?: string, isConversation: boolean = false): { allowed: boolean; reason?: string } {
+  const breaker = getCircuitBreaker("main");
+  if (breaker?.state === "open") {
+    return { allowed: false, reason: "Circuit breaker OPEN: " + breaker.reason };
+  }
+
+  if (target && isSuppressed(target)) {
+    return { allowed: false, reason: target + " is suppressed" };
+  }
+
+  const metrics = getTodayMetrics();
+  if (metrics && metrics.actions_taken >= SAFETY_CONFIG.maxActionsPerDay) {
+    return { allowed: false, reason: "Daily limit reached (" + metrics.actions_taken + "/" + SAFETY_CONFIG.maxActionsPerDay + ")" };
+  }
+
+  return { allowed: true };
+}

package/installer/templates/self-improve.ts.txt

@@ -0,0 +1,48 @@
+/**
+ * Self-Improvement Module — Generator->Reflector->Curator pattern
+ * Auto-generated by MetaClaw Installer
+ */
+
+import { getDb } from "./db.js";
+import { log } from "./observability.js";
+
+export function recordOutcome(promptType: string, score: number, feedback?: string) {
+  const db = getDb();
+  const version = db.prepare(
+    "SELECT id, total_runs, avg_score FROM prompt_versions WHERE prompt_type = ? AND is_active = 1 ORDER BY version DESC LIMIT 1"
+  ).get(promptType) as any;
+
+  if (version) {
+    const newTotal = version.total_runs + 1;
+    const newAvg = ((version.avg_score * version.total_runs) + score) / newTotal;
+    db.prepare("UPDATE prompt_versions SET total_runs = ?, avg_score = ? WHERE id = ?").run(newTotal, newAvg, version.id);
+  }
+
+  log("info", "self_improve.outcome", { promptType, score, feedback });
+}
+
+export function shouldOptimize(promptType: string): boolean {
+  const db = getDb();
+  const version = db.prepare(
+    "SELECT total_runs, avg_score FROM prompt_versions WHERE prompt_type = ? AND is_active = 1 ORDER BY version DESC LIMIT 1"
+  ).get(promptType) as any;
+
+  if (!version) return false;
+  return version.total_runs > 0 && version.total_runs % 30 === 0;
+}
+
+export function getCurrentPrompt(promptType: string): string | null {
+  const db = getDb();
+  const row = db.prepare(
+    "SELECT content FROM prompt_versions WHERE prompt_type = ? AND is_active = 1 ORDER BY version DESC LIMIT 1"
+  ).get(promptType) as any;
+  return row?.content || null;
+}
+
+export function savePromptVersion(promptType: string, content: string, createdBy: string = "curator") {
+  const db = getDb();
+  const current = db.prepare("SELECT MAX(version) as v FROM prompt_versions WHERE prompt_type = ?").get(promptType) as any;
+  const nextVersion = (current?.v || 0) + 1;
+  db.prepare("INSERT INTO prompt_versions (prompt_type, version, content, created_by) VALUES (?, ?, ?, ?)").run(promptType, nextVersion, content, createdBy);
+  log("info", "self_improve.new_version", { promptType, version: nextVersion, createdBy });
+}