glotfile 1.0.1 → 1.1.0

package/dist/server/cli.js

@@ -58,6 +58,14 @@ var init_atomic_write = __esm({
 });
 
 // src/server/lint/registry.ts
+function unknownRuleIds(ids) {
+  const valid = new Set(RULE_IDS);
+  return ids.filter((id) => !valid.has(id));
+}
+function suggestRuleId(unknown) {
+  const lower = unknown.toLowerCase();
+  return RULE_IDS.find((id) => id.includes(lower) || lower.includes(id));
+}
 var RULE_IDS, DEFAULT_SEVERITY;
 var init_registry = __esm({
   "src/server/lint/registry.ts"() {
@@ -271,7 +279,8 @@ function validate(raw) {
     }
   }
   if (raw.glossary !== void 0 && !Array.isArray(raw.glossary)) fail("glossary must be an array");
-  const state = { glossary: [], ...raw };
+  if (raw.glossarySuggestions !== void 0 && !Array.isArray(raw.glossarySuggestions)) fail("glossarySuggestions must be an array");
+  const state = { glossary: [], glossarySuggestions: [], ...raw };
   return state;
 }
 function defaultState() {
@@ -290,6 +299,7 @@ function defaultState() {
       autoExport: true
     },
     glossary: [],
+    glossarySuggestions: [],
     keys: {}
   };
 }
@@ -807,6 +817,39 @@ function upsertGlossaryEntry(state, entry) {
 function deleteGlossaryEntry(state, term) {
   state.glossary = state.glossary.filter((e) => e.term !== term);
 }
+function normGlossaryTerm(term) {
+  return term.trim().toLowerCase();
+}
+function mergeGlossarySuggestions(state, found) {
+  const known = /* @__PURE__ */ new Set();
+  for (const g of state.glossary) known.add(normGlossaryTerm(g.term));
+  for (const s of state.glossarySuggestions) known.add(normGlossaryTerm(s.term));
+  const added = [];
+  for (const f of found) {
+    const term = f.term.trim();
+    if (!term) continue;
+    const key = normGlossaryTerm(term);
+    if (known.has(key)) continue;
+    known.add(key);
+    const sug = { term, status: "pending" };
+    if (f.note?.trim()) sug.note = f.note.trim();
+    if (f.doNotTranslate) sug.doNotTranslate = true;
+    if (f.caseSensitive) sug.caseSensitive = true;
+    if (f.wholeWord === false) sug.wholeWord = false;
+    state.glossarySuggestions.push(sug);
+    added.push(sug);
+  }
+  return added;
+}
+function dismissGlossarySuggestion(state, term) {
+  const key = normGlossaryTerm(term);
+  const s = state.glossarySuggestions.find((x) => normGlossaryTerm(x.term) === key);
+  if (s) s.status = "dismissed";
+}
+function removeGlossarySuggestion(state, term) {
+  const key = normGlossaryTerm(term);
+  state.glossarySuggestions = state.glossarySuggestions.filter((x) => normGlossaryTerm(x.term) !== key);
+}
 function addCustomWord(state, word) {
   const w = word.trim();
   if (!w) return;
@@ -2528,6 +2571,54 @@ var init_batch = __esm({
   }
 });
 
+// src/server/ai/price-cache.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { homedir } from "os";
+import { join as join3 } from "path";
+function isModelPrice(v) {
+  if (!v || typeof v !== "object") return false;
+  const p = v;
+  return typeof p.inputPerMTok === "number" && typeof p.outputPerMTok === "number";
+}
+function loadPriceCache(path = defaultPriceCachePath()) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync4(path, "utf8"));
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const raw = parsed;
+  if (!raw.models || typeof raw.models !== "object") return null;
+  const models = {};
+  for (const [id, price] of Object.entries(raw.models)) {
+    if (isModelPrice(price)) models[id] = price;
+  }
+  return {
+    source: typeof raw.source === "string" ? raw.source : "unknown",
+    fetchedAt: typeof raw.fetchedAt === "string" ? raw.fetchedAt : "",
+    models
+  };
+}
+function savePriceCache(cache2, path = defaultPriceCachePath()) {
+  writeFileAtomic(path, JSON.stringify(cache2, null, 2) + "\n");
+}
+function getPriceCache() {
+  if (memo === void 0) memo = loadPriceCache();
+  return memo;
+}
+function invalidatePriceCache() {
+  memo = void 0;
+}
+var defaultPriceCachePath, memo;
+var init_price_cache = __esm({
+  "src/server/ai/price-cache.ts"() {
+    "use strict";
+    init_atomic_write();
+    defaultPriceCachePath = () => process.env.GLOTFILE_PRICES_PATH || join3(homedir(), ".glotfile", "model-prices.json");
+  }
+});
+
 // src/server/ai/pricing.ts
 function addUsage(into, add) {
   into.inputTokens += add.inputTokens;
@@ -2541,7 +2632,9 @@ function usageCostUsd(usage, ai, multiplier = 1) {
   return pricing ? estimateUsageCostUsd(usage, pricing, multiplier) : void 0;
 }
 function estimateUsageCostUsd(usage, pricing, multiplier = 1) {
-  const inputCost = (usage.inputTokens + usage.cacheCreationInputTokens * CACHE_WRITE_MULTIPLIER + usage.cacheReadInputTokens * CACHE_READ_MULTIPLIER) * pricing.inputPerMTok;
+  const writeRate = pricing.cacheWritePerMTok ?? pricing.inputPerMTok * CACHE_WRITE_MULTIPLIER;
+  const readRate = pricing.cacheReadPerMTok ?? pricing.inputPerMTok * CACHE_READ_MULTIPLIER;
+  const inputCost = usage.inputTokens * pricing.inputPerMTok + usage.cacheCreationInputTokens * writeRate + usage.cacheReadInputTokens * readRate;
   return (inputCost + usage.outputTokens * pricing.outputPerMTok) / 1e6 * multiplier;
 }
 function bareModelId(model) {
@@ -2552,12 +2645,27 @@ function bareModelId(model) {
   if (anth !== -1) id = id.slice(anth + "anthropic.".length);
   return id;
 }
-function resolvePricing(ai) {
+function lookupCachePrice(cache2, id) {
+  const exact = cache2.models[id];
+  if (exact) return { source: "cache", ...exact };
+  let best;
+  for (const [cid, price] of Object.entries(cache2.models)) {
+    if (id.startsWith(cid) && (!best || cid.length > best.id.length)) {
+      best = { id: cid, price: { source: "cache", ...price } };
+    }
+  }
+  return best ? best.price : null;
+}
+function resolvePricing(ai, cache2 = getPriceCache()) {
   if (ai.inputPricePerMTok !== void 0 && ai.outputPricePerMTok !== void 0) {
     return { source: "profile", inputPerMTok: ai.inputPricePerMTok, outputPerMTok: ai.outputPricePerMTok };
   }
   if (FREE_PROVIDERS.has(ai.provider)) return { source: "builtin", inputPerMTok: 0, outputPerMTok: 0 };
   const id = bareModelId(ai.model);
+  if (cache2) {
+    const cached = lookupCachePrice(cache2, id);
+    if (cached) return cached;
+  }
   let best;
   for (const row of PRICE_TABLE) {
     if (id.startsWith(row[0]) && (!best || row[0].length > best[0].length)) best = row;
@@ -2568,6 +2676,7 @@ var BATCH_PRICE_MULTIPLIER, CACHE_WRITE_MULTIPLIER, CACHE_READ_MULTIPLIER, PRICE
 var init_pricing = __esm({
   "src/server/ai/pricing.ts"() {
     "use strict";
+    init_price_cache();
     BATCH_PRICE_MULTIPLIER = 0.5;
     CACHE_WRITE_MULTIPLIER = 1.25;
     CACHE_READ_MULTIPLIER = 0.1;
@@ -3216,11 +3325,11 @@ var init_glotfile_dir = __esm({
 });
 
 // src/server/local-settings.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
 function readJson(path) {
   try {
-    const parsed = JSON.parse(readFileSync4(path, "utf8"));
+    const parsed = JSON.parse(readFileSync5(path, "utf8"));
     return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
   } catch {
     return {};
@@ -3307,13 +3416,23 @@ var init_local_settings = __esm({
 });
 
 // src/server/glossary.ts
-function contains(haystack, needle, caseSensitive) {
-  return caseSensitive ? haystack.includes(needle) : haystack.toLowerCase().includes(needle.toLowerCase());
+function escapeRegExp2(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function contains(haystack, needle, caseSensitive, wholeWord) {
+  if (!wholeWord) {
+    return caseSensitive ? haystack.includes(needle) : haystack.toLowerCase().includes(needle.toLowerCase());
+  }
+  const re = new RegExp(`(?<![\\p{L}\\p{N}])${escapeRegExp2(needle)}(?![\\p{L}\\p{N}])`, caseSensitive ? "u" : "iu");
+  return re.test(haystack);
+}
+function termInSource(source, entry) {
+  return contains(source, entry.term, entry.caseSensitive, entry.wholeWord ?? true);
 }
 function relevantGlossary(source, targetLocale, glossary) {
   const hints = [];
   for (const entry of glossary) {
-    if (!contains(source, entry.term, entry.caseSensitive)) continue;
+    if (!termInSource(source, entry)) continue;
     hints.push({
       term: entry.term,
       doNotTranslate: entry.doNotTranslate,
@@ -3323,10 +3442,20 @@ function relevantGlossary(source, targetLocale, glossary) {
   }
   return hints;
 }
+function sourceKeysForTerm(state, term, opts = {}) {
+  const pseudo = { term, caseSensitive: opts.caseSensitive, wholeWord: opts.wholeWord };
+  const out = [];
+  for (const [key, entry] of Object.entries(state.keys)) {
+    const lv = entry.values[state.config.sourceLocale];
+    const text = lv?.value ?? lv?.forms?.other ?? "";
+    if (text && termInSource(text, pseudo)) out.push(key);
+  }
+  return out;
+}
 function glossaryViolations(source, value, targetLocale, glossary) {
   const out = [];
   for (const entry of glossary) {
-    if (!contains(source, entry.term, entry.caseSensitive)) continue;
+    if (!termInSource(source, entry)) continue;
     if (entry.doNotTranslate) {
       if (!contains(value, entry.term, entry.caseSensitive)) {
         out.push({ term: entry.term, expected: entry.term, kind: "do-not-translate" });
@@ -3347,7 +3476,7 @@ var init_glossary = __esm({
 });
 
 // src/server/ai/run.ts
-import { readFileSync as readFileSync5, existsSync as existsSync5 } from "fs";
+import { readFileSync as readFileSync6, existsSync as existsSync5 } from "fs";
 import { resolve as resolve4, extname } from "path";
 function selectRequests(state, opts) {
   const targets = (opts.locales ?? state.config.locales).filter((l) => l !== state.config.sourceLocale);
@@ -3421,7 +3550,7 @@ function attachScreenshots(reqs, state, projectRoot) {
       if (!existsSync5(abs)) {
         cache2.set(screenshot, null);
       } else {
-        const buf = readFileSync5(abs);
+        const buf = readFileSync6(abs);
         cache2.set(screenshot, buf.length > MAX_IMAGE_BYTES ? null : { mediaType, base64: buf.toString("base64") });
       }
     }
@@ -3567,16 +3696,16 @@ var init_run = __esm({
 });
 
 // src/server/ai/pending-batch.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync3, rmSync as rmSync4 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync3, rmSync as rmSync4 } from "fs";
+import { join as join4 } from "path";
 function pendingBatchPath(projectRoot) {
-  return join3(projectRoot, ".glotfile", "batch.json");
+  return join4(projectRoot, ".glotfile", "batch.json");
 }
 function loadPendingBatch(projectRoot) {
   const path = pendingBatchPath(projectRoot);
   if (!existsSync6(path)) return void 0;
   try {
-    const parsed = JSON.parse(readFileSync6(path, "utf8"));
+    const parsed = JSON.parse(readFileSync7(path, "utf8"));
     if (parsed?.version !== 1) return void 0;
     return parsed;
   } catch {
@@ -3584,9 +3713,9 @@ function loadPendingBatch(projectRoot) {
   }
 }
 function savePendingBatch(projectRoot, pending) {
-  const dir = join3(projectRoot, ".glotfile");
+  const dir = join4(projectRoot, ".glotfile");
   mkdirSync4(dir, { recursive: true });
-  const gitignore = join3(dir, ".gitignore");
+  const gitignore = join4(dir, ".gitignore");
   if (!existsSync6(gitignore)) writeFileSync3(gitignore, "*\n");
   writeFileSync3(pendingBatchPath(projectRoot), JSON.stringify(pending, null, 2) + "\n");
 }
@@ -3600,7 +3729,7 @@ var init_pending_batch = __esm({
 });
 
 // src/server/log.ts
-import { appendFileSync, existsSync as existsSync7, openSync, fstatSync, readSync, closeSync, statSync as statSync2, readFileSync as readFileSync7 } from "fs";
+import { appendFileSync, existsSync as existsSync7, openSync, fstatSync, readSync, closeSync, statSync as statSync2, readFileSync as readFileSync8 } from "fs";
 import { resolve as resolve5 } from "path";
 function logPath(projectRoot) {
   return resolve5(projectRoot, ".glotfile", "log.jsonl");
@@ -3613,7 +3742,7 @@ function appendLog(projectRoot, entry) {
 }
 function trimLog(path, maxBytes = MAX_LOG_BYTES, targetBytes = TRIM_LOG_TO_BYTES) {
   if (!existsSync7(path) || statSync2(path).size <= maxBytes) return;
-  const lines = readFileSync7(path, "utf8").split("\n").filter((l) => l.trim() !== "");
+  const lines = readFileSync8(path, "utf8").split("\n").filter((l) => l.trim() !== "");
   const kept = [];
   let bytes = 0;
   for (let i = lines.length - 1; i >= 0; i--) {
@@ -3812,7 +3941,7 @@ var init_batch_run = __esm({
 });
 
 // src/server/ai/context.ts
-import { existsSync as existsSync8, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync9 } from "fs";
 import { resolve as resolve6 } from "path";
 function globToRegExp2(glob) {
   const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
@@ -3828,7 +3957,7 @@ function extractSnippets(refs, projectRoot, fileCache) {
     const absPath = resolve6(projectRoot, ref.file);
     if (!fileCache.has(ref.file)) {
       if (!existsSync8(absPath)) continue;
-      const content = readFileSync8(absPath, "utf8");
+      const content = readFileSync9(absPath, "utf8");
       fileCache.set(ref.file, content.split("\n"));
     }
     const lines = fileCache.get(ref.file);
@@ -3844,6 +3973,21 @@ function extractSnippets(refs, projectRoot, fileCache) {
   }
   return snippets;
 }
+function attachUsageSnippets(targets, cache2, projectRoot) {
+  const fileCache = /* @__PURE__ */ new Map();
+  for (const target of targets) {
+    const allRefs = Object.entries(cache2.files).flatMap(
+      ([file, entry]) => entry.refs.filter((r) => r.key === target.key).map((r) => ({
+        key: r.key,
+        file,
+        line: r.line,
+        col: r.col,
+        scanner: r.scanner
+      }))
+    );
+    target.usageSnippets = extractSnippets(allRefs, projectRoot, fileCache);
+  }
+}
 function buildUsageIndex(cache2) {
   const index = /* @__PURE__ */ new Map();
   for (const [file, entry] of Object.entries(cache2.files)) {
@@ -3982,16 +4126,16 @@ var init_context = __esm({
 });
 
 // src/server/ai/pending-context-batch.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync4, rmSync as rmSync5 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync4, rmSync as rmSync5 } from "fs";
+import { join as join5 } from "path";
 function pendingContextBatchPath(projectRoot) {
-  return join4(projectRoot, ".glotfile", "context-batch.json");
+  return join5(projectRoot, ".glotfile", "context-batch.json");
 }
 function loadPendingContextBatch(projectRoot) {
   const path = pendingContextBatchPath(projectRoot);
   if (!existsSync9(path)) return void 0;
   try {
-    const parsed = JSON.parse(readFileSync9(path, "utf8"));
+    const parsed = JSON.parse(readFileSync10(path, "utf8"));
     if (parsed?.version !== 1) return void 0;
     return parsed;
   } catch {
@@ -3999,9 +4143,9 @@ function loadPendingContextBatch(projectRoot) {
   }
 }
 function savePendingContextBatch(projectRoot, pending) {
-  const dir = join4(projectRoot, ".glotfile");
+  const dir = join5(projectRoot, ".glotfile");
   mkdirSync5(dir, { recursive: true });
-  const gitignore = join4(dir, ".gitignore");
+  const gitignore = join5(dir, ".gitignore");
   if (!existsSync9(gitignore)) writeFileSync4(gitignore, "*\n");
   writeFileSync4(pendingContextBatchPath(projectRoot), JSON.stringify(pending, null, 2) + "\n");
 }
@@ -4122,6 +4266,109 @@ var init_context_batch_run = __esm({
   }
 });
 
+// src/server/ai/glossary-suggest.ts
+function globToRegExp3(glob) {
+  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+  return new RegExp(`^${escaped}$`);
+}
+function selectGlossarySources(state, opts) {
+  const keyRe = opts.keyGlob ? globToRegExp3(opts.keyGlob) : null;
+  let rows = [];
+  for (const key of Object.keys(state.keys)) {
+    if (keyRe && !keyRe.test(key)) continue;
+    const entry = state.keys[key];
+    if (opts.since) {
+      if (!entry.createdAt || entry.createdAt < opts.since) continue;
+    }
+    const lv = entry.values[state.config.sourceLocale];
+    const source = (lv?.value ?? lv?.forms?.other ?? "").trim();
+    if (!source) continue;
+    rows.push({ key, source });
+  }
+  rows.sort((a, b) => {
+    const ta = state.keys[a.key].createdAt ?? "";
+    const tb = state.keys[b.key].createdAt ?? "";
+    return tb.localeCompare(ta) || a.key.localeCompare(b.key);
+  });
+  if (opts.limit !== void 0) rows = rows.slice(0, opts.limit);
+  return rows;
+}
+function knownTermList(state) {
+  const out = /* @__PURE__ */ new Set();
+  for (const g of state.glossary) out.add(g.term);
+  for (const s of state.glossarySuggestions) out.add(s.term);
+  return [...out];
+}
+function buildGlossarySuggestSystemPrompt() {
+  return [
+    "You identify GLOSSARY-CANDIDATE terms in a UI string catalog so they translate consistently.",
+    "A glossary term is a brand or product name, a feature or module name, an acronym, a piece of domain/industry jargon, or any noun phrase that should translate the SAME way everywhere (or stay verbatim).",
+    "You are given source strings (the app's original language). Return the candidate terms you find.",
+    "Rules:",
+    "- Only surface terms a translator would benefit from pinning. IGNORE ordinary words, verbs, and generic UI labels (e.g. 'Save', 'Cancel', 'Welcome').",
+    "- Prefer terms that recur or are clearly proper nouns / product names / acronyms.",
+    "- Set doNotTranslate: true for brand/product names, code identifiers, and acronyms that must stay verbatim in every language.",
+    "- Set caseSensitive: true only when casing is meaningful (e.g. an all-caps acronym that must not match a lowercase common word).",
+    "- Set wholeWord: false ONLY if the term should also match inside larger words; otherwise omit it (whole-word is the default).",
+    "- note: one short phrase on why it's a term (e.g. 'product name', 'industry acronym', 'recurring UI concept'). Keep it under 80 characters.",
+    "- Do NOT return any term in the provided 'Already known' list.",
+    "- Return the term exactly as it appears in the source (preserve casing)."
+  ].join("\n");
+}
+function buildGlossarySuggestBatchPrompt(sources, knownTerms) {
+  const known = knownTerms.length ? knownTerms.join(", ") : "(none yet)";
+  const lines = sources.map((s) => `- [${s.key}] ${s.source}`).join("\n");
+  return [
+    `Already known (do NOT return these): ${known}`,
+    "",
+    "Source strings:",
+    lines,
+    "",
+    'Return JSON {"terms":[{"term","note?","doNotTranslate?","caseSensitive?","wholeWord?"}]}. Return an empty array if you find no good candidates.'
+  ].join("\n");
+}
+function dedupeTerms(terms) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const t of terms) {
+    const term = t.term?.trim();
+    if (!term) continue;
+    const key = term.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push({ ...t, term });
+  }
+  return out;
+}
+var GLOSSARY_SUGGEST_SCHEMA;
+var init_glossary_suggest = __esm({
+  "src/server/ai/glossary-suggest.ts"() {
+    "use strict";
+    GLOSSARY_SUGGEST_SCHEMA = {
+      type: "object",
+      properties: {
+        terms: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              term: { type: "string" },
+              note: { type: "string" },
+              doNotTranslate: { type: "boolean" },
+              caseSensitive: { type: "boolean" },
+              wholeWord: { type: "boolean" }
+            },
+            required: ["term"],
+            additionalProperties: false
+          }
+        }
+      },
+      required: ["terms"],
+      additionalProperties: false
+    };
+  }
+});
+
 // src/server/ai/estimate.ts
 function estimateTokens(text) {
   const cjk = text.match(CJK_RE)?.length ?? 0;
@@ -4170,29 +4417,131 @@ function estimateTranslation(state, ai, opts) {
     estimatedCost: pricing ? (inputTokens * pricing.inputPerMTok + outputTokens * pricing.outputPerMTok) / 1e6 : null
   };
 }
-var CJK_RE, EXPANSION, ITEM_REPLY_OVERHEAD, FORM_REPLY_OVERHEAD;
+function estimateContext(targets, ai) {
+  const batchSize = Math.max(1, ai.contextBatchSize ?? ai.batchSize ?? 10);
+  const batches = chunk(targets, batchSize);
+  const system = buildContextSystemPrompt();
+  let inputTokens = 0;
+  let outputTokens = 0;
+  for (const batch of batches) {
+    inputTokens += estimateTokens(system) + estimateTokens(buildContextBatchPrompt(batch));
+    outputTokens += batch.length * (CONTEXT_REPLY_OVERHEAD + TYPICAL_CONTEXT_TOKENS);
+  }
+  const pricing = resolvePricing(ai);
+  return {
+    keys: targets.length,
+    batches: batches.length,
+    inputTokens,
+    outputTokens,
+    pricing,
+    estimatedCost: pricing ? (inputTokens * pricing.inputPerMTok + outputTokens * pricing.outputPerMTok) / 1e6 : null
+  };
+}
+function estimateGlossarySuggest(sources, knownTerms, ai) {
+  const batchSize = Math.max(1, ai.contextBatchSize ?? ai.batchSize ?? 10);
+  const batches = chunk(sources, batchSize);
+  const system = buildGlossarySuggestSystemPrompt();
+  let inputTokens = 0;
+  let outputTokens = 0;
+  for (const batch of batches) {
+    inputTokens += estimateTokens(system) + estimateTokens(buildGlossarySuggestBatchPrompt(batch, knownTerms));
+    outputTokens += Math.ceil(batch.length * TERM_YIELD) * TERM_REPLY_TOKENS;
+  }
+  const pricing = resolvePricing(ai);
+  return {
+    sources: sources.length,
+    batches: batches.length,
+    inputTokens,
+    outputTokens,
+    pricing,
+    estimatedCost: pricing ? (inputTokens * pricing.inputPerMTok + outputTokens * pricing.outputPerMTok) / 1e6 : null
+  };
+}
+var CJK_RE, EXPANSION, ITEM_REPLY_OVERHEAD, FORM_REPLY_OVERHEAD, CONTEXT_REPLY_OVERHEAD, TYPICAL_CONTEXT_TOKENS, TERM_REPLY_TOKENS, TERM_YIELD;
 var init_estimate = __esm({
   "src/server/ai/estimate.ts"() {
     "use strict";
     init_run();
     init_provider();
+    init_context();
+    init_glossary_suggest();
     init_batch();
     init_pricing();
     CJK_RE = /[　-鿿가-힯豈-﫿]/g;
     EXPANSION = 1.2;
     ITEM_REPLY_OVERHEAD = 16;
     FORM_REPLY_OVERHEAD = 8;
+    CONTEXT_REPLY_OVERHEAD = 16;
+    TYPICAL_CONTEXT_TOKENS = 35;
+    TERM_REPLY_TOKENS = 24;
+    TERM_YIELD = 0.15;
+  }
+});
+
+// src/server/ai/price-fetch.ts
+function normalizeModelsDevPrices(api) {
+  const out = {};
+  const ranks = {};
+  if (!api || typeof api !== "object") return out;
+  for (const [provId, prov] of Object.entries(api)) {
+    const models = prov?.models;
+    if (!models || typeof models !== "object") continue;
+    const rank = providerRank(provId);
+    for (const [modelKey, model] of Object.entries(models)) {
+      const cost = model?.cost;
+      if (!cost || typeof cost.input !== "number" || typeof cost.output !== "number") continue;
+      const bareId = bareModelId(modelKey);
+      if (!bareId) continue;
+      const existingRank = ranks[bareId];
+      if (existingRank !== void 0 && existingRank <= rank) continue;
+      const price = { inputPerMTok: cost.input, outputPerMTok: cost.output };
+      if (typeof cost.cache_read === "number") price.cacheReadPerMTok = cost.cache_read;
+      if (typeof cost.cache_write === "number") price.cacheWritePerMTok = cost.cache_write;
+      out[bareId] = price;
+      ranks[bareId] = rank;
+    }
+  }
+  return out;
+}
+async function refreshPrices(opts = {}) {
+  const url = opts.url ?? priceUrl();
+  const doFetch = opts.fetchImpl ?? fetch;
+  const res = await doFetch(url);
+  if (!res.ok) throw new Error(`Failed to fetch prices from ${url}: HTTP ${res.status}`);
+  const api = await res.json();
+  const models = normalizeModelsDevPrices(api);
+  const modelCount = Object.keys(models).length;
+  if (modelCount === 0) throw new Error(`No model prices found in response from ${url}`);
+  const cache2 = { source: "models.dev", fetchedAt: (opts.now ?? defaultNow)(), models };
+  const path = opts.path ?? defaultPriceCachePath();
+  savePriceCache(cache2, path);
+  return { source: cache2.source, fetchedAt: cache2.fetchedAt, modelCount, path };
+}
+var MODELS_DEV_URL, priceUrl, PROVIDER_PREFERENCE, providerRank, defaultNow;
+var init_price_fetch = __esm({
+  "src/server/ai/price-fetch.ts"() {
+    "use strict";
+    init_pricing();
+    init_price_cache();
+    MODELS_DEV_URL = "https://models.dev/api.json";
+    priceUrl = () => process.env.GLOTFILE_PRICES_URL || MODELS_DEV_URL;
+    PROVIDER_PREFERENCE = ["anthropic", "openai", "google", "meta-llama", "mistral", "deepseek", "xai", "groq"];
+    providerRank = (provId) => {
+      const i = PROVIDER_PREFERENCE.indexOf(provId);
+      return i === -1 ? PROVIDER_PREFERENCE.length : i;
+    };
+    defaultNow = () => (/* @__PURE__ */ new Date()).toISOString();
   }
 });
 
 // src/server/scan.ts
-import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync11 } from "fs";
 import { resolve as resolve7 } from "path";
 function loadUsageCache(projectRoot) {
   const path = resolve7(projectRoot, ".glotfile", "usage.json");
   if (!existsSync10(path)) return null;
   try {
-    return JSON.parse(readFileSync10(path, "utf8"));
+    return JSON.parse(readFileSync11(path, "utf8"));
   } catch {
     return null;
   }
@@ -4257,8 +4606,8 @@ var init_scan = __esm({
 });
 
 // src/server/scanner.ts
-import { readdirSync as readdirSync3, statSync as statSync3, readFileSync as readFileSync11 } from "fs";
-import { join as join5, extname as extname2, relative } from "path";
+import { readdirSync as readdirSync3, statSync as statSync3, readFileSync as readFileSync12 } from "fs";
+import { join as join6, extname as extname2, relative } from "path";
 function scannerForExt(ext) {
   return EXT_SCANNER[ext] ?? null;
 }
@@ -4480,7 +4829,7 @@ function* walkFiles(dir, root, exclude) {
   }
   for (const name of entries) {
     if (ALWAYS_EXCLUDE.has(name)) continue;
-    const abs = join5(dir, name);
+    const abs = join6(dir, name);
     const rel = relative(root, abs);
     let st;
     try {
@@ -4510,7 +4859,7 @@ function runScan(projectRoot, opts, existing) {
     const ext = extname2(relPath);
     const scanner = scannerForExt(ext);
     if (!scanner) continue;
-    const abs = join5(projectRoot, relPath);
+    const abs = join6(projectRoot, relPath);
     let st;
     try {
       st = statSync3(abs);
@@ -4526,7 +4875,7 @@ function runScan(projectRoot, opts, existing) {
     }
     let content;
     try {
-      content = readFileSync11(abs, "utf8");
+      content = readFileSync12(abs, "utf8");
     } catch {
       continue;
     }
@@ -4660,8 +5009,8 @@ var init_scanner = __esm({
 });
 
 // src/server/import/detect.ts
-import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync12, statSync as statSync4 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync4, readFileSync as readFileSync13, statSync as statSync4 } from "fs";
+import { join as join7 } from "path";
 function safeIsDir(p) {
   try {
     return statSync4(p).isDirectory();
@@ -4670,7 +5019,7 @@ function safeIsDir(p) {
   }
 }
 function listDirs(dir) {
-  return readdirSync4(dir).filter((e) => safeIsDir(join6(dir, e)));
+  return readdirSync4(dir).filter((e) => safeIsDir(join7(dir, e)));
 }
 function fileCount(dir) {
   try {
@@ -4684,23 +5033,23 @@ function pickSource(locales, sizeOf) {
   return [...locales].sort((a, b) => sizeOf(b) - sizeOf(a) || a.localeCompare(b))[0] ?? "en";
 }
 function detectLaravel(root) {
-  const localeRoot = [join6(root, "resources", "lang"), join6(root, "lang")].find(safeIsDir);
+  const localeRoot = [join7(root, "resources", "lang"), join7(root, "lang")].find(safeIsDir);
   if (!localeRoot) return null;
   const locales = listDirs(localeRoot).filter((d) => LOCALE_RE.test(d));
   if (locales.length === 0) return null;
-  const sourceLocale = pickSource(locales, (loc) => fileCount(join6(localeRoot, loc)));
+  const sourceLocale = pickSource(locales, (loc) => fileCount(join7(localeRoot, loc)));
   return { format: "laravel-php", localeRoot, locales, sourceLocale };
 }
 function detectVue(root, forced = false) {
   for (const rel of VUE_DIR_CANDIDATES) {
-    const localeRoot = join6(root, rel);
+    const localeRoot = join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const locales = readdirSync4(localeRoot).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).filter((l) => LOCALE_RE.test(l));
     const enough = locales.length >= 2 || locales.length === 1 && (forced || locales[0] === "en" || locales[0].startsWith("en-") || locales[0].startsWith("en_"));
     if (enough) {
       const sourceLocale = pickSource(locales, (loc) => {
         try {
-          return statSync4(join6(localeRoot, `${loc}.json`)).size;
+          return statSync4(join7(localeRoot, `${loc}.json`)).size;
         } catch {
           return 0;
         }
@@ -4711,9 +5060,9 @@ function detectVue(root, forced = false) {
   return null;
 }
 function hasNextIntlSignal(root) {
-  if (NEXT_INTL_CONFIG_CANDIDATES.some((rel) => existsSync11(join6(root, rel)))) return true;
+  if (NEXT_INTL_CONFIG_CANDIDATES.some((rel) => existsSync11(join7(root, rel)))) return true;
   try {
-    const pkg = JSON.parse(readFileSync12(join6(root, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync13(join7(root, "package.json"), "utf8"));
     if (pkg.dependencies?.["next-intl"] || pkg.devDependencies?.["next-intl"]) return true;
   } catch {
   }
@@ -4722,7 +5071,7 @@ function hasNextIntlSignal(root) {
 function nextIntlDefaultLocale(root) {
   for (const rel of NEXT_INTL_ROUTING_CANDIDATES) {
     try {
-      const m = readFileSync12(join6(root, rel), "utf8").match(/defaultLocale\s*:\s*['"]([^'"]+)['"]/);
+      const m = readFileSync13(join7(root, rel), "utf8").match(/defaultLocale\s*:\s*['"]([^'"]+)['"]/);
       if (m) return m[1];
     } catch {
     }
@@ -4732,14 +5081,14 @@ function nextIntlDefaultLocale(root) {
 function detectNextIntl(root, forced = false) {
   if (!forced && !hasNextIntlSignal(root)) return null;
   for (const rel of NEXT_INTL_DIR_CANDIDATES) {
-    const localeRoot = join6(root, rel);
+    const localeRoot = join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const locales = readdirSync4(localeRoot).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).filter((l) => LOCALE_RE.test(l));
     if (locales.length === 0) continue;
     const def = nextIntlDefaultLocale(root);
     const sourceLocale = def && locales.includes(def) ? def : pickSource(locales, (loc) => {
       try {
-        return statSync4(join6(localeRoot, `${loc}.json`)).size;
+        return statSync4(join7(localeRoot, `${loc}.json`)).size;
       } catch {
         return 0;
       }
@@ -4750,7 +5099,7 @@ function detectNextIntl(root, forced = false) {
 }
 function detectArb(root) {
   for (const rel of ["lib/l10n", "l10n", "lib/src/l10n"]) {
-    const localeRoot = join6(root, rel);
+    const localeRoot = join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const locales = readdirSync4(localeRoot).map((f) => f.match(/^(?:app_)?(.+)\.arb$/)?.[1]).filter((l) => !!l && LOCALE_RE.test(l));
     if (locales.length >= 1) {
@@ -4760,10 +5109,10 @@ function detectArb(root) {
   return null;
 }
 function lprojLocales(dir) {
-  return listDirs(dir).map((d) => d.match(/^(.+)\.lproj$/)?.[1]).filter((l) => !!l && LOCALE_RE.test(l) && existsSync11(join6(dir, `${l}.lproj`, "Localizable.strings")));
+  return listDirs(dir).map((d) => d.match(/^(.+)\.lproj$/)?.[1]).filter((l) => !!l && LOCALE_RE.test(l) && existsSync11(join7(dir, `${l}.lproj`, "Localizable.strings")));
 }
 function detectApple(root) {
-  const candidates = [root, ...listDirs(root).map((d) => join6(root, d))];
+  const candidates = [root, ...listDirs(root).map((d) => join7(root, d))];
   let best = null;
   for (const dir of candidates) {
     const locales = lprojLocales(dir);
@@ -4775,7 +5124,7 @@ function detectApple(root) {
         locales,
         sourceLocale: pickSource(locales, (loc) => {
           try {
-            return statSync4(join6(dir, `${loc}.lproj`, "Localizable.strings")).size;
+            return statSync4(join7(dir, `${loc}.lproj`, "Localizable.strings")).size;
           } catch {
             return 0;
           }
@@ -4787,7 +5136,7 @@ function detectApple(root) {
 }
 function detectAngularXliff(root) {
   for (const rel of ANGULAR_DIR_CANDIDATES) {
-    const localeRoot = rel === "." ? root : join6(root, rel);
+    const localeRoot = rel === "." ? root : join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const files = readdirSync4(localeRoot).filter((f) => /^messages(\..+)?\.xlf$/.test(f)).sort();
     if (files.length === 0) continue;
@@ -4795,7 +5144,7 @@ function detectAngularXliff(root) {
     const attrFile = files.includes("messages.xlf") ? "messages.xlf" : files[0];
     let sourceLocale;
     try {
-      sourceLocale = readFileSync12(join6(localeRoot, attrFile), "utf8").match(/source-language="([^"]+)"/)?.[1];
+      sourceLocale = readFileSync13(join7(localeRoot, attrFile), "utf8").match(/source-language="([^"]+)"/)?.[1];
     } catch {
     }
     if (!sourceLocale && locales.length === 0) continue;
@@ -4806,14 +5155,14 @@ function detectAngularXliff(root) {
   return null;
 }
 function detectRails(root) {
-  const localeRoot = join6(root, "config", "locales");
+  const localeRoot = join7(root, "config", "locales");
   if (!safeIsDir(localeRoot)) return null;
   const locales = [];
   for (const file of readdirSync4(localeRoot).sort()) {
     if (!/\.ya?ml$/.test(file)) continue;
     let text;
     try {
-      text = readFileSync12(join6(localeRoot, file), "utf8");
+      text = readFileSync13(join7(localeRoot, file), "utf8");
     } catch {
       continue;
     }
@@ -4827,15 +5176,15 @@ function detectRails(root) {
 }
 function detectI18next(root) {
   for (const rel of I18NEXT_DIR_CANDIDATES) {
-    const localeRoot = join6(root, rel);
+    const localeRoot = join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const locales = listDirs(localeRoot).filter(
-      (d) => LOCALE_RE.test(d) && readdirSync4(join6(localeRoot, d)).some((f) => f.endsWith(".json"))
+      (d) => LOCALE_RE.test(d) && readdirSync4(join7(localeRoot, d)).some((f) => f.endsWith(".json"))
     );
     if (locales.length === 0) continue;
     const sourceLocale = pickSource(locales, (loc) => {
       try {
-        return readdirSync4(join6(localeRoot, loc)).filter((f) => f.endsWith(".json")).reduce((sum, f) => sum + statSync4(join6(localeRoot, loc, f)).size, 0);
+        return readdirSync4(join7(localeRoot, loc)).filter((f) => f.endsWith(".json")).reduce((sum, f) => sum + statSync4(join7(localeRoot, loc, f)).size, 0);
       } catch {
         return 0;
       }
@@ -4852,8 +5201,8 @@ function gettextLocales(dir) {
       if (!locales.includes(flat)) locales.push(flat);
       continue;
     }
-    if (!LOCALE_RE.test(entry) || !safeIsDir(join6(dir, entry))) continue;
-    const sub = join6(dir, entry);
+    if (!LOCALE_RE.test(entry) || !safeIsDir(join7(dir, entry))) continue;
+    const sub = join7(dir, entry);
     const hasPo = (d) => {
       try {
         return readdirSync4(d).some((f) => f.endsWith(".po"));
@@ -4861,7 +5210,7 @@ function gettextLocales(dir) {
         return false;
       }
     };
-    if (hasPo(join6(sub, "LC_MESSAGES")) || hasPo(sub)) {
+    if (hasPo(join7(sub, "LC_MESSAGES")) || hasPo(sub)) {
       if (!locales.includes(entry)) locales.push(entry);
     }
   }
@@ -4869,7 +5218,7 @@ function gettextLocales(dir) {
 }
 function detectGettext(root) {
   for (const rel of GETTEXT_DIR_CANDIDATES) {
-    const localeRoot = join6(root, rel);
+    const localeRoot = join7(root, rel);
     if (!safeIsDir(localeRoot)) continue;
     const locales = gettextLocales(localeRoot);
     if (locales.length === 0) continue;
@@ -4878,10 +5227,10 @@ function detectGettext(root) {
   return null;
 }
 function detectAppleStringsdict(root) {
-  const candidates = [root, ...listDirs(root).map((d) => join6(root, d))];
+  const candidates = [root, ...listDirs(root).map((d) => join7(root, d))];
   let best = null;
   for (const dir of candidates) {
-    const locales = listDirs(dir).map((d) => d.match(/^(.+)\.lproj$/)?.[1]).filter((l) => !!l && LOCALE_RE.test(l) && existsSync11(join6(dir, `${l}.lproj`, "Localizable.stringsdict")));
+    const locales = listDirs(dir).map((d) => d.match(/^(.+)\.lproj$/)?.[1]).filter((l) => !!l && LOCALE_RE.test(l) && existsSync11(join7(dir, `${l}.lproj`, "Localizable.stringsdict")));
     if (locales.length === 0) continue;
     if (!best || locales.length > best.locales.length) {
       best = { format: "apple-stringsdict", localeRoot: dir, locales, sourceLocale: pickSource(locales, () => 0) };
@@ -4968,8 +5317,8 @@ var init_flatten = __esm({
 });
 
 // src/server/import/parsers/vue-i18n-json.ts
-import { readdirSync as readdirSync5, readFileSync as readFileSync13 } from "fs";
-import { join as join7 } from "path";
+import { readdirSync as readdirSync5, readFileSync as readFileSync14 } from "fs";
+import { join as join8 } from "path";
 function fromVueI18n(value) {
   return value.replace(/\{'([^']*)'\}/g, "'$1'");
 }
@@ -4992,7 +5341,7 @@ var init_vue_i18n_json2 = __esm({
           if (opts?.locales && !opts.locales.includes(locale)) continue;
           let data;
           try {
-            data = JSON.parse(readFileSync13(join7(localeRoot, file), "utf8"));
+            data = JSON.parse(readFileSync14(join8(localeRoot, file), "utf8"));
           } catch (e) {
             warnings.push(`vue-i18n-json: failed to parse ${file}: ${e.message}`);
             continue;
@@ -5009,8 +5358,8 @@ var init_vue_i18n_json2 = __esm({
 });
 
 // src/server/import/parsers/next-intl-json.ts
-import { readdirSync as readdirSync6, readFileSync as readFileSync14 } from "fs";
-import { join as join8 } from "path";
+import { readdirSync as readdirSync6, readFileSync as readFileSync15 } from "fs";
+import { join as join9 } from "path";
 var LOCALE_RE3, nextIntlJson2;
 var init_next_intl_json2 = __esm({
   "src/server/import/parsers/next-intl-json.ts"() {
@@ -5030,7 +5379,7 @@ var init_next_intl_json2 = __esm({
           if (opts?.locales && !opts.locales.includes(locale)) continue;
           let data;
           try {
-            data = JSON.parse(readFileSync14(join8(localeRoot, file), "utf8"));
+            data = JSON.parse(readFileSync15(join9(localeRoot, file), "utf8"));
           } catch (e) {
             warnings.push(`next-intl-json: failed to parse ${file}: ${e.message}`);
             continue;
@@ -5064,16 +5413,16 @@ var init_placeholders2 = __esm({
 
 // src/server/import/parsers/laravel-php.ts
 import { readdirSync as readdirSync7, statSync as statSync5 } from "fs";
-import { join as join9, relative as relative2 } from "path";
+import { join as join10, relative as relative2 } from "path";
 import { execFileSync } from "child_process";
 function listDirs2(dir) {
-  return readdirSync7(dir).filter((e) => statSync5(join9(dir, e)).isDirectory());
+  return readdirSync7(dir).filter((e) => statSync5(join10(dir, e)).isDirectory());
 }
 function listPhpFiles(dir) {
   const out = [];
   const walk = (d) => {
     for (const e of readdirSync7(d)) {
-      const full = join9(d, e);
+      const full = join10(d, e);
       if (statSync5(full).isDirectory()) walk(full);
       else if (e.endsWith(".php")) out.push(full);
     }
@@ -5116,7 +5465,7 @@ var init_laravel_php2 = __esm({
         for (const locale of listDirs2(localeRoot).sort()) {
           if (locale === "vendor") continue;
           if (opts?.locales && !opts.locales.includes(locale)) continue;
-          const localeDir = join9(localeRoot, locale);
+          const localeDir = join10(localeRoot, locale);
           locales.push(locale);
           for (const file of listPhpFiles(localeDir)) {
             const group = relative2(localeDir, file).replace(/\\/g, "/").replace(/\.php$/, "");
@@ -5141,8 +5490,8 @@ var init_laravel_php2 = __esm({
 });
 
 // src/server/import/parsers/flutter-arb.ts
-import { readdirSync as readdirSync8, readFileSync as readFileSync15 } from "fs";
-import { join as join10 } from "path";
+import { readdirSync as readdirSync8, readFileSync as readFileSync16 } from "fs";
+import { join as join11 } from "path";
 function localeFromArbName(file) {
   const m = file.match(/^(.+)\.arb$/);
   if (!m) return null;
@@ -5182,7 +5531,7 @@ var init_flutter_arb2 = __esm({
           if (opts?.locales && !opts.locales.includes(locale)) continue;
           let data;
           try {
-            data = JSON.parse(readFileSync15(join10(localeRoot, file), "utf8"));
+            data = JSON.parse(readFileSync16(join11(localeRoot, file), "utf8"));
           } catch (e) {
             warnings.push(`flutter-arb: failed to parse ${file}: ${e.message}`);
             continue;
@@ -5209,8 +5558,8 @@ var init_flutter_arb2 = __esm({
 });
 
 // src/server/import/parsers/apple-strings.ts
-import { readdirSync as readdirSync9, readFileSync as readFileSync16, statSync as statSync6 } from "fs";
-import { join as join11 } from "path";
+import { readdirSync as readdirSync9, readFileSync as readFileSync17, statSync as statSync6 } from "fs";
+import { join as join12 } from "path";
 function localeFromLproj(dir) {
   const m = dir.match(/^(.+)\.lproj$/);
   if (!m) return null;
@@ -5330,16 +5679,16 @@ var init_apple_strings2 = __esm({
           const locale = localeFromLproj(dir);
           if (!locale) continue;
           if (opts?.locales && !opts.locales.includes(locale)) continue;
-          const file = join11(localeRoot, dir, TABLE);
+          const file = join12(localeRoot, dir, TABLE);
           let text;
           try {
             if (!statSync6(file).isFile()) continue;
-            text = readFileSync16(file, "utf8");
+            text = readFileSync17(file, "utf8");
           } catch {
             continue;
           }
           locales.push(locale);
-          const others = readdirSync9(join11(localeRoot, dir)).filter((f) => f.endsWith(".strings") && f !== TABLE);
+          const others = readdirSync9(join12(localeRoot, dir)).filter((f) => f.endsWith(".strings") && f !== TABLE);
           if (others.length) {
             warnings.push(`apple-strings: ${dir} has other .strings tables (${others.join(", ")}); only ${TABLE} is imported`);
           }
@@ -5354,8 +5703,8 @@ var init_apple_strings2 = __esm({
 });
 
 // src/server/import/parsers/angular-xliff.ts
-import { readdirSync as readdirSync10, readFileSync as readFileSync17 } from "fs";
-import { join as join12 } from "path";
+import { readdirSync as readdirSync10, readFileSync as readFileSync18 } from "fs";
+import { join as join13 } from "path";
 function decodeEntities(s) {
   return s.replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16))).replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d))).replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
 }
@@ -5426,7 +5775,7 @@ var init_angular_xliff2 = __esm({
           if (fnameLocale !== void 0 && !LOCALE_RE6.test(fnameLocale)) continue;
           let xml;
           try {
-            xml = readFileSync17(join12(localeRoot, file), "utf8");
+            xml = readFileSync18(join13(localeRoot, file), "utf8");
           } catch (e) {
             warnings.push(`angular-xliff: failed to read ${file}: ${e.message}`);
             continue;
@@ -5473,8 +5822,8 @@ var init_angular_xliff2 = __esm({
 });
 
 // src/server/import/parsers/gettext-po.ts
-import { readdirSync as readdirSync11, readFileSync as readFileSync18 } from "fs";
-import { join as join13 } from "path";
+import { readdirSync as readdirSync11, readFileSync as readFileSync19 } from "fs";
+import { join as join14 } from "path";
 function unescapePo(s) {
   return s.replace(
     /\\([\\"ntr])/g,
@@ -5563,17 +5912,17 @@ function discoverPoFiles(root) {
   for (const e of entries) {
     if (e.isFile() && e.name.endsWith(".po")) {
       const base = e.name.slice(0, -3);
-      found.push({ path: join13(root, e.name), rel: e.name, locale: LOCALE_RE7.test(base) ? base : null });
+      found.push({ path: join14(root, e.name), rel: e.name, locale: LOCALE_RE7.test(base) ? base : null });
     } else if (e.isDirectory() && LOCALE_RE7.test(e.name)) {
-      for (const sub of [join13(e.name, "LC_MESSAGES"), e.name]) {
+      for (const sub of [join14(e.name, "LC_MESSAGES"), e.name]) {
         let names;
         try {
-          names = readdirSync11(join13(root, sub)).sort();
+          names = readdirSync11(join14(root, sub)).sort();
         } catch {
           continue;
         }
         for (const f of names) {
-          if (f.endsWith(".po")) found.push({ path: join13(root, sub, f), rel: join13(sub, f), locale: e.name });
+          if (f.endsWith(".po")) found.push({ path: join14(root, sub, f), rel: join14(sub, f), locale: e.name });
         }
       }
     }
@@ -5597,7 +5946,7 @@ var init_gettext_po2 = __esm({
         for (const file of discoverPoFiles(localeRoot)) {
           let entries;
           try {
-            entries = parseEntries(readFileSync18(file.path, "utf8"));
+            entries = parseEntries(readFileSync19(file.path, "utf8"));
           } catch (e) {
             warnings.push(`gettext-po: failed to parse ${file.rel}: ${e.message}`);
             continue;
@@ -5644,8 +5993,8 @@ var init_gettext_po2 = __esm({
 });
 
 // src/server/import/parsers/i18next-json.ts
-import { readdirSync as readdirSync12, readFileSync as readFileSync19, statSync as statSync7 } from "fs";
-import { join as join14 } from "path";
+import { readdirSync as readdirSync12, readFileSync as readFileSync20, statSync as statSync7 } from "fs";
+import { join as join15 } from "path";
 function safeIsDir2(p) {
   try {
     return statSync7(p).isDirectory();
@@ -5660,7 +6009,7 @@ function fromI18next(value) {
 function ingestFile(path, label, prefix, locale, keys, warnings) {
   let data;
   try {
-    data = JSON.parse(readFileSync19(path, "utf8"));
+    data = JSON.parse(readFileSync20(path, "utf8"));
   } catch (e) {
     warnings.push(`i18next-json: failed to parse ${label}: ${e.message}`);
     return false;
@@ -5713,7 +6062,7 @@ var init_i18next_json2 = __esm({
         const keys = {};
         const locales = [];
         for (const entry of readdirSync12(localeRoot).sort()) {
-          const full = join14(localeRoot, entry);
+          const full = join15(localeRoot, entry);
           if (safeIsDir2(full)) {
             if (!LOCALE_RE8.test(entry)) continue;
             if (opts?.locales && !opts.locales.includes(entry)) continue;
@@ -5722,7 +6071,7 @@ var init_i18next_json2 = __esm({
               if (!file.endsWith(".json")) continue;
               const ns = file.slice(0, -".json".length);
               const prefix = ns === DEFAULT_NAMESPACE ? "" : `${ns}.`;
-              if (ingestFile(join14(full, file), `${entry}/${file}`, prefix, entry, keys, warnings)) any = true;
+              if (ingestFile(join15(full, file), `${entry}/${file}`, prefix, entry, keys, warnings)) any = true;
             }
             if (any && !locales.includes(entry)) locales.push(entry);
           } else if (entry.endsWith(".json")) {
@@ -5741,8 +6090,8 @@ var init_i18next_json2 = __esm({
 });
 
 // src/server/import/parsers/rails-yaml.ts
-import { readdirSync as readdirSync13, readFileSync as readFileSync20 } from "fs";
-import { join as join15 } from "path";
+import { readdirSync as readdirSync13, readFileSync as readFileSync21 } from "fs";
+import { join as join16 } from "path";
 function makeNode() {
   return /* @__PURE__ */ Object.create(null);
 }
@@ -5966,7 +6315,7 @@ var init_rails_yaml2 = __esm({
           if (!file.endsWith(".yml") && !file.endsWith(".yaml")) continue;
           let text;
           try {
-            text = readFileSync20(join15(localeRoot, file), "utf8");
+            text = readFileSync21(join16(localeRoot, file), "utf8");
           } catch (e) {
             warnings.push(`rails-yaml: failed to read ${file}: ${e.message}`);
             continue;
@@ -5989,8 +6338,8 @@ var init_rails_yaml2 = __esm({
 });
 
 // src/server/import/parsers/apple-stringsdict.ts
-import { readdirSync as readdirSync14, readFileSync as readFileSync21, statSync as statSync8 } from "fs";
-import { join as join16 } from "path";
+import { readdirSync as readdirSync14, readFileSync as readFileSync22, statSync as statSync8 } from "fs";
+import { join as join17 } from "path";
 function localeFromLproj2(dir) {
   const m = dir.match(/^(.+)\.lproj$/);
   if (!m) return null;
@@ -6150,16 +6499,16 @@ var init_apple_stringsdict2 = __esm({
           const locale = localeFromLproj2(dir);
           if (!locale) continue;
           if (opts?.locales && !opts.locales.includes(locale)) continue;
-          const file = join16(localeRoot, dir, TABLE2);
+          const file = join17(localeRoot, dir, TABLE2);
           let text;
           try {
             if (!statSync8(file).isFile()) continue;
-            text = readFileSync21(file, "utf8");
+            text = readFileSync22(file, "utf8");
           } catch {
             continue;
           }
           locales.push(locale);
-          const others = readdirSync14(join16(localeRoot, dir)).filter(
+          const others = readdirSync14(join17(localeRoot, dir)).filter(
             (f) => f.endsWith(".stringsdict") && f !== TABLE2
           );
           if (others.length) {
@@ -6633,7 +6982,7 @@ var init_run2 = __esm({
 });
 
 // src/server/lint/outputs.ts
-import { readFileSync as readFileSync22, existsSync as existsSync12 } from "fs";
+import { readFileSync as readFileSync23, existsSync as existsSync12 } from "fs";
 import { resolve as resolve8 } from "path";
 function checkOutputs(state, root) {
   const out = [];
@@ -6641,7 +6990,7 @@ function checkOutputs(state, root) {
     const result = getAdapter(output.adapter).export(state, output);
     for (const file of result.files) {
       const abs = resolve8(root, file.path);
-      const current = existsSync12(abs) ? readFileSync22(abs, "utf8") : null;
+      const current = existsSync12(abs) ? readFileSync23(abs, "utf8") : null;
       if (current === null) {
         out.push({ ruleId: "output-stale", key: file.path, locale: "", severity: "error", message: "output file is missing; run `glotfile export`" });
       } else if (current !== file.contents) {
@@ -6749,6 +7098,7 @@ function assemble2(parsed, opts) {
       spelling: { customWords: [] }
     },
     glossary: [],
+    glossarySuggestions: [],
     keys,
     warnings
   };
@@ -7092,13 +7442,63 @@ var init_checks = __esm({
   }
 });
 
+// src/server/ai/explain-error.ts
+function rawMessage(err) {
+  if (err instanceof Error && err.message) return err.message;
+  if (typeof err === "string") return err;
+  if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+    return err.message;
+  }
+  return String(err ?? "Unknown error");
+}
+function explainProviderError(provider, err) {
+  const raw = rawMessage(err);
+  const m = raw.toLowerCase();
+  if (provider === "bedrock") {
+    if (/could not load credentials|unable to locate credentials|credentialsprovider|credentials from any providers/.test(m)) {
+      return "No AWS credentials found. Set AWS_PROFILE (or AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY) in your shell or a .env file in the directory you started glotfile from, or use an SSO / instance role. If you just edited .env, restart glotfile so it reloads. For SSO, run `aws sso login`.";
+    }
+    if (/on-demand throughput isn.?t supported/.test(m) || /inference profile/.test(m)) {
+      return 'This Bedrock model needs an inference profile for on-demand use. Prefix the model id with your region group \u2014 e.g. "eu.anthropic.claude-3-5-sonnet-20241022-v2:0" (or "us." / "apac." for your region).';
+    }
+    if (/not authorized to perform/.test(m) || /no identity-based policy/.test(m) || /bedrock:invoke/.test(m)) {
+      return "Your AWS credentials authenticated, but their IAM policy doesn't allow this action. Add bedrock:InvokeModel (and bedrock:InvokeModelWithResponseStream) for this model to the IAM policy on this user/role.";
+    }
+    if (/access to the model|don.?t have access to the model/.test(m)) {
+      return "Your account doesn't have access to this model in this region. Enable it in the Bedrock console under Model access, for the region you configured.";
+    }
+    if (/access ?denied/.test(m)) {
+      return "Bedrock denied access. Either the model isn't enabled for your account/region (enable it in the Bedrock console under Model access) or your IAM policy is missing bedrock:InvokeModel for this model.";
+    }
+    if (/region/.test(m)) {
+      return "No AWS region set for Bedrock. Set the Region in AI settings, or AWS_REGION in your environment.";
+    }
+  }
+  const keyEnv = KEY_ENV[provider];
+  if (keyEnv && /api key|unauthorized|\b401\b|authentication|incorrect api key|invalid x-api-key/.test(m)) {
+    return `${provider} rejected the request \u2014 check ${keyEnv}. Set it in your environment or a .env file in the directory you started glotfile from.`;
+  }
+  return raw;
+}
+var KEY_ENV;
+var init_explain_error = __esm({
+  "src/server/ai/explain-error.ts"() {
+    "use strict";
+    KEY_ENV = {
+      anthropic: "ANTHROPIC_API_KEY",
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY"
+    };
+  }
+});
+
 // src/server/ui-prefs.ts
-import { readFileSync as readFileSync23 } from "fs";
-import { homedir } from "os";
-import { join as join17 } from "path";
+import { readFileSync as readFileSync24 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join18 } from "path";
 function readJson2(path) {
   try {
-    const parsed = JSON.parse(readFileSync23(path, "utf8"));
+    const parsed = JSON.parse(readFileSync24(path, "utf8"));
     return parsed && typeof parsed === "object" ? parsed : {};
   } catch {
     return {};
@@ -7123,7 +7523,7 @@ var init_ui_prefs = __esm({
     THEMES = ["system", "light", "dark"];
     isThemeMode = (v) => THEMES.includes(v);
     isPanelWidth = (v) => typeof v === "number" && Number.isFinite(v) && v >= 120 && v <= 1200;
-    defaultUiPrefsPath = () => join17(homedir(), ".glotfile", "ui.json");
+    defaultUiPrefsPath = () => join18(homedir2(), ".glotfile", "ui.json");
     DEFAULTS = { theme: "system" };
   }
 });
@@ -7157,7 +7557,7 @@ var init_events = __esm({
 
 // src/server/watch.ts
 import { statSync as statSync9, readdirSync as readdirSync15 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 import { createHash as createHash2 } from "crypto";
 function hashState(state) {
   return createHash2("sha1").update(serializeJson(state, state.config.format)).digest("hex");
@@ -7173,15 +7573,15 @@ function signature(statePath) {
   const parts = [];
   for (const rel of ["config.json", "keys.json"]) {
     try {
-      const s = statSync9(join18(dir, rel));
+      const s = statSync9(join19(dir, rel));
       parts.push(`${rel}:${s.size}:${s.mtimeMs}`);
     } catch {
     }
   }
   try {
-    for (const name of readdirSync15(join18(dir, "locales")).sort()) {
+    for (const name of readdirSync15(join19(dir, "locales")).sort()) {
       if (!name.endsWith(".json")) continue;
-      const s = statSync9(join18(dir, "locales", name));
+      const s = statSync9(join19(dir, "locales", name));
       parts.push(`${name}:${s.size}:${s.mtimeMs}`);
     }
   } catch {
@@ -7260,34 +7660,19 @@ var init_watch = __esm({
 // src/server/api.ts
 import { Hono } from "hono";
 import { streamSSE } from "hono/streaming";
-import { readFileSync as readFileSync24, existsSync as existsSync13, readdirSync as readdirSync16, statSync as statSync10, rmSync as rmSync6 } from "fs";
+import { readFileSync as readFileSync25, existsSync as existsSync13, readdirSync as readdirSync16, statSync as statSync10, rmSync as rmSync6 } from "fs";
 import { dirname as dirname3, resolve as resolve9, basename, relative as relative4, sep as sep2 } from "path";
 function projectName(root) {
   const nameFile = resolve9(root, ".idea", ".name");
   if (existsSync13(nameFile)) {
     try {
-      const name = readFileSync24(nameFile, "utf8").trim();
+      const name = readFileSync25(nameFile, "utf8").trim();
       if (name) return name;
     } catch {
     }
   }
   return basename(root);
 }
-function attachUsageSnippets(targets, cache2, projectRoot) {
-  const fileCache = /* @__PURE__ */ new Map();
-  for (const target of targets) {
-    const allRefs = Object.entries(cache2.files).flatMap(
-      ([file, entry]) => entry.refs.filter((r) => r.key === target.key).map((r) => ({
-        key: r.key,
-        file,
-        line: r.line,
-        col: r.col,
-        scanner: r.scanner
-      }))
-    );
-    target.usageSnippets = extractSnippets(allRefs, projectRoot, fileCache);
-  }
-}
 function createApi(deps) {
   const app = new Hono();
   const load = () => loadState(deps.statePath);
@@ -7419,6 +7804,61 @@ function createApi(deps) {
     }
     return c.json({ ok: true });
   });
+  app.post("/ai-test", async (c) => {
+    const aiCfg = loadLocalSettings(projectRoot).ai;
+    const meta = { provider: aiCfg.provider, model: aiCfg.model };
+    let provider;
+    try {
+      provider = deps.makeProvider ? deps.makeProvider() : makeProvider(aiCfg);
+    } catch (e) {
+      return c.json({ ok: false, ...meta, error: explainProviderError(aiCfg.provider, e) });
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 3e4);
+    try {
+      const probe = {
+        id: "probe",
+        key: "glotfile.connection-test",
+        source: "Hello",
+        sourceLocale: "en",
+        targetLocale: "es",
+        placeholders: []
+      };
+      await provider.translate([probe], void 0, controller.signal);
+      return c.json({ ok: true, ...meta });
+    } catch (e) {
+      const error = controller.signal.aborted ? "Connection test timed out after 30s \u2014 the provider didn't respond." : explainProviderError(aiCfg.provider, e);
+      return c.json({ ok: false, ...meta, error });
+    } finally {
+      clearTimeout(timer);
+    }
+  });
+  app.get("/prices", (c) => {
+    const cache2 = loadPriceCache();
+    const ai = loadLocalSettings(projectRoot).ai;
+    const pricing = resolvePricing(ai, cache2);
+    return c.json({
+      source: cache2?.source ?? null,
+      fetchedAt: cache2?.fetchedAt ?? null,
+      modelCount: cache2 ? Object.keys(cache2.models).length : 0,
+      path: defaultPriceCachePath(),
+      resolved: pricing ? { provider: ai.provider, model: ai.model, ...pricing } : null
+    });
+  });
+  app.get("/prices/list", (c) => {
+    const cache2 = loadPriceCache();
+    const models = cache2 ? Object.entries(cache2.models).map(([id, p]) => ({ id, ...p })).sort((a, b) => a.id.localeCompare(b.id)) : [];
+    return c.json({ source: cache2?.source ?? null, fetchedAt: cache2?.fetchedAt ?? null, models });
+  });
+  app.post("/prices/refresh", async (c) => {
+    try {
+      const res = await refreshPrices();
+      invalidatePriceCache();
+      return c.json({ ok: true, ...res });
+    } catch (e) {
+      return c.json({ error: e.message }, 502);
+    }
+  });
   app.get("/file", (c) => c.json({ path: deps.statePath, name: basename(deps.statePath), dir: projectRoot, project: basename(projectRoot) }));
   app.get("/files", (c) => {
     const found = /* @__PURE__ */ new Map();
@@ -7783,6 +8223,90 @@ function createApi(deps) {
     logChange({ kind: "glossary", summary: `Deleted glossary term "${term}"`, before });
     return c.json({ ok: true });
   });
+  app.get("/glossary/suggestions", (c) => {
+    const s = load();
+    const pending = s.glossarySuggestions.filter((x) => x.status === "pending");
+    return c.json(pending.map((x) => ({
+      ...x,
+      occurrences: sourceKeysForTerm(s, x.term, { caseSensitive: x.caseSensitive, wholeWord: x.wholeWord }).length
+    })));
+  });
+  app.post("/glossary/suggestions/dismiss", async (c) => {
+    const { term } = await c.req.json();
+    if (typeof term !== "string") return c.json({ error: "term must be a string" }, 400);
+    const s = load();
+    dismissGlossarySuggestion(s, term);
+    persist(s);
+    logChange({ kind: "glossary", summary: `Dismissed suggested term "${term}"` });
+    return c.json({ ok: true });
+  });
+  app.delete("/glossary/suggestions/:term", (c) => {
+    const s = load();
+    const term = decodeURIComponent(c.req.param("term"));
+    removeGlossarySuggestion(s, term);
+    persist(s);
+    return c.json({ ok: true });
+  });
+  app.post("/glossary/suggest", async (c) => {
+    const signal = c.req.raw.signal;
+    const body = await c.req.json().catch(() => ({}));
+    return streamSSE(c, async (stream) => {
+      const s0 = load();
+      const sources = selectGlossarySources(s0, { keyGlob: body.keyGlob, limit: body.limit, since: body.since });
+      if (!sources.length) {
+        await stream.writeSSE({ event: "done", data: JSON.stringify({ added: 0, terms: [] }) });
+        return;
+      }
+      const aiCfg = loadLocalSettings(projectRoot).ai;
+      let provider;
+      try {
+        provider = deps.makeProvider ? deps.makeProvider() : makeProvider(aiCfg);
+      } catch (e) {
+        await stream.writeSSE({ event: "error", data: JSON.stringify({ error: e.message }) });
+        return;
+      }
+      const known = knownTermList(s0);
+      await stream.writeSSE({ event: "start", data: JSON.stringify({ total: sources.length }) });
+      const system = buildGlossarySuggestSystemPrompt();
+      const batchSize = aiCfg.contextBatchSize ?? aiCfg.batchSize ?? 10;
+      const concurrency = aiCfg.contextConcurrency ?? aiCfg.concurrency ?? 3;
+      const chunks = [];
+      for (let i = 0; i < sources.length; i += batchSize) chunks.push(sources.slice(i, i + batchSize));
+      const all = [];
+      let done = 0;
+      let next = 0;
+      async function worker() {
+        while (next < chunks.length) {
+          if (signal?.aborted) break;
+          const chunkRows = chunks[next++];
+          try {
+            const raw = await provider.complete({ system, content: [{ type: "text", text: buildGlossarySuggestBatchPrompt(chunkRows, known) }], schema: GLOSSARY_SUGGEST_SCHEMA });
+            all.push(...raw.terms ?? []);
+          } catch (e) {
+            void stream.writeSSE({ event: "warn", data: JSON.stringify({ error: e.message }) });
+          }
+          done += chunkRows.length;
+          void stream.writeSSE({ event: "progress", data: JSON.stringify({ done, total: sources.length }) });
+        }
+      }
+      await Promise.all(Array.from({ length: Math.min(concurrency, chunks.length) }, worker));
+      if (signal?.aborted) return;
+      const fresh = load();
+      const added = mergeGlossarySuggestions(fresh, dedupeTerms(all));
+      const usage = provider.takeUsage?.();
+      persist(fresh);
+      appendLog(projectRoot, {
+        at: (/* @__PURE__ */ new Date()).toISOString(),
+        kind: "glossary",
+        summary: `Suggested ${added.length} glossary term(s)`,
+        model: aiCfg.model,
+        system,
+        usage,
+        estimatedCostUsd: usageCostUsd(usage, aiCfg)
+      });
+      await stream.writeSSE({ event: "done", data: JSON.stringify({ added: added.length, terms: added }) });
+    });
+  });
   app.post("/keys/:key/screenshot", async (c) => {
     const key = c.req.param("key");
     const body = await c.req.parseBody();
@@ -7968,7 +8492,7 @@ function createApi(deps) {
       try {
         provider = deps.makeProvider ? deps.makeProvider() : makeProvider(aiCfg);
       } catch (e) {
-        await stream.writeSSE({ event: "error", data: JSON.stringify({ error: e.message }) });
+        await stream.writeSSE({ event: "error", data: JSON.stringify({ error: explainProviderError(aiCfg.provider, e) }) });
         return;
       }
       const { skipped } = attachScreenshotsForProvider(reqs, s, dirname3(resolve9(deps.statePath)), provider.supportsVision());
@@ -7985,58 +8509,65 @@ function createApi(deps) {
         event: "start",
         data: JSON.stringify({ total: reqs.length, locales: [...localeTotals].map(([locale, total]) => ({ locale, total })) })
       });
-      await runLocaleParallel(reqs, provider, {
-        // Announce a language the moment a worker picks it up — this is the
-        // signal that "something is happening" during the long first LLM call.
-        onLocaleStart: (locale) => {
-          void stream.writeSSE({ event: "locale-start", data: JSON.stringify({ locale }) });
-        },
-        onBatchComplete: (done, total, batchResults, locale) => {
-          const fresh = load();
-          const { written, errors } = applyResults(fresh, reqs, batchResults);
-          persist(fresh);
-          totalWritten += written;
-          allErrors.push(...errors);
-          const usage = provider.takeUsage?.();
-          appendLog(projectRoot, {
-            at: (/* @__PURE__ */ new Date()).toISOString(),
-            kind: "translate",
-            summary: `Translated ${batchResults.length} item(s)`,
-            model: aiCfg.model,
-            system,
-            items: batchResults.map((r) => {
-              const req = reqById.get(r.id);
-              return { id: r.id, key: req?.key ?? "", source: req?.source ?? "", targetLocale: req?.targetLocale, context: req?.context, glossary: req?.glossary, screenshot: req ? fresh.keys[req.key]?.screenshot : void 0 };
-            }),
-            results: batchResults,
-            usage,
-            estimatedCostUsd: usageCostUsd(usage, aiCfg)
-          });
-          const ld = (localeDone.get(locale) ?? 0) + batchResults.length;
-          localeDone.set(locale, ld);
-          console.log(`[translate] ${done}/${total}`);
-          void stream.writeSSE({
-            event: "progress",
-            data: JSON.stringify({ done, total, written: totalWritten, errors, locale, localeDone: ld, localeTotal: localeTotals.get(locale) ?? 0 })
-          });
-        },
-        onLocaleDone: (locale) => {
-          void stream.writeSSE({ event: "locale-done", data: JSON.stringify({ locale }) });
-        },
-        // Record the raw reply so an unparseable model response is diagnosable
-        // from the activity log instead of vanishing into per-item errors.
-        onMalformedReply: (raw, batchSize, locale) => {
-          console.error(`[translate] malformed model reply (${locale}, batch of ${batchSize})${batchSize > 1 ? " \u2014 splitting batch and retrying" : ""}`);
-          appendLog(projectRoot, {
-            at: (/* @__PURE__ */ new Date()).toISOString(),
-            kind: "translate",
-            summary: `Malformed model reply (${locale}, batch of ${batchSize})`,
-            model: aiCfg.model,
-            locale,
-            raw
-          });
+      try {
+        await runLocaleParallel(reqs, provider, {
+          // Announce a language the moment a worker picks it up — this is the
+          // signal that "something is happening" during the long first LLM call.
+          onLocaleStart: (locale) => {
+            void stream.writeSSE({ event: "locale-start", data: JSON.stringify({ locale }) });
+          },
+          onBatchComplete: (done, total, batchResults, locale) => {
+            const fresh = load();
+            const { written, errors } = applyResults(fresh, reqs, batchResults);
+            persist(fresh);
+            totalWritten += written;
+            allErrors.push(...errors);
+            const usage = provider.takeUsage?.();
+            appendLog(projectRoot, {
+              at: (/* @__PURE__ */ new Date()).toISOString(),
+              kind: "translate",
+              summary: `Translated ${batchResults.length} item(s)`,
+              model: aiCfg.model,
+              system,
+              items: batchResults.map((r) => {
+                const req = reqById.get(r.id);
+                return { id: r.id, key: req?.key ?? "", source: req?.source ?? "", targetLocale: req?.targetLocale, context: req?.context, glossary: req?.glossary, screenshot: req ? fresh.keys[req.key]?.screenshot : void 0 };
+              }),
+              results: batchResults,
+              usage,
+              estimatedCostUsd: usageCostUsd(usage, aiCfg)
+            });
+            const ld = (localeDone.get(locale) ?? 0) + batchResults.length;
+            localeDone.set(locale, ld);
+            console.log(`[translate] ${done}/${total}`);
+            void stream.writeSSE({
+              event: "progress",
+              data: JSON.stringify({ done, total, written: totalWritten, errors, locale, localeDone: ld, localeTotal: localeTotals.get(locale) ?? 0 })
+            });
+          },
+          onLocaleDone: (locale) => {
+            void stream.writeSSE({ event: "locale-done", data: JSON.stringify({ locale }) });
+          },
+          // Record the raw reply so an unparseable model response is diagnosable
+          // from the activity log instead of vanishing into per-item errors.
+          onMalformedReply: (raw, batchSize, locale) => {
+            console.error(`[translate] malformed model reply (${locale}, batch of ${batchSize})${batchSize > 1 ? " \u2014 splitting batch and retrying" : ""}`);
+            appendLog(projectRoot, {
+              at: (/* @__PURE__ */ new Date()).toISOString(),
+              kind: "translate",
+              summary: `Malformed model reply (${locale}, batch of ${batchSize})`,
+              model: aiCfg.model,
+              locale,
+              raw
+            });
+          }
+        }, aiCfg.concurrency, signal, aiCfg.batchSize);
+      } catch (e) {
+        if (!signal?.aborted) {
+          await stream.writeSSE({ event: "error", data: JSON.stringify({ error: explainProviderError(aiCfg.provider, e) }) });
         }
-      }, aiCfg.concurrency, signal, aiCfg.batchSize);
+        return;
+      }
       if (!signal?.aborted) {
         console.log(`[translate] done \u2014 wrote ${totalWritten}, ${allErrors.length} error(s)`);
         await stream.writeSSE({ event: "done", data: JSON.stringify({ written: totalWritten, errors: allErrors }) });
@@ -8063,23 +8594,28 @@ function createApi(deps) {
       try {
         provider = deps.makeProvider ? deps.makeProvider() : makeProvider(aiCfg);
       } catch (e) {
-        return c.json({ error: e.message }, 400);
+        return c.json({ error: explainProviderError(aiCfg.provider, e) }, 400);
       }
       const { skipped } = attachScreenshotsForProvider(toTranslate, s, dirname3(resolve9(deps.statePath)), provider.supportsVision());
       if (skipped) console.warn(`Model "${aiCfg.model}" has no vision support; ${skipped} screenshot(s) ignored.`);
-      const results = await runLocaleParallel(toTranslate, provider, {
-        onMalformedReply: (raw, batchSize, locale) => {
-          console.error(`[translate] malformed model reply (${locale}, batch of ${batchSize})${batchSize > 1 ? " \u2014 splitting batch and retrying" : ""}`);
-          appendLog(projectRoot, {
-            at: (/* @__PURE__ */ new Date()).toISOString(),
-            kind: "translate",
-            summary: `Malformed model reply (${locale}, batch of ${batchSize})`,
-            model: aiCfg.model,
-            locale,
-            raw
-          });
-        }
-      }, aiCfg.concurrency, void 0, aiCfg.batchSize);
+      let results;
+      try {
+        results = await runLocaleParallel(toTranslate, provider, {
+          onMalformedReply: (raw, batchSize, locale) => {
+            console.error(`[translate] malformed model reply (${locale}, batch of ${batchSize})${batchSize > 1 ? " \u2014 splitting batch and retrying" : ""}`);
+            appendLog(projectRoot, {
+              at: (/* @__PURE__ */ new Date()).toISOString(),
+              kind: "translate",
+              summary: `Malformed model reply (${locale}, batch of ${batchSize})`,
+              model: aiCfg.model,
+              locale,
+              raw
+            });
+          }
+        }, aiCfg.concurrency, void 0, aiCfg.batchSize);
+      } catch (e) {
+        return c.json({ error: explainProviderError(aiCfg.provider, e) }, 502);
+      }
       const latest = load();
       ({ written, errors } = applyResults(latest, toTranslate, results, void 0, force));
       const usage = provider.takeUsage?.();
@@ -8350,6 +8886,22 @@ function createApi(deps) {
       await stream.writeSSE({ event: "done", data: JSON.stringify({ requested: targets.length, written: totalWritten, errors: allErrors }) });
     });
   });
+  app.post("/context/estimate", async (c) => {
+    const body = await c.req.json().catch(() => ({}));
+    const cache2 = loadUsageCache(projectRoot);
+    if (!cache2) return c.json({ error: "No usage index found. Run 'glotfile scan' first." }, 400);
+    const targets = selectContextTargets(load(), {
+      all: body.all,
+      keyGlob: body.keyGlob,
+      limit: body.limit,
+      since: body.since,
+      keys: body.keys,
+      force: body.force
+    }, cache2, body.lastRunAt);
+    const aiCfg = loadLocalSettings(projectRoot).ai;
+    attachUsageSnippets(targets, cache2, projectRoot);
+    return c.json(estimateContext(targets, aiCfg));
+  });
   app.get("/context/batch/status", async (c) => {
     const aiCfg = loadLocalSettings(projectRoot).ai;
     let supported = false;
@@ -8454,6 +9006,8 @@ var init_api = __esm({
   "src/server/api.ts"() {
     "use strict";
     init_state();
+    init_glossary_suggest();
+    init_glossary();
     init_accept();
     init_scan();
     init_scanner();
@@ -8467,12 +9021,15 @@ var init_api = __esm({
     init_ai();
     init_run();
     init_provider();
+    init_explain_error();
     init_batch_run();
     init_pending_batch();
     init_context_batch_run();
     init_pending_context_batch();
     init_estimate();
     init_pricing();
+    init_price_fetch();
+    init_price_cache();
     init_log();
     init_schema();
     init_run3();
@@ -8497,7 +9054,7 @@ __export(server_exports, {
 import { Hono as Hono2 } from "hono";
 import { serve } from "@hono/node-server";
 import { fileURLToPath } from "url";
-import { dirname as dirname4, join as join19, resolve as resolve10, extname as extname3, sep as sep3 } from "path";
+import { dirname as dirname4, join as join20, resolve as resolve10, extname as extname3, sep as sep3 } from "path";
 import { readFile, stat } from "fs/promises";
 import { createServer } from "net";
 import open from "open";
@@ -8553,7 +9110,7 @@ function buildApp(opts) {
         const file = await readFileResponse(target);
         if (file) return file;
       }
-      const index = await readFileResponse(join19(root, "index.html"));
+      const index = await readFileResponse(join20(root, "index.html"));
       if (index) return index;
       return c.notFound();
     });
@@ -8623,7 +9180,7 @@ var init_server = __esm({
     init_scanner();
     init_usage();
     here = dirname4(fileURLToPath(import.meta.url));
-    DEFAULT_UI_DIR = join19(here, "..", "ui");
+    DEFAULT_UI_DIR = join20(here, "..", "ui");
     MIME = {
       ".html": "text/html; charset=utf-8",
       ".js": "text/javascript; charset=utf-8",
@@ -8655,8 +9212,8 @@ var init_server = __esm({
 // src/server/cli.ts
 init_state();
 init_stats();
-import { resolve as resolve11, dirname as dirname5, join as join20, basename as basename2 } from "path";
-import { readFileSync as readFileSync25, existsSync as existsSync14, mkdirSync as mkdirSync6, cpSync } from "fs";
+import { resolve as resolve11, dirname as dirname5, join as join21, basename as basename2 } from "path";
+import { readFileSync as readFileSync26, existsSync as existsSync14, mkdirSync as mkdirSync6, cpSync } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/server/agent-cli.ts
@@ -8788,13 +9345,17 @@ init_pending_batch();
 init_context_batch_run();
 init_pending_context_batch();
 init_estimate();
+init_glossary_suggest();
 init_pricing();
+init_price_fetch();
+init_price_cache();
 init_log();
 init_scan();
 init_scanner();
 init_usage();
 init_context();
 init_run2();
+init_registry();
 init_outputs();
 
 // src/server/lint/locate.ts
@@ -8871,7 +9432,7 @@ function formatSarif(report, ctx) {
 }
 
 // src/server/cli.ts
-var COMMANDS = ["serve", "export", "translate", "lint", "check", "import", "sync", "build-context", "scan", "prune", "split", "skill", "batch", "get", "stats", "set", "set-state", "clear", "apply"];
+var COMMANDS = ["serve", "export", "translate", "lint", "check", "import", "sync", "build-context", "suggest-glossary", "scan", "prune", "split", "skill", "batch", "prices", "get", "stats", "set", "set-state", "clear", "apply"];
 var isCommand = (s) => s != null && COMMANDS.includes(s);
 function parseArgs(argv) {
   const statePath = resolve11(process.cwd(), "glotfile.json");
@@ -8947,6 +9508,7 @@ function parseArgs(argv) {
     else if (flag === "--batch") args.batch = true;
     else if (flag === "--wait") args.wait = true;
     else if (flag === "--print") args.print = true;
+    else if (flag === "--refresh") args.refresh = true;
     else if (flag === "--state" && next) {
       args.states = next.split(",");
       i++;
@@ -9042,7 +9604,7 @@ function translateSelection(args) {
 }
 function readStdin() {
   try {
-    return readFileSync25(0, "utf8");
+    return readFileSync26(0, "utf8");
   } catch {
     return "";
   }
@@ -9310,15 +9872,15 @@ async function runContextBatchAction(args, pending, action, projectRoot) {
 function sarifContextFor(statePath) {
   if (detectFormat(statePath) === "split") {
     const dir = splitDirFor(statePath);
-    const keysPath = join20(dir, "keys.json");
+    const keysPath = join21(dir, "keys.json");
     return {
       keysUri: `${basename2(dir)}/keys.json`,
-      keysRawText: existsSync14(keysPath) ? readFileSync25(keysPath, "utf8") : ""
+      keysRawText: existsSync14(keysPath) ? readFileSync26(keysPath, "utf8") : ""
     };
   }
   return {
     keysUri: basename2(statePath),
-    keysRawText: existsSync14(statePath) ? readFileSync25(statePath, "utf8") : ""
+    keysRawText: existsSync14(statePath) ? readFileSync26(statePath, "utf8") : ""
   };
 }
 function printReport(report, format, statePath) {
@@ -9327,6 +9889,18 @@ function printReport(report, format, statePath) {
   else console.log(formatText(report).trimEnd());
 }
 async function runLintCmd(args) {
+  if (args.ruleIds) {
+    const unknown = unknownRuleIds(args.ruleIds);
+    if (unknown.length > 0) {
+      for (const id of unknown) {
+        const hint = suggestRuleId(id);
+        console.error(`Unknown --rule '${id}'.${hint ? ` Did you mean '${hint}'?` : ""}`);
+      }
+      console.error(`Valid rules: ${RULE_IDS.join(", ")}.`);
+      process.exitCode = 1;
+      return;
+    }
+  }
   const state = loadState(args.statePath);
   if (args.accept) {
     const { acceptFindings: acceptFindings2 } = await Promise.resolve().then(() => (init_accept(), accept_exports));
@@ -9468,29 +10042,30 @@ async function runBuildContext(args) {
     console.log("No keys need context.");
     return;
   }
+  const aiCfg = loadLocalSettings(projectRoot).ai;
+  attachUsageSnippets(targets, cache2, projectRoot);
+  if (args.estimate) {
+    const est = estimateContext(targets, aiCfg);
+    const fmt = (n) => n.toLocaleString("en-US");
+    console.log(`Estimate for ${fmt(est.keys)} key(s) in ${fmt(est.batches)} batch(es) \u2014 ${aiCfg.provider} \xB7 ${aiCfg.model}`);
+    console.log(`Totals: ~${fmt(est.inputTokens)} input / ~${fmt(est.outputTokens)} output tokens`);
+    if (est.pricing) {
+      const cost = est.estimatedCost;
+      console.log(`Estimated cost: ~$${cost >= 0.1 ? cost.toFixed(2) : cost.toFixed(4)} (\xB120%, ${est.pricing.source} pricing $${est.pricing.inputPerMTok}/$${est.pricing.outputPerMTok} per MTok)`);
+    } else {
+      console.log("No pricing known for this model \u2014 set inputPricePerMTok/outputPricePerMTok in your AI settings for a dollar estimate.");
+    }
+    return;
+  }
   let provider;
   try {
-    provider = makeProvider(loadLocalSettings(projectRoot).ai);
+    provider = makeProvider(aiCfg);
   } catch (e) {
     console.error(e.message);
     process.exitCode = 1;
     return;
   }
-  const fileCache = /* @__PURE__ */ new Map();
-  for (const target of targets) {
-    const refs = Object.values(cache2.files).flatMap(
-      (f) => f.refs.filter((r) => r.key === target.key).map((r) => ({
-        key: r.key,
-        file: Object.keys(cache2.files).find((path) => cache2.files[path]?.refs.includes(r)) ?? "",
-        line: r.line,
-        col: r.col,
-        scanner: r.scanner
-      }))
-    );
-    target.usageSnippets = extractSnippets(refs, projectRoot, fileCache);
-  }
   const system = buildContextSystemPrompt();
-  const aiCfg = loadLocalSettings(projectRoot).ai;
   const batchSize = aiCfg.contextBatchSize ?? aiCfg.batchSize ?? 10;
   const concurrency = aiCfg.contextConcurrency ?? aiCfg.concurrency ?? 3;
   if (args.batch) {
@@ -9546,6 +10121,71 @@ async function runBuildContext(args) {
   console.log(`Wrote context for ${written} key(s).`);
   for (const e of errors) console.warn(`skip ${e.key}: ${e.error}`);
 }
+async function runSuggestGlossary(args) {
+  const state = loadState(args.statePath);
+  const projectRoot = dirname5(resolve11(args.statePath));
+  const sources = selectGlossarySources(state, { keyGlob: args.keyGlob, limit: args.limit, since: args.since });
+  if (!sources.length) {
+    console.log("No source strings to scan.");
+    return;
+  }
+  const aiCfg = loadLocalSettings(projectRoot).ai;
+  const known = knownTermList(state);
+  if (args.estimate) {
+    const est = estimateGlossarySuggest(sources, known, aiCfg);
+    const fmt = (n) => n.toLocaleString("en-US");
+    console.log(`Estimate for ${fmt(est.sources)} source string(s) in ${fmt(est.batches)} batch(es) \u2014 ${aiCfg.provider} \xB7 ${aiCfg.model}`);
+    console.log(`Totals: ~${fmt(est.inputTokens)} input / ~${fmt(est.outputTokens)} output tokens`);
+    if (est.pricing) {
+      const cost = est.estimatedCost;
+      console.log(`Estimated cost: ~$${cost >= 0.1 ? cost.toFixed(2) : cost.toFixed(4)} (\xB120%, ${est.pricing.source} pricing $${est.pricing.inputPerMTok}/$${est.pricing.outputPerMTok} per MTok)`);
+    } else {
+      console.log("No pricing known for this model \u2014 set inputPricePerMTok/outputPricePerMTok in your AI settings for a dollar estimate.");
+    }
+    return;
+  }
+  let provider;
+  try {
+    provider = makeProvider(aiCfg);
+  } catch (e) {
+    console.error(e.message);
+    process.exitCode = 1;
+    return;
+  }
+  const system = buildGlossarySuggestSystemPrompt();
+  const batchSize = aiCfg.contextBatchSize ?? aiCfg.batchSize ?? 10;
+  const concurrency = aiCfg.contextConcurrency ?? aiCfg.concurrency ?? 3;
+  const chunks = [];
+  for (let i = 0; i < sources.length; i += batchSize) chunks.push(sources.slice(i, i + batchSize));
+  const all = [];
+  let done = 0;
+  let next = 0;
+  async function worker() {
+    while (next < chunks.length) {
+      const chunkRows = chunks[next++];
+      try {
+        const raw = await provider.complete({ system, content: [{ type: "text", text: buildGlossarySuggestBatchPrompt(chunkRows, known) }], schema: GLOSSARY_SUGGEST_SCHEMA });
+        const batch = raw;
+        all.push(...batch.terms ?? []);
+      } catch (e) {
+        console.warn(`batch failed: ${e.message}`);
+      }
+      done += chunkRows.length;
+      console.log(`[${done}/${sources.length}] scanned`);
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(concurrency, chunks.length) }, worker));
+  const added = mergeGlossarySuggestions(state, dedupeTerms(all));
+  saveState(args.statePath, state);
+  appendLog(projectRoot, {
+    at: (/* @__PURE__ */ new Date()).toISOString(),
+    kind: "glossary",
+    summary: `Suggested ${added.length} glossary term(s)`,
+    model: aiCfg.model
+  });
+  console.log(`Found ${added.length} new candidate term(s). Review them in the glossary UI.`);
+  for (const s of added) console.log(`  \u2022 ${s.term}${s.note ? ` \u2014 ${s.note}` : ""}`);
+}
 async function runScanCmd(args) {
   const state = loadState(args.statePath);
   const projectRoot = dirname5(resolve11(args.statePath));
@@ -9619,10 +10259,10 @@ function runSplit(args) {
     `Split catalog into ${splitDirFor(args.statePath)}/ (config.json, keys.json, locales/ \u2014 up to ${state.config.locales.length} locale files). Removed ${args.statePath}.`
   );
 }
-var SKILL_SRC = join20(dirname5(fileURLToPath2(import.meta.url)), "..", "..", "skill");
+var SKILL_SRC = join21(dirname5(fileURLToPath2(import.meta.url)), "..", "..", "skill");
 function runSkill(args) {
   if (args.print) {
-    console.log(readFileSync25(join20(SKILL_SRC, "SKILL.md"), "utf8").trimEnd());
+    console.log(readFileSync26(join21(SKILL_SRC, "SKILL.md"), "utf8").trimEnd());
     return;
   }
   const dest = resolve11(process.cwd(), ".claude", "skills", "glotfile");
@@ -9801,6 +10441,39 @@ function runApply(args) {
   console.log(JSON.stringify({ applied: r.applied, keysTouched: r.keysTouched, saved, dryRun: !!args.dryRun, errors: r.errors }, null, 2));
   if (r.errors.length) process.exitCode = 1;
 }
+async function runPrices(args) {
+  const projectRoot = dirname5(resolve11(args.statePath));
+  if (args.refresh) {
+    try {
+      const res = await refreshPrices();
+      invalidatePriceCache();
+      console.log(`Updated ${res.modelCount} model price(s) from ${res.source}.`);
+      console.log(`Fetched ${new Date(res.fetchedAt).toLocaleString()} \u2192 ${res.path}`);
+    } catch (e) {
+      console.error(`Could not refresh prices: ${e.message}`);
+      console.error("Existing cached prices (if any) are unchanged.");
+      process.exitCode = 1;
+    }
+    return;
+  }
+  const cache2 = loadPriceCache();
+  if (cache2) {
+    const when = cache2.fetchedAt ? new Date(cache2.fetchedAt).toLocaleString() : "unknown time";
+    console.log(`Price cache: ${Object.keys(cache2.models).length} model(s) from ${cache2.source}, fetched ${when}.`);
+    console.log(`Location: ${defaultPriceCachePath()}`);
+  } else {
+    console.log("No price cache yet. Run `glotfile prices --refresh` to fetch the latest from models.dev.");
+  }
+  const aiCfg = loadLocalSettings(projectRoot).ai;
+  const pricing = resolvePricing(aiCfg, cache2);
+  if (pricing) {
+    console.log(`
+${aiCfg.provider} \xB7 ${aiCfg.model}: $${pricing.inputPerMTok}/$${pricing.outputPerMTok} per MTok (${pricing.source}).`);
+  } else {
+    console.log(`
+No price known for ${aiCfg.provider} \xB7 ${aiCfg.model}. Set inputPricePerMTok/outputPricePerMTok in AI settings, or refresh.`);
+  }
+}
 var GLOBAL_OPTS = [
   ["-f, --file <path>", "State file to use (default: ./glotfile.json)"],
   ["-h, --help", "Show this help"]
@@ -9879,12 +10552,24 @@ var COMMAND_HELP = {
   },
   "build-context": {
     summary: "AI-generate per-key context to improve translation (requires a prior scan).",
-    usage: "glotfile build-context [--all] [--key <glob>] [--limit <n>] [--since <date>] [--batch]",
+    usage: "glotfile build-context [--all] [--key <glob>] [--limit <n>] [--since <date>] [--estimate] [--batch]",
     options: [
       ["--all", "(Re)build context for every key, not just those missing it"],
       ["--key <glob>", "Only keys matching this glob"],
       ["--limit <n>", "Process at most n keys"],
-      ["--since <date>", "Only keys added or changed since this date"]
+      ["--since <date>", "Only keys added or changed since this date"],
+      ["--estimate", "Print batches, tokens and estimated cost without building"],
+      ["--batch", "Submit via the provider's batch API (50% cost, async; anthropic only)"]
+    ]
+  },
+  "suggest-glossary": {
+    summary: "AI-scan source strings for candidate glossary terms (adds a review queue; existing terms are skipped).",
+    usage: "glotfile suggest-glossary [--key <glob>] [--limit <n>] [--since <date>] [--estimate]",
+    options: [
+      ["--key <glob>", "Only scan keys matching this glob"],
+      ["--limit <n>", "Scan at most n source strings"],
+      ["--since <date>", "Only keys added since this date"],
+      ["--estimate", "Print batches, tokens and estimated cost without scanning"]
     ]
   },
   scan: {
@@ -9923,6 +10608,13 @@ var COMMAND_HELP = {
       ["cancel", "Cancel the pending batch and discard the handle"]
     ]
   },
+  prices: {
+    summary: "Show or refresh the model price cache used for cost estimates (models.dev).",
+    usage: "glotfile prices [--refresh]",
+    options: [
+      ["--refresh", "Fetch the latest prices from models.dev into the cache (the only command that hits the network)"]
+    ]
+  },
   get: {
     summary: "Extract values from the catalog (filtered) without loading the whole file. Prints JSON.",
     usage: "glotfile get [<key-glob>\u2026] [--key <glob>] [--locale <list>] [--state <list>] [--fields <list>] [--keys-only] [--format json|ndjson]",
@@ -10012,8 +10704,8 @@ ${formatOpts([...options, ...GLOBAL_OPTS])}`);
   );
 }
 function printVersion() {
-  const pkgPath = join20(dirname5(fileURLToPath2(import.meta.url)), "..", "..", "package.json");
-  console.log(JSON.parse(readFileSync25(pkgPath, "utf8")).version);
+  const pkgPath = join21(dirname5(fileURLToPath2(import.meta.url)), "..", "..", "package.json");
+  console.log(JSON.parse(readFileSync26(pkgPath, "utf8")).version);
 }
 async function main(argv) {
   const args = parseArgs(argv);
@@ -10033,11 +10725,13 @@ async function main(argv) {
   if (args.command === "import") return runImportCmd(args);
   if (args.command === "sync") return runSyncCmd(args);
   if (args.command === "build-context") return runBuildContext(args);
+  if (args.command === "suggest-glossary") return runSuggestGlossary(args);
   if (args.command === "scan") return runScanCmd(args);
   if (args.command === "prune") return runPrune(args);
   if (args.command === "split") return runSplit(args);
   if (args.command === "skill") return runSkill(args);
   if (args.command === "batch") return runBatch(args);
+  if (args.command === "prices") return runPrices(args);
   if (args.command === "get") return runGetCmd(args);
   if (args.command === "stats") return runStatsCmd(args);
   if (args.command === "set") return runSet(args);