glotfile 0.3.0 → 0.4.0

package/dist/server/server.js

@@ -103,6 +103,7 @@ function isPluralForm(key) {
 }
 var LOCALE_CASES = ["lower-hyphen", "lower-underscore", "bcp47-hyphen", "bcp47-underscore"];
 var PROVIDERS = ["anthropic", "openai", "bedrock", "openrouter", "ollama", "claude-code"];
+var PROMPT_STYLES = ["default", "translategemma"];
 var GlotfileError = class extends Error {
 };
 function isObject(v) {
@@ -1172,7 +1173,7 @@ function buildContextBatchPrompt(reqs) {
 ${s.lines}
 \`\`\``;
     }).join("\n\n") : "(no code references found \u2014 infer from key path and source value)";
-    return { id: r.id, key: r.key, source: r.source, codeSnippets: snippetText, hasScreenshot: r.image !== void 0 };
+    return { id: r.id, key: r.key, source: r.source, codeSnippets: snippetText };
   });
   return 'Write a context note for each key. Return JSON {"items":[{"id","context"}]}.\n' + JSON.stringify(items, null, 2);
 }
@@ -1433,6 +1434,7 @@ function selectRequests(state, opts) {
           id: String(id++),
           key,
           source: other,
+          sourceLocale: state.config.sourceLocale,
           context: entry.context,
           targetLocale: locale,
           maxLength: entry.maxLength,
@@ -1453,6 +1455,7 @@ function selectRequests(state, opts) {
         id: String(id++),
         key,
         source,
+        sourceLocale: state.config.sourceLocale,
         context: entry.context,
         targetLocale: locale,
         maxLength: entry.maxLength,
@@ -2340,15 +2343,15 @@ function getAdapter(name) {
 }
 
 // src/server/api.ts
-import { readFileSync as readFileSync13, existsSync as existsSync9, readdirSync as readdirSync7, rmSync as rmSync4 } from "fs";
+import { readFileSync as readFileSync13, existsSync as existsSync9, readdirSync as readdirSync7, statSync as statSync4, rmSync as rmSync4 } from "fs";
 import { dirname as dirname2, resolve as resolve8, basename, relative as relative3, sep } from "path";
 
 // src/server/ai/anthropic.ts
 import Anthropic from "@anthropic-ai/sdk";
 
 // src/server/ai/provider.ts
-function buildSystemPrompt() {
-  return [
+function buildSystemPrompt(hasPluralItems) {
+  const lines = [
     "You are a professional software localization engine for a UI string catalog.",
     "Your goal: translate each source UI string into its target locale accurately and idiomatically, as a native speaker would phrase it in a real app interface.",
     "",
@@ -2360,20 +2363,28 @@ function buildSystemPrompt() {
     "- Glossary: a term marked do-not-translate MUST appear unchanged in the translation. A term with a forced translation for the target locale MUST use that exact translation.",
     "- Respect the max length (characters) when given; prefer a shorter natural phrasing over exceeding it.",
     "- Match the register and capitalization conventions of the target language and of UI microcopy.",
-    "- Return ONLY the translated string for each item \u2014 no quotes, notes, or explanations.",
-    "",
-    'Plural items: an item with a `plural` field gives you the source plural FORMS (keyed by CLDR category) and the `categories` REQUIRED for the target language. Return a `forms` object with one idiomatic translation per REQUIRED category \u2014 including categories the source language does not have (infer them from meaning). Keep the count token shown in the source forms (e.g. {count}) in every form that states a quantity; the `zero`, `one`, and `two` forms MAY omit it when that is natural in the target language \u2014 e.g. "No files", "One file", or a dual form that encodes the count grammatically (Arabic \u0645\u0644\u0641\u0627\u0646). Never introduce a placeholder the source did not have. For these items return `forms` instead of `translation`.'
-  ].join("\n");
+    "- Return ONLY the translated string for each item \u2014 no quotes, notes, or explanations."
+  ];
+  if (hasPluralItems) {
+    lines.push(
+      "",
+      'Plural items: an item with a `plural` field gives you the source plural FORMS (keyed by CLDR category) and the `categories` REQUIRED for the target language. Return a `forms` object with one idiomatic translation per REQUIRED category \u2014 including categories the source language does not have (infer them from meaning). Keep the count token shown in the source forms (e.g. {count}) in every form that states a quantity; the `zero`, `one`, and `two` forms MAY omit it when that is natural in the target language \u2014 e.g. "No files", "One file", or a dual form that encodes the count grammatically (Arabic \u0645\u0644\u0641\u0627\u0646). Never introduce a placeholder the source did not have. For these items return `forms` instead of `translation`.'
+    );
+  }
+  return lines.join("\n");
 }
 function buildBatchPrompt(reqs) {
   const targetLocale = reqs[0]?.targetLocale ?? "";
+  const hasPluralItems = reqs.some((r) => r.plural !== void 0);
   const items = reqs.map((r) => {
     const base = {
       id: r.id,
       key: r.key,
       context: r.context ?? null,
       maxLength: r.maxLength ?? null,
-      placeholders: r.placeholders,
+      // Wrap in braces so the model sees "{site}" not "site" — makes the visual
+      // connection to the source string obvious and reduces rename errors.
+      placeholders: r.placeholders.map((p) => `{${p}}`),
       glossary: r.glossary ?? [],
       hasScreenshot: r.image !== void 0
     };
@@ -2382,10 +2393,24 @@ function buildBatchPrompt(reqs) {
     }
     return { ...base, source: r.source };
   });
+  const returnFormat = hasPluralItems ? 'For a scalar item (has `source`) return {"id","translation"}; for a plural item (has `plural`) return {"id","forms"} with one string per required category.' : 'Return {"id","translation"} for each item.';
   return `Translate every item below into the target locale: ${targetLocale}. All items share this one target language.
-Glossary entries are constraints you MUST apply. Items with hasScreenshot:true have a screenshot supplied as a separate image block above; use it for context. For a scalar item (has \`source\`) return {"id","translation"}; for a plural item (has \`plural\`) return {"id","forms"} with one string per required category. Return JSON {"items":[\u2026]}.
+Glossary entries are constraints you MUST apply. Items with hasScreenshot:true have a screenshot supplied as a separate image block above; use it for context. ${returnFormat} Return JSON {"items":[\u2026]}.
 ` + JSON.stringify(items, null, 2);
 }
+function buildTranslateGemmaSystemPrompt(sourceLocale, targetLocale) {
+  return `You are a professional ${sourceLocale} to ${targetLocale} translator. Your goal is to accurately convey the meaning and nuances of the original ${sourceLocale} text while adhering to ${targetLocale} grammar, vocabulary, and cultural sensitivities. Produce only the ${targetLocale} translation, without any additional explanations or commentary. Preserve every interpolation placeholder exactly as written (e.g. {site}, {count}, {name}) \u2014 do not translate, rename, or remove them. Preserve markdown formatting markers exactly as written (e.g. **bold**, *italic*, __underline__) \u2014 copy them into the translation in the same positions. Please translate the following ${sourceLocale} text into ${targetLocale}:`;
+}
+function buildTranslateGemmaUserPrompt(source) {
+  return `
+
+${source}`;
+}
+function parseTranslateGemmaResponse(text, id) {
+  const translation = text.trim();
+  if (!translation) return { id, error: "No translation returned" };
+  return { id, translation };
+}
 var BATCH_SCHEMA = {
   type: "object",
   properties: {
@@ -2531,7 +2556,7 @@ var AnthropicProvider = class {
     const res = await this.client.messages.create({
       model: this.config.model,
       max_tokens: 8192,
-      system: [{ type: "text", text: buildSystemPrompt(), cache_control: { type: "ephemeral" } }],
+      system: [{ type: "text", text: buildSystemPrompt(batch.some((r) => r.plural !== void 0)), cache_control: { type: "ephemeral" } }],
       output_config: { format: { type: "json_schema", schema: BATCH_SCHEMA } },
       messages: [{ role: "user", content }]
     }, { signal });
@@ -2621,7 +2646,7 @@ var OpenAIProvider = class {
       // via runBatched, so non-strict schema guidance is sufficient.
       response_format: { type: "json_schema", json_schema: { name: "translations", schema: BATCH_SCHEMA, strict: false } },
       messages: [
-        { role: "system", content: buildSystemPrompt() },
+        { role: "system", content: buildSystemPrompt(batch.some((r) => r.plural !== void 0)) },
         { role: "user", content: this.buildUserContent(batch) }
       ]
     }, { signal });
@@ -2725,7 +2750,7 @@ var BedrockProvider = class {
   buildInput(batch) {
     const input = {
       modelId: this.config.model,
-      system: [{ text: buildSystemPrompt() }],
+      system: [{ text: buildSystemPrompt(batch.some((r) => r.plural !== void 0)) }],
       messages: [{ role: "user", content: this.buildContentBlocks(batch) }]
     };
     if (!this.isMeta()) {
@@ -2785,7 +2810,27 @@ var OllamaProvider = class extends OpenAIProvider {
     super(config, client ?? loadOpenAIClient(ollamaClientOptions(config)));
   }
   supportsVision() {
-    return false;
+    return this.config.vision === true;
+  }
+  // translategemma expects a per-item system prompt, a plain-text user message
+  // (no JSON, no structured output), and returns a plain-text translation.
+  async callBatch(batch, signal) {
+    if (this.config.promptStyle !== "translategemma") {
+      return super.callBatch(batch, signal);
+    }
+    const results = [];
+    for (const req of batch) {
+      const res = await this.client.chat.completions.create({
+        model: this.config.model,
+        messages: [
+          { role: "system", content: buildTranslateGemmaSystemPrompt(req.sourceLocale, req.targetLocale) },
+          { role: "user", content: buildTranslateGemmaUserPrompt(req.source) }
+        ]
+      }, { signal });
+      const text = res.choices?.[0]?.message?.content ?? "";
+      results.push(parseTranslateGemmaResponse(text, req.id));
+    }
+    return results;
   }
 };
 
@@ -2865,7 +2910,7 @@ var ClaudeCodeProvider = class {
     const prompt = buildBatchPrompt(batch);
     let result;
     try {
-      result = await this.spawnFn(prompt, buildSystemPrompt(), this.config.model);
+      result = await this.spawnFn(prompt, buildSystemPrompt(batch.some((r) => r.plural !== void 0)), this.config.model);
     } catch (err) {
       if (signal?.aborted) return [];
       throw err;
@@ -3424,18 +3469,37 @@ function coerceAi(raw) {
     model: typeof a.model === "string" && a.model ? a.model : DEFAULT_AI.model,
     endpoint: typeof a.endpoint === "string" ? a.endpoint : null,
     region: typeof a.region === "string" ? a.region : null,
-    batchSize: typeof a.batchSize === "number" && a.batchSize > 0 ? a.batchSize : DEFAULT_AI.batchSize
+    batchSize: typeof a.batchSize === "number" && a.batchSize > 0 ? a.batchSize : DEFAULT_AI.batchSize,
+    concurrency: typeof a.concurrency === "number" && a.concurrency > 0 ? a.concurrency : void 0,
+    contextBatchSize: typeof a.contextBatchSize === "number" && a.contextBatchSize > 0 ? a.contextBatchSize : void 0,
+    contextConcurrency: typeof a.contextConcurrency === "number" && a.contextConcurrency > 0 ? a.contextConcurrency : void 0,
+    vision: typeof a.vision === "boolean" ? a.vision : void 0,
+    promptStyle: PROMPT_STYLES.includes(a.promptStyle) ? a.promptStyle : void 0
   };
 }
+function coerceProfiles(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+  const result = {};
+  for (const [k, v] of Object.entries(raw)) {
+    if (typeof k === "string" && k.trim()) result[k] = coerceAi(v);
+  }
+  return result;
+}
 function loadLocalSettings(projectRoot) {
   const raw = readJson2(settingsPath(projectRoot));
-  return { ai: coerceAi(raw.ai), editor: isEditorId(raw.editor) ? raw.editor : DEFAULT_EDITOR };
+  const profiles = coerceProfiles(raw.profiles);
+  const activeProfile = typeof raw.activeProfile === "string" && raw.activeProfile in profiles ? raw.activeProfile : null;
+  const baseAi = coerceAi(raw.ai);
+  const ai = activeProfile ? profiles[activeProfile] : baseAi;
+  return { ai, editor: isEditorId(raw.editor) ? raw.editor : DEFAULT_EDITOR, profiles, activeProfile };
 }
 function saveLocalSettings(projectRoot, patch) {
   const path = settingsPath(projectRoot);
   const merged = { ...readJson2(path) };
   if (patch.ai !== void 0) merged.ai = patch.ai;
   if (patch.editor !== void 0) merged.editor = patch.editor;
+  if (patch.profiles !== void 0) merged.profiles = patch.profiles;
+  if (patch.activeProfile !== void 0) merged.activeProfile = patch.activeProfile;
   ensureGlotfileDir(projectRoot);
   writeFileAtomic(path, JSON.stringify(merged, null, 2) + "\n");
 }
@@ -3523,32 +3587,90 @@ function createApi(deps) {
     saveLocalSettings(projectRoot, patch);
     return c.json({ ok: true });
   });
+  app.get("/ai-profiles", (c) => {
+    const ls = loadLocalSettings(projectRoot);
+    return c.json({ profiles: ls.profiles, activeProfile: ls.activeProfile });
+  });
+  app.put("/ai-profiles/:name", async (c) => {
+    const name = c.req.param("name").trim();
+    if (!name) return c.json({ error: "name required" }, 400);
+    const body = await c.req.json().catch(() => ({}));
+    const err = aiConfigError(body);
+    if (err) return c.json({ error: err }, 400);
+    const ls = loadLocalSettings(projectRoot);
+    saveLocalSettings(projectRoot, { profiles: { ...ls.profiles, [name]: body } });
+    return c.json({ ok: true });
+  });
+  app.delete("/ai-profiles/:name", (c) => {
+    const name = c.req.param("name");
+    const ls = loadLocalSettings(projectRoot);
+    if (!(name in ls.profiles)) return c.json({ error: "profile not found" }, 404);
+    const profiles = { ...ls.profiles };
+    delete profiles[name];
+    const patch = { profiles };
+    if (ls.activeProfile === name) patch.activeProfile = null;
+    saveLocalSettings(projectRoot, patch);
+    return c.json({ ok: true });
+  });
+  app.post("/ai-profiles/active", async (c) => {
+    const { name } = await c.req.json().catch(() => ({}));
+    if (name !== null && name !== void 0) {
+      if (typeof name !== "string") return c.json({ error: "name must be a string or null" }, 400);
+      const ls = loadLocalSettings(projectRoot);
+      if (name !== "" && !(name in ls.profiles)) return c.json({ error: "profile not found" }, 404);
+      saveLocalSettings(projectRoot, { activeProfile: name || null });
+    } else {
+      saveLocalSettings(projectRoot, { activeProfile: null });
+    }
+    return c.json({ ok: true });
+  });
   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();
-    found.set(deps.statePath, { name: basename(deps.statePath), path: deps.statePath });
-    let entries = [];
-    try {
-      entries = readdirSync7(projectRoot);
-    } catch {
-    }
-    for (const name of entries) {
-      let abs;
-      if ((name === "glotfile" || name.endsWith(".glotfile")) && existsSync9(resolve8(projectRoot, name, "config.json"))) {
-        abs = resolve8(projectRoot, `${name}.json`);
-      } else if (name === "glotfile.json" || name.endsWith(".glotfile.json")) {
-        abs = resolve8(projectRoot, name);
-      } else {
-        continue;
-      }
-      if (found.has(abs)) continue;
+    const activeRel = relative3(projectRoot, deps.statePath);
+    found.set(deps.statePath, {
+      name: basename(deps.statePath),
+      path: deps.statePath,
+      relDir: activeRel !== basename(activeRel) ? dirname2(activeRel) : void 0
+    });
+    function walk(dir, depth) {
+      if (depth > 4) return;
+      let entries = [];
       try {
-        loadState(abs);
-        found.set(abs, { name: basename(abs), path: abs });
+        entries = readdirSync7(dir);
       } catch {
+        return;
+      }
+      for (const name of entries) {
+        if (name.startsWith(".") || name === "node_modules") continue;
+        const abs = resolve8(dir, name);
+        let filePath = null;
+        if ((name === "glotfile" || name.endsWith(".glotfile")) && existsSync9(resolve8(abs, "config.json"))) {
+          filePath = resolve8(dir, `${name}.json`);
+        } else if (name === "glotfile.json" || name.endsWith(".glotfile.json")) {
+          filePath = abs;
+        } else {
+          try {
+            if (statSync4(abs).isDirectory()) walk(abs, depth + 1);
+          } catch {
+          }
+          continue;
+        }
+        if (found.has(filePath)) continue;
+        try {
+          loadState(filePath);
+          const rel = relative3(projectRoot, filePath);
+          found.set(filePath, { name: basename(filePath), path: filePath, relDir: rel !== basename(filePath) ? dirname2(rel) : void 0 });
+        } catch {
+        }
       }
     }
-    const files = [...found.values()].sort((a, b) => a.name.localeCompare(b.name));
+    walk(projectRoot, 0);
+    const files = [...found.values()].sort((a, b) => {
+      const ka = a.relDir ? `${a.relDir}/${a.name}` : a.name;
+      const kb = b.relDir ? `${b.relDir}/${b.name}` : b.name;
+      return ka.localeCompare(kb);
+    });
     return c.json(files);
   });
   app.post("/file", async (c) => {
@@ -3680,7 +3802,7 @@ function createApi(deps) {
     return c.json({ removed });
   });
   app.post("/keys/bulk-meta", async (c) => {
-    const { keys, addTags, removeTags, skipTranslate } = await c.req.json();
+    const { keys, addTags, removeTags, skipTranslate, clearContext } = await c.req.json();
     if (!Array.isArray(keys) || keys.length === 0) return c.json({ error: "keys must be a non-empty array" }, 400);
     const s = load();
     let updated = 0;
@@ -3698,6 +3820,11 @@ function createApi(deps) {
         if (skipTranslate) setMetadata(s, key, { skipTranslate: true });
         else delete entry.skipTranslate;
       }
+      if (clearContext === true) {
+        delete entry.context;
+        delete entry.contextSource;
+        delete entry.contextAt;
+      }
       updated++;
     }
     persist(s);
@@ -3978,7 +4105,7 @@ function createApi(deps) {
       console.log(`[translate] ${reqs.length} string(s) \u2192 ${aiCfg.model}`);
       let totalWritten = 0;
       const allErrors = [];
-      const system = buildSystemPrompt();
+      const system = buildSystemPrompt(reqs.some((r) => r.plural !== void 0));
       const reqById = new Map(reqs.map((r) => [r.id, r]));
       const localeTotals = /* @__PURE__ */ new Map();
       for (const r of reqs) localeTotals.set(r.targetLocale, (localeTotals.get(r.targetLocale) ?? 0) + 1);
@@ -3994,8 +4121,9 @@ function createApi(deps) {
           void stream.writeSSE({ event: "locale-start", data: JSON.stringify({ locale }) });
         },
         onBatchComplete: (done, total, batchResults, locale) => {
-          const { written, errors } = applyResults(s, reqs, batchResults);
-          persist(s);
+          const fresh = load();
+          const { written, errors } = applyResults(fresh, reqs, batchResults);
+          persist(fresh);
           totalWritten += written;
           allErrors.push(...errors);
           appendLog(projectRoot, {
@@ -4006,7 +4134,7 @@ function createApi(deps) {
             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 ? s.keys[req.key]?.screenshot : void 0 };
+              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
           });
@@ -4021,7 +4149,7 @@ function createApi(deps) {
         onLocaleDone: (locale) => {
           void stream.writeSSE({ event: "locale-done", data: JSON.stringify({ locale }) });
         }
-      }, void 0, signal);
+      }, aiCfg.concurrency, signal);
       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 }) });
@@ -4052,14 +4180,15 @@ function createApi(deps) {
       }
       const { skipped } = attachScreenshotsForProvider(toTranslate, s, projectRoot, provider.supportsVision());
       if (skipped) console.warn(`Model "${aiCfg.model}" has no vision support; ${skipped} screenshot(s) ignored.`);
-      const results = await runLocaleParallel(toTranslate, provider);
-      ({ written, errors } = applyResults(s, toTranslate, results, void 0, force));
+      const results = await runLocaleParallel(toTranslate, provider, {}, aiCfg.concurrency);
+      const latest = load();
+      ({ written, errors } = applyResults(latest, toTranslate, results, void 0, force));
       const entry = {
         at: (/* @__PURE__ */ new Date()).toISOString(),
         kind: "translate",
         summary: `Translated ${toTranslate.length} item(s)`,
         model: aiCfg.model,
-        system: buildSystemPrompt(),
+        system: buildSystemPrompt(toTranslate.some((r) => r.plural !== void 0)),
         // Log the screenshot PATH only — never the image bytes.
         items: toTranslate.map((r) => ({
           id: r.id,
@@ -4068,13 +4197,13 @@ function createApi(deps) {
           targetLocale: r.targetLocale,
           context: r.context,
           glossary: r.glossary,
-          screenshot: s.keys[r.key]?.screenshot
+          screenshot: latest.keys[r.key]?.screenshot
         })),
         results
       };
       appendLog(projectRoot, entry);
+      persist(latest);
     }
-    persist(s);
     return c.json({ requested: reqs.length, written, errors });
   }));
   app.get("/log", (c) => c.json(readLog(projectRoot, 100)));
@@ -4130,55 +4259,95 @@ function createApi(deps) {
     return c.json({ indexed: true, scannedAt: cache2.scannedAt, used: computeUsedKeys(load(), cache2) });
   });
   app.post("/context/build", async (c) => {
+    const signal = c.req.raw.signal;
     const body = await c.req.json().catch(() => ({}));
-    const s = load();
-    const cache2 = loadUsageCache(projectRoot);
-    if (!cache2) return c.json({ error: "No usage index found. Run 'glotfile scan' first." }, 400);
-    const targets = selectContextTargets(s, {
-      all: body.all,
-      keyGlob: body.keyGlob,
-      limit: body.limit,
-      since: body.since,
-      keys: body.keys
-    }, cache2, body.lastRunAt);
-    if (!targets.length) return c.json({ requested: 0, written: 0, errors: [] });
-    const aiCfg = loadLocalSettings(projectRoot).ai;
-    let provider;
-    try {
-      provider = deps.makeProvider ? deps.makeProvider() : makeProvider(aiCfg);
-    } catch (e) {
-      return c.json({ error: e.message }, 400);
-    }
-    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);
-    }
-    const system = buildContextSystemPrompt();
-    const prompt = buildContextBatchPrompt(targets);
-    const raw = await provider.complete({ system, content: [{ type: "text", text: prompt }], schema: CONTEXT_BATCH_SCHEMA });
-    const batch = raw;
-    const { written, errors } = applyContext(s, targets, batch.items ?? []);
-    appendLog(projectRoot, {
-      at: (/* @__PURE__ */ new Date()).toISOString(),
-      kind: "context",
-      summary: `Generated context for ${targets.length} key(s)`,
-      model: aiCfg.model,
-      system,
-      items: targets.map((t) => ({ id: t.id, key: t.key, source: t.source })),
-      results: (batch.items ?? []).map((r) => ({ id: r.id, value: r.context, error: r.error }))
+    return streamSSE(c, async (stream) => {
+      const s = load();
+      const cache2 = loadUsageCache(projectRoot);
+      if (!cache2) {
+        await stream.writeSSE({ event: "error", data: JSON.stringify({ error: "No usage index found. Run 'glotfile scan' first." }) });
+        return;
+      }
+      const targets = selectContextTargets(s, {
+        all: body.all,
+        keyGlob: body.keyGlob,
+        limit: body.limit,
+        since: body.since,
+        keys: body.keys
+      }, cache2, body.lastRunAt);
+      if (!targets.length) {
+        await stream.writeSSE({ event: "done", data: JSON.stringify({ requested: 0, written: 0, errors: [] }) });
+        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;
+      }
+      await stream.writeSSE({ event: "start", data: JSON.stringify({ total: targets.length }) });
+      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);
+      }
+      const system = buildContextSystemPrompt();
+      const batchSize = aiCfg.contextBatchSize ?? aiCfg.batchSize ?? 10;
+      const concurrency = aiCfg.contextConcurrency ?? aiCfg.concurrency ?? 3;
+      const chunks = [];
+      for (let i = 0; i < targets.length; i += batchSize) chunks.push(targets.slice(i, i + batchSize));
+      let totalWritten = 0;
+      let totalDone = 0;
+      const allErrors = [];
+      let next = 0;
+      async function worker() {
+        while (next < chunks.length) {
+          if (signal?.aborted) break;
+          const chunk2 = chunks[next++];
+          let raw;
+          try {
+            raw = await provider.complete({ system, content: [{ type: "text", text: buildContextBatchPrompt(chunk2) }], schema: CONTEXT_BATCH_SCHEMA });
+          } catch (e) {
+            totalDone += chunk2.length;
+            allErrors.push(...chunk2.map((t) => ({ key: t.key, error: e.message })));
+            void stream.writeSSE({ event: "progress", data: JSON.stringify({ done: totalDone, total: targets.length, written: totalWritten }) });
+            continue;
+          }
+          if (signal?.aborted) break;
+          const batch = raw;
+          const fresh = load();
+          const { written, errors } = applyContext(fresh, chunk2, batch.items ?? []);
+          appendLog(projectRoot, {
+            at: (/* @__PURE__ */ new Date()).toISOString(),
+            kind: "context",
+            summary: `Generated context for ${chunk2.length} key(s)`,
+            model: aiCfg.model,
+            system,
+            items: chunk2.map((t) => ({ id: t.id, key: t.key, source: t.source })),
+            results: (batch.items ?? []).map((r) => ({ id: r.id, value: r.context, error: r.error }))
+          });
+          persist(fresh);
+          totalWritten += written;
+          totalDone += chunk2.length;
+          allErrors.push(...errors);
+          void stream.writeSSE({ event: "progress", data: JSON.stringify({ done: totalDone, total: targets.length, written: totalWritten }) });
+        }
+      }
+      await Promise.all(Array.from({ length: Math.min(concurrency, chunks.length) }, worker));
+      if (signal?.aborted) return;
+      console.log(`[context] ${totalWritten} context(s) written${allErrors.length ? `, ${allErrors.length} error(s)` : ""}`);
+      await stream.writeSSE({ event: "done", data: JSON.stringify({ requested: targets.length, written: totalWritten, errors: allErrors }) });
     });
-    persist(s);
-    console.log(`[context] ${written} context(s) written${errors.length ? `, ${errors.length} error(s)` : ""}`);
-    return c.json({ requested: targets.length, written, errors });
   });
   app.onError(
     (err, c) => c.json({ error: err.message }, err instanceof GlotfileError ? 400 : 500)