transduck 0.4.3 → 0.5.1

package/dist/backend.js

@@ -4,11 +4,31 @@
 import { getProvider } from './providers/index.js';
 // Re-export prompts for backward compat (tests import buildMessages from backend)
 export { buildMessages, buildPluralMessages } from './providers/prompts.js';
+function checkApiKey(config) {
+    if (config.provider === 'claude_code') {
+        const token = process.env[config.tokenEnv];
+        if (!token) {
+            throw new Error(`Missing API token: ${config.tokenEnv} environment variable is not set.\n` +
+                `Run: export ${config.tokenEnv}=your-token-here`);
+        }
+        return;
+    }
+    const apiKey = process.env[config.apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Missing API key: ${config.apiKeyEnv} environment variable is not set.\n` +
+            `Run: export ${config.apiKeyEnv}=your-key-here\n` +
+            `Or add it to your .env file.`);
+    }
+}
 export async function translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    if (!_clientOverride)
+        checkApiKey(config);
     const provider = await getProvider(config);
     return provider.translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }
 export async function translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    if (!_clientOverride)
+        checkApiKey(config);
     const provider = await getProvider(config);
     return provider.translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }

package/dist/cli.d.ts

@@ -43,6 +43,13 @@ export declare function runScan(opts: ScanOptions): Promise<string>;
 export interface StatsOptions {
     configPath?: string;
 }
+export interface ClearOptions {
+    lang?: string;
+    failedOnly?: boolean;
+    yes?: boolean;
+    configPath?: string;
+}
+export declare function runClear(opts: ClearOptions): Promise<string>;
 export declare function runStats(opts: StatsOptions): Promise<string>;
 declare const program: Command;
 export { program };

package/dist/cli.js

@@ -18,7 +18,7 @@ export async function runInit(opts) {
     const config = {
         project: { name: opts.name, context: opts.context },
         languages: { source: opts.sourceLang.toUpperCase(), targets: opts.targetLangs.map(l => l.toUpperCase()) },
-        storage: { path: './translations.lmdb' },
+        storage: { path: './translations.db' },
     };
     if (providerChoice === 2) {
         config.backend = {
@@ -46,7 +46,7 @@ export async function runInit(opts) {
     }
     const configPath = join(opts.dir, 'transduck.yaml');
     writeFileSync(configPath, yamlStringify(config));
-    const dbPath = join(opts.dir, 'translations.lmdb');
+    const dbPath = join(opts.dir, 'translations.db');
     const store = new TranslationStore(dbPath);
     await store.initialize();
     store.close();
@@ -434,6 +434,45 @@ export async function runScan(opts) {
     }
     return lines.join('\n');
 }
+export async function runClear(opts) {
+    const cfg = loadConfig(opts.configPath);
+    const store = new TranslationStore(cfg.storagePath);
+    await store.initialize();
+    const targetLang = opts.lang?.toUpperCase();
+    const entryCount = store.count(targetLang, opts.failedOnly);
+    let desc;
+    if (targetLang && opts.failedOnly) {
+        desc = `${entryCount} failed translation(s) for ${targetLang}`;
+    }
+    else if (targetLang) {
+        desc = `${entryCount} translation(s) for ${targetLang}`;
+    }
+    else if (opts.failedOnly) {
+        desc = `${entryCount} failed translation(s) across all languages`;
+    }
+    else {
+        desc = `${entryCount} translation(s) across all languages`;
+    }
+    if (entryCount === 0) {
+        store.close();
+        return 'Nothing to clear.';
+    }
+    if (!opts.yes) {
+        const readline = await import('readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise(resolve => {
+            rl.question(`This will delete ${desc}. Type "Yes" to confirm: `, resolve);
+        });
+        rl.close();
+        if (answer !== 'Yes') {
+            store.close();
+            return 'Cancelled.';
+        }
+    }
+    await store.clear(targetLang, opts.failedOnly);
+    store.close();
+    return `Deleted ${desc}.`;
+}
 export async function runStats(opts) {
     const cfg = loadConfig(opts.configPath);
     const store = new TranslationStore(cfg.storagePath);
@@ -454,7 +493,7 @@ export async function runStats(opts) {
 }
 // CLI entry point
 const program = new Command();
-program.name('transduck').description('AI-native translation tool').version('0.4.3');
+program.name('transduck').description('AI-native translation tool').version('0.5.1');
 program.command('init')
     .description('Initialize a new transduck project')
     .action(async () => {
@@ -539,6 +578,21 @@ program.command('warm')
     });
     console.log(output);
 });
+program.command('clear')
+    .description('Clear cached translations from the database')
+    .option('--lang <code>', 'Only clear translations for this language')
+    .option('--failed-only', 'Only clear failed translations')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--config <path>', 'Path to transduck.yaml')
+    .action(async (opts) => {
+    const output = await runClear({
+        lang: opts.lang,
+        failedOnly: opts.failedOnly,
+        yes: opts.yes,
+        configPath: opts.config ?? '',
+    });
+    console.log(output);
+});
 program.command('stats')
     .description('Show translation database statistics')
     .option('--config <path>', 'Path to transduck.yaml')

package/dist/storage.js

@@ -1,24 +1,10 @@
-import { open } from 'lmdb';
+import Database from 'better-sqlite3';
 import { createHash } from 'crypto';
-// 1 GB default map size — plenty for translation caches
-const DEFAULT_MAP_SIZE = 1024 * 1024 * 1024;
 function contentHash(sourceText, projectContextHash, stringContextHash) {
     return createHash('sha256')
         .update(sourceText + '\x00' + projectContextHash + '\x00' + stringContextHash)
         .digest('hex');
 }
-function makeKey(sourceLang, targetLang, chash, pluralCategory) {
-    return `${sourceLang}|${targetLang}|${chash}|${pluralCategory}`;
-}
-function parseKey(key) {
-    const parts = key.split('|');
-    return {
-        sourceLang: parts[0],
-        targetLang: parts[1],
-        contentHash: parts[2],
-        pluralCategory: parts[3] ?? '',
-    };
-}
 export class TranslationStore {
     dbPath;
     db = null;
@@ -26,12 +12,25 @@ export class TranslationStore {
         this.dbPath = dbPath;
     }
     async initialize() {
-        this.db = open({
-            path: this.dbPath,
-            mapSize: DEFAULT_MAP_SIZE,
-            encoding: 'json',
-            noSubdir: true,
-        });
+        this.db = new Database(this.dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS translations (
+        source_lang TEXT NOT NULL,
+        target_lang TEXT NOT NULL,
+        content_hash TEXT NOT NULL,
+        plural_category TEXT NOT NULL DEFAULT '',
+        source_text TEXT NOT NULL,
+        translated_text TEXT NOT NULL,
+        model TEXT NOT NULL,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        project_context_hash TEXT NOT NULL,
+        string_context_hash TEXT NOT NULL,
+        string_context TEXT NOT NULL DEFAULT '',
+        PRIMARY KEY (source_lang, target_lang, content_hash, plural_category)
+      )
+    `);
     }
     getDb() {
         if (!this.db)
@@ -41,81 +40,45 @@ export class TranslationStore {
     async lookup(params) {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-        const key = makeKey(params.sourceLang, params.targetLang, chash, '');
-        const entry = db.get(key);
-        if (entry && entry.status === 'translated') {
-            return entry.translated_text;
-        }
-        return null;
+        const row = db.prepare('SELECT translated_text FROM translations WHERE source_lang = ? AND target_lang = ? AND content_hash = ? AND plural_category = ? AND status = ?').get(params.sourceLang, params.targetLang, chash, '', 'translated');
+        return row?.translated_text ?? null;
     }
     async insert(params) {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-        const key = makeKey(params.sourceLang, params.targetLang, chash, '');
-        // ON CONFLICT DO NOTHING — only insert if key doesn't exist
-        if (db.get(key) !== undefined)
-            return;
-        await db.put(key, {
-            source_text: params.sourceText,
-            translated_text: params.translatedText,
-            model: params.model,
-            status: params.status,
-            created_at: new Date().toISOString(),
-            project_context_hash: params.projectContextHash,
-            string_context_hash: params.stringContextHash,
-            string_context: params.stringContext,
-        });
+        db.prepare(`INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
+       VALUES (?, ?, ?, '', ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext);
     }
     async lookupPlural(params) {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-        const prefix = makeKey(params.sourceLang, params.targetLang, chash, '');
+        const rows = db.prepare(`SELECT plural_category, translated_text FROM translations
+       WHERE source_lang = ? AND target_lang = ? AND content_hash = ? AND plural_category != '' AND status = ?`).all(params.sourceLang, params.targetLang, chash, 'translated');
         const result = {};
-        for (const { key, value } of db.getRange({ start: prefix })) {
-            const keyStr = key;
-            if (!keyStr.startsWith(prefix))
-                break;
-            const parsed = parseKey(keyStr);
-            // Skip regular entries (empty plural_category)
-            if (!parsed.pluralCategory)
-                continue;
-            if (value.status === 'translated') {
-                result[parsed.pluralCategory] = value.translated_text;
-            }
+        for (const row of rows) {
+            result[row.plural_category] = row.translated_text;
         }
         return result;
     }
     async insertPlural(params) {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-        const key = makeKey(params.sourceLang, params.targetLang, chash, params.pluralCategory);
-        // ON CONFLICT DO NOTHING
-        if (db.get(key) !== undefined)
-            return;
-        await db.put(key, {
-            source_text: params.sourceText,
-            translated_text: params.translatedText,
-            model: params.model,
-            status: params.status,
-            created_at: new Date().toISOString(),
-            project_context_hash: params.projectContextHash,
-            string_context_hash: params.stringContextHash,
-            string_context: params.stringContext,
-        });
+        db.prepare(`INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.pluralCategory, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext);
     }
     async stats() {
         const db = this.getDb();
         let totalTranslations = 0;
         let totalFailed = 0;
         const byLanguage = {};
-        for (const { key, value } of db.getRange({})) {
-            const parsed = parseKey(key);
-            if (value.status === 'translated') {
-                totalTranslations++;
-                byLanguage[parsed.targetLang] = (byLanguage[parsed.targetLang] ?? 0) + 1;
+        const rows = db.prepare('SELECT target_lang, status, COUNT(*) as count FROM translations GROUP BY target_lang, status').all();
+        for (const row of rows) {
+            if (row.status === 'translated') {
+                totalTranslations += row.count;
+                byLanguage[row.target_lang] = (byLanguage[row.target_lang] ?? 0) + row.count;
             }
-            else if (value.status === 'failed') {
-                totalFailed++;
+            else if (row.status === 'failed') {
+                totalFailed += row.count;
             }
         }
         return { totalTranslations, totalFailed, byLanguage };
@@ -125,36 +88,36 @@ export class TranslationStore {
      */
     count(targetLang, failedOnly) {
         const db = this.getDb();
-        let n = 0;
-        for (const { key, value } of db.getRange({})) {
-            const parsed = parseKey(key);
-            if (targetLang && parsed.targetLang !== targetLang)
-                continue;
-            if (failedOnly && value.status !== 'failed')
-                continue;
-            n++;
+        let sql = 'SELECT COUNT(*) as count FROM translations WHERE 1=1';
+        const params = [];
+        if (targetLang) {
+            sql += ' AND target_lang = ?';
+            params.push(targetLang);
+        }
+        if (failedOnly) {
+            sql += ' AND status = ?';
+            params.push('failed');
         }
-        return n;
+        const row = db.prepare(sql).get(...params);
+        return row.count;
     }
     /**
      * Delete entries matching optional filters. Returns count deleted.
      */
     async clear(targetLang, failedOnly) {
         const db = this.getDb();
-        const toDelete = [];
-        for (const { key, value } of db.getRange({})) {
-            const keyStr = key;
-            const parsed = parseKey(keyStr);
-            if (targetLang && parsed.targetLang !== targetLang)
-                continue;
-            if (failedOnly && value.status !== 'failed')
-                continue;
-            toDelete.push(keyStr);
+        let sql = 'DELETE FROM translations WHERE 1=1';
+        const params = [];
+        if (targetLang) {
+            sql += ' AND target_lang = ?';
+            params.push(targetLang);
         }
-        for (const k of toDelete) {
-            await db.remove(k);
+        if (failedOnly) {
+            sql += ' AND status = ?';
+            params.push('failed');
         }
-        return toDelete.length;
+        const result = db.prepare(sql).run(...params);
+        return result.changes;
     }
     close() {
         if (this.db) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transduck",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "description": "AI-native translation tool using source text as keys",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,12 +25,13 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "lmdb": "^3.5.2",
+    "better-sqlite3": "^11.0.0",
     "openai": "^4.0.0",
     "yaml": "^2.0.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.0.0",
+    "@types/better-sqlite3": "^7.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",

package/src/backend.ts

@@ -8,6 +8,27 @@ import { getProvider } from './providers/index.js';
 // Re-export prompts for backward compat (tests import buildMessages from backend)
 export { buildMessages, buildPluralMessages } from './providers/prompts.js';
 
+function checkApiKey(config: TransduckConfig): void {
+  if (config.provider === 'claude_code') {
+    const token = process.env[config.tokenEnv];
+    if (!token) {
+      throw new Error(
+        `Missing API token: ${config.tokenEnv} environment variable is not set.\n` +
+        `Run: export ${config.tokenEnv}=your-token-here`
+      );
+    }
+    return;
+  }
+  const apiKey = process.env[config.apiKeyEnv];
+  if (!apiKey) {
+    throw new Error(
+      `Missing API key: ${config.apiKeyEnv} environment variable is not set.\n` +
+      `Run: export ${config.apiKeyEnv}=your-key-here\n` +
+      `Or add it to your .env file.`
+    );
+  }
+}
+
 export async function translate(
   sourceText: string,
   sourceLang: string,
@@ -17,6 +38,7 @@ export async function translate(
   config: TransduckConfig,
   _clientOverride?: any,
 ): Promise<string> {
+  if (!_clientOverride) checkApiKey(config);
   const provider = await getProvider(config);
   return provider.translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }
@@ -31,6 +53,7 @@ export async function translatePlural(
   config: TransduckConfig,
   _clientOverride?: any,
 ): Promise<Record<string, string>> {
+  if (!_clientOverride) checkApiKey(config);
   const provider = await getProvider(config);
   return provider.translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }

package/src/cli.ts

@@ -31,7 +31,7 @@ export async function runInit(opts: InitOptions): Promise<string> {
   const config: Record<string, any> = {
     project: { name: opts.name, context: opts.context },
     languages: { source: opts.sourceLang.toUpperCase(), targets: opts.targetLangs.map(l => l.toUpperCase()) },
-    storage: { path: './translations.lmdb' },
+    storage: { path: './translations.db' },
   };
 
   if (providerChoice === 2) {
@@ -60,7 +60,7 @@ export async function runInit(opts: InitOptions): Promise<string> {
   const configPath = join(opts.dir, 'transduck.yaml');
   writeFileSync(configPath, yamlStringify(config));
 
-  const dbPath = join(opts.dir, 'translations.lmdb');
+  const dbPath = join(opts.dir, 'translations.db');
   const store = new TranslationStore(dbPath);
   await store.initialize();
   store.close();
@@ -539,6 +539,55 @@ export interface StatsOptions {
   configPath?: string;
 }
 
+export interface ClearOptions {
+  lang?: string;
+  failedOnly?: boolean;
+  yes?: boolean;
+  configPath?: string;
+}
+
+export async function runClear(opts: ClearOptions): Promise<string> {
+  const cfg = loadConfig(opts.configPath);
+  const store = new TranslationStore(cfg.storagePath);
+  await store.initialize();
+
+  const targetLang = opts.lang?.toUpperCase();
+  const entryCount = store.count(targetLang, opts.failedOnly);
+
+  let desc: string;
+  if (targetLang && opts.failedOnly) {
+    desc = `${entryCount} failed translation(s) for ${targetLang}`;
+  } else if (targetLang) {
+    desc = `${entryCount} translation(s) for ${targetLang}`;
+  } else if (opts.failedOnly) {
+    desc = `${entryCount} failed translation(s) across all languages`;
+  } else {
+    desc = `${entryCount} translation(s) across all languages`;
+  }
+
+  if (entryCount === 0) {
+    store.close();
+    return 'Nothing to clear.';
+  }
+
+  if (!opts.yes) {
+    const readline = await import('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise<string>(resolve => {
+      rl.question(`This will delete ${desc}. Type "Yes" to confirm: `, resolve);
+    });
+    rl.close();
+    if (answer !== 'Yes') {
+      store.close();
+      return 'Cancelled.';
+    }
+  }
+
+  await store.clear(targetLang, opts.failedOnly);
+  store.close();
+  return `Deleted ${desc}.`;
+}
+
 export async function runStats(opts: StatsOptions): Promise<string> {
   const cfg = loadConfig(opts.configPath);
   const store = new TranslationStore(cfg.storagePath);
@@ -562,7 +611,7 @@ export async function runStats(opts: StatsOptions): Promise<string> {
 // CLI entry point
 const program = new Command();
 
-program.name('transduck').description('AI-native translation tool').version('0.4.3');
+program.name('transduck').description('AI-native translation tool').version('0.5.1');
 
 program.command('init')
   .description('Initialize a new transduck project')
@@ -659,6 +708,22 @@ program.command('warm')
     console.log(output);
   });
 
+program.command('clear')
+  .description('Clear cached translations from the database')
+  .option('--lang <code>', 'Only clear translations for this language')
+  .option('--failed-only', 'Only clear failed translations')
+  .option('-y, --yes', 'Skip confirmation prompt')
+  .option('--config <path>', 'Path to transduck.yaml')
+  .action(async (opts: { lang?: string; failedOnly?: boolean; yes?: boolean; config?: string }) => {
+    const output = await runClear({
+      lang: opts.lang,
+      failedOnly: opts.failedOnly,
+      yes: opts.yes,
+      configPath: opts.config ?? '',
+    });
+    console.log(output);
+  });
+
 program.command('stats')
   .description('Show translation database statistics')
   .option('--config <path>', 'Path to transduck.yaml')

package/src/storage.ts

@@ -1,9 +1,6 @@
-import { open, type Database, type RootDatabase } from 'lmdb';
+import Database from 'better-sqlite3';
 import { createHash } from 'crypto';
 
-// 1 GB default map size — plenty for translation caches
-const DEFAULT_MAP_SIZE = 1024 * 1024 * 1024;
-
 export interface LookupParams {
   sourceText: string;
   sourceLang: string;
@@ -27,17 +24,6 @@ export interface InsertPluralParams extends LookupParams {
   status: string;
 }
 
-interface StoredEntry {
-  source_text: string;
-  translated_text: string;
-  model: string;
-  status: string;
-  created_at: string;
-  project_context_hash: string;
-  string_context_hash: string;
-  string_context: string;
-}
-
 interface Stats {
   totalTranslations: number;
   totalFailed: number;
@@ -50,38 +36,37 @@ function contentHash(sourceText: string, projectContextHash: string, stringConte
     .digest('hex');
 }
 
-function makeKey(sourceLang: string, targetLang: string, chash: string, pluralCategory: string): string {
-  return `${sourceLang}|${targetLang}|${chash}|${pluralCategory}`;
-}
-
-function parseKey(key: string): { sourceLang: string; targetLang: string; contentHash: string; pluralCategory: string } {
-  const parts = key.split('|');
-  return {
-    sourceLang: parts[0],
-    targetLang: parts[1],
-    contentHash: parts[2],
-    pluralCategory: parts[3] ?? '',
-  };
-}
-
 export class TranslationStore {
   private dbPath: string;
-  private db: RootDatabase<StoredEntry, string> | null = null;
+  private db: Database.Database | null = null;
 
   constructor(dbPath: string) {
     this.dbPath = dbPath;
   }
 
   async initialize(): Promise<void> {
-    this.db = open<StoredEntry, string>({
-      path: this.dbPath,
-      mapSize: DEFAULT_MAP_SIZE,
-      encoding: 'json',
-      noSubdir: true,
-    });
+    this.db = new Database(this.dbPath);
+    this.db.pragma('journal_mode = WAL');
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS translations (
+        source_lang TEXT NOT NULL,
+        target_lang TEXT NOT NULL,
+        content_hash TEXT NOT NULL,
+        plural_category TEXT NOT NULL DEFAULT '',
+        source_text TEXT NOT NULL,
+        translated_text TEXT NOT NULL,
+        model TEXT NOT NULL,
+        status TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        project_context_hash TEXT NOT NULL,
+        string_context_hash TEXT NOT NULL,
+        string_context TEXT NOT NULL DEFAULT '',
+        PRIMARY KEY (source_lang, target_lang, content_hash, plural_category)
+      )
+    `);
   }
 
-  private getDb(): RootDatabase<StoredEntry, string> {
+  private getDb(): Database.Database {
     if (!this.db) throw new Error('Store not initialized');
     return this.db;
   }
@@ -89,47 +74,36 @@ export class TranslationStore {
   async lookup(params: LookupParams): Promise<string | null> {
     const db = this.getDb();
     const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-    const key = makeKey(params.sourceLang, params.targetLang, chash, '');
-    const entry = db.get(key);
-    if (entry && entry.status === 'translated') {
-      return entry.translated_text;
-    }
-    return null;
+    const row = db.prepare(
+      'SELECT translated_text FROM translations WHERE source_lang = ? AND target_lang = ? AND content_hash = ? AND plural_category = ? AND status = ?'
+    ).get(params.sourceLang, params.targetLang, chash, '', 'translated') as { translated_text: string } | undefined;
+    return row?.translated_text ?? null;
   }
 
   async insert(params: InsertParams): Promise<void> {
     const db = this.getDb();
     const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-    const key = makeKey(params.sourceLang, params.targetLang, chash, '');
-    // ON CONFLICT DO NOTHING — only insert if key doesn't exist
-    if (db.get(key) !== undefined) return;
-    await db.put(key, {
-      source_text: params.sourceText,
-      translated_text: params.translatedText,
-      model: params.model,
-      status: params.status,
-      created_at: new Date().toISOString(),
-      project_context_hash: params.projectContextHash,
-      string_context_hash: params.stringContextHash,
-      string_context: params.stringContext,
-    });
+    db.prepare(
+      `INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
+       VALUES (?, ?, ?, '', ?, ?, ?, ?, ?, ?, ?, ?)`
+    ).run(
+      params.sourceLang, params.targetLang, chash,
+      params.sourceText, params.translatedText, params.model, params.status,
+      new Date().toISOString(),
+      params.projectContextHash, params.stringContextHash, params.stringContext,
+    );
   }
 
   async lookupPlural(params: LookupParams): Promise<Record<string, string>> {
     const db = this.getDb();
     const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-    const prefix = makeKey(params.sourceLang, params.targetLang, chash, '');
+    const rows = db.prepare(
+      `SELECT plural_category, translated_text FROM translations
+       WHERE source_lang = ? AND target_lang = ? AND content_hash = ? AND plural_category != '' AND status = ?`
+    ).all(params.sourceLang, params.targetLang, chash, 'translated') as { plural_category: string; translated_text: string }[];
     const result: Record<string, string> = {};
-
-    for (const { key, value } of db.getRange({ start: prefix })) {
-      const keyStr = key as string;
-      if (!keyStr.startsWith(prefix)) break;
-      const parsed = parseKey(keyStr);
-      // Skip regular entries (empty plural_category)
-      if (!parsed.pluralCategory) continue;
-      if (value.status === 'translated') {
-        result[parsed.pluralCategory] = value.translated_text;
-      }
+    for (const row of rows) {
+      result[row.plural_category] = row.translated_text;
     }
     return result;
   }
@@ -137,19 +111,15 @@ export class TranslationStore {
   async insertPlural(params: InsertPluralParams): Promise<void> {
     const db = this.getDb();
     const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
-    const key = makeKey(params.sourceLang, params.targetLang, chash, params.pluralCategory);
-    // ON CONFLICT DO NOTHING
-    if (db.get(key) !== undefined) return;
-    await db.put(key, {
-      source_text: params.sourceText,
-      translated_text: params.translatedText,
-      model: params.model,
-      status: params.status,
-      created_at: new Date().toISOString(),
-      project_context_hash: params.projectContextHash,
-      string_context_hash: params.stringContextHash,
-      string_context: params.stringContext,
-    });
+    db.prepare(
+      `INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+    ).run(
+      params.sourceLang, params.targetLang, chash, params.pluralCategory,
+      params.sourceText, params.translatedText, params.model, params.status,
+      new Date().toISOString(),
+      params.projectContextHash, params.stringContextHash, params.stringContext,
+    );
   }
 
   async stats(): Promise<Stats> {
@@ -158,13 +128,16 @@ export class TranslationStore {
     let totalFailed = 0;
     const byLanguage: Record<string, number> = {};
 
-    for (const { key, value } of db.getRange({})) {
-      const parsed = parseKey(key as string);
-      if (value.status === 'translated') {
-        totalTranslations++;
-        byLanguage[parsed.targetLang] = (byLanguage[parsed.targetLang] ?? 0) + 1;
-      } else if (value.status === 'failed') {
-        totalFailed++;
+    const rows = db.prepare(
+      'SELECT target_lang, status, COUNT(*) as count FROM translations GROUP BY target_lang, status'
+    ).all() as { target_lang: string; status: string; count: number }[];
+
+    for (const row of rows) {
+      if (row.status === 'translated') {
+        totalTranslations += row.count;
+        byLanguage[row.target_lang] = (byLanguage[row.target_lang] ?? 0) + row.count;
+      } else if (row.status === 'failed') {
+        totalFailed += row.count;
       }
     }
 
@@ -176,14 +149,18 @@ export class TranslationStore {
    */
   count(targetLang?: string, failedOnly?: boolean): number {
     const db = this.getDb();
-    let n = 0;
-    for (const { key, value } of db.getRange({})) {
-      const parsed = parseKey(key as string);
-      if (targetLang && parsed.targetLang !== targetLang) continue;
-      if (failedOnly && value.status !== 'failed') continue;
-      n++;
+    let sql = 'SELECT COUNT(*) as count FROM translations WHERE 1=1';
+    const params: unknown[] = [];
+    if (targetLang) {
+      sql += ' AND target_lang = ?';
+      params.push(targetLang);
+    }
+    if (failedOnly) {
+      sql += ' AND status = ?';
+      params.push('failed');
     }
-    return n;
+    const row = db.prepare(sql).get(...params) as { count: number };
+    return row.count;
   }
 
   /**
@@ -191,18 +168,18 @@ export class TranslationStore {
    */
   async clear(targetLang?: string, failedOnly?: boolean): Promise<number> {
     const db = this.getDb();
-    const toDelete: string[] = [];
-    for (const { key, value } of db.getRange({})) {
-      const keyStr = key as string;
-      const parsed = parseKey(keyStr);
-      if (targetLang && parsed.targetLang !== targetLang) continue;
-      if (failedOnly && value.status !== 'failed') continue;
-      toDelete.push(keyStr);
+    let sql = 'DELETE FROM translations WHERE 1=1';
+    const params: unknown[] = [];
+    if (targetLang) {
+      sql += ' AND target_lang = ?';
+      params.push(targetLang);
     }
-    for (const k of toDelete) {
-      await db.remove(k);
+    if (failedOnly) {
+      sql += ' AND status = ?';
+      params.push('failed');
     }
-    return toDelete.length;
+    const result = db.prepare(sql).run(...params);
+    return result.changes;
   }
 
   close(): void {

package/tests/ait.test.ts

@@ -15,7 +15,7 @@ function makeConfig(tmpDir: string): TransduckConfig {
     projectContext: 'A test site',
     sourceLang: 'EN',
     targetLangs: ['DE', 'ES'],
-    storagePath: join(tmpDir, 'test.lmdb'),
+    storagePath: join(tmpDir, 'test.db'),
     provider: 'openai',
     apiKeyEnv: 'OPENAI_API_KEY',
     tokenEnv: 'CLAUDE_CODE_OAUTH_TOKEN',

package/tests/backend.test.ts

@@ -8,7 +8,7 @@ function makeConfig(): TransduckConfig {
     projectContext: 'A travel site about Mallorca',
     sourceLang: 'EN',
     targetLangs: ['DE'],
-    storagePath: '/tmp/test.lmdb',
+    storagePath: '/tmp/test.db',
     provider: 'openai',
     apiKeyEnv: 'OPENAI_API_KEY',
     tokenEnv: 'CLAUDE_CODE_OAUTH_TOKEN',

package/tests/cli.test.ts

@@ -27,7 +27,7 @@ languages:
   targets:
     - DE
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   api_key_env: OPENAI_API_KEY
   model: gpt-4.1-mini
@@ -55,7 +55,7 @@ describe('CLI functions', () => {
     });
     const { existsSync } = await import('fs');
     expect(existsSync(join(tmpDir, 'transduck.yaml'))).toBe(true);
-    expect(existsSync(join(tmpDir, 'translations.lmdb'))).toBe(true);
+    expect(existsSync(join(tmpDir, 'translations.db'))).toBe(true);
   });
 
   it('stats on empty db shows zero', async () => {
@@ -68,7 +68,7 @@ describe('CLI functions', () => {
 
   it('translate returns cached with vars interpolated', async () => {
     const configPath = writeConfig(tmpDir);
-    const dbPath = join(tmpDir, 'translations.lmdb');
+    const dbPath = join(tmpDir, 'translations.db');
 
     // Pre-populate the DB
     const store = new TranslationStore(dbPath);
@@ -91,7 +91,7 @@ describe('CLI functions', () => {
 
   it('translate-plural returns cached plural form', async () => {
     const configPath = writeConfig(tmpDir);
-    const dbPath = join(tmpDir, 'translations.lmdb');
+    const dbPath = join(tmpDir, 'translations.db');
 
     // Pre-populate the DB with plural forms
     const store = new TranslationStore(dbPath);
@@ -132,7 +132,7 @@ describe('CLI functions', () => {
 
   it('warm handles plural entries', async () => {
     const configPath = writeConfig(tmpDir);
-    const dbPath = join(tmpDir, 'translations.lmdb');
+    const dbPath = join(tmpDir, 'translations.db');
 
     // Pre-populate some plural forms so warm skips them
     const store = new TranslationStore(dbPath);
@@ -202,7 +202,7 @@ describe('CLI functions', () => {
     writeFileSync(join(srcDir, 'app.py'), 'ait("Hello")\n');
 
     // Pre-populate the DB so warm skips
-    const dbPath = join(tmpDir, 'translations.lmdb');
+    const dbPath = join(tmpDir, 'translations.db');
     const store = new TranslationStore(dbPath);
     await store.initialize();
     await store.insert({

package/tests/config.test.ts

@@ -19,7 +19,7 @@ languages:
     - DE
     - ES
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   api_key_env: OPENAI_API_KEY
   model: gpt-4.1-mini
@@ -60,7 +60,7 @@ describe('loadConfig', () => {
     const configPath = join(tmpDir, 'transduck.yaml');
     writeFileSync(configPath, VALID_YAML);
     const cfg = loadConfig(configPath);
-    expect(cfg.storagePath).toBe(join(tmpDir, 'translations.lmdb'));
+    expect(cfg.storagePath).toBe(join(tmpDir, 'translations.db'));
   });
 
   it('discovers config from TRANSDUCK_CONFIG env var', () => {

package/tests/handler.test.ts

@@ -21,7 +21,7 @@ languages:
   targets:
     - DE
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   api_key_env: OPENAI_API_KEY
   model: gpt-4.1-mini
@@ -48,7 +48,7 @@ describe('handleTranslationRequest', () => {
     const { createHash } = await import('crypto');
     const hash = (t: string) => createHash('sha256').update(t).digest('hex');
 
-    const store = new TranslationStore(join(tmpDir, 'translations.lmdb'));
+    const store = new TranslationStore(join(tmpDir, 'translations.db'));
     await store.initialize();
     await store.insert({
       sourceText: 'Hello', sourceLang: 'EN', targetLang: 'DE',
@@ -83,7 +83,7 @@ describe('handleTranslationRequest', () => {
     const { createHash } = await import('crypto');
     const hash = (t: string) => createHash('sha256').update(t).digest('hex');
 
-    const store = new TranslationStore(join(tmpDir, 'translations.lmdb'));
+    const store = new TranslationStore(join(tmpDir, 'translations.db'));
     await store.initialize();
     await store.insert({
       sourceText: 'Book', sourceLang: 'EN', targetLang: 'DE',
@@ -106,7 +106,7 @@ describe('handleTranslationRequest', () => {
     const { createHash } = await import('crypto');
     const hash = (t: string) => createHash('sha256').update(t).digest('hex');
 
-    const store = new TranslationStore(join(tmpDir, 'translations.lmdb'));
+    const store = new TranslationStore(join(tmpDir, 'translations.db'));
     await store.initialize();
     const sourceKey = '{count} item\x00{count} items';
     await store.insertPlural({

package/tests/providers.test.ts

@@ -20,7 +20,7 @@ function makeConfig(overrides: Partial<TransduckConfig> = {}): TransduckConfig {
     projectContext: 'A test site',
     sourceLang: 'EN',
     targetLangs: ['DE'],
-    storagePath: '/tmp/test.lmdb',
+    storagePath: '/tmp/test.db',
     provider: 'openai',
     apiKeyEnv: 'OPENAI_API_KEY',
     tokenEnv: 'CLAUDE_CODE_OAUTH_TOKEN',
@@ -207,7 +207,7 @@ languages:
   source: EN
   targets: [DE]
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   api_key_env: OPENAI_API_KEY
   model: gpt-4.1-mini
@@ -230,7 +230,7 @@ languages:
   source: EN
   targets: [DE]
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   provider: claude_api
   api_key_env: ANTHROPIC_API_KEY
@@ -255,7 +255,7 @@ languages:
   source: EN
   targets: [DE]
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   provider: claude_code
   token_env: CLAUDE_CODE_OAUTH_TOKEN
@@ -277,7 +277,7 @@ languages:
   source: EN
   targets: [DE]
 storage:
-  path: ./translations.lmdb
+  path: ./translations.db
 backend:
   provider: claude_code
 `);

package/tests/storage.test.ts

@@ -14,7 +14,7 @@ describe('TranslationStore', () => {
 
   beforeEach(async () => {
     const tmpDir = mkdtempSync(join(tmpdir(), 'transduck-test-'));
-    store = new TranslationStore(join(tmpDir, 'test.lmdb'));
+    store = new TranslationStore(join(tmpDir, 'test.db'));
     await store.initialize();
   });