@tolkbot/cli 0.7.0 → 0.9.0

package/dist/index.js

@@ -105,7 +105,7 @@ var require_path = __commonJS({
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.convertPosixPathToPattern = exports.convertWindowsPathToPattern = exports.convertPathToPattern = exports.escapePosixPath = exports.escapeWindowsPath = exports.escape = exports.removeLeadingDotSegment = exports.makeAbsolute = exports.unixify = void 0;
     var os3 = __require("os");
-    var path13 = __require("path");
+    var path12 = __require("path");
     var IS_WINDOWS_PLATFORM = os3.platform() === "win32";
     var LEADING_DOT_SEGMENT_CHARACTERS_COUNT = 2;
     var POSIX_UNESCAPED_GLOB_SYMBOLS_RE = /(\\?)([()*?[\]{|}]|^!|[!+@](?=\()|\\(?![!()*+?@[\]{|}]))/g;
@@ -117,7 +117,7 @@ var require_path = __commonJS({
     }
     exports.unixify = unixify;
     function makeAbsolute(cwd, filepath) {
-      return path13.resolve(cwd, filepath);
+      return path12.resolve(cwd, filepath);
     }
     exports.makeAbsolute = makeAbsolute;
     function removeLeadingDotSegment(entry) {
@@ -1416,7 +1416,7 @@ var require_braces = __commonJS({
 var require_constants2 = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/constants.js"(exports, module) {
     "use strict";
-    var path13 = __require("path");
+    var path12 = __require("path");
     var WIN_SLASH = "\\\\/";
     var WIN_NO_SLASH = `[^${WIN_SLASH}]`;
     var DEFAULT_MAX_EXTGLOB_RECURSION = 0;
@@ -1590,7 +1590,7 @@ var require_constants2 = __commonJS({
       /* | */
       CHAR_ZERO_WIDTH_NOBREAK_SPACE: 65279,
       /* \uFEFF */
-      SEP: path13.sep,
+      SEP: path12.sep,
       /**
        * Create EXTGLOB_CHARS
        */
@@ -1617,7 +1617,7 @@ var require_constants2 = __commonJS({
 var require_utils2 = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/utils.js"(exports) {
     "use strict";
-    var path13 = __require("path");
+    var path12 = __require("path");
     var win32 = process.platform === "win32";
     var {
       REGEX_BACKSLASH,
@@ -1646,7 +1646,7 @@ var require_utils2 = __commonJS({
       if (options && typeof options.windows === "boolean") {
         return options.windows;
       }
-      return win32 === true || path13.sep === "\\";
+      return win32 === true || path12.sep === "\\";
     };
     exports.escapeLast = (input2, char, lastIdx) => {
       const idx = input2.lastIndexOf(char, lastIdx);
@@ -3010,7 +3010,7 @@ var require_parse2 = __commonJS({
 var require_picomatch = __commonJS({
   "../../node_modules/.pnpm/picomatch@2.3.2/node_modules/picomatch/lib/picomatch.js"(exports, module) {
     "use strict";
-    var path13 = __require("path");
+    var path12 = __require("path");
     var scan = require_scan();
     var parse4 = require_parse2();
     var utils = require_utils2();
@@ -3095,7 +3095,7 @@ var require_picomatch = __commonJS({
     };
     picomatch.matchBase = (input2, glob, options, posix = utils.isWindows(options)) => {
       const regex = glob instanceof RegExp ? glob : picomatch.makeRe(glob, options);
-      return regex.test(path13.basename(input2));
+      return regex.test(path12.basename(input2));
     };
     picomatch.isMatch = (str, patterns, options) => picomatch(patterns, options)(str);
     picomatch.parse = (pattern, options) => {
@@ -3322,7 +3322,7 @@ var require_pattern = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.isAbsolute = exports.partitionAbsoluteAndRelative = exports.removeDuplicateSlashes = exports.matchAny = exports.convertPatternsToRe = exports.makeRe = exports.getPatternParts = exports.expandBraceExpansion = exports.expandPatternsWithBraceExpansion = exports.isAffectDepthOfReadingPattern = exports.endsWithSlashGlobStar = exports.hasGlobStar = exports.getBaseDirectory = exports.isPatternRelatedToParentDirectory = exports.getPatternsOutsideCurrentDirectory = exports.getPatternsInsideCurrentDirectory = exports.getPositivePatterns = exports.getNegativePatterns = exports.isPositivePattern = exports.isNegativePattern = exports.convertToNegativePattern = exports.convertToPositivePattern = exports.isDynamicPattern = exports.isStaticPattern = void 0;
-    var path13 = __require("path");
+    var path12 = __require("path");
     var globParent = require_glob_parent();
     var micromatch = require_micromatch();
     var GLOBSTAR = "**";
@@ -3417,7 +3417,7 @@ var require_pattern = __commonJS({
     }
     exports.endsWithSlashGlobStar = endsWithSlashGlobStar;
     function isAffectDepthOfReadingPattern(pattern) {
-      const basename = path13.basename(pattern);
+      const basename = path12.basename(pattern);
       return endsWithSlashGlobStar(pattern) || isStaticPattern(basename);
     }
     exports.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
@@ -3475,7 +3475,7 @@ var require_pattern = __commonJS({
     }
     exports.partitionAbsoluteAndRelative = partitionAbsoluteAndRelative;
     function isAbsolute(pattern) {
-      return path13.isAbsolute(pattern);
+      return path12.isAbsolute(pattern);
     }
     exports.isAbsolute = isAbsolute;
   }
@@ -3652,8 +3652,8 @@ var require_utils3 = __commonJS({
     exports.errno = errno;
     var fs10 = require_fs();
     exports.fs = fs10;
-    var path13 = require_path();
-    exports.path = path13;
+    var path12 = require_path();
+    exports.path = path12;
     var pattern = require_pattern();
     exports.pattern = pattern;
     var stream = require_stream();
@@ -3765,8 +3765,8 @@ var require_async = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.read = void 0;
-    function read(path13, settings, callback) {
-      settings.fs.lstat(path13, (lstatError, lstat) => {
+    function read(path12, settings, callback) {
+      settings.fs.lstat(path12, (lstatError, lstat) => {
         if (lstatError !== null) {
           callFailureCallback(callback, lstatError);
           return;
@@ -3775,7 +3775,7 @@ var require_async = __commonJS({
           callSuccessCallback(callback, lstat);
           return;
         }
-        settings.fs.stat(path13, (statError, stat) => {
+        settings.fs.stat(path12, (statError, stat) => {
           if (statError !== null) {
             if (settings.throwErrorOnBrokenSymbolicLink) {
               callFailureCallback(callback, statError);
@@ -3807,13 +3807,13 @@ var require_sync = __commonJS({
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.read = void 0;
-    function read(path13, settings) {
-      const lstat = settings.fs.lstatSync(path13);
+    function read(path12, settings) {
+      const lstat = settings.fs.lstatSync(path12);
       if (!lstat.isSymbolicLink() || !settings.followSymbolicLink) {
         return lstat;
       }
       try {
-        const stat = settings.fs.statSync(path13);
+        const stat = settings.fs.statSync(path12);
         if (settings.markSymbolicLink) {
           stat.isSymbolicLink = () => true;
         }
@@ -3884,17 +3884,17 @@ var require_out = __commonJS({
     var sync = require_sync();
     var settings_1 = require_settings();
     exports.Settings = settings_1.default;
-    function stat(path13, optionsOrSettingsOrCallback, callback) {
+    function stat(path12, optionsOrSettingsOrCallback, callback) {
       if (typeof optionsOrSettingsOrCallback === "function") {
-        async.read(path13, getSettings(), optionsOrSettingsOrCallback);
+        async.read(path12, getSettings(), optionsOrSettingsOrCallback);
         return;
       }
-      async.read(path13, getSettings(optionsOrSettingsOrCallback), callback);
+      async.read(path12, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports.stat = stat;
-    function statSync2(path13, optionsOrSettings) {
+    function statSync2(path12, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
-      return sync.read(path13, settings);
+      return sync.read(path12, settings);
     }
     exports.statSync = statSync2;
     function getSettings(settingsOrOptions = {}) {
@@ -4112,16 +4112,16 @@ var require_async2 = __commonJS({
           return;
         }
         const tasks = names.map((name) => {
-          const path13 = common.joinPathSegments(directory, name, settings.pathSegmentSeparator);
+          const path12 = common.joinPathSegments(directory, name, settings.pathSegmentSeparator);
           return (done) => {
-            fsStat.stat(path13, settings.fsStatSettings, (error62, stats) => {
+            fsStat.stat(path12, settings.fsStatSettings, (error62, stats) => {
               if (error62 !== null) {
                 done(error62);
                 return;
               }
               const entry = {
                 name,
-                path: path13,
+                path: path12,
                 dirent: utils.fs.createDirentFromStats(name, stats)
               };
               if (settings.stats) {
@@ -4239,7 +4239,7 @@ var require_settings2 = __commonJS({
   "../../node_modules/.pnpm/@nodelib+fs.scandir@2.1.5/node_modules/@nodelib/fs.scandir/out/settings.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    var path13 = __require("path");
+    var path12 = __require("path");
     var fsStat = require_out();
     var fs10 = require_fs4();
     var Settings = class {
@@ -4247,7 +4247,7 @@ var require_settings2 = __commonJS({
         this._options = _options;
         this.followSymbolicLinks = this._getValue(this._options.followSymbolicLinks, false);
         this.fs = fs10.createFileSystemAdapter(this._options.fs);
-        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path13.sep);
+        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path12.sep);
         this.stats = this._getValue(this._options.stats, false);
         this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
         this.fsStatSettings = new fsStat.Settings({
@@ -4274,17 +4274,17 @@ var require_out2 = __commonJS({
     var sync = require_sync2();
     var settings_1 = require_settings2();
     exports.Settings = settings_1.default;
-    function scandir(path13, optionsOrSettingsOrCallback, callback) {
+    function scandir(path12, optionsOrSettingsOrCallback, callback) {
       if (typeof optionsOrSettingsOrCallback === "function") {
-        async.read(path13, getSettings(), optionsOrSettingsOrCallback);
+        async.read(path12, getSettings(), optionsOrSettingsOrCallback);
         return;
       }
-      async.read(path13, getSettings(optionsOrSettingsOrCallback), callback);
+      async.read(path12, getSettings(optionsOrSettingsOrCallback), callback);
     }
     exports.scandir = scandir;
-    function scandirSync(path13, optionsOrSettings) {
+    function scandirSync(path12, optionsOrSettings) {
       const settings = getSettings(optionsOrSettings);
-      return sync.read(path13, settings);
+      return sync.read(path12, settings);
     }
     exports.scandirSync = scandirSync;
     function getSettings(settingsOrOptions = {}) {
@@ -4932,7 +4932,7 @@ var require_settings3 = __commonJS({
   "../../node_modules/.pnpm/@nodelib+fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/settings.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    var path13 = __require("path");
+    var path12 = __require("path");
     var fsScandir = require_out2();
     var Settings = class {
       constructor(_options = {}) {
@@ -4942,7 +4942,7 @@ var require_settings3 = __commonJS({
         this.deepFilter = this._getValue(this._options.deepFilter, null);
         this.entryFilter = this._getValue(this._options.entryFilter, null);
         this.errorFilter = this._getValue(this._options.errorFilter, null);
-        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path13.sep);
+        this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path12.sep);
         this.fsScandirSettings = new fsScandir.Settings({
           followSymbolicLinks: this._options.followSymbolicLinks,
           fs: this._options.fs,
@@ -5004,7 +5004,7 @@ var require_reader2 = __commonJS({
   "../../node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/readers/reader.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    var path13 = __require("path");
+    var path12 = __require("path");
     var fsStat = require_out();
     var utils = require_utils3();
     var Reader = class {
@@ -5017,7 +5017,7 @@ var require_reader2 = __commonJS({
         });
       }
       _getFullEntryPath(filepath) {
-        return path13.resolve(this._settings.cwd, filepath);
+        return path12.resolve(this._settings.cwd, filepath);
       }
       _makeEntry(stats, pattern) {
         const entry = {
@@ -5433,7 +5433,7 @@ var require_provider = __commonJS({
   "../../node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/providers/provider.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    var path13 = __require("path");
+    var path12 = __require("path");
     var deep_1 = require_deep();
     var entry_1 = require_entry();
     var error_1 = require_error();
@@ -5447,7 +5447,7 @@ var require_provider = __commonJS({
         this.entryTransformer = new entry_2.default(this._settings);
       }
       _getRootDirectory(task) {
-        return path13.resolve(this._settings.cwd, task.base);
+        return path12.resolve(this._settings.cwd, task.base);
       }
       _getReaderOptions(task) {
         const basePath = task.base === "." ? "" : task.base;
@@ -5784,10 +5784,10 @@ var require_out4 = __commonJS({
 });
 
 // src/main.ts
-import { Command as Command9, CommanderError, Option as Option2 } from "commander";
+import { Command as Command10, CommanderError, Option as Option2 } from "commander";
 
 // package.json
-var version = "0.7.0";
+var version = "0.9.0";
 
 // src/commands/auth/index.ts
 import { Command } from "commander";
@@ -28423,6 +28423,48 @@ function parseTranslations(raw) {
     return { locale, text };
   });
 }
+function pickTermMatch(term, candidates) {
+  const exact = candidates.filter((c) => c.src.trim() === term.trim());
+  const matches = exact.length > 0 ? exact : candidates;
+  const [only, ...rest] = matches;
+  if (!only) {
+    throw new CliError(
+      `No glossary term "${term}".`,
+      "List the terms with 'tolkbot glossary list'.",
+      "not_found"
+    );
+  }
+  if (rest.length > 0) {
+    const lines = matches.map(
+      (c) => `  ${c._id}  "${c.src}" (${c.srcLocale}, ${c.projectId === void 0 ? "organization" : "project"})`
+    );
+    throw new CliError(
+      `"${term}" matches ${matches.length} glossary terms:
+${lines.join("\n")}`,
+      "Pass --id with the one you mean.",
+      "ambiguous_term"
+    );
+  }
+  return only;
+}
+async function resolveGlossaryId(client3, context, target) {
+  if (target.id !== void 0 && target.term !== void 0) {
+    throw new UsageError("Pass either a term or --id, not both.");
+  }
+  if (target.id !== void 0) return target.id;
+  if (target.term === void 0) {
+    throw new UsageError(
+      "Name the term, or pass --id.",
+      'For example: tolkbot glossary show "Dashboard"'
+    );
+  }
+  const candidates = await client3.query(api.glossaries.findByTerm, {
+    organizationId: context.organizationId,
+    projectId: context.projectId,
+    term: target.term
+  });
+  return pickTermMatch(target.term, candidates)._id;
+}
 
 // src/commands/glossary/create.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
@@ -28914,25 +28956,27 @@ function RemoveUI({ state }) {
 async function runGlossaryRemove(opts) {
   const run = async () => {
     const convexClient = await getAuthenticatedConvexClient();
-    const { organizationId: organizationId2 } = await getProjectContext(convexClient);
+    const context = await getProjectContext(convexClient);
+    const glossaryId = await resolveGlossaryId(convexClient, context, opts);
     await convexClient.mutation(api.glossaries.remove, {
-      organizationId: organizationId2,
-      glossaryId: opts.id
+      organizationId: context.organizationId,
+      glossaryId
     });
+    return glossaryId;
   };
   if (opts.json) {
-    await run();
-    jsonSuccess({ id: opts.id, ok: true });
+    jsonSuccess({ id: await run(), ok: true });
   }
   const { unmount } = renderTransient(
     /* @__PURE__ */ jsx6(RemoveUI, { state: { type: "removing" } })
   );
+  let id;
   try {
-    await run();
+    id = await run();
   } finally {
     unmount();
   }
-  render7(/* @__PURE__ */ jsx6(RemoveUI, { state: { type: "success", id: opts.id } })).unmount();
+  render7(/* @__PURE__ */ jsx6(RemoveUI, { state: { type: "success", id } })).unmount();
 }
 
 // src/commands/glossary/show.tsx
@@ -28980,11 +29024,12 @@ function GlossaryShowUI({ state }) {
     ] }) })
   ] });
 }
-async function loadGlossary(id) {
+async function loadGlossary(target) {
   const convexClient = await getAuthenticatedConvexClient();
-  const { organizationId: organizationId2 } = await getProjectContext(convexClient);
+  const context = await getProjectContext(convexClient);
+  const id = await resolveGlossaryId(convexClient, context, target);
   const glossary = await convexClient.query(api.glossaries.getById, {
-    organizationId: organizationId2,
+    organizationId: context.organizationId,
     glossaryId: id
   });
   if (!glossary) {
@@ -28998,7 +29043,7 @@ async function loadGlossary(id) {
 }
 async function runGlossaryShow(opts) {
   if (opts.json) {
-    const glossary2 = await loadGlossary(opts.id);
+    const glossary2 = await loadGlossary(opts);
     jsonSuccess({
       id: glossary2._id,
       term: glossary2.src,
@@ -29013,7 +29058,7 @@ async function runGlossaryShow(opts) {
   );
   let glossary;
   try {
-    glossary = await loadGlossary(opts.id);
+    glossary = await loadGlossary(opts);
   } finally {
     unmount();
   }
@@ -29063,29 +29108,36 @@ async function runGlossaryUpdate(opts) {
   const update = async () => {
     const patch = buildPatch();
     const convexClient = await getAuthenticatedConvexClient();
-    const { organizationId: organizationId2 } = await getProjectContext(convexClient);
+    const context = await getProjectContext(convexClient);
+    const glossaryId = await resolveGlossaryId(
+      convexClient,
+      context,
+      opts.target
+    );
     await convexClient.mutation(api.glossaries.update, {
-      organizationId: organizationId2,
-      glossaryId: opts.id,
+      organizationId: context.organizationId,
+      glossaryId,
       patch
     });
+    return glossaryId;
   };
   if (opts.json) {
-    await update();
-    jsonSuccess({ id: opts.id, ok: true });
+    jsonSuccess({ id: await update(), ok: true });
   }
   const { unmount } = renderTransient(
     /* @__PURE__ */ jsx8(UpdateUI, { state: { type: "updating" } })
   );
+  let id;
   try {
-    await update();
+    id = await update();
   } finally {
     unmount();
   }
-  render9(/* @__PURE__ */ jsx8(UpdateUI, { state: { type: "success", id: opts.id } })).unmount();
+  render9(/* @__PURE__ */ jsx8(UpdateUI, { state: { type: "success", id } })).unmount();
 }
 
 // src/commands/glossary/index.ts
+var TERM_HELP = "The term, as the glossary spells it (any case). A term that matches more than one entry lists them; pass --id then";
 var glossaryCommand = new Command2("glossary").description(
   "Manage glossary terms"
 );
@@ -29098,13 +29150,13 @@ glossaryCommand.command("list").description("List glossary terms for the current
   const parsed = validateOrExit(schema, opts);
   await runGlossaryList(parsed);
 });
-glossaryCommand.command("show").description("Show details of a glossary term").requiredOption("--id <glossaryId>", "Glossary term ID").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+glossaryCommand.command("show").description("Show details of a glossary term").argument("[term]", TERM_HELP).option("--id <glossaryId>", "Glossary term ID, instead of the term").option("--json", "Output as JSON (machine-readable)").action(async (term, opts) => {
   const schema = z4.object({
-    id: z4.string().min(1),
+    id: z4.string().min(1).optional(),
     json: z4.boolean().optional()
   });
   const parsed = validateOrExit(schema, opts);
-  await runGlossaryShow(parsed);
+  await runGlossaryShow({ ...parsed, term });
 });
 glossaryCommand.command("create").description("Create a new glossary term").requiredOption("--term <text>", "Source term").requiredOption("--locale <locale>", "Source locale (e.g. en)").option("--context <text>", "AI context for translation guidance").option("--do-not-translate", "Mark term as do-not-translate").option(
   "--translation <locale:text...>",
@@ -29121,12 +29173,12 @@ glossaryCommand.command("create").description("Create a new glossary term").requ
   const parsed = validateOrExit(schema, opts);
   await runGlossaryCreate(parsed);
 });
-glossaryCommand.command("update").description("Update an existing glossary term").requiredOption("--id <glossaryId>", "Glossary term ID").option("--term <text>", "New source term").option("--locale <locale>", "New source locale").option("--context <text>", "AI context for translation guidance").option("--do-not-translate", "Mark term as do-not-translate").option("--no-do-not-translate", "Unmark do-not-translate").option(
+glossaryCommand.command("update").description("Update an existing glossary term").argument("[term]", TERM_HELP).option("--id <glossaryId>", "Glossary term ID, instead of the term").option("--term <text>", "New source term").option("--locale <locale>", "New source locale").option("--context <text>", "AI context for translation guidance").option("--do-not-translate", "Mark term as do-not-translate").option("--no-do-not-translate", "Unmark do-not-translate").option(
   "--translation <locale:text...>",
   "Translations in locale:text format (replaces all translations)"
-).option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+).option("--json", "Output as JSON (machine-readable)").action(async (term, opts) => {
   const schema = z4.object({
-    id: z4.string().min(1),
+    id: z4.string().min(1).optional(),
     term: z4.string().optional(),
     locale: z4.string().optional(),
     context: z4.string().optional(),
@@ -29134,21 +29186,21 @@ glossaryCommand.command("update").description("Update an existing glossary term"
     translation: z4.array(z4.string()).optional(),
     json: z4.boolean().optional()
   });
-  const parsed = validateOrExit(schema, opts);
-  await runGlossaryUpdate(parsed);
+  const { id, ...parsed } = validateOrExit(schema, opts);
+  await runGlossaryUpdate({ ...parsed, target: { id, term } });
 });
-glossaryCommand.command("remove").description("Remove a glossary term").requiredOption("--id <glossaryId>", "Glossary term ID").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+glossaryCommand.command("remove").description("Remove a glossary term").argument("[term]", TERM_HELP).option("--id <glossaryId>", "Glossary term ID, instead of the term").option("--json", "Output as JSON (machine-readable)").action(async (term, opts) => {
   const schema = z4.object({
-    id: z4.string().min(1),
+    id: z4.string().min(1).optional(),
     json: z4.boolean().optional()
   });
   const parsed = validateOrExit(schema, opts);
-  await runGlossaryRemove(parsed);
+  await runGlossaryRemove({ ...parsed, term });
 });
 
 // src/commands/init/index.tsx
-import { existsSync as existsSync4 } from "fs";
-import path9 from "path";
+import { existsSync as existsSync5 } from "fs";
+import path10 from "path";
 import { Box as Box10, render as render10, Text as Text10 } from "ink";
 
 // src/lib/telemetry.ts
@@ -29363,9 +29415,9 @@ function runtimeProperties(cliVersion) {
   };
 }
 var activeCommand = null;
-function beginCommand(path13, cliVersion) {
+function beginCommand(path12, cliVersion) {
   activeCommand = {
-    path: path13,
+    path: path12,
     startedAt: Date.now(),
     cliVersion,
     reported: false
@@ -29384,11 +29436,59 @@ function completeCommand(exitCode) {
   });
 }
 
-// src/commands/init/core.ts
-import { execSync as execSync2 } from "child_process";
-import { existsSync as existsSync3 } from "fs";
+// src/commands/init/agents-file.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import path8 from "path";
 
+// ../shared/src/agents/index.ts
+var AGENT_DOCS_URL = "https://docs.tolkbot.ai/docs/for-agents";
+var AGENT_BLOCK = `## Translations
+
+TolkBot translates this project. Run its commands in the directory that holds \`tolkbot.json\`.
+
+- Add new strings to the base locale file only. Never write the other locale files by hand.
+- After changing strings, run \`npx tolkbot status\` and \`npx tolkbot translate --all\`, then \`npx tolkbot validate\` before committing.
+- To correct a translation, run \`npx tolkbot set <key> --locale <locale> --value "<text>" --learn "<why>"\`. TolkBot keeps the value and learns from the note.
+- Leave every key alone that \`npx tolkbot status --keys\` lists as held by a person.
+- More: ${AGENT_DOCS_URL}`;
+var AGENT_BLOCK_START = "<!-- tolkbot:start -->";
+var AGENT_BLOCK_END = "<!-- tolkbot:end -->";
+var MARKED_AGENT_BLOCK = `${AGENT_BLOCK_START}
+${AGENT_BLOCK}
+${AGENT_BLOCK_END}`;
+function withAgentBlock(existing) {
+  if (existing === null) {
+    return {
+      ok: true,
+      change: "created",
+      content: `${MARKED_AGENT_BLOCK}
+`
+    };
+  }
+  const start = existing.indexOf(AGENT_BLOCK_START);
+  const end = existing.indexOf(AGENT_BLOCK_END);
+  if (start === -1 && end === -1) {
+    const trimmed = existing.replace(/\s+$/, "");
+    const content2 = trimmed === "" ? `${MARKED_AGENT_BLOCK}
+` : `${trimmed}
+
+${MARKED_AGENT_BLOCK}
+`;
+    return { ok: true, change: "added", content: content2 };
+  }
+  if (start === -1 || end === -1 || end < start) {
+    return { ok: false, reason: "unmatched_marker" };
+  }
+  const before = existing.slice(0, start);
+  const after = existing.slice(end + AGENT_BLOCK_END.length);
+  const content = `${before}${MARKED_AGENT_BLOCK}${after}`;
+  return {
+    ok: true,
+    change: content === existing ? "unchanged" : "updated",
+    content
+  };
+}
+
 // src/lib/repository-root.ts
 import { execFileSync } from "child_process";
 import fs7 from "fs";
@@ -29429,7 +29529,52 @@ function realpath(p) {
   }
 }
 
+// src/commands/init/agents-file.ts
+var AGENT_FILE_NAMES = ["AGENTS.md", "CLAUDE.md"];
+function defaultAgentsFile(cwd) {
+  const start = path8.resolve(cwd);
+  const root = gitToplevel(start) ?? start;
+  for (let dir = start; ; dir = path8.dirname(dir)) {
+    for (const name of AGENT_FILE_NAMES) {
+      const candidate = path8.join(dir, name);
+      if (existsSync3(candidate)) return candidate;
+    }
+    if (dir === root || path8.dirname(dir) === dir) break;
+  }
+  return path8.join(root, "AGENTS.md");
+}
+function resolveAgentsFile(cwd, requested) {
+  return requested === true ? defaultAgentsFile(cwd) : path8.resolve(cwd, requested);
+}
+function writeAgentsFile(file2) {
+  const existing = existsSync3(file2) ? readFileSync3(file2, "utf8") : null;
+  const edit = withAgentBlock(existing);
+  if (!edit.ok) {
+    throw new CliError(
+      `${file2} has a TolkBot block that is missing its start or end marker.`,
+      "Remove the half of the block that is left, or the marker, and run 'tolkbot init --agents-file' again."
+    );
+  }
+  if (edit.change !== "unchanged") writeFileSync2(file2, edit.content);
+  return { path: file2, change: edit.change };
+}
+function describeAgentsFile(result, shown) {
+  switch (result.change) {
+    case "created":
+      return `Wrote the agent instructions to ${shown}`;
+    case "added":
+      return `Added the agent instructions to ${shown}`;
+    case "updated":
+      return `Updated the agent instructions in ${shown}`;
+    case "unchanged":
+      return `${shown} already has the agent instructions`;
+  }
+}
+
 // src/commands/init/core.ts
+import { execSync as execSync2 } from "child_process";
+import { existsSync as existsSync4 } from "fs";
+import path9 from "path";
 var DETECTION_TIMEOUT_MS = 3 * 6e4;
 var DETECTION_POLL_MS = 1e3;
 function getRecommendedFramework(projectType) {
@@ -29536,7 +29681,7 @@ function ambiguousProjectError(candidates) {
 function configInDirectory(dir) {
   try {
     const found = readConfig(dir);
-    if (!found || path8.dirname(found.path) !== path8.resolve(dir)) {
+    if (!found || path9.dirname(found.path) !== path9.resolve(dir)) {
       return void 0;
     }
     return {
@@ -29549,7 +29694,7 @@ function configInDirectory(dir) {
   }
 }
 function newProjectName(repository, subpath) {
-  return subpath === "" ? repository : path8.posix.basename(subpath);
+  return subpath === "" ? repository : path9.posix.basename(subpath);
 }
 async function linkRepository(cwd, plan, opts = {}) {
   const { owner, name } = resolveRepoIdentity(cwd);
@@ -29630,14 +29775,14 @@ async function linkRepository(cwd, plan, opts = {}) {
     () => convexClient.query(api.projects.getProjectForCli, { projectId })
   );
   requireSourcePattern(project, `${owner}/${name}`);
-  const projectDir = path8.join(
+  const projectDir = path9.join(
     root,
     ...project.subpath.split("/").filter(Boolean)
   );
-  const configDir = opts.existingConfig?.projectId === projectId ? path8.dirname(opts.existingConfig.path) : (
+  const configDir = opts.existingConfig?.projectId === projectId ? path9.dirname(opts.existingConfig.path) : (
     // A checkout without the project's directory (a sparse one)
     // keeps the config where init ran.
-    existsSync3(projectDir) ? projectDir : cwd
+    existsSync4(projectDir) ? projectDir : cwd
   );
   return {
     projectId,
@@ -29667,8 +29812,8 @@ function writeProjectConfig(result, framework, opts) {
   );
 }
 function displayPath(cwd, file2) {
-  const relative = path8.relative(cwd, file2);
-  return relative.startsWith("..") || path8.isAbsolute(relative) ? file2 : relative;
+  const relative = path9.relative(cwd, file2);
+  return relative.startsWith("..") || path9.isAbsolute(relative) ? file2 : relative;
 }
 function isDetecting(project) {
   return project.initializationStatus === "pending" || project.initializationStatus === "initializing";
@@ -29741,6 +29886,7 @@ function friendlyProjectType(t) {
 function InitWizard({
   force,
   project,
+  agentsFile,
   onComplete,
   onFailure
 }) {
@@ -29755,6 +29901,27 @@ function InitWizard({
   });
   const [error62, setError] = React.useState(null);
   const [pendingChoice, setPendingChoice] = React.useState(null);
+  const agentsTarget = React.useMemo(
+    () => resolveAgentsFile(cwd, agentsFile ?? true),
+    [cwd, agentsFile]
+  );
+  function addAgentInstructions() {
+    try {
+      const result = writeAgentsFile(agentsTarget);
+      setSetupData((prev) => ({
+        ...prev,
+        agentsLine: describeAgentsFile(
+          result,
+          displayPath(cwd, result.path)
+        )
+      }));
+    } catch (err) {
+      setSetupData((prev) => ({
+        ...prev,
+        agentsLine: err instanceof Error ? err.message : String(err)
+      }));
+    }
+  }
   React.useEffect(() => {
     if (step === "detecting") {
       setTimeout(() => {
@@ -29810,7 +29977,12 @@ function InitWizard({
           createdProject: result.createdProject,
           organizationId: result.organizationId
         });
-        setStep("done");
+        if (agentsFile) {
+          addAgentInstructions();
+          setStep("done");
+        } else {
+          setStep("agentsOffer");
+        }
       } catch (err) {
         setError(err instanceof Error ? err.message : String(err));
         setStep("done");
@@ -30045,6 +30217,30 @@ function InitWizard({
       ] })
     ] }) });
   }
+  if (step === "agentsOffer") {
+    return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs9(Text9, { children: [
+        "Add TolkBot's instructions for coding agents to",
+        " ",
+        displayPath(cwd, agentsTarget),
+        "?"
+      ] }),
+      /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "They tell an agent to run tolkbot translate and validate instead of writing locale files by hand." }),
+      /* @__PURE__ */ jsx9(Box9, { marginTop: 1, children: /* @__PURE__ */ jsx9(
+        Select,
+        {
+          options: [
+            { label: "Yes", value: "yes" },
+            { label: "No", value: "no" }
+          ],
+          onChange: (value) => {
+            if (value === "yes") addAgentInstructions();
+            setStep("done");
+          }
+        }
+      ) })
+    ] });
+  }
   if (step === "done") {
     if (error62) {
       return /* @__PURE__ */ jsxs9(Box9, { flexDirection: "column", children: [
@@ -30073,10 +30269,13 @@ function InitWizard({
         "Files: ",
         setupData.link?.sourcePattern
       ] }) }),
-      setupData.configPath && /* @__PURE__ */ jsx9(Box9, { marginTop: 1, children: /* @__PURE__ */ jsxs9(Text9, { children: [
-        "Wrote ",
-        displayPath(cwd, setupData.configPath)
-      ] }) }),
+      setupData.configPath && /* @__PURE__ */ jsxs9(Box9, { marginTop: 1, flexDirection: "column", children: [
+        /* @__PURE__ */ jsxs9(Text9, { children: [
+          "Wrote ",
+          displayPath(cwd, setupData.configPath)
+        ] }),
+        setupData.agentsLine && /* @__PURE__ */ jsx9(Text9, { children: setupData.agentsLine })
+      ] }),
       setupData.shouldInstall && /* @__PURE__ */ jsxs9(Box9, { marginTop: 1, flexDirection: "column", children: [
         /* @__PURE__ */ jsx9(Text9, { children: "Next steps:" }),
         /* @__PURE__ */ jsx9(Text9, { dimColor: true, children: "1. Import i18n in your app - see docs" }),
@@ -30143,7 +30342,8 @@ function resolvePlan(cwd, opts) {
 function SummaryUI({
   plan,
   result,
-  configPath
+  configPath,
+  agentsLine
 }) {
   return /* @__PURE__ */ jsxs10(Box10, { flexDirection: "column", children: [
     /* @__PURE__ */ jsxs10(Box10, { children: [
@@ -30181,10 +30381,13 @@ function SummaryUI({
         result.createdProject ? " (created)" : " (existing)"
       ] })
     ] }),
-    /* @__PURE__ */ jsx10(Box10, { marginTop: 1, children: /* @__PURE__ */ jsxs10(Text10, { children: [
-      "Wrote ",
-      configPath
-    ] }) })
+    /* @__PURE__ */ jsxs10(Box10, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs10(Text10, { children: [
+        "Wrote ",
+        configPath
+      ] }),
+      agentsLine && /* @__PURE__ */ jsx10(Text10, { children: agentsLine })
+    ] })
   ] });
 }
 async function runHeadless(cwd, opts) {
@@ -30208,6 +30411,7 @@ async function runHeadless(cwd, opts) {
   const configPath = writeProjectConfig(result, plan.framework, {
     force: opts.force
   });
+  const agents = opts.agentsFile ? writeAgentsFile(resolveAgentsFile(cwd, opts.agentsFile)) : null;
   track("cli_init_completed", {
     framework: plan.framework,
     framework_detected: detectedFramework,
@@ -30231,7 +30435,8 @@ async function runHeadless(cwd, opts) {
         baseLocale: result.baseLanguage,
         targets: result.targetLanguages,
         createdProject: result.createdProject,
-        installed: plan.install
+        installed: plan.install,
+        agentsFile: agents
       },
       0
     );
@@ -30243,7 +30448,8 @@ async function runHeadless(cwd, opts) {
       {
         plan,
         result,
-        configPath: displayPath(cwd, configPath)
+        configPath: displayPath(cwd, configPath),
+        agentsLine: agents ? describeAgentsFile(agents, displayPath(cwd, agents.path)) : null
       }
     )
   ).unmount();
@@ -30266,8 +30472,8 @@ async function requireLogin() {
 }
 function refuseExistingConfig(cwd, force) {
   if (force) return;
-  const existing = path9.join(cwd, "tolkbot.json");
-  if (existsSync4(existing)) {
+  const existing = path10.join(cwd, "tolkbot.json");
+  if (existsSync5(existing)) {
     throw new CliError(
       `${existing} already exists.`,
       "Run 'tolkbot init --force' to link again and refresh it."
@@ -30292,6 +30498,7 @@ async function runInteractive(opts) {
       {
         force: opts.force,
         project: opts.project,
+        agentsFile: opts.agentsFile,
         onComplete: (summary) => {
           setTelemetryOrganization(summary.organizationId);
           track("cli_init_completed", {
@@ -30388,7 +30595,7 @@ function describeLeftOut(plan) {
 
 // src/commands/translate/apply-core.ts
 import fs8 from "fs/promises";
-import path10 from "path";
+import path11 from "path";
 
 // ../../node_modules/.pnpm/@noble+hashes@2.4.0/node_modules/@noble/hashes/_u64.js
 var fromNumH = (n) => n / 2 ** 32 | 0;
@@ -30957,7 +31164,7 @@ async function applyTasks(input2) {
     }
     const baseKeys = new Set(getKeys(source.data));
     const target = targetFileFor(sourceFile, dstLocale, files, scope);
-    const targetPath = path10.join(root, ...target.relativePath.split("/"));
+    const targetPath = path11.join(root, ...target.relativePath.split("/"));
     const existing = target.existing ? await readTranslationFile(target.existing.absolutePath, format) : void 0;
     if (existing?.error !== void 0) {
       for (const task of tasks) refuse(task, "target_unreadable");
@@ -31012,7 +31219,7 @@ async function applyTasks(input2) {
 async function writeTranslationFile(input2) {
   const { targetPath, data } = input2;
   const model = input2.existingContent ?? input2.sourceContent;
-  await fs8.mkdir(path10.dirname(targetPath), { recursive: true });
+  await fs8.mkdir(path11.dirname(targetPath), { recursive: true });
   if (input2.format === "json") {
     await fs8.writeFile(
       targetPath,
@@ -31723,10 +31930,13 @@ var ERROR_CODES = {
   login_failed: EXIT_CODES.failure,
   repository_path_claimed: EXIT_CODES.failure,
   repository_path_in_use: EXIT_CODES.failure,
+  key_not_found: EXIT_CODES.failure,
+  placeholder_mismatch: EXIT_CODES.failure,
   // 2: usage
   usage: EXIT_CODES.usage,
   unsupported_locale: EXIT_CODES.usage,
   ambiguous_project: EXIT_CODES.usage,
+  ambiguous_term: EXIT_CODES.usage,
   // 3: not authenticated, or not allowed
   not_authenticated: EXIT_CODES.auth,
   token_expired: EXIT_CODES.auth,
@@ -31806,10 +32016,10 @@ function serverMessage(message) {
 }
 function argumentError(message) {
   if (!message.includes("ArgumentValidationError")) return null;
-  const path13 = /Path: \.?(\S+)/.exec(message)?.[1];
+  const path12 = /Path: \.?(\S+)/.exec(message)?.[1];
   const value = /Value: (.+)/.exec(message)?.[1];
   return new UsageError(
-    path13 && value ? `TolkBot refused ${value} as ${path13}.` : "TolkBot refused the arguments.",
+    path12 && value ? `TolkBot refused ${value} as ${path12}.` : "TolkBot refused the arguments.",
     "Check the id or value passed; list ids with the command's list subcommand."
   );
 }
@@ -32422,6 +32632,50 @@ Examples:
 import { Command as Command5 } from "commander";
 import { z as z7 } from "zod/v4";
 
+// src/commands/learnings/add.ts
+async function addLearning(ctx, opts) {
+  const { project } = ctx;
+  if (sameLocale(opts.locale, project.baseLanguage)) {
+    throw new UsageError(
+      `${opts.locale} is the project's base language.`,
+      "A learning is about translating into another language: pass that one as --locale."
+    );
+  }
+  if (opts.translation !== void 0 && opts.source === void 0) {
+    throw new UsageError(
+      "--translation needs --source: the text it translates."
+    );
+  }
+  const dstLocale = governanceLocale(project, opts.locale);
+  const id = await ctx.client.mutation(api.learnings.createForProject, {
+    organizationId: project.organizationId,
+    projectId: project._id,
+    srcLocale: project.baseLanguage,
+    dstLocale,
+    sourceText: opts.source ?? "",
+    suggestedTranslation: opts.translation ?? "",
+    reasoning: opts.note,
+    feedbackType: opts.translation !== void 0 ? "incorrect-term" : "other"
+  });
+  return {
+    id,
+    srcLocale: project.baseLanguage,
+    dstLocale,
+    sourceText: opts.source ?? null,
+    suggestedTranslation: opts.translation ?? null,
+    note: opts.note
+  };
+}
+async function runLearningsAdd(opts) {
+  const ctx = await loadPlanContext(process.cwd());
+  const learning = await addLearning(ctx, opts);
+  if (opts.json) jsonSuccess(learning);
+  console.log(
+    `\u2713 Learning saved for ${learning.srcLocale} \u2192 ${learning.dstLocale}`
+  );
+  console.log(`  ID: ${learning.id}`);
+}
+
 // src/commands/learnings/archive.tsx
 import { Spinner as Spinner10 } from "@inkjs/ui";
 import { Box as Box13, render as render12, Text as Text13 } from "ink";
@@ -32504,15 +32758,14 @@ function LearningsListUI({ state }) {
         ] }),
         l.status === "archived" && /* @__PURE__ */ jsx14(Text14, { color: "yellow", children: "[archived]" })
       ] }),
-      /* @__PURE__ */ jsx14(Box14, { paddingLeft: 2, children: /* @__PURE__ */ jsxs14(Text14, { children: [
+      l.sourceText ? /* @__PURE__ */ jsx14(Box14, { paddingLeft: 2, children: /* @__PURE__ */ jsxs14(Text14, { children: [
         '"',
         l.sourceText,
-        '" \u2192 "',
-        l.suggestedTranslation,
-        '"'
-      ] }) }),
+        '"',
+        l.suggestedTranslation ? ` \u2192 "${l.suggestedTranslation}"` : ""
+      ] }) }) : /* @__PURE__ */ jsx14(Box14, { paddingLeft: 2, children: /* @__PURE__ */ jsx14(Text14, { children: "Every string" }) }),
       l.reasoning && /* @__PURE__ */ jsx14(Box14, { paddingLeft: 2, children: /* @__PURE__ */ jsxs14(Text14, { dimColor: true, children: [
-        "Reason: ",
+        "Note: ",
         l.reasoning
       ] }) }),
       /* @__PURE__ */ jsx14(Box14, { paddingLeft: 2, children: /* @__PURE__ */ jsxs14(Text14, { dimColor: true, children: [
@@ -32618,9 +32871,9 @@ function LearningShowUI({ state }) {
   return /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", children: [
     /* @__PURE__ */ jsxs16(Box16, { gap: 1, children: [
       /* @__PURE__ */ jsx16(Text16, { bold: true, children: "Source text:" }),
-      /* @__PURE__ */ jsx16(Text16, { children: learning.sourceText })
+      /* @__PURE__ */ jsx16(Text16, { children: learning.sourceText || "(every string)" })
     ] }),
-    /* @__PURE__ */ jsxs16(Box16, { gap: 1, children: [
+    learning.suggestedTranslation && /* @__PURE__ */ jsxs16(Box16, { gap: 1, children: [
       /* @__PURE__ */ jsx16(Text16, { bold: true, children: "Suggested translation:" }),
       /* @__PURE__ */ jsx16(Text16, { children: learning.suggestedTranslation })
     ] }),
@@ -32637,7 +32890,7 @@ function LearningShowUI({ state }) {
       /* @__PURE__ */ jsx16(Text16, { children: learning.feedbackType })
     ] }),
     /* @__PURE__ */ jsxs16(Box16, { gap: 1, children: [
-      /* @__PURE__ */ jsx16(Text16, { bold: true, children: "Reasoning:" }),
+      /* @__PURE__ */ jsx16(Text16, { bold: true, children: "Note:" }),
       /* @__PURE__ */ jsx16(Text16, { children: learning.reasoning })
     ] }),
     /* @__PURE__ */ jsxs16(Box16, { gap: 1, children: [
@@ -32699,7 +32952,7 @@ async function runLearningsShow(opts) {
 
 // src/commands/learnings/index.ts
 var learningsCommand = new Command5("learnings").description(
-  "View and manage translation learnings"
+  "Add, view and manage translation learnings"
 );
 learningsCommand.command("list").description("List translation learnings for the current project").option("--status <status>", "Filter by status (active or archived)").option("--limit <n>", "Max number of results", (v) => Number(v), 100).option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
   const schema = z7.object({
@@ -32710,6 +32963,25 @@ learningsCommand.command("list").description("List translation learnings for the
   const parsed = validateOrExit(schema, opts);
   await runLearningsList(parsed);
 });
+learningsCommand.command("add").description(
+  "Tell TolkBot how to translate for this project: a note, optionally about a source text"
+).requiredOption("--locale <locale>", "Target locale the learning is for").requiredOption(
+  "--note <text>",
+  'What to do and why, e.g. "Address the reader as du, never De"'
+).option(
+  "--source <text>",
+  "Source text the note is about; without it the note applies to every string"
+).option("--translation <text>", "The translation to prefer for --source").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+  const schema = z7.object({
+    locale: z7.string().min(1),
+    note: z7.string().trim().min(1),
+    source: z7.string().trim().min(1).optional(),
+    translation: z7.string().trim().min(1).optional(),
+    json: z7.boolean().optional()
+  });
+  const parsed = validateOrExit(schema, opts);
+  await runLearningsAdd(parsed);
+});
 learningsCommand.command("show").description("Show details of a learning").requiredOption("--id <learningId>", "Learning ID").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
   const schema = z7.object({
     id: z7.string().min(1),
@@ -32735,1583 +33007,1694 @@ learningsCommand.command("remove").description("Permanently remove a learning").
   await runLearningsRemove(parsed);
 });
 
-// src/commands/status/index.ts
+// src/commands/set/index.ts
 import { Command as Command6 } from "commander";
 import { z as z8 } from "zod/v4";
 
-// src/commands/status/status.tsx
-import { Spinner as Spinner14 } from "@inkjs/ui";
-import { Box as Box17, Text as Text17 } from "ink";
-
-// src/commands/status/status-core.ts
-function fullKey4(namespace, key) {
-  return namespace ? `${namespace}.${key}` : key;
+// ../ai/src/validators/placeholders.ts
+var IDENTIFIER = /^[A-Za-z0-9_$][A-Za-z0-9_$.[\]-]*$/;
+var PRINTF_CONV = "sdiufFeEgGxXocpn%@";
+function isIdentifier(s) {
+  return IDENTIFIER.test(s);
 }
-function isPersonHold(reason) {
-  return reason === "locked" || reason === "pending-draft";
+function matchBrace(s, open3) {
+  let depth = 0;
+  for (let i = open3; i < s.length; i++) {
+    if (s[i] === "{") depth++;
+    else if (s[i] === "}") {
+      depth--;
+      if (depth === 0) return i;
+    }
+  }
+  return -1;
 }
-function count(reasons2) {
-  const byReason = {};
-  for (const reason of reasons2)
-    byReason[reason] = (byReason[reason] ?? 0) + 1;
-  return { total: reasons2.length, byReason };
+function splitTopLevel(s, limit) {
+  const parts = [];
+  let depth = 0;
+  let start = 0;
+  for (let i = 0; i < s.length; i++) {
+    const c = s[i];
+    if (c === "{") depth++;
+    else if (c === "}") depth--;
+    else if (c === "," && depth === 0 && parts.length < limit - 1) {
+      parts.push(s.slice(start, i));
+      start = i + 1;
+    }
+  }
+  parts.push(s.slice(start));
+  return parts;
 }
-function openPullRequest(rows, locale) {
-  const row = rows.find(
-    (r) => r.prState === "open" && r.prUrl !== void 0 && sameLocale(r.targetLanguage, locale)
-  );
-  if (!row?.prUrl) return null;
-  return { number: row.prNumber ?? null, url: row.prUrl };
+function parseBranches(s) {
+  const branches = [];
+  let i = 0;
+  while (i < s.length) {
+    while (i < s.length && /\s/.test(s[i] ?? "")) i++;
+    if (i >= s.length) break;
+    const keyStart = i;
+    while (i < s.length && !/[\s{]/.test(s[i] ?? "")) i++;
+    const keyword = s.slice(keyStart, i);
+    if (!keyword) break;
+    if (keyword.startsWith("offset:")) {
+      branches.push({ keyword, message: "" });
+      continue;
+    }
+    while (i < s.length && /\s/.test(s[i] ?? "")) i++;
+    if (s[i] !== "{") break;
+    const close = matchBrace(s, i);
+    if (close === -1) break;
+    branches.push({ keyword, message: s.slice(i + 1, close) });
+    i = close + 1;
+  }
+  return branches;
 }
-function languageStatus(locale, plan, pullRequests, opts = {}) {
-  const { summary } = plan;
-  const held = [
-    ...plan.heldKeys,
-    ...plan.protectedKeys.flatMap(
-      ({ key, reason }) => isPersonHold(reason) ? [{ key, reason }] : []
-    )
-  ];
-  const kept = plan.protectedKeys.flatMap(
-    ({ key, reason }) => isPersonHold(reason) ? [] : [{ key, reason }]
-  );
-  const tasks = (reason) => plan.tasks.filter((t) => t.reason === reason).map((t) => fullKey4(t.namespace, t.key));
+function parseIcuComplex(token) {
+  return token.complex ?? null;
+}
+function readBraceToken(s, i) {
+  if (s[i + 1] === "{") {
+    const close2 = s.indexOf("}}", i + 2);
+    if (close2 !== -1) {
+      const inner2 = s.slice(i + 2, close2);
+      if (!inner2.includes("{") && !inner2.includes("}")) {
+        const name2 = (inner2.split(",")[0] ?? "").trim();
+        if (isIdentifier(name2)) {
+          const rest = inner2.slice(inner2.indexOf(name2) + name2.length);
+          const suffix = rest.trim();
+          return {
+            text: s.slice(i, close2 + 2),
+            kind: "mustache",
+            name: name2,
+            signature: `mustache:${name2}${suffix ? `:${suffix.replace(/\s+/g, " ")}` : ""}`,
+            start: i,
+            end: close2 + 2
+          };
+        }
+      }
+    }
+  }
+  const close = matchBrace(s, i);
+  if (close === -1) return null;
+  const inner = s.slice(i + 1, close);
+  const parts = splitTopLevel(inner, 3);
+  const name = (parts[0] ?? "").trim();
+  if (!isIdentifier(name)) return null;
+  const text = s.slice(i, close + 1);
+  const type = (parts[1] ?? "").trim();
+  if (parts.length === 3 && (type === "plural" || type === "select" || type === "selectordinal")) {
+    const branches = parseBranches(parts[2] ?? "");
+    return {
+      text,
+      kind: "icu-complex",
+      name,
+      complex: { name, type, branches },
+      // Branch MESSAGES are translatable, so they stay out of the
+      // signature; their keywords and nested tokens are compared separately.
+      signature: `icu-complex:${name}:${type}:${branches.map((b) => b.keyword).sort().join("|")}`,
+      start: i,
+      end: close + 1
+    };
+  }
+  const normalized = parts.map((p) => p.trim().replace(/\s+/g, " ")).join(", ");
   return {
-    locale,
-    expected: summary.totalKeys,
-    upToDate: summary.upToDate,
-    missing: summary.missing,
-    changed: summary.changed,
-    heldByPerson: count(held.map((h) => h.reason)),
-    keptForPerson: count(kept.map((k) => k.reason)),
-    untracked: summary.untracked,
-    pullRequest: openPullRequest(pullRequests, locale),
-    ...opts.keys ? {
-      keys: {
-        missing: tasks("missing"),
-        changed: tasks("changed"),
-        heldByPerson: held,
-        keptForPerson: kept,
-        untracked: plan.untrackedKeys.map((k) => k.key)
+    text,
+    kind: "icu-simple",
+    name,
+    signature: `icu-simple:${normalized}`,
+    start: i,
+    end: close + 1
+  };
+}
+function readPercentToken(s, i) {
+  if (s[i + 1] === "{") {
+    const close = s.indexOf("}", i + 2);
+    if (close !== -1) {
+      const name = s.slice(i + 2, close).trim();
+      if (isIdentifier(name)) {
+        return {
+          text: s.slice(i, close + 1),
+          kind: "ruby",
+          name,
+          signature: `ruby:${name}`,
+          start: i,
+          end: close + 1
+        };
       }
-    } : {}
+    }
+  }
+  let j = i + 1;
+  if (j >= s.length || s[j] === " ") return null;
+  const rest = s.slice(j);
+  const argnum = /^(\d+)\$/.exec(rest);
+  if (argnum) j += argnum[0].length;
+  while (j < s.length && "-+0#".includes(s[j] ?? "")) j++;
+  while (j < s.length && /\d/.test(s[j] ?? "")) j++;
+  if (s[j] === ".") {
+    j++;
+    while (j < s.length && /\d/.test(s[j] ?? "")) j++;
+  }
+  const conv = s[j];
+  if (!conv || !PRINTF_CONV.includes(conv)) return null;
+  const text = s.slice(i, j + 1);
+  return {
+    text,
+    kind: "printf",
+    name: argnum?.[1] ?? "",
+    signature: `printf:${text}`,
+    start: i,
+    end: j + 1
   };
 }
-function needsTranslation(language) {
-  return language.missing > 0 || language.changed > 0;
+var TAG = /^<\/?[A-Za-z0-9][A-Za-z0-9._-]*\s*\/?>/;
+function readTagToken(s, i) {
+  const m = TAG.exec(s.slice(i));
+  if (!m) return null;
+  const text = m[0];
+  return {
+    text,
+    kind: "tag",
+    name: text.replace(/[<>/\s]/g, ""),
+    signature: `tag:${text.replace(/\s+/g, "")}`,
+    start: i,
+    end: i + text.length
+  };
 }
-var REASON_WORDS = {
-  locked: "locked",
-  "pending-draft": "pending draft",
-  manual: "written by a person",
-  "target-edited": "edited since TolkBot wrote it",
-  unknown: "no record of who wrote it"
-};
-function reasons(counts) {
-  return Object.entries(counts.byReason).map(
-    ([reason, n]) => `${n} ${REASON_WORDS[reason]}`
-  ).join(", ");
+function readNestingToken(s, i) {
+  if (!s.startsWith("$t(", i)) return null;
+  const close = s.indexOf(")", i + 3);
+  if (close === -1) return null;
+  const text = s.slice(i, close + 1);
+  return {
+    text,
+    kind: "nesting",
+    name: s.slice(i + 3, close).trim(),
+    signature: `nesting:${text.replace(/\s+/g, "")}`,
+    start: i,
+    end: close + 1
+  };
 }
-function describeLanguage(language) {
-  const counts = [
-    `${language.expected} expected`,
-    `${language.upToDate} up to date`,
-    `${language.missing} missing`,
-    `${language.changed} changed since translated`
-  ].join(", ");
-  const mark = needsTranslation(language) ? "\u2022" : "\u2713";
-  const lines = [`${mark} ${language.locale}: ${counts}`];
-  if (language.heldByPerson.total > 0) {
-    lines.push(
-      `    ${language.heldByPerson.total} held by a person (${reasons(language.heldByPerson)})`
-    );
-  }
-  if (language.keptForPerson.total > 0) {
-    lines.push(
-      `    ${language.keptForPerson.total} changed but kept for a person (${reasons(language.keptForPerson)})`
-    );
-  }
-  if (language.untracked > 0) {
-    lines.push(
-      `    ${language.untracked} untracked: TolkBot has no record of them`
-    );
-  }
-  if (language.pullRequest) {
-    lines.push(`    Pull request: ${language.pullRequest.url}`);
+function extractPlaceholders(s) {
+  const tokens = [];
+  let i = 0;
+  while (i < s.length) {
+    const c = s[i];
+    let token = null;
+    if (c === "{") token = readBraceToken(s, i);
+    else if (c === "%") token = readPercentToken(s, i);
+    else if (c === "<") token = readTagToken(s, i);
+    else if (c === "$") token = readNestingToken(s, i);
+    if (token) {
+      tokens.push(token);
+      i = token.end;
+      continue;
+    }
+    i++;
   }
-  const { keys } = language;
-  if (keys) {
-    const list = (label, names) => {
-      if (names.length === 0) return;
-      lines.push(`    ${label}:`);
-      for (const name of names) lines.push(`      ${name}`);
-    };
-    list("Missing", keys.missing);
-    list("Changed", keys.changed);
-    list(
-      "Held by a person",
-      keys.heldByPerson.map(
-        (k) => `${k.key} (${REASON_WORDS[k.reason]})`
-      )
-    );
-    list(
-      "Kept for a person",
-      keys.keptForPerson.map(
-        (k) => `${k.key} (${REASON_WORDS[k.reason]})`
-      )
-    );
-    list("Untracked", keys.untracked);
+  return tokens;
+}
+function countHashes(s) {
+  return (s.match(/#/g) ?? []).length;
+}
+function subtract(a, b) {
+  const pool = /* @__PURE__ */ new Map();
+  for (const t of b) pool.set(t.signature, (pool.get(t.signature) ?? 0) + 1);
+  const out = [];
+  for (const t of a) {
+    const left = pool.get(t.signature) ?? 0;
+    if (left > 0) pool.set(t.signature, left - 1);
+    else out.push(t);
   }
-  return lines;
+  return out;
 }
-
-// src/commands/status/status.tsx
-import { jsx as jsx17, jsxs as jsxs17 } from "react/jsx-runtime";
-var OFFLINE_HINT = "Without a login, 'tolkbot validate' checks the files on this machine.";
-async function runStatus(opts) {
-  let ctx;
-  try {
-    ctx = await loadPlanContext(process.cwd());
-  } catch (error62) {
-    if (error62 instanceof AuthError) {
-      throw new AuthError(
-        error62.baseMessage,
-        [error62.hint, OFFLINE_HINT].filter(Boolean).join(" "),
-        error62.code
+function compareIcuBranches(srcToken, outToken, problems, missing, extra) {
+  const src = parseIcuComplex(srcToken);
+  const out = parseIcuComplex(outToken);
+  if (!src || !out) return;
+  const outByKeyword = new Map(out.branches.map((b) => [b.keyword, b]));
+  for (const branch of src.branches) {
+    const counterpart = outByKeyword.get(branch.keyword);
+    if (!counterpart) continue;
+    const srcHashes = countHashes(branch.message);
+    const outHashes = countHashes(counterpart.message);
+    if (srcHashes !== outHashes) {
+      problems.push(
+        `{${src.name}} branch "${branch.keyword}" has ${srcHashes} "#" in the source but ${outHashes} in the translation`
       );
+      if (srcHashes > outHashes) missing.push("#");
+      else extra.push("#");
     }
-    throw error62;
-  }
-  const { project } = ctx;
-  const srcLocale = project.baseLanguage;
-  const locales = project.targetLanguages;
-  const progress = renderTransient(
-    /* @__PURE__ */ jsxs17(Box17, { children: [
-      /* @__PURE__ */ jsx17(Spinner14, {}),
-      /* @__PURE__ */ jsxs17(Text17, { children: [
-        " Reading the status of ",
-        project.name,
-        "\u2026"
-      ] })
-    ] })
-  );
-  const languages = [];
-  let credits;
-  try {
-    const pullRequests = locales.length === 0 ? [] : await ctx.client.query(api.prJobs.listByProject, {
-      organizationId: project.organizationId,
-      projectId: project._id
-    });
-    for (const locale of locales) {
-      const plan = await planForLocale(ctx, srcLocale, locale);
-      languages.push(
-        languageStatus(locale, plan, pullRequests, {
-          keys: opts.keys
-        })
+    const nested = compareStrict(branch.message, counterpart.message);
+    if (!nested.ok) {
+      missing.push(...nested.missing);
+      extra.push(...nested.extra);
+      problems.push(
+        ...nested.problems.map(
+          (p) => `inside {${src.name}} branch "${branch.keyword}": ${p}`
+        )
       );
     }
-    credits = await readCreditBalance(ctx);
-  } finally {
-    progress.unmount();
   }
-  const payload = {
-    project: {
-      name: project.name,
-      slug: project.slug,
-      url: `${env.TOLKBOT_WEB_URL}/projects/${project.slug}`,
-      baseLanguage: srcLocale,
-      pattern: fullPattern(scopeOf(project)),
-      autoCreatePR: project.workflow?.autoCreatePR ?? DEFAULT_BEHAVIORAL_SETTINGS.workflow.autoCreatePR
-    },
-    credits: { balance: credits },
-    languages
-  };
-  const outOfDate = languages.some(needsTranslation);
-  const exitCode = opts.exitCode && outOfDate ? 1 : 0;
-  if (opts.json) {
-    if (exitCode === 0) jsonSuccess(payload);
-    jsonResult(payload, exitCode);
-    return;
+}
+function compareStrict(src, out) {
+  const srcTokens = extractPlaceholders(src);
+  const outTokens = extractPlaceholders(out);
+  const missingTokens = subtract(srcTokens, outTokens);
+  const extraTokens = subtract(outTokens, srcTokens);
+  const missing = missingTokens.map((t) => t.text);
+  const extra = extraTokens.map((t) => t.text);
+  const problems = [];
+  for (const t of missingTokens) {
+    problems.push(`"${t.text}" is missing from the translation`);
   }
-  const { project: p } = payload;
-  console.log(`${p.name} (${p.slug}) ${p.url}`);
-  console.log(
-    `Base language ${p.baseLanguage}, files ${p.pattern}, auto-create pull requests ${p.autoCreatePR ? "on" : "off"}`
-  );
-  console.log(
-    credits === null ? "Credits left: could not be read" : `Credits left: ${credits}`
-  );
-  console.log("");
-  if (languages.length === 0) {
-    console.log(
-      `No target languages configured. Add them in the project settings at ${p.url}/settings.`
+  for (const t of extraTokens) {
+    problems.push(
+      `"${t.text}" appears in the translation but not the source`
     );
   }
-  for (const language of languages) {
-    for (const line of describeLanguage(language)) console.log(line);
+  const matchedOut = /* @__PURE__ */ new Map();
+  for (const t of outTokens) {
+    if (t.kind !== "icu-complex") continue;
+    const bucket = matchedOut.get(t.signature) ?? [];
+    bucket.push(t);
+    matchedOut.set(t.signature, bucket);
   }
-  if (outOfDate) {
-    console.log(
-      "\nRun 'tolkbot translate --all' to translate what is missing or changed."
-    );
+  for (const t of srcTokens) {
+    if (t.kind !== "icu-complex") continue;
+    const counterpart = matchedOut.get(t.signature)?.shift();
+    if (counterpart) {
+      compareIcuBranches(t, counterpart, problems, missing, extra);
+    }
   }
-  process.exitCode = exitCode;
+  return {
+    ok: problems.length === 0,
+    missing,
+    extra,
+    problems,
+    incompletePlurals: []
+  };
 }
-
-// src/commands/status/index.ts
-var statusCommand = new Command6("status").description(
-  "Show what each language is missing, what waits for a person, the open pull requests and the credits left"
-).option("--keys", "List the keys by name under each language").option(
-  "--exit-code",
-  "Exit 1 when any language has missing or changed keys"
-).option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
-  const schema = z8.object({
-    keys: z8.boolean().optional(),
-    exitCode: z8.boolean().optional(),
-    json: z8.boolean().optional()
-  });
-  await runStatus(validateOrExit(schema, opts));
-});
-
-// src/commands/telemetry.ts
-import { Command as Command7 } from "commander";
-import { z as z9 } from "zod/v4";
-var REASONS = {
-  env: `disabled by $${TELEMETRY_ENV_VAR}`,
-  "do-not-track": `disabled by $${DO_NOT_TRACK_ENV_VAR}`,
-  preference: "disabled with `tolkbot telemetry off`",
-  "no-key": "disabled: this build has no telemetry key",
-  default: "enabled"
-};
-async function printStatus(json2) {
-  const state = await telemetryState();
-  if (json2) {
-    jsonResult({ ...state, preferenceFile: getPreferencePath() }, 0);
-    return;
+function pluralArgument(token) {
+  const complex = token.complex;
+  if (token.kind !== "icu-complex" || !complex) return null;
+  if (complex.type !== "plural" && complex.type !== "selectordinal") {
+    return null;
   }
-  console.log(
-    `Telemetry is ${state.enabled ? "on" : "off"} (${REASONS[state.reason]}).`
-  );
-  console.log(
-    `Turn it off with \`tolkbot telemetry off\`, $${TELEMETRY_ENV_VAR}=0 or $${DO_NOT_TRACK_ENV_VAR}=1.`
-  );
+  return {
+    token,
+    name: complex.name,
+    type: complex.type,
+    branches: complex.branches
+  };
 }
-var telemetryCommand = new Command7("telemetry").description(
-  "Control anonymous usage reporting"
-);
-telemetryCommand.command("status", { isDefault: true }).description("Show whether telemetry is on and why").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
-  const parsed = validateOrExit(
-    z9.object({ json: z9.boolean().optional() }),
-    opts
-  );
-  await printStatus(parsed.json);
-});
-telemetryCommand.command("off").description("Stop reporting usage from this machine").action(async () => {
-  await setTelemetryPreference(false);
-  console.log(
-    `Telemetry is off. Preference saved to ${getPreferencePath()}.`
+function isPluralToken(token) {
+  return pluralArgument(token) !== null;
+}
+function withoutPlurals(s, plurals) {
+  let out = s;
+  const byPositionDesc = [...plurals].sort(
+    (a, b) => b.token.start - a.token.start
   );
-});
-telemetryCommand.command("on").description("Resume reporting usage from this machine").action(async () => {
-  await setTelemetryPreference(true);
-  await printStatus(false);
-});
-
-// src/commands/translate/index.ts
-import { Command as Command8 } from "commander";
-import { z as z10 } from "zod/v4";
-
-// src/commands/translate/adopt.tsx
-var STAMP_CHUNK2 = 200;
-async function adoptLocale(ctx, srcLocale, dstLocale) {
-  const plan = await planForLocale(ctx, srcLocale, dstLocale);
-  const locale = governanceLocale(ctx.project, dstLocale);
-  const byTemplate = /* @__PURE__ */ new Map();
-  for (const key of plan.untrackedKeys) {
-    const group = byTemplate.get(key.pathTemplate) ?? [];
-    group.push(key);
-    byTemplate.set(key.pathTemplate, group);
-  }
-  const outcome = {
-    dstLocale,
-    untracked: plan.untrackedKeys.length,
-    adopted: 0,
-    skipped: 0
-  };
-  for (const [pathTemplate, keys] of byTemplate) {
-    for (let i = 0; i < keys.length; i += STAMP_CHUNK2) {
-      const result = await ctx.client.mutation(
-        api.localeKeyStates.adoptUntrackedForCli,
-        {
-          organizationId: ctx.project.organizationId,
-          projectId: ctx.project._id,
-          locale,
-          pathTemplate,
-          entries: keys.slice(i, i + STAMP_CHUNK2).map((key) => ({
-            key: key.fileKey,
-            namespace: key.namespace,
-            baseValue: key.src,
-            translatedValue: key.dst
-          }))
-        }
-      );
-      outcome.adopted += result.adopted;
-      outcome.skipped += result.skipped;
-    }
+  for (const p of byPositionDesc) {
+    out = out.slice(0, p.token.start) + " " + out.slice(p.token.end);
   }
-  return outcome;
+  return out;
 }
-async function runAdopt(opts) {
-  const run = async () => {
-    const ctx = await loadPlanContext(process.cwd());
-    const src = opts.src ?? ctx.project.baseLanguage;
-    const locales = opts.all ? ctx.project.targetLanguages : opts.dst ? [opts.dst] : [];
-    if (locales.length === 0) {
-      throw opts.all ? new CliError(
-        "No target languages configured for this project.",
-        "Add one with 'tolkbot languages add <code>'.",
-        "no_target_languages"
-      ) : new UsageError(
-        "Either --dst <locale> or --all must be provided."
-      );
-    }
-    const outcomes2 = [];
-    for (const dst of locales)
-      outcomes2.push(await adoptLocale(ctx, src, dst));
-    track("cli_translate_completed", {
-      mode: "adopt",
-      key_count: outcomes2.reduce((n, o) => n + o.adopted, 0),
-      locale_count: outcomes2.length,
-      job_count: 0,
-      json: opts.json === true
-    });
-    return outcomes2;
-  };
-  if (opts.json) {
-    jsonSuccess({ adopted: await run() });
+function fixedKeywords(p) {
+  return p.branches.map((b) => b.keyword).filter((k) => !PLURAL_CATEGORIES.has(k)).sort();
+}
+function comparePluralPair(src, out, dstLocale, result) {
+  const srcFixed = fixedKeywords(src).join(" ");
+  const outFixed = fixedKeywords(out).join(" ");
+  if (srcFixed !== outFixed) {
+    result.problems.push(
+      `{${src.name}} has branches [${srcFixed}] in the source but [${outFixed}] in the translation`
+    );
   }
-  const outcomes = await run();
-  for (const o of outcomes) {
-    console.log(
-      `\u2713 ${o.dstLocale}: adopted ${o.adopted} untracked translation(s)` + (o.skipped > 0 ? `, ${o.skipped} already tracked` : "")
+  const pluralType = src.type === "plural" ? "cardinal" : "ordinal";
+  const outKeywords = new Set(out.branches.map((b) => b.keyword));
+  const lacking = requiredPluralCategories(dstLocale, pluralType).filter(
+    (c) => !outKeywords.has(c)
+  );
+  if (lacking.length > 0) {
+    result.incompletePlurals.push(
+      `{${src.name}} has no ${lacking.map((c) => `"${c}"`).join(", ")} branch, which ${dstLocale} needs`
     );
   }
-}
-
-// src/commands/translate/edit.tsx
-import path12 from "path";
-import { Spinner as Spinner15 } from "@inkjs/ui";
-import { Box as Box18, render as render16, Text as Text18 } from "ink";
-
-// src/utils/locale-files.ts
-import path11 from "path";
-async function findLocaleFiles(baseDir) {
-  const adapter = createAdapter("json");
-  const result = await adapter.discover(baseDir);
-  const localeFiles = /* @__PURE__ */ new Map();
-  for (const [locale, files] of result.filesByLocale) {
-    localeFiles.set(
-      locale,
-      files.map((f) => f.path)
+  const srcByKeyword = new Map(src.branches.map((b) => [b.keyword, b]));
+  const srcOther = srcByKeyword.get("other");
+  for (const branch of out.branches) {
+    if (branch.keyword.startsWith("offset:")) continue;
+    const counterpart = srcByKeyword.get(branch.keyword) ?? (PLURAL_CATEGORIES.has(branch.keyword) ? srcOther : void 0);
+    if (!counterpart) continue;
+    const srcHashes = countHashes(counterpart.message);
+    const outHashes = countHashes(branch.message);
+    const sayableInWords = branch.keyword.startsWith("=") || isSingleNumberCategory(dstLocale, pluralType, branch.keyword);
+    if (srcHashes !== outHashes && !(sayableInWords && outHashes <= Math.max(srcHashes, 1))) {
+      result.problems.push(
+        `{${src.name}} branch "${branch.keyword}" has ${outHashes} "#" but the source's "${counterpart.keyword}" has ${srcHashes}`
+      );
+      if (srcHashes > outHashes) result.missing.push("#");
+      else result.extra.push("#");
+    }
+    const nested = compareForLocale(
+      counterpart.message,
+      branch.message,
+      dstLocale
+    );
+    result.missing.push(...nested.missing);
+    result.extra.push(...nested.extra);
+    result.problems.push(
+      ...nested.problems.map(
+        (p) => `inside {${src.name}} branch "${branch.keyword}": ${p}`
+      )
     );
+    result.incompletePlurals.push(...nested.incompletePlurals);
   }
-  return localeFiles;
 }
-function resolveFileForKey(files, key, namespace) {
-  if (files.length === 0) return null;
-  if (files.length === 1) return files[0] ?? null;
-  const ns = namespace ?? key.split(".")[0];
-  for (const file2 of files) {
-    const fileName = path11.parse(path11.basename(file2)).name;
-    if (fileName === ns) {
-      return file2;
+function compareForLocale(src, out, dstLocale) {
+  const srcPlurals = extractPlaceholders(src).map(pluralArgument).filter((p) => p !== null);
+  const outPlurals = extractPlaceholders(out).map(pluralArgument).filter((p) => p !== null);
+  const result = compareStrict(
+    withoutPlurals(src, srcPlurals),
+    withoutPlurals(out, outPlurals)
+  );
+  const unmatched = [...outPlurals];
+  for (const p of srcPlurals) {
+    const i = unmatched.findIndex(
+      (o) => o.name === p.name && o.type === p.type
+    );
+    const counterpart = i === -1 ? void 0 : unmatched.splice(i, 1)[0];
+    if (!counterpart) {
+      result.missing.push(p.token.text);
+      result.problems.push(
+        `"${p.token.text}" is missing from the translation`
+      );
+      continue;
     }
+    comparePluralPair(p, counterpart, dstLocale, result);
   }
-  return files[0] ?? null;
-}
-function resolveKeyInFile(key, targetFile, fileCount, namespace) {
-  if (fileCount <= 1 || namespace) return key;
-  const fileName = path11.parse(path11.basename(targetFile)).name;
-  if (key.startsWith(`${fileName}.`)) {
-    return key.slice(fileName.length + 1);
+  for (const o of unmatched) {
+    result.extra.push(o.token.text);
+    result.problems.push(
+      `"${o.token.text}" appears in the translation but not the source`
+    );
   }
-  return key;
+  result.ok = result.problems.length === 0;
+  return result;
 }
-
-// src/commands/translate/edit.tsx
-import { jsx as jsx18, jsxs as jsxs18 } from "react/jsx-runtime";
-function EditUI({ state }) {
-  if (state.type === "editing") {
-    return /* @__PURE__ */ jsxs18(Box18, { children: [
-      /* @__PURE__ */ jsx18(Spinner15, {}),
-      /* @__PURE__ */ jsx18(Text18, { children: " Editing translation\u2026" })
-    ] });
-  }
-  return /* @__PURE__ */ jsxs18(Box18, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs18(Box18, { children: [
-      /* @__PURE__ */ jsx18(Text18, { color: "green", children: "\u2713" }),
-      /* @__PURE__ */ jsxs18(Text18, { children: [
-        " ",
-        "Updated ",
-        /* @__PURE__ */ jsx18(Text18, { bold: true, children: state.key })
-      ] })
-    ] }),
-    /* @__PURE__ */ jsx18(Box18, { paddingLeft: 2, children: /* @__PURE__ */ jsx18(Text18, { dimColor: true, children: state.value }) }),
-    /* @__PURE__ */ jsx18(Box18, { marginTop: 1, children: /* @__PURE__ */ jsxs18(Text18, { dimColor: true, children: [
-      "File: ",
-      state.filePath
-    ] }) })
-  ] });
+function comparePlaceholders(src, out, options = {}) {
+  return options.dstLocale ? compareForLocale(src, out, options.dstLocale) : compareStrict(src, out);
 }
-async function performEdit(opts) {
-  const baseDir = process.cwd();
-  const config3 = readConfig(baseDir);
-  if (!config3) throw noConfigError();
-  const localeFiles = await findLocaleFiles(baseDir);
-  const files = localeFiles.get(opts.locale);
-  if (!files || files.length === 0) {
-    throw new CliError(
-      `No translation files found for locale "${opts.locale}".`,
-      `Available locales: ${[...localeFiles.keys()].join(", ") || "none"}.`,
-      "no_translation_files"
-    );
+function repairPlaceholders(src, out, options = {}) {
+  const initial = comparePlaceholders(src, out, options);
+  if (initial.ok) return out;
+  const tokens = (s) => options.dstLocale ? extractPlaceholders(s).filter((t) => !isPluralToken(t)) : extractPlaceholders(s);
+  const srcTokens = tokens(src);
+  const outTokens = tokens(out);
+  const missingTokens = subtract(srcTokens, outTokens);
+  const extraTokens = subtract(outTokens, srcTokens);
+  if (missingTokens.length === 0 || missingTokens.length !== extraTokens.length) {
+    return null;
   }
-  const targetFile = resolveFileForKey(files, opts.key, opts.namespace);
-  if (!targetFile) {
-    throw new CliError(
-      `Could not determine target file for key "${opts.key}" in locale "${opts.locale}".`,
-      "Pass --namespace to say which file the key belongs to."
+  const braceKinds = /* @__PURE__ */ new Set([
+    "mustache",
+    "icu-simple",
+    "ruby"
+  ]);
+  const unclaimed = [...missingTokens];
+  const rewrites = [];
+  for (const bad of extraTokens) {
+    if (!braceKinds.has(bad.kind)) return null;
+    const idx = unclaimed.findIndex(
+      (m) => braceKinds.has(m.kind) && m.name.toLowerCase() === bad.name.toLowerCase()
     );
+    if (idx === -1) return null;
+    const [good] = unclaimed.splice(idx, 1);
+    if (!good) return null;
+    rewrites.push({ start: bad.start, end: bad.end, text: good.text });
   }
-  const keyInFile = resolveKeyInFile(
-    opts.key,
-    targetFile,
-    files.length,
-    opts.namespace
-  );
-  const adapter = createAdapter("json");
-  let existingData = {};
-  try {
-    const parsed = await adapter.parse(targetFile);
-    existingData = parsed.data;
-  } catch {
+  if (unclaimed.length > 0) return null;
+  rewrites.sort((a, b) => b.start - a.start);
+  let repaired = out;
+  for (const r of rewrites) {
+    repaired = repaired.slice(0, r.start) + r.text + repaired.slice(r.end);
   }
-  const updatedData = setByPath(
-    existingData,
-    keyInFile,
-    opts.value
-  );
-  await adapter.serialize(targetFile, updatedData, { merge: false });
-  const relativePath = path12.relative(baseDir, targetFile);
-  return { filePath: relativePath, key: opts.key, value: opts.value };
+  return comparePlaceholders(src, repaired, options).ok ? repaired : null;
 }
-async function runEdit(opts) {
-  if (opts.json) {
-    const result2 = await performEdit(opts);
-    jsonSuccess({
-      file: result2.filePath,
-      key: result2.key,
-      value: result2.value
-    });
-  }
-  const { unmount } = renderTransient(/* @__PURE__ */ jsx18(EditUI, { state: { type: "editing" } }));
-  let result;
-  try {
-    result = await performEdit(opts);
-  } finally {
-    unmount();
-  }
-  render16(/* @__PURE__ */ jsx18(EditUI, { state: { type: "success", ...result } })).unmount();
+function settlePlaceholders(src, out, options = {}) {
+  const comparison = comparePlaceholders(src, out, options);
+  if (comparison.ok) return { value: out, repaired: false, comparison };
+  const value = repairPlaceholders(src, out, options);
+  return { value, repaired: value !== null, comparison };
 }
 
-// src/commands/translate/translate.tsx
-import { Spinner as Spinner16 } from "@inkjs/ui";
-import { Box as Box19, Text as Text19 } from "ink";
-import { jsx as jsx19, jsxs as jsxs19 } from "react/jsx-runtime";
-function planOutput(plan) {
-  return {
-    ...plan.summary,
-    protectedKeys: plan.protectedKeys,
-    heldKeys: plan.heldKeys,
-    untrackedKeys: plan.untrackedKeys.map((k) => k.key)
-  };
-}
-function fullKey5(namespace, key) {
-  return namespace ? `${namespace}.${key}` : key;
-}
-function characters(text) {
-  return Array.from(text).length;
+// ../ai/src/utils/term-match.ts
+function sharedPrefixLength(a, b) {
+  const minLen = Math.min(a.length, b.length);
+  let shared = 0;
+  while (shared < minLen && a[shared] === b[shared]) shared++;
+  return shared;
 }
-function targetLocales(ctx, opts) {
-  if (opts.dst) return [opts.dst];
-  const locales = ctx.project.targetLanguages;
-  if (locales.length === 0) {
-    throw new CliError(
-      "No target languages configured.",
-      "Add one with 'tolkbot languages add <code>'.",
-      "no_target_languages"
-    );
+var MIN_FUZZY_LENGTH = 4;
+var MIN_SHARED_FRACTION = 0.7;
+var UNSPACED_SCRIPT = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}]/u;
+var WORD_SPLIT = /[\s,.:;!?()[\]{}'"/\\-]+/;
+var MAX_DERIVED_PREFIX = 4;
+var MIN_DERIVED_STEM = 5;
+function termAppearsInText(text, term, opts = {}) {
+  const haystack = opts.caseSensitive ? text : text.toLowerCase();
+  const needle = (opts.caseSensitive ? term : term.toLowerCase()).trim();
+  if (needle.length === 0) return false;
+  if (UNSPACED_SCRIPT.test(needle)) return haystack.includes(needle);
+  if (/\s/.test(needle) && haystack.includes(needle)) return true;
+  const termWords = needle.split(WORD_SPLIT).filter(Boolean);
+  const words2 = haystack.split(WORD_SPLIT).filter(Boolean);
+  for (let start = 0; start + termWords.length <= words2.length; start++) {
+    if (termWords.every(
+      (termWord, offset) => wordMatches(
+        words2[start + offset] ?? "",
+        termWord,
+        opts.derivedForms ?? false
+      )
+    )) {
+      return true;
+    }
   }
-  return locales;
+  return false;
 }
-async function runTranslate(opts) {
-  const ctx = await loadPlanContext(process.cwd());
-  const srcLocale = opts.src ?? ctx.project.baseLanguage;
-  const dstLocales = targetLocales(ctx, opts);
-  if (opts.dryRun) {
-    await runDryRun(ctx, srcLocale, dstLocales, opts);
-    return;
+function wordMatches(word, termWord, derivedForms) {
+  if (word === termWord) return true;
+  if (termWord.length < MIN_FUZZY_LENGTH || word.length < MIN_FUZZY_LENGTH) {
+    return false;
   }
-  await runLanguages(ctx, srcLocale, dstLocales, opts);
-}
-var NO_ESTIMATE = "No credit estimate exists for this project yet. Keys and characters are what a run would send.";
-async function runDryRun(ctx, srcLocale, dstLocales, opts) {
-  const languages = [];
-  const progress = renderTransient(
-    /* @__PURE__ */ jsx19(Working, { text: `Planning ${dstLocales.join(", ")}\u2026` })
-  );
-  try {
-    for (const dstLocale of dstLocales) {
-      const { plan } = await generateTasks(ctx, srcLocale, dstLocale, {
-        retranslateUntracked: opts.retranslateUntracked
-      });
-      languages.push({
-        dstLocale,
-        keys: plan.tasks.length,
-        characters: plan.tasks.reduce(
-          (n, task) => n + characters(task.src),
-          0
-        ),
-        tasks: plan.tasks.map((task) => ({
-          key: fullKey5(task.namespace, task.key),
-          path: task.path,
-          reason: task.reason,
-          ...opts.verbose ? { src: task.src } : {}
-        })),
-        plan
-      });
+  const minShared = Math.ceil(termWord.length * MIN_SHARED_FRACTION);
+  if (sharedPrefixLength(word, termWord) >= minShared) return true;
+  if (!derivedForms || minShared < MIN_DERIVED_STEM) return false;
+  for (let offset = 1; offset <= MAX_DERIVED_PREFIX; offset++) {
+    if (sharedPrefixLength(word.slice(offset), termWord) >= minShared) {
+      return true;
     }
-  } finally {
-    progress.unmount();
-  }
-  const total = {
-    keys: languages.reduce((n, l) => n + l.keys, 0),
-    characters: languages.reduce((n, l) => n + l.characters, 0)
-  };
-  const balance = await readCreditBalance(ctx);
-  track("cli_translate_completed", {
-    mode: "plan",
-    key_count: total.keys,
-    locale_count: languages.length,
-    job_count: 0,
-    json: opts.json ?? false
-  });
-  if (opts.json) {
-    jsonSuccess({
-      dryRun: true,
-      srcLocale,
-      languages: languages.map(({ plan, ...language }) => ({
-        ...language,
-        plan: planOutput(plan)
-      })),
-      total,
-      estimate: null,
-      estimateNote: NO_ESTIMATE,
-      credits: { balance }
-    });
   }
-  for (const language of languages) {
-    const head = `${srcLocale} \u2192 ${language.dstLocale}`;
-    if (language.keys === 0) {
-      console.log(`\u2713 ${head}: up to date`);
+  return false;
+}
+
+// ../ai/src/translations/glossary.ts
+function extractGlossaryData(glossaries, dstLocale) {
+  const terms = [];
+  const doNotTranslate = [];
+  const contextTerms = [];
+  for (const g of glossaries) {
+    const id = g.id ? { id: g.id } : {};
+    if (g.doNotTranslate) {
+      doNotTranslate.push({ ...id, term: g.src });
+      if (g.aiContext) {
+        contextTerms.push({ ...id, term: g.src, context: g.aiContext });
+      }
     } else {
-      console.log(
-        `\u2022 ${head}: ${language.keys} key(s) to translate, ${language.characters} characters`
+      const translation = pickGlossaryTranslation(
+        g.translations,
+        dstLocale
       );
-    }
-    for (const line of describePlan(language.plan)) {
-      console.log(`    ${line}`);
-    }
-    if (opts.verbose) {
-      for (const task of language.tasks) {
-        console.log(`    ${task.key}: ${JSON.stringify(task.src)}`);
+      if (translation) {
+        terms.push({
+          ...id,
+          source: g.src,
+          target: translation.text,
+          ...g.aiContext ? { notes: g.aiContext } : {}
+        });
+      } else if (g.aiContext) {
+        contextTerms.push({ ...id, term: g.src, context: g.aiContext });
       }
     }
   }
-  console.log(
-    `
-In all: ${total.keys} key(s), ${total.characters} characters.` + (balance === null ? "" : ` Credit balance: ${balance}.`)
-  );
-  console.log(NO_ESTIMATE);
-  console.log("Nothing was started. Run without --dry-run to translate.");
-}
-function Working({ text }) {
-  return /* @__PURE__ */ jsxs19(Box19, { children: [
-    /* @__PURE__ */ jsx19(Spinner16, {}),
-    /* @__PURE__ */ jsxs19(Text19, { children: [
-      " ",
-      text
-    ] })
-  ] });
-}
-function progressText(dstLocale, summary) {
-  if (!summary) return `${dstLocale}: starting\u2026`;
-  const done = summary.completed + summary.failed;
-  return `${dstLocale}: translating ${done}/${summary.total}\u2026`;
+  return { terms, doNotTranslate, contextTerms };
 }
-function describeOutcome2(outcome) {
-  const { dstLocale, status, keys, written } = outcome;
-  const wrote = written ? `, ${written.keys} written to ${written.files} file(s)` : "";
-  const notApplied = outcome.notApplied.length > 0 ? `, ${outcome.notApplied.length} not applied` : "";
-  switch (status) {
-    case "up-to-date":
-      return `\u2713 ${dstLocale}: up to date`;
-    case "started":
-      return `\u2192 ${dstLocale}: started job ${outcome.jobId} with ${keys} key(s)`;
-    case "succeeded":
-      return `\u2713 ${dstLocale}: ${outcome.completed} translated${wrote}${notApplied}`;
-    case "partial":
-      return `\u26A0 ${dstLocale}: ${outcome.completed} of ${keys} translated, ${outcome.failed} failed${wrote}${notApplied}`;
-    case "failed":
-      return `\u2717 ${dstLocale}: the job failed (${outcome.jobId})${wrote}${notApplied}`;
-    case "cancelled":
-      return `\u2717 ${dstLocale}: the job was cancelled (${outcome.jobId})`;
-    case "timed-out":
-      return `\u2717 ${dstLocale}: ${outcome.error}`;
-    case "not-started":
-      return `\u2717 ${dstLocale}: not started. ${outcome.error}`;
-    case "pending":
-    case "running":
-      return `\u2026 ${dstLocale}: ${status}`;
+function filterGlossaryByRelevance(glossary, src) {
+  return {
+    terms: glossary.terms.filter(
+      (t) => termAppearsInText(src, t.source, {
+        caseSensitive: t.caseSensitive
+      })
+    ),
+    doNotTranslate: glossary.doNotTranslate.filter(
+      (t) => termAppearsInText(src, t.term)
+    ),
+    contextTerms: glossary.contextTerms.filter(
+      (t) => termAppearsInText(src, t.term)
+    )
+  };
+}
+function checkGlossaryCompliance(terms, translation) {
+  const missing = [];
+  for (const term of terms) {
+    const target = term.target.trim();
+    if (!target) continue;
+    if (!termAppearsInText(translation, target, {
+      caseSensitive: term.caseSensitive,
+      derivedForms: true
+    })) {
+      missing.push({ source: term.source, target: term.target });
+    }
   }
+  return missing;
 }
-async function runLanguages(ctx, srcLocale, dstLocales, opts) {
-  const { project, framework } = ctx;
-  const json2 = opts.json ?? false;
-  const outcomes = [];
-  let failure2 = null;
-  let stopped = null;
-  const report = (outcome) => {
-    outcomes.push(outcome);
-    if (json2) return;
-    console.log(describeOutcome2(outcome));
-    for (const line of describeNotApplied(outcome.notApplied)) {
-      console.log(`  ${line}`);
+
+// ../ai/src/translations/languages.ts
+var VERIFIER_LANGUAGES = {
+  en: "English",
+  nb: "Norwegian Bokm\xE5l",
+  nn: "Norwegian Nynorsk",
+  sv: "Swedish",
+  da: "Danish",
+  fi: "Finnish",
+  is: "Icelandic",
+  de: "German",
+  nl: "Dutch",
+  fr: "French",
+  es: "Spanish",
+  pt: "Portuguese",
+  it: "Italian",
+  ca: "Catalan",
+  ro: "Romanian",
+  pl: "Polish",
+  cs: "Czech",
+  sk: "Slovak",
+  hu: "Hungarian",
+  el: "Greek",
+  ru: "Russian",
+  uk: "Ukrainian",
+  bg: "Bulgarian",
+  sr: "Serbian",
+  hr: "Croatian",
+  tr: "Turkish",
+  ar: "Arabic",
+  he: "Hebrew",
+  fa: "Persian",
+  hi: "Hindi",
+  bn: "Bengali",
+  th: "Thai",
+  vi: "Vietnamese",
+  id: "Indonesian",
+  ms: "Malay",
+  ja: "Japanese",
+  ko: "Korean",
+  zh: "Chinese",
+  other: "Any other language, or no natural language at all"
+};
+var LANGUAGE_ALIASES = { no: "nb" };
+function verifierLanguage(locale) {
+  const head = locale.trim().split(/[-_]/)[0] ?? "";
+  const base = (/^[a-z]{2,3}(?=[A-Z])/.exec(head) ?? /^[A-Za-z]{2,3}$/.exec(head))?.[0].toLowerCase();
+  if (!base) return void 0;
+  const language = LANGUAGE_ALIASES[base] ?? base;
+  return language in VERIFIER_LANGUAGES && language !== "other" ? language : void 0;
+}
+
+// ../ai/src/translations/deterministic-health.ts
+var REQUIRED_SCRIPT = {
+  ko: /\p{Script=Hangul}/u,
+  ja: /[\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Han}]/u,
+  zh: /\p{Script=Han}/u,
+  ar: /\p{Script=Arabic}/u,
+  fa: /\p{Script=Arabic}/u,
+  he: /\p{Script=Hebrew}/u,
+  ru: /\p{Script=Cyrillic}/u,
+  uk: /\p{Script=Cyrillic}/u,
+  bg: /\p{Script=Cyrillic}/u,
+  el: /\p{Script=Greek}/u,
+  th: /\p{Script=Thai}/u,
+  hi: /\p{Script=Devanagari}/u,
+  bn: /\p{Script=Bengali}/u
+};
+var MIN_LETTERS = 4;
+var MIN_SENTENCE_WORDS = 3;
+var MIN_SENTENCE_LETTERS = 8;
+function proseOf(text) {
+  return text.replace(/\{\{[^{}]*\}\}/g, " ").replace(/\{[^{}]*\}/g, " ").replace(/\{[^{}]*\}/g, " ").replace(/<[^<>]*>/g, " ").replace(/`[^`]*`/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/%[sdif@]|%\d+\$[sdif@]/g, " ");
+}
+function letters(text) {
+  return text.match(/\p{L}/gu)?.length ?? 0;
+}
+function words(text) {
+  return text.trim().split(/\s+/).filter(Boolean).length;
+}
+function deterministicHealth(input2) {
+  const findings = [];
+  const translation = input2.translation.trim();
+  const source = input2.source.trim();
+  if (!translation) return { findings, needsModel: false };
+  if (!comparePlaceholders(source, translation, {
+    dstLocale: input2.dstLocale
+  }).ok) {
+    findings.push("placeholder_mismatch");
+  }
+  const prose = proseOf(translation);
+  const letterCount = letters(prose);
+  const sameLanguage = verifierLanguage(input2.srcLocale) !== void 0 && verifierLanguage(input2.srcLocale) === verifierLanguage(input2.dstLocale);
+  if (translation === source) {
+    if (!sameLanguage && words(prose) >= MIN_SENTENCE_WORDS && letterCount >= MIN_SENTENCE_LETTERS) {
+      findings.push("same_as_source");
     }
+    return { findings, needsModel: false };
+  }
+  if (letterCount < MIN_LETTERS) return { findings, needsModel: false };
+  const language = verifierLanguage(input2.dstLocale);
+  const script = language ? REQUIRED_SCRIPT[language] : void 0;
+  if (script && !script.test(prose)) {
+    findings.push("wrong_script");
+    return { findings, needsModel: false };
+  }
+  return { findings, needsModel: true };
+}
+
+// ../ai/src/translations/consistency.ts
+function findSourceInconsistencies(pairs, referencePairs = []) {
+  const groups = /* @__PURE__ */ new Map();
+  const add = (p, reviewable) => {
+    const src = p.src.trim();
+    if (!src) return;
+    const list = groups.get(src) ?? [];
+    list.push({
+      key: p.key,
+      dst: p.dst,
+      reviewable,
+      ...p.context ? { context: p.context } : {}
+    });
+    groups.set(src, list);
   };
-  for (const dstLocale of dstLocales) {
-    const progress = renderTransient(
-      /* @__PURE__ */ jsx19(Working, { text: `${dstLocale}: planning\u2026` })
+  for (const p of pairs) add(p, true);
+  for (const p of referencePairs) add(p, false);
+  const out = [];
+  for (const [src, variants] of groups) {
+    if (variants.length < 2) continue;
+    if (new Set(variants.map((v) => v.dst.trim())).size < 2) continue;
+    if (!variants.some((v) => v.reviewable)) continue;
+    const contexts = new Set(variants.map((v) => v.context?.trim() ?? ""));
+    out.push({ src, variants, unexplained: contexts.size === 1 });
+  }
+  return out;
+}
+
+// src/commands/set/set-core.ts
+async function locateKey(ctx, key, locale) {
+  const { root, project } = ctx;
+  const scope = scopeOf(project);
+  const format = formatOf(scope);
+  const files = await listLocaleFiles(root, scope);
+  const sourceFiles = filesForLocale(files, project.baseLanguage);
+  if (sourceFiles.length === 0) {
+    throw new CliError(
+      `No ${project.baseLanguage} translation file matches "${fullPattern(scope)}" under ${root}.`,
+      "The pattern comes from the project settings; check it there, or that you are in the right repository.",
+      "no_translation_files"
     );
-    try {
-      const { tasks, plan } = await generateTasks(
-        ctx,
-        srcLocale,
-        dstLocale,
-        { retranslateUntracked: opts.retranslateUntracked }
+  }
+  const found = [];
+  for (const file2 of sourceFiles) {
+    const prefix = file2.namespace ? `${file2.namespace}.` : "";
+    if (!key.startsWith(prefix)) continue;
+    const fileKey = key.slice(prefix.length);
+    const read = await readTranslationFile(file2.absolutePath, format);
+    if (read.error !== void 0) {
+      throw new CliError(
+        `Cannot read the ${project.baseLanguage} file ${file2.relativePath}: ${read.error}`
       );
-      const base = {
-        dstLocale,
-        status: "up-to-date",
-        jobId: null,
-        keys: tasks.length,
-        completed: null,
-        failed: null,
-        written: null,
-        notApplied: [],
-        error: null,
-        plan: planOutput(plan)
-      };
-      const leftOut = describeLeftOut(plan);
-      if (stopped !== null) {
-        progress.unmount();
-        report({ ...base, status: "not-started", error: stopped });
-        continue;
-      }
-      if (tasks.length === 0) {
-        progress.unmount();
-        report(base);
-        printNotes(json2, leftOut);
-        continue;
-      }
-      progress.rerender(/* @__PURE__ */ jsx19(Working, { text: progressText(dstLocale, null) }));
-      let jobId;
-      try {
-        jobId = await startTranslationJob({
-          projectId: project._id,
-          organizationId: project.organizationId,
-          framework,
-          srcLocale,
-          dstLocale,
-          tasks
-        });
-      } catch (error62) {
-        const refused = toCliError(error62);
-        failure2 ??= refused;
-        progress.unmount();
-        report({
-          ...base,
-          status: "not-started",
-          error: refused.baseMessage
-        });
-        if (exitCodeFor(refused.code) === EXIT_CODES.billing) {
-          stopped = `TolkBot refused the ${dstLocale} job: ${refused.baseMessage}`;
-        }
-        continue;
-      }
-      if (!opts.wait) {
-        progress.unmount();
-        report({ ...base, status: "started", jobId });
-        printNotes(json2, leftOut);
-        continue;
-      }
-      let summary;
-      try {
-        summary = await waitForTranslationJob(
-          project.organizationId,
-          jobId,
-          (latest) => progress.rerender(
-            /* @__PURE__ */ jsx19(Working, { text: progressText(dstLocale, latest) })
-          )
-        );
-      } catch (error62) {
-        if (!(error62 instanceof JobWaitTimeoutError)) throw error62;
-        failure2 ??= error62;
-        progress.unmount();
-        report({
-          ...base,
-          status: "timed-out",
-          jobId,
-          error: error62.baseMessage
-        });
-        stopped = `The CLI stopped waiting for the ${dstLocale} job.`;
-        continue;
-      }
-      const finished = {
-        ...base,
-        status: summary.status,
-        jobId,
-        completed: summary.completed,
-        failed: summary.failed
-      };
-      if (summary.status !== "cancelled") {
-        progress.rerender(
-          /* @__PURE__ */ jsx19(Working, { text: `${dstLocale}: writing the files\u2026` })
-        );
-        const applied = await applyJob(ctx, jobId);
-        finished.written = { files: applied.files, keys: applied.keys };
-        finished.notApplied = applied.notApplied;
-      }
-      const unsuccessful = unsuccessfulJobError(jobId, summary.status);
-      if (unsuccessful) {
-        failure2 ??= unsuccessful;
-        finished.error = unsuccessful.baseMessage;
-      }
-      progress.unmount();
-      report(finished);
-      printNotes(json2, leftOut);
-      if (summary.status === "cancelled") {
-        stopped = `The ${dstLocale} job was cancelled.`;
-      }
-    } finally {
-      progress.unmount();
     }
+    const expected = expectedTargetKeys(getKeys(read.data), locale).get(
+      fileKey
+    );
+    if (!expected) continue;
+    const source = getByPath(read.data, expected.sourceKey);
+    if (typeof source !== "string") continue;
+    found.push({ file: file2, data: read.data, fileKey, source });
   }
-  track("cli_translate_completed", {
-    mode: "run",
-    key_count: outcomes.reduce((n, o) => n + o.keys, 0),
-    locale_count: outcomes.length,
-    job_count: outcomes.filter((o) => o.jobId).length,
-    json: json2
-  });
-  const payload = { srcLocale, languages: outcomes };
-  if (json2) {
-    if (!failure2) jsonSuccess(payload);
-    jsonResult(payload, 1);
-    fail(failure2);
+  const [only, ...rest] = found;
+  if (!only) {
+    throw new CliError(
+      `"${key}" is not a key of the ${project.baseLanguage} files.`,
+      sourceFiles.some((file2) => file2.namespace) ? "Keys are named with their namespace first, as the dashboard names them: namespace.key." : "Run 'tolkbot status --keys' to list the keys a language is missing.",
+      "key_not_found"
+    );
   }
-  if (!opts.wait && outcomes.some((o) => o.status === "started")) {
-    console.log(
-      "\nThe jobs keep running. Follow them with 'tolkbot jobs list' and write them into the files with 'tolkbot jobs apply'."
+  if (rest.length > 0) {
+    throw new CliError(
+      `"${key}" names a key in more than one file: ${found.map((f) => f.file.relativePath).join(", ")}.`
     );
   }
-  if (failure2) fail(failure2);
-}
-function printNotes(json2, notes) {
-  if (json2) return;
-  for (const note of notes) console.log(`    ${note}`);
+  return only;
 }
-function checkTranslateOptions(opts) {
-  if (!opts.dst && !opts.all) {
+async function setValue(ctx, input2) {
+  const { root, project } = ctx;
+  if (sameLocale(input2.locale, project.baseLanguage)) {
     throw new UsageError(
-      "Either --dst <locale> or --all must be provided.",
-      "Run 'tolkbot translate --help'."
+      `${input2.locale} is the project's base language.`,
+      "Edit the source file itself; 'tolkbot set' writes translations."
     );
   }
-  if (opts.dst && opts.all) {
-    throw new UsageError("Cannot use both --dst and --all.");
+  if (input2.value.trim().length === 0) {
+    throw new UsageError("--value is empty.");
   }
-  if (opts.dryRun && !opts.wait) {
-    throw new UsageError(
-      "Cannot use --dry-run with --no-wait: a dry run starts nothing."
+  const locale = governanceLocale(project, input2.locale);
+  const located = await locateKey(ctx, input2.key, locale);
+  const comparison = comparePlaceholders(located.source, input2.value, {
+    dstLocale: locale
+  });
+  if (!comparison.ok && !input2.force) {
+    const repaired = settlePlaceholders(located.source, input2.value, {
+      dstLocale: locale
+    });
+    throw new CliError(
+      `The value's placeholders do not match the source "${located.source}": ${comparison.problems.join("; ")}.`,
+      repaired.repaired && repaired.value !== null ? `Did you mean "${repaired.value}"? Pass --force to write it as it is.` : "Fix the value, or pass --force to write it as it is.",
+      "placeholder_mismatch"
     );
   }
-}
-
-// src/commands/translate/index.ts
-var RETRANSLATE_UNTRACKED_HELP = "Also retranslate translations TolkBot has no record of (kept by default)";
-var translateCommand2 = new Command8("translate").description(
-  "Translate what is missing or changed, and write the results into your locale files"
-).option(
-  "--src <locale>",
-  "Source locale (defaults to the project's base language)"
-).option("--dst <locale>", "Destination locale").option("--all", "Every target language").option("--dry-run", "Print what a run would translate, and start nothing").option(
-  "--no-wait",
-  "Start the jobs and print their IDs without waiting; apply them later with 'tolkbot jobs apply'"
-).option("--retranslate-untracked", RETRANSLATE_UNTRACKED_HELP).option("--verbose", "With --dry-run, include each key's source string").option("--json", "Output as JSON (machine-readable)").allowExcessArguments(true).enablePositionalOptions().action(async (opts, command) => {
-  const [word] = command.args;
-  if (word !== void 0) {
-    throw new UsageError(
-      `unknown command 'translate ${word}'`,
-      "Run 'tolkbot translate --help'. Jobs are under 'tolkbot jobs'."
+  const scope = scopeOf(project);
+  const files = await listLocaleFiles(root, scope);
+  const target = targetFileFor(located.file, locale, files, scope);
+  const before = target.existing ? await readTranslationFile(
+    target.existing.absolutePath,
+    formatOf(scope)
+  ) : void 0;
+  const previousValue = before?.data ? getByPath(before.data, located.fileKey) : void 0;
+  const applied = await applyTasks({
+    root,
+    scope,
+    srcLocale: project.baseLanguage,
+    dstLocale: locale,
+    tasks: [
+      {
+        key: located.fileKey,
+        namespace: located.file.namespace,
+        path: located.file.relativePath,
+        src: located.source,
+        dst: input2.value,
+        status: "succeeded"
+      }
+    ]
+  });
+  const [written] = applied.written;
+  if (!written) {
+    const reason = applied.refused[0]?.reason;
+    throw new CliError(
+      reason === "target_unreadable" ? `Cannot read the ${locale} file ${target.relativePath}.` : `"${input2.key}" was not written (${reason ?? "unknown reason"}).`,
+      reason === "target_unreadable" ? "Fix the file so it parses, then run this again." : void 0
     );
   }
-  const schema = z10.object({
-    src: z10.string().min(1).optional(),
-    dst: z10.string().min(1).optional(),
-    all: z10.boolean().optional(),
-    dryRun: z10.boolean().optional(),
-    wait: z10.boolean(),
-    retranslateUntracked: z10.boolean().optional(),
-    verbose: z10.boolean().optional(),
-    json: z10.boolean().optional()
-  });
-  const parsed = validateOrExit(schema, opts);
-  checkTranslateOptions(parsed);
-  await runTranslate(parsed);
-});
-translateCommand2.command("adopt").description(
-  "Record existing translations TolkBot has no baseline for as reviewed, so they are kept until their source changes"
-).option(
-  "--src <locale>",
-  "Source locale (defaults to the project's base language)"
-).option("--dst <locale>", "Destination locale").option("--all", "Every target language").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
-  const schema = z10.object({
-    src: z10.string().min(1).optional(),
-    dst: z10.string().min(1).optional(),
-    all: z10.boolean().optional(),
-    json: z10.boolean().optional()
-  });
-  const parsed = validateOrExit(schema, opts);
-  if (parsed.dst && parsed.all) {
-    throw new UsageError("Cannot use both --dst and --all.");
-  }
-  await runAdopt(parsed);
-});
-translateCommand2.command("edit").description("Edit a translation value in a locale file").requiredOption("--key <key>", "Translation key (e.g. common.hello)").requiredOption("--locale <locale>", "Target locale (e.g. fr, de)").requiredOption("--value <text>", "New translation value").option("--namespace <ns>", "Namespace to resolve file (if ambiguous)").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
-  const schema = z10.object({
-    key: z10.string().min(1),
-    locale: z10.string().min(1),
-    value: z10.string().min(1),
-    namespace: z10.string().optional(),
-    json: z10.boolean().optional()
-  });
-  const parsed = validateOrExit(schema, opts);
-  await runEdit(parsed);
-});
-
-// src/commands/validate.tsx
-import { Box as Box20, render as render17, Text as Text20 } from "ink";
-
-// src/utils/pattern-discovery.ts
-import fs9 from "fs/promises";
-var DEFAULT_NAMESPACE = "translation";
-async function parseFile(absolutePath, format) {
-  let content;
+  const ids = {
+    organizationId: project.organizationId,
+    projectId: project._id
+  };
   try {
-    content = await fs9.readFile(absolutePath, "utf-8");
-  } catch {
-    throw new Error("Could not read file");
+    await ctx.client.mutation(api.localeKeyStates.stampManualForCli, {
+      ...ids,
+      locale,
+      pathTemplate: written.pathTemplate,
+      entries: [
+        {
+          key: located.fileKey,
+          namespace: located.file.namespace,
+          baseValue: located.source,
+          translatedValue: input2.value
+        }
+      ]
+    });
+  } catch (error62) {
+    throw new CliError(
+      `${written.relativePath} holds the new value, but TolkBot could not record it as yours: ${error62 instanceof Error ? error62.message : String(error62)}`,
+      "Run the same command again to record it; until then a translation run may replace it."
+    );
   }
-  const parsed = format === "ts" ? parseTsContent(content) : parseJsonContent(content);
-  const problem = parsed.issues?.find((issue2) => issue2.type === "error");
-  if (problem) throw new Error(problem.message);
-  return parsed.data;
-}
-async function discoverByPattern(root, scope) {
-  const format = formatOf(scope);
-  const files = await listLocaleFiles(root, scope);
-  if (files.length === 0) return null;
-  const filesByLocale = /* @__PURE__ */ new Map();
-  const parseErrors = [];
-  for (const file2 of files) {
-    try {
-      const data = await parseFile(file2.absolutePath, format);
-      const group = filesByLocale.get(file2.locale) ?? [];
-      group.push({
-        data,
-        path: file2.absolutePath,
-        relativePath: file2.relativePath,
-        locale: file2.locale,
-        namespace: file2.namespace ?? DEFAULT_NAMESPACE
-      });
-      filesByLocale.set(file2.locale, group);
-    } catch (error62) {
-      parseErrors.push({
-        path: file2.absolutePath,
-        relativePath: file2.relativePath,
-        locale: file2.locale,
-        message: error62 instanceof Error ? error62.message : String(error62)
-      });
-    }
+  let learningId = null;
+  if (input2.learn !== void 0) {
+    learningId = await ctx.client.mutation(api.learnings.createForProject, {
+      ...ids,
+      srcLocale: project.baseLanguage,
+      dstLocale: locale,
+      sourceText: located.source,
+      suggestedTranslation: input2.value,
+      reasoning: input2.learn,
+      feedbackType: "incorrect-term"
+    });
   }
-  const locales = [...new Set(files.map((file2) => file2.locale))];
   return {
-    format,
-    pattern: fullPattern(scope),
-    filesByLocale,
-    locales,
-    baseLocale: detectBaseLocale(locales),
-    fileCount: files.length,
-    parseErrors
+    key: input2.key,
+    locale,
+    file: written.relativePath,
+    value: input2.value,
+    previous: typeof previousValue === "string" ? previousValue : null,
+    source: located.source,
+    placeholderProblems: comparison.ok ? [] : comparison.problems,
+    incompletePlurals: comparison.incompletePlurals,
+    learningId
   };
 }
 
-// ../ai/src/validators/placeholders.ts
-var IDENTIFIER = /^[A-Za-z0-9_$][A-Za-z0-9_$.[\]-]*$/;
-var PRINTF_CONV = "sdiufFeEgGxXocpn%@";
-function isIdentifier(s) {
-  return IDENTIFIER.test(s);
+// src/commands/set/index.ts
+var setCommand = new Command6("set").description(
+  "Write a translation yourself; TolkBot keeps it until its source text changes"
+).argument("<key>", "The key, as the dashboard names it (e.g. common.save)").requiredOption("--locale <locale>", "Target locale (e.g. nb)").requiredOption("--value <text>", "The translation").option(
+  "--force",
+  "Write the value even when its placeholders do not match the source"
+).option(
+  "--learn <note>",
+  `Also store a learning for the project, e.g. "use Oversikt, not Dashbord: it is the app's word"`
+).option("--json", "Output as JSON (machine-readable)").action(async (key, opts) => {
+  const schema = z8.object({
+    locale: z8.string().min(1),
+    value: z8.string(),
+    force: z8.boolean().optional(),
+    learn: z8.string().trim().min(1).optional(),
+    json: z8.boolean().optional()
+  });
+  const parsed = validateOrExit(schema, opts);
+  await runSet({ key, ...parsed });
+});
+async function runSet(opts) {
+  const ctx = await loadPlanContext(process.cwd());
+  const result = await setValue(ctx, opts);
+  if (opts.json) jsonSuccess(result);
+  printResult(result);
 }
-function matchBrace(s, open3) {
-  let depth = 0;
-  for (let i = open3; i < s.length; i++) {
-    if (s[i] === "{") depth++;
-    else if (s[i] === "}") {
-      depth--;
-      if (depth === 0) return i;
-    }
+function printResult(result) {
+  console.log(
+    `\u2713 ${result.locale}: set ${result.key} in ${result.file}, recorded as yours`
+  );
+  if (result.previous !== null && result.previous !== result.value) {
+    console.log(`  was: ${result.previous}`);
   }
-  return -1;
-}
-function splitTopLevel(s, limit) {
-  const parts = [];
-  let depth = 0;
-  let start = 0;
-  for (let i = 0; i < s.length; i++) {
-    const c = s[i];
-    if (c === "{") depth++;
-    else if (c === "}") depth--;
-    else if (c === "," && depth === 0 && parts.length < limit - 1) {
-      parts.push(s.slice(start, i));
-      start = i + 1;
-    }
+  if (result.learningId) {
+    console.log(`  learning saved: ${result.learningId}`);
+  }
+  for (const problem of result.placeholderProblems) {
+    console.error(`! written with --force: ${problem}`);
+  }
+  for (const plural2 of result.incompletePlurals) {
+    console.error(`! ${plural2}`);
   }
-  parts.push(s.slice(start));
-  return parts;
 }
-function parseBranches(s) {
-  const branches = [];
-  let i = 0;
-  while (i < s.length) {
-    while (i < s.length && /\s/.test(s[i] ?? "")) i++;
-    if (i >= s.length) break;
-    const keyStart = i;
-    while (i < s.length && !/[\s{]/.test(s[i] ?? "")) i++;
-    const keyword = s.slice(keyStart, i);
-    if (!keyword) break;
-    if (keyword.startsWith("offset:")) {
-      branches.push({ keyword, message: "" });
-      continue;
-    }
-    while (i < s.length && /\s/.test(s[i] ?? "")) i++;
-    if (s[i] !== "{") break;
-    const close = matchBrace(s, i);
-    if (close === -1) break;
-    branches.push({ keyword, message: s.slice(i + 1, close) });
-    i = close + 1;
-  }
-  return branches;
-}
-function parseIcuComplex(token) {
-  return token.complex ?? null;
+
+// src/commands/status/index.ts
+import { Command as Command7 } from "commander";
+import { z as z9 } from "zod/v4";
+
+// src/commands/status/status.tsx
+import { Spinner as Spinner14 } from "@inkjs/ui";
+import { Box as Box17, Text as Text17 } from "ink";
+
+// src/commands/status/status-core.ts
+function fullKey4(namespace, key) {
+  return namespace ? `${namespace}.${key}` : key;
 }
-function readBraceToken(s, i) {
-  if (s[i + 1] === "{") {
-    const close2 = s.indexOf("}}", i + 2);
-    if (close2 !== -1) {
-      const inner2 = s.slice(i + 2, close2);
-      if (!inner2.includes("{") && !inner2.includes("}")) {
-        const name2 = (inner2.split(",")[0] ?? "").trim();
-        if (isIdentifier(name2)) {
-          const rest = inner2.slice(inner2.indexOf(name2) + name2.length);
-          const suffix = rest.trim();
-          return {
-            text: s.slice(i, close2 + 2),
-            kind: "mustache",
-            name: name2,
-            signature: `mustache:${name2}${suffix ? `:${suffix.replace(/\s+/g, " ")}` : ""}`,
-            start: i,
-            end: close2 + 2
-          };
-        }
-      }
-    }
-  }
-  const close = matchBrace(s, i);
-  if (close === -1) return null;
-  const inner = s.slice(i + 1, close);
-  const parts = splitTopLevel(inner, 3);
-  const name = (parts[0] ?? "").trim();
-  if (!isIdentifier(name)) return null;
-  const text = s.slice(i, close + 1);
-  const type = (parts[1] ?? "").trim();
-  if (parts.length === 3 && (type === "plural" || type === "select" || type === "selectordinal")) {
-    const branches = parseBranches(parts[2] ?? "");
-    return {
-      text,
-      kind: "icu-complex",
-      name,
-      complex: { name, type, branches },
-      // Branch MESSAGES are translatable, so they stay out of the
-      // signature; their keywords and nested tokens are compared separately.
-      signature: `icu-complex:${name}:${type}:${branches.map((b) => b.keyword).sort().join("|")}`,
-      start: i,
-      end: close + 1
-    };
-  }
-  const normalized = parts.map((p) => p.trim().replace(/\s+/g, " ")).join(", ");
-  return {
-    text,
-    kind: "icu-simple",
-    name,
-    signature: `icu-simple:${normalized}`,
-    start: i,
-    end: close + 1
-  };
+function isPersonHold(reason) {
+  return reason === "locked" || reason === "pending-draft";
 }
-function readPercentToken(s, i) {
-  if (s[i + 1] === "{") {
-    const close = s.indexOf("}", i + 2);
-    if (close !== -1) {
-      const name = s.slice(i + 2, close).trim();
-      if (isIdentifier(name)) {
-        return {
-          text: s.slice(i, close + 1),
-          kind: "ruby",
-          name,
-          signature: `ruby:${name}`,
-          start: i,
-          end: close + 1
-        };
-      }
-    }
-  }
-  let j = i + 1;
-  if (j >= s.length || s[j] === " ") return null;
-  const rest = s.slice(j);
-  const argnum = /^(\d+)\$/.exec(rest);
-  if (argnum) j += argnum[0].length;
-  while (j < s.length && "-+0#".includes(s[j] ?? "")) j++;
-  while (j < s.length && /\d/.test(s[j] ?? "")) j++;
-  if (s[j] === ".") {
-    j++;
-    while (j < s.length && /\d/.test(s[j] ?? "")) j++;
-  }
-  const conv = s[j];
-  if (!conv || !PRINTF_CONV.includes(conv)) return null;
-  const text = s.slice(i, j + 1);
-  return {
-    text,
-    kind: "printf",
-    name: argnum?.[1] ?? "",
-    signature: `printf:${text}`,
-    start: i,
-    end: j + 1
-  };
+function count(reasons2) {
+  const byReason = {};
+  for (const reason of reasons2)
+    byReason[reason] = (byReason[reason] ?? 0) + 1;
+  return { total: reasons2.length, byReason };
 }
-var TAG = /^<\/?[A-Za-z0-9][A-Za-z0-9._-]*\s*\/?>/;
-function readTagToken(s, i) {
-  const m = TAG.exec(s.slice(i));
-  if (!m) return null;
-  const text = m[0];
-  return {
-    text,
-    kind: "tag",
-    name: text.replace(/[<>/\s]/g, ""),
-    signature: `tag:${text.replace(/\s+/g, "")}`,
-    start: i,
-    end: i + text.length
-  };
+function openPullRequest(rows, locale) {
+  const row = rows.find(
+    (r) => r.prState === "open" && r.prUrl !== void 0 && sameLocale(r.targetLanguage, locale)
+  );
+  if (!row?.prUrl) return null;
+  return { number: row.prNumber ?? null, url: row.prUrl };
 }
-function readNestingToken(s, i) {
-  if (!s.startsWith("$t(", i)) return null;
-  const close = s.indexOf(")", i + 3);
-  if (close === -1) return null;
-  const text = s.slice(i, close + 1);
+function languageStatus(locale, plan, pullRequests, opts = {}) {
+  const { summary } = plan;
+  const held = [
+    ...plan.heldKeys,
+    ...plan.protectedKeys.flatMap(
+      ({ key, reason }) => isPersonHold(reason) ? [{ key, reason }] : []
+    )
+  ];
+  const kept = plan.protectedKeys.flatMap(
+    ({ key, reason }) => isPersonHold(reason) ? [] : [{ key, reason }]
+  );
+  const tasks = (reason) => plan.tasks.filter((t) => t.reason === reason).map((t) => fullKey4(t.namespace, t.key));
   return {
-    text,
-    kind: "nesting",
-    name: s.slice(i + 3, close).trim(),
-    signature: `nesting:${text.replace(/\s+/g, "")}`,
-    start: i,
-    end: close + 1
+    locale,
+    expected: summary.totalKeys,
+    upToDate: summary.upToDate,
+    missing: summary.missing,
+    changed: summary.changed,
+    heldByPerson: count(held.map((h) => h.reason)),
+    keptForPerson: count(kept.map((k) => k.reason)),
+    untracked: summary.untracked,
+    pullRequest: openPullRequest(pullRequests, locale),
+    ...opts.keys ? {
+      keys: {
+        missing: tasks("missing"),
+        changed: tasks("changed"),
+        heldByPerson: held,
+        keptForPerson: kept,
+        untracked: plan.untrackedKeys.map((k) => k.key)
+      }
+    } : {}
   };
 }
-function extractPlaceholders(s) {
-  const tokens = [];
-  let i = 0;
-  while (i < s.length) {
-    const c = s[i];
-    let token = null;
-    if (c === "{") token = readBraceToken(s, i);
-    else if (c === "%") token = readPercentToken(s, i);
-    else if (c === "<") token = readTagToken(s, i);
-    else if (c === "$") token = readNestingToken(s, i);
-    if (token) {
-      tokens.push(token);
-      i = token.end;
-      continue;
-    }
-    i++;
-  }
-  return tokens;
+function needsTranslation(language) {
+  return language.missing > 0 || language.changed > 0;
 }
-function countHashes(s) {
-  return (s.match(/#/g) ?? []).length;
+var REASON_WORDS = {
+  locked: "locked",
+  "pending-draft": "pending draft",
+  manual: "written by a person",
+  "target-edited": "edited since TolkBot wrote it",
+  unknown: "no record of who wrote it"
+};
+function reasons(counts) {
+  return Object.entries(counts.byReason).map(
+    ([reason, n]) => `${n} ${REASON_WORDS[reason]}`
+  ).join(", ");
 }
-function subtract(a, b) {
-  const pool = /* @__PURE__ */ new Map();
-  for (const t of b) pool.set(t.signature, (pool.get(t.signature) ?? 0) + 1);
-  const out = [];
-  for (const t of a) {
-    const left = pool.get(t.signature) ?? 0;
-    if (left > 0) pool.set(t.signature, left - 1);
-    else out.push(t);
+function describeLanguage(language) {
+  const counts = [
+    `${language.expected} expected`,
+    `${language.upToDate} up to date`,
+    `${language.missing} missing`,
+    `${language.changed} changed since translated`
+  ].join(", ");
+  const mark = needsTranslation(language) ? "\u2022" : "\u2713";
+  const lines = [`${mark} ${language.locale}: ${counts}`];
+  if (language.heldByPerson.total > 0) {
+    lines.push(
+      `    ${language.heldByPerson.total} held by a person (${reasons(language.heldByPerson)})`
+    );
   }
-  return out;
+  if (language.keptForPerson.total > 0) {
+    lines.push(
+      `    ${language.keptForPerson.total} changed but kept for a person (${reasons(language.keptForPerson)})`
+    );
+  }
+  if (language.untracked > 0) {
+    lines.push(
+      `    ${language.untracked} untracked: TolkBot has no record of them`
+    );
+  }
+  if (language.pullRequest) {
+    lines.push(`    Pull request: ${language.pullRequest.url}`);
+  }
+  const { keys } = language;
+  if (keys) {
+    const list = (label, names) => {
+      if (names.length === 0) return;
+      lines.push(`    ${label}:`);
+      for (const name of names) lines.push(`      ${name}`);
+    };
+    list("Missing", keys.missing);
+    list("Changed", keys.changed);
+    list(
+      "Held by a person",
+      keys.heldByPerson.map(
+        (k) => `${k.key} (${REASON_WORDS[k.reason]})`
+      )
+    );
+    list(
+      "Kept for a person",
+      keys.keptForPerson.map(
+        (k) => `${k.key} (${REASON_WORDS[k.reason]})`
+      )
+    );
+    list("Untracked", keys.untracked);
+  }
+  return lines;
 }
-function compareIcuBranches(srcToken, outToken, problems, missing, extra) {
-  const src = parseIcuComplex(srcToken);
-  const out = parseIcuComplex(outToken);
-  if (!src || !out) return;
-  const outByKeyword = new Map(out.branches.map((b) => [b.keyword, b]));
-  for (const branch of src.branches) {
-    const counterpart = outByKeyword.get(branch.keyword);
-    if (!counterpart) continue;
-    const srcHashes = countHashes(branch.message);
-    const outHashes = countHashes(counterpart.message);
-    if (srcHashes !== outHashes) {
-      problems.push(
-        `{${src.name}} branch "${branch.keyword}" has ${srcHashes} "#" in the source but ${outHashes} in the translation`
+
+// src/commands/status/status.tsx
+import { jsx as jsx17, jsxs as jsxs17 } from "react/jsx-runtime";
+var OFFLINE_HINT = "Without a login, 'tolkbot validate' checks the files on this machine.";
+async function runStatus(opts) {
+  let ctx;
+  try {
+    ctx = await loadPlanContext(process.cwd());
+  } catch (error62) {
+    if (error62 instanceof AuthError) {
+      throw new AuthError(
+        error62.baseMessage,
+        [error62.hint, OFFLINE_HINT].filter(Boolean).join(" "),
+        error62.code
       );
-      if (srcHashes > outHashes) missing.push("#");
-      else extra.push("#");
     }
-    const nested = compareStrict(branch.message, counterpart.message);
-    if (!nested.ok) {
-      missing.push(...nested.missing);
-      extra.push(...nested.extra);
-      problems.push(
-        ...nested.problems.map(
-          (p) => `inside {${src.name}} branch "${branch.keyword}": ${p}`
-        )
+    throw error62;
+  }
+  const { project } = ctx;
+  const srcLocale = project.baseLanguage;
+  const locales = project.targetLanguages;
+  const progress = renderTransient(
+    /* @__PURE__ */ jsxs17(Box17, { children: [
+      /* @__PURE__ */ jsx17(Spinner14, {}),
+      /* @__PURE__ */ jsxs17(Text17, { children: [
+        " Reading the status of ",
+        project.name,
+        "\u2026"
+      ] })
+    ] })
+  );
+  const languages = [];
+  let credits;
+  try {
+    const pullRequests = locales.length === 0 ? [] : await ctx.client.query(api.prJobs.listByProject, {
+      organizationId: project.organizationId,
+      projectId: project._id
+    });
+    for (const locale of locales) {
+      const plan = await planForLocale(ctx, srcLocale, locale);
+      languages.push(
+        languageStatus(locale, plan, pullRequests, {
+          keys: opts.keys
+        })
       );
     }
+    credits = await readCreditBalance(ctx);
+  } finally {
+    progress.unmount();
   }
-}
-function compareStrict(src, out) {
-  const srcTokens = extractPlaceholders(src);
-  const outTokens = extractPlaceholders(out);
-  const missingTokens = subtract(srcTokens, outTokens);
-  const extraTokens = subtract(outTokens, srcTokens);
-  const missing = missingTokens.map((t) => t.text);
-  const extra = extraTokens.map((t) => t.text);
-  const problems = [];
-  for (const t of missingTokens) {
-    problems.push(`"${t.text}" is missing from the translation`);
+  const payload = {
+    project: {
+      name: project.name,
+      slug: project.slug,
+      url: `${env.TOLKBOT_WEB_URL}/projects/${project.slug}`,
+      baseLanguage: srcLocale,
+      pattern: fullPattern(scopeOf(project)),
+      autoCreatePR: project.workflow?.autoCreatePR ?? DEFAULT_BEHAVIORAL_SETTINGS.workflow.autoCreatePR
+    },
+    credits: { balance: credits },
+    languages
+  };
+  const outOfDate = languages.some(needsTranslation);
+  const exitCode = opts.exitCode && outOfDate ? 1 : 0;
+  if (opts.json) {
+    if (exitCode === 0) jsonSuccess(payload);
+    jsonResult(payload, exitCode);
+    return;
   }
-  for (const t of extraTokens) {
-    problems.push(
-      `"${t.text}" appears in the translation but not the source`
+  const { project: p } = payload;
+  console.log(`${p.name} (${p.slug}) ${p.url}`);
+  console.log(
+    `Base language ${p.baseLanguage}, files ${p.pattern}, auto-create pull requests ${p.autoCreatePR ? "on" : "off"}`
+  );
+  console.log(
+    credits === null ? "Credits left: could not be read" : `Credits left: ${credits}`
+  );
+  console.log("");
+  if (languages.length === 0) {
+    console.log(
+      `No target languages configured. Add them in the project settings at ${p.url}/settings.`
     );
   }
-  const matchedOut = /* @__PURE__ */ new Map();
-  for (const t of outTokens) {
-    if (t.kind !== "icu-complex") continue;
-    const bucket = matchedOut.get(t.signature) ?? [];
-    bucket.push(t);
-    matchedOut.set(t.signature, bucket);
+  for (const language of languages) {
+    for (const line of describeLanguage(language)) console.log(line);
   }
-  for (const t of srcTokens) {
-    if (t.kind !== "icu-complex") continue;
-    const counterpart = matchedOut.get(t.signature)?.shift();
-    if (counterpart) {
-      compareIcuBranches(t, counterpart, problems, missing, extra);
-    }
+  if (outOfDate) {
+    console.log(
+      "\nRun 'tolkbot translate --all' to translate what is missing or changed."
+    );
   }
-  return {
-    ok: problems.length === 0,
-    missing,
-    extra,
-    problems,
-    incompletePlurals: []
+  process.exitCode = exitCode;
+}
+
+// src/commands/status/index.ts
+var statusCommand = new Command7("status").description(
+  "Show what each language is missing, what waits for a person, the open pull requests and the credits left"
+).option("--keys", "List the keys by name under each language").option(
+  "--exit-code",
+  "Exit 1 when any language has missing or changed keys"
+).option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+  const schema = z9.object({
+    keys: z9.boolean().optional(),
+    exitCode: z9.boolean().optional(),
+    json: z9.boolean().optional()
+  });
+  await runStatus(validateOrExit(schema, opts));
+});
+
+// src/commands/telemetry.ts
+import { Command as Command8 } from "commander";
+import { z as z10 } from "zod/v4";
+var REASONS = {
+  env: `disabled by $${TELEMETRY_ENV_VAR}`,
+  "do-not-track": `disabled by $${DO_NOT_TRACK_ENV_VAR}`,
+  preference: "disabled with `tolkbot telemetry off`",
+  "no-key": "disabled: this build has no telemetry key",
+  default: "enabled"
+};
+async function printStatus(json2) {
+  const state = await telemetryState();
+  if (json2) {
+    jsonResult({ ...state, preferenceFile: getPreferencePath() }, 0);
+    return;
+  }
+  console.log(
+    `Telemetry is ${state.enabled ? "on" : "off"} (${REASONS[state.reason]}).`
+  );
+  console.log(
+    `Turn it off with \`tolkbot telemetry off\`, $${TELEMETRY_ENV_VAR}=0 or $${DO_NOT_TRACK_ENV_VAR}=1.`
+  );
+}
+var telemetryCommand = new Command8("telemetry").description(
+  "Control anonymous usage reporting"
+);
+telemetryCommand.command("status", { isDefault: true }).description("Show whether telemetry is on and why").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+  const parsed = validateOrExit(
+    z10.object({ json: z10.boolean().optional() }),
+    opts
+  );
+  await printStatus(parsed.json);
+});
+telemetryCommand.command("off").description("Stop reporting usage from this machine").action(async () => {
+  await setTelemetryPreference(false);
+  console.log(
+    `Telemetry is off. Preference saved to ${getPreferencePath()}.`
+  );
+});
+telemetryCommand.command("on").description("Resume reporting usage from this machine").action(async () => {
+  await setTelemetryPreference(true);
+  await printStatus(false);
+});
+
+// src/commands/translate/index.ts
+import { Command as Command9 } from "commander";
+import { z as z11 } from "zod/v4";
+
+// src/commands/translate/adopt.tsx
+var STAMP_CHUNK2 = 200;
+async function adoptLocale(ctx, srcLocale, dstLocale) {
+  const plan = await planForLocale(ctx, srcLocale, dstLocale);
+  const locale = governanceLocale(ctx.project, dstLocale);
+  const byTemplate = /* @__PURE__ */ new Map();
+  for (const key of plan.untrackedKeys) {
+    const group = byTemplate.get(key.pathTemplate) ?? [];
+    group.push(key);
+    byTemplate.set(key.pathTemplate, group);
+  }
+  const outcome = {
+    dstLocale,
+    untracked: plan.untrackedKeys.length,
+    adopted: 0,
+    skipped: 0
   };
+  for (const [pathTemplate, keys] of byTemplate) {
+    for (let i = 0; i < keys.length; i += STAMP_CHUNK2) {
+      const result = await ctx.client.mutation(
+        api.localeKeyStates.adoptUntrackedForCli,
+        {
+          organizationId: ctx.project.organizationId,
+          projectId: ctx.project._id,
+          locale,
+          pathTemplate,
+          entries: keys.slice(i, i + STAMP_CHUNK2).map((key) => ({
+            key: key.fileKey,
+            namespace: key.namespace,
+            baseValue: key.src,
+            translatedValue: key.dst
+          }))
+        }
+      );
+      outcome.adopted += result.adopted;
+      outcome.skipped += result.skipped;
+    }
+  }
+  return outcome;
 }
-function pluralArgument(token) {
-  const complex = token.complex;
-  if (token.kind !== "icu-complex" || !complex) return null;
-  if (complex.type !== "plural" && complex.type !== "selectordinal") {
-    return null;
+async function runAdopt(opts) {
+  const run = async () => {
+    const ctx = await loadPlanContext(process.cwd());
+    const src = opts.src ?? ctx.project.baseLanguage;
+    const locales = opts.all ? ctx.project.targetLanguages : opts.dst ? [opts.dst] : [];
+    if (locales.length === 0) {
+      throw opts.all ? new CliError(
+        "No target languages configured for this project.",
+        "Add one with 'tolkbot languages add <code>'.",
+        "no_target_languages"
+      ) : new UsageError(
+        "Either --dst <locale> or --all must be provided."
+      );
+    }
+    const outcomes2 = [];
+    for (const dst of locales)
+      outcomes2.push(await adoptLocale(ctx, src, dst));
+    track("cli_translate_completed", {
+      mode: "adopt",
+      key_count: outcomes2.reduce((n, o) => n + o.adopted, 0),
+      locale_count: outcomes2.length,
+      job_count: 0,
+      json: opts.json === true
+    });
+    return outcomes2;
+  };
+  if (opts.json) {
+    jsonSuccess({ adopted: await run() });
   }
+  const outcomes = await run();
+  for (const o of outcomes) {
+    console.log(
+      `\u2713 ${o.dstLocale}: adopted ${o.adopted} untracked translation(s)` + (o.skipped > 0 ? `, ${o.skipped} already tracked` : "")
+    );
+  }
+}
+
+// src/commands/translate/translate.tsx
+import { Spinner as Spinner15 } from "@inkjs/ui";
+import { Box as Box18, Text as Text18 } from "ink";
+import { jsx as jsx18, jsxs as jsxs18 } from "react/jsx-runtime";
+function planOutput(plan) {
   return {
-    token,
-    name: complex.name,
-    type: complex.type,
-    branches: complex.branches
+    ...plan.summary,
+    protectedKeys: plan.protectedKeys,
+    heldKeys: plan.heldKeys,
+    untrackedKeys: plan.untrackedKeys.map((k) => k.key)
   };
 }
-function withoutPlurals(s, plurals) {
-  let out = s;
-  const byPositionDesc = [...plurals].sort(
-    (a, b) => b.token.start - a.token.start
-  );
-  for (const p of byPositionDesc) {
-    out = out.slice(0, p.token.start) + " " + out.slice(p.token.end);
-  }
-  return out;
+function fullKey5(namespace, key) {
+  return namespace ? `${namespace}.${key}` : key;
 }
-function fixedKeywords(p) {
-  return p.branches.map((b) => b.keyword).filter((k) => !PLURAL_CATEGORIES.has(k)).sort();
+function characters(text) {
+  return Array.from(text).length;
 }
-function comparePluralPair(src, out, dstLocale, result) {
-  const srcFixed = fixedKeywords(src).join(" ");
-  const outFixed = fixedKeywords(out).join(" ");
-  if (srcFixed !== outFixed) {
-    result.problems.push(
-      `{${src.name}} has branches [${srcFixed}] in the source but [${outFixed}] in the translation`
+function targetLocales(ctx, opts) {
+  if (opts.dst) return [opts.dst];
+  const locales = ctx.project.targetLanguages;
+  if (locales.length === 0) {
+    throw new CliError(
+      "No target languages configured.",
+      "Add one with 'tolkbot languages add <code>'.",
+      "no_target_languages"
     );
   }
-  const pluralType = src.type === "plural" ? "cardinal" : "ordinal";
-  const outKeywords = new Set(out.branches.map((b) => b.keyword));
-  const lacking = requiredPluralCategories(dstLocale, pluralType).filter(
-    (c) => !outKeywords.has(c)
+  return locales;
+}
+async function runTranslate(opts) {
+  const ctx = await loadPlanContext(process.cwd());
+  const srcLocale = opts.src ?? ctx.project.baseLanguage;
+  const dstLocales = targetLocales(ctx, opts);
+  if (opts.dryRun) {
+    await runDryRun(ctx, srcLocale, dstLocales, opts);
+    return;
+  }
+  await runLanguages(ctx, srcLocale, dstLocales, opts);
+}
+var NO_ESTIMATE = "No credit estimate exists for this project yet. Keys and characters are what a run would send.";
+async function runDryRun(ctx, srcLocale, dstLocales, opts) {
+  const languages = [];
+  const progress = renderTransient(
+    /* @__PURE__ */ jsx18(Working, { text: `Planning ${dstLocales.join(", ")}\u2026` })
   );
-  if (lacking.length > 0) {
-    result.incompletePlurals.push(
-      `{${src.name}} has no ${lacking.map((c) => `"${c}"`).join(", ")} branch, which ${dstLocale} needs`
-    );
+  try {
+    for (const dstLocale of dstLocales) {
+      const { plan } = await generateTasks(ctx, srcLocale, dstLocale, {
+        retranslateUntracked: opts.retranslateUntracked
+      });
+      languages.push({
+        dstLocale,
+        keys: plan.tasks.length,
+        characters: plan.tasks.reduce(
+          (n, task) => n + characters(task.src),
+          0
+        ),
+        tasks: plan.tasks.map((task) => ({
+          key: fullKey5(task.namespace, task.key),
+          path: task.path,
+          reason: task.reason,
+          ...opts.verbose ? { src: task.src } : {}
+        })),
+        plan
+      });
+    }
+  } finally {
+    progress.unmount();
   }
-  const srcByKeyword = new Map(src.branches.map((b) => [b.keyword, b]));
-  const srcOther = srcByKeyword.get("other");
-  for (const branch of out.branches) {
-    if (branch.keyword.startsWith("offset:")) continue;
-    const counterpart = srcByKeyword.get(branch.keyword) ?? (PLURAL_CATEGORIES.has(branch.keyword) ? srcOther : void 0);
-    if (!counterpart) continue;
-    const srcHashes = countHashes(counterpart.message);
-    const outHashes = countHashes(branch.message);
-    const sayableInWords = branch.keyword.startsWith("=") || isSingleNumberCategory(dstLocale, pluralType, branch.keyword);
-    if (srcHashes !== outHashes && !(sayableInWords && outHashes <= Math.max(srcHashes, 1))) {
-      result.problems.push(
-        `{${src.name}} branch "${branch.keyword}" has ${outHashes} "#" but the source's "${counterpart.keyword}" has ${srcHashes}`
+  const total = {
+    keys: languages.reduce((n, l) => n + l.keys, 0),
+    characters: languages.reduce((n, l) => n + l.characters, 0)
+  };
+  const balance = await readCreditBalance(ctx);
+  track("cli_translate_completed", {
+    mode: "plan",
+    key_count: total.keys,
+    locale_count: languages.length,
+    job_count: 0,
+    json: opts.json ?? false
+  });
+  if (opts.json) {
+    jsonSuccess({
+      dryRun: true,
+      srcLocale,
+      languages: languages.map(({ plan, ...language }) => ({
+        ...language,
+        plan: planOutput(plan)
+      })),
+      total,
+      estimate: null,
+      estimateNote: NO_ESTIMATE,
+      credits: { balance }
+    });
+  }
+  for (const language of languages) {
+    const head = `${srcLocale} \u2192 ${language.dstLocale}`;
+    if (language.keys === 0) {
+      console.log(`\u2713 ${head}: up to date`);
+    } else {
+      console.log(
+        `\u2022 ${head}: ${language.keys} key(s) to translate, ${language.characters} characters`
       );
-      if (srcHashes > outHashes) result.missing.push("#");
-      else result.extra.push("#");
     }
-    const nested = compareForLocale(
-      counterpart.message,
-      branch.message,
-      dstLocale
-    );
-    result.missing.push(...nested.missing);
-    result.extra.push(...nested.extra);
-    result.problems.push(
-      ...nested.problems.map(
-        (p) => `inside {${src.name}} branch "${branch.keyword}": ${p}`
-      )
-    );
-    result.incompletePlurals.push(...nested.incompletePlurals);
+    for (const line of describePlan(language.plan)) {
+      console.log(`    ${line}`);
+    }
+    if (opts.verbose) {
+      for (const task of language.tasks) {
+        console.log(`    ${task.key}: ${JSON.stringify(task.src)}`);
+      }
+    }
+  }
+  console.log(
+    `
+In all: ${total.keys} key(s), ${total.characters} characters.` + (balance === null ? "" : ` Credit balance: ${balance}.`)
+  );
+  console.log(NO_ESTIMATE);
+  console.log("Nothing was started. Run without --dry-run to translate.");
+}
+function Working({ text }) {
+  return /* @__PURE__ */ jsxs18(Box18, { children: [
+    /* @__PURE__ */ jsx18(Spinner15, {}),
+    /* @__PURE__ */ jsxs18(Text18, { children: [
+      " ",
+      text
+    ] })
+  ] });
+}
+function progressText(dstLocale, summary) {
+  if (!summary) return `${dstLocale}: starting\u2026`;
+  const done = summary.completed + summary.failed;
+  return `${dstLocale}: translating ${done}/${summary.total}\u2026`;
+}
+function describeOutcome2(outcome) {
+  const { dstLocale, status, keys, written } = outcome;
+  const wrote = written ? `, ${written.keys} written to ${written.files} file(s)` : "";
+  const notApplied = outcome.notApplied.length > 0 ? `, ${outcome.notApplied.length} not applied` : "";
+  switch (status) {
+    case "up-to-date":
+      return `\u2713 ${dstLocale}: up to date`;
+    case "started":
+      return `\u2192 ${dstLocale}: started job ${outcome.jobId} with ${keys} key(s)`;
+    case "succeeded":
+      return `\u2713 ${dstLocale}: ${outcome.completed} translated${wrote}${notApplied}`;
+    case "partial":
+      return `\u26A0 ${dstLocale}: ${outcome.completed} of ${keys} translated, ${outcome.failed} failed${wrote}${notApplied}`;
+    case "failed":
+      return `\u2717 ${dstLocale}: the job failed (${outcome.jobId})${wrote}${notApplied}`;
+    case "cancelled":
+      return `\u2717 ${dstLocale}: the job was cancelled (${outcome.jobId})`;
+    case "timed-out":
+      return `\u2717 ${dstLocale}: ${outcome.error}`;
+    case "not-started":
+      return `\u2717 ${dstLocale}: not started. ${outcome.error}`;
+    case "pending":
+    case "running":
+      return `\u2026 ${dstLocale}: ${status}`;
   }
 }
-function compareForLocale(src, out, dstLocale) {
-  const srcPlurals = extractPlaceholders(src).map(pluralArgument).filter((p) => p !== null);
-  const outPlurals = extractPlaceholders(out).map(pluralArgument).filter((p) => p !== null);
-  const result = compareStrict(
-    withoutPlurals(src, srcPlurals),
-    withoutPlurals(out, outPlurals)
-  );
-  const unmatched = [...outPlurals];
-  for (const p of srcPlurals) {
-    const i = unmatched.findIndex(
-      (o) => o.name === p.name && o.type === p.type
+async function runLanguages(ctx, srcLocale, dstLocales, opts) {
+  const { project, framework } = ctx;
+  const json2 = opts.json ?? false;
+  const outcomes = [];
+  let failure2 = null;
+  let stopped = null;
+  const report = (outcome) => {
+    outcomes.push(outcome);
+    if (json2) return;
+    console.log(describeOutcome2(outcome));
+    for (const line of describeNotApplied(outcome.notApplied)) {
+      console.log(`  ${line}`);
+    }
+  };
+  for (const dstLocale of dstLocales) {
+    const progress = renderTransient(
+      /* @__PURE__ */ jsx18(Working, { text: `${dstLocale}: planning\u2026` })
     );
-    const counterpart = i === -1 ? void 0 : unmatched.splice(i, 1)[0];
-    if (!counterpart) {
-      result.missing.push(p.token.text);
-      result.problems.push(
-        `"${p.token.text}" is missing from the translation`
+    try {
+      const { tasks, plan } = await generateTasks(
+        ctx,
+        srcLocale,
+        dstLocale,
+        { retranslateUntracked: opts.retranslateUntracked }
       );
-      continue;
+      const base = {
+        dstLocale,
+        status: "up-to-date",
+        jobId: null,
+        keys: tasks.length,
+        completed: null,
+        failed: null,
+        written: null,
+        notApplied: [],
+        error: null,
+        plan: planOutput(plan)
+      };
+      const leftOut = describeLeftOut(plan);
+      if (stopped !== null) {
+        progress.unmount();
+        report({ ...base, status: "not-started", error: stopped });
+        continue;
+      }
+      if (tasks.length === 0) {
+        progress.unmount();
+        report(base);
+        printNotes(json2, leftOut);
+        continue;
+      }
+      progress.rerender(/* @__PURE__ */ jsx18(Working, { text: progressText(dstLocale, null) }));
+      let jobId;
+      try {
+        jobId = await startTranslationJob({
+          projectId: project._id,
+          organizationId: project.organizationId,
+          framework,
+          srcLocale,
+          dstLocale,
+          tasks
+        });
+      } catch (error62) {
+        const refused = toCliError(error62);
+        failure2 ??= refused;
+        progress.unmount();
+        report({
+          ...base,
+          status: "not-started",
+          error: refused.baseMessage
+        });
+        if (exitCodeFor(refused.code) === EXIT_CODES.billing) {
+          stopped = `TolkBot refused the ${dstLocale} job: ${refused.baseMessage}`;
+        }
+        continue;
+      }
+      if (!opts.wait) {
+        progress.unmount();
+        report({ ...base, status: "started", jobId });
+        printNotes(json2, leftOut);
+        continue;
+      }
+      let summary;
+      try {
+        summary = await waitForTranslationJob(
+          project.organizationId,
+          jobId,
+          (latest) => progress.rerender(
+            /* @__PURE__ */ jsx18(Working, { text: progressText(dstLocale, latest) })
+          )
+        );
+      } catch (error62) {
+        if (!(error62 instanceof JobWaitTimeoutError)) throw error62;
+        failure2 ??= error62;
+        progress.unmount();
+        report({
+          ...base,
+          status: "timed-out",
+          jobId,
+          error: error62.baseMessage
+        });
+        stopped = `The CLI stopped waiting for the ${dstLocale} job.`;
+        continue;
+      }
+      const finished = {
+        ...base,
+        status: summary.status,
+        jobId,
+        completed: summary.completed,
+        failed: summary.failed
+      };
+      if (summary.status !== "cancelled") {
+        progress.rerender(
+          /* @__PURE__ */ jsx18(Working, { text: `${dstLocale}: writing the files\u2026` })
+        );
+        const applied = await applyJob(ctx, jobId);
+        finished.written = { files: applied.files, keys: applied.keys };
+        finished.notApplied = applied.notApplied;
+      }
+      const unsuccessful = unsuccessfulJobError(jobId, summary.status);
+      if (unsuccessful) {
+        failure2 ??= unsuccessful;
+        finished.error = unsuccessful.baseMessage;
+      }
+      progress.unmount();
+      report(finished);
+      printNotes(json2, leftOut);
+      if (summary.status === "cancelled") {
+        stopped = `The ${dstLocale} job was cancelled.`;
+      }
+    } finally {
+      progress.unmount();
     }
-    comparePluralPair(p, counterpart, dstLocale, result);
   }
-  for (const o of unmatched) {
-    result.extra.push(o.token.text);
-    result.problems.push(
-      `"${o.token.text}" appears in the translation but not the source`
+  track("cli_translate_completed", {
+    mode: "run",
+    key_count: outcomes.reduce((n, o) => n + o.keys, 0),
+    locale_count: outcomes.length,
+    job_count: outcomes.filter((o) => o.jobId).length,
+    json: json2
+  });
+  const payload = { srcLocale, languages: outcomes };
+  if (json2) {
+    if (!failure2) jsonSuccess(payload);
+    jsonResult(payload, 1);
+    fail(failure2);
+  }
+  if (!opts.wait && outcomes.some((o) => o.status === "started")) {
+    console.log(
+      "\nThe jobs keep running. Follow them with 'tolkbot jobs list' and write them into the files with 'tolkbot jobs apply'."
     );
   }
-  result.ok = result.problems.length === 0;
-  return result;
-}
-function comparePlaceholders(src, out, options = {}) {
-  return options.dstLocale ? compareForLocale(src, out, options.dstLocale) : compareStrict(src, out);
+  if (failure2) fail(failure2);
 }
-
-// ../ai/src/utils/term-match.ts
-function sharedPrefixLength(a, b) {
-  const minLen = Math.min(a.length, b.length);
-  let shared = 0;
-  while (shared < minLen && a[shared] === b[shared]) shared++;
-  return shared;
+function printNotes(json2, notes) {
+  if (json2) return;
+  for (const note of notes) console.log(`    ${note}`);
 }
-var MIN_FUZZY_LENGTH = 4;
-var MIN_SHARED_FRACTION = 0.7;
-var UNSPACED_SCRIPT = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}]/u;
-var WORD_SPLIT = /[\s,.:;!?()[\]{}'"/\\-]+/;
-var MAX_DERIVED_PREFIX = 4;
-var MIN_DERIVED_STEM = 5;
-function termAppearsInText(text, term, opts = {}) {
-  const haystack = opts.caseSensitive ? text : text.toLowerCase();
-  const needle = (opts.caseSensitive ? term : term.toLowerCase()).trim();
-  if (needle.length === 0) return false;
-  if (UNSPACED_SCRIPT.test(needle)) return haystack.includes(needle);
-  if (/\s/.test(needle) && haystack.includes(needle)) return true;
-  const termWords = needle.split(WORD_SPLIT).filter(Boolean);
-  const words2 = haystack.split(WORD_SPLIT).filter(Boolean);
-  for (let start = 0; start + termWords.length <= words2.length; start++) {
-    if (termWords.every(
-      (termWord, offset) => wordMatches(
-        words2[start + offset] ?? "",
-        termWord,
-        opts.derivedForms ?? false
-      )
-    )) {
-      return true;
-    }
+function checkTranslateOptions(opts) {
+  if (!opts.dst && !opts.all) {
+    throw new UsageError(
+      "Either --dst <locale> or --all must be provided.",
+      "Run 'tolkbot translate --help'."
+    );
   }
-  return false;
-}
-function wordMatches(word, termWord, derivedForms) {
-  if (word === termWord) return true;
-  if (termWord.length < MIN_FUZZY_LENGTH || word.length < MIN_FUZZY_LENGTH) {
-    return false;
+  if (opts.dst && opts.all) {
+    throw new UsageError("Cannot use both --dst and --all.");
   }
-  const minShared = Math.ceil(termWord.length * MIN_SHARED_FRACTION);
-  if (sharedPrefixLength(word, termWord) >= minShared) return true;
-  if (!derivedForms || minShared < MIN_DERIVED_STEM) return false;
-  for (let offset = 1; offset <= MAX_DERIVED_PREFIX; offset++) {
-    if (sharedPrefixLength(word.slice(offset), termWord) >= minShared) {
-      return true;
-    }
+  if (opts.dryRun && !opts.wait) {
+    throw new UsageError(
+      "Cannot use --dry-run with --no-wait: a dry run starts nothing."
+    );
   }
-  return false;
 }
 
-// ../ai/src/translations/glossary.ts
-function extractGlossaryData(glossaries, dstLocale) {
-  const terms = [];
-  const doNotTranslate = [];
-  const contextTerms = [];
-  for (const g of glossaries) {
-    const id = g.id ? { id: g.id } : {};
-    if (g.doNotTranslate) {
-      doNotTranslate.push({ ...id, term: g.src });
-      if (g.aiContext) {
-        contextTerms.push({ ...id, term: g.src, context: g.aiContext });
-      }
-    } else {
-      const translation = pickGlossaryTranslation(
-        g.translations,
-        dstLocale
-      );
-      if (translation) {
-        terms.push({
-          ...id,
-          source: g.src,
-          target: translation.text,
-          ...g.aiContext ? { notes: g.aiContext } : {}
-        });
-      } else if (g.aiContext) {
-        contextTerms.push({ ...id, term: g.src, context: g.aiContext });
-      }
-    }
+// src/commands/translate/index.ts
+var RETRANSLATE_UNTRACKED_HELP = "Also retranslate translations TolkBot has no record of (kept by default)";
+var translateCommand2 = new Command9("translate").description(
+  "Translate what is missing or changed, and write the results into your locale files"
+).option(
+  "--src <locale>",
+  "Source locale (defaults to the project's base language)"
+).option("--dst <locale>", "Destination locale").option("--all", "Every target language").option("--dry-run", "Print what a run would translate, and start nothing").option(
+  "--no-wait",
+  "Start the jobs and print their IDs without waiting; apply them later with 'tolkbot jobs apply'"
+).option("--retranslate-untracked", RETRANSLATE_UNTRACKED_HELP).option("--verbose", "With --dry-run, include each key's source string").option("--json", "Output as JSON (machine-readable)").allowExcessArguments(true).enablePositionalOptions().action(async (opts, command) => {
+  const [word] = command.args;
+  if (word !== void 0) {
+    throw new UsageError(
+      `unknown command 'translate ${word}'`,
+      "Run 'tolkbot translate --help'. Jobs are under 'tolkbot jobs'."
+    );
   }
-  return { terms, doNotTranslate, contextTerms };
-}
-function filterGlossaryByRelevance(glossary, src) {
-  return {
-    terms: glossary.terms.filter(
-      (t) => termAppearsInText(src, t.source, {
-        caseSensitive: t.caseSensitive
-      })
-    ),
-    doNotTranslate: glossary.doNotTranslate.filter(
-      (t) => termAppearsInText(src, t.term)
-    ),
-    contextTerms: glossary.contextTerms.filter(
-      (t) => termAppearsInText(src, t.term)
-    )
-  };
-}
-function checkGlossaryCompliance(terms, translation) {
-  const missing = [];
-  for (const term of terms) {
-    const target = term.target.trim();
-    if (!target) continue;
-    if (!termAppearsInText(translation, target, {
-      caseSensitive: term.caseSensitive,
-      derivedForms: true
-    })) {
-      missing.push({ source: term.source, target: term.target });
-    }
+  const schema = z11.object({
+    src: z11.string().min(1).optional(),
+    dst: z11.string().min(1).optional(),
+    all: z11.boolean().optional(),
+    dryRun: z11.boolean().optional(),
+    wait: z11.boolean(),
+    retranslateUntracked: z11.boolean().optional(),
+    verbose: z11.boolean().optional(),
+    json: z11.boolean().optional()
+  });
+  const parsed = validateOrExit(schema, opts);
+  checkTranslateOptions(parsed);
+  await runTranslate(parsed);
+});
+translateCommand2.command("adopt").description(
+  "Record existing translations TolkBot has no baseline for as reviewed, so they are kept until their source changes"
+).option(
+  "--src <locale>",
+  "Source locale (defaults to the project's base language)"
+).option("--dst <locale>", "Destination locale").option("--all", "Every target language").option("--json", "Output as JSON (machine-readable)").action(async (opts) => {
+  const schema = z11.object({
+    src: z11.string().min(1).optional(),
+    dst: z11.string().min(1).optional(),
+    all: z11.boolean().optional(),
+    json: z11.boolean().optional()
+  });
+  const parsed = validateOrExit(schema, opts);
+  if (parsed.dst && parsed.all) {
+    throw new UsageError("Cannot use both --dst and --all.");
   }
-  return missing;
-}
+  await runAdopt(parsed);
+});
 
-// ../ai/src/translations/languages.ts
-var VERIFIER_LANGUAGES = {
-  en: "English",
-  nb: "Norwegian Bokm\xE5l",
-  nn: "Norwegian Nynorsk",
-  sv: "Swedish",
-  da: "Danish",
-  fi: "Finnish",
-  is: "Icelandic",
-  de: "German",
-  nl: "Dutch",
-  fr: "French",
-  es: "Spanish",
-  pt: "Portuguese",
-  it: "Italian",
-  ca: "Catalan",
-  ro: "Romanian",
-  pl: "Polish",
-  cs: "Czech",
-  sk: "Slovak",
-  hu: "Hungarian",
-  el: "Greek",
-  ru: "Russian",
-  uk: "Ukrainian",
-  bg: "Bulgarian",
-  sr: "Serbian",
-  hr: "Croatian",
-  tr: "Turkish",
-  ar: "Arabic",
-  he: "Hebrew",
-  fa: "Persian",
-  hi: "Hindi",
-  bn: "Bengali",
-  th: "Thai",
-  vi: "Vietnamese",
-  id: "Indonesian",
-  ms: "Malay",
-  ja: "Japanese",
-  ko: "Korean",
-  zh: "Chinese",
-  other: "Any other language, or no natural language at all"
-};
-var LANGUAGE_ALIASES = { no: "nb" };
-function verifierLanguage(locale) {
-  const head = locale.trim().split(/[-_]/)[0] ?? "";
-  const base = (/^[a-z]{2,3}(?=[A-Z])/.exec(head) ?? /^[A-Za-z]{2,3}$/.exec(head))?.[0].toLowerCase();
-  if (!base) return void 0;
-  const language = LANGUAGE_ALIASES[base] ?? base;
-  return language in VERIFIER_LANGUAGES && language !== "other" ? language : void 0;
-}
+// src/commands/validate.tsx
+import { Box as Box19, render as render16, Text as Text19 } from "ink";
 
-// ../ai/src/translations/deterministic-health.ts
-var REQUIRED_SCRIPT = {
-  ko: /\p{Script=Hangul}/u,
-  ja: /[\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Han}]/u,
-  zh: /\p{Script=Han}/u,
-  ar: /\p{Script=Arabic}/u,
-  fa: /\p{Script=Arabic}/u,
-  he: /\p{Script=Hebrew}/u,
-  ru: /\p{Script=Cyrillic}/u,
-  uk: /\p{Script=Cyrillic}/u,
-  bg: /\p{Script=Cyrillic}/u,
-  el: /\p{Script=Greek}/u,
-  th: /\p{Script=Thai}/u,
-  hi: /\p{Script=Devanagari}/u,
-  bn: /\p{Script=Bengali}/u
-};
-var MIN_LETTERS = 4;
-var MIN_SENTENCE_WORDS = 3;
-var MIN_SENTENCE_LETTERS = 8;
-function proseOf(text) {
-  return text.replace(/\{\{[^{}]*\}\}/g, " ").replace(/\{[^{}]*\}/g, " ").replace(/\{[^{}]*\}/g, " ").replace(/<[^<>]*>/g, " ").replace(/`[^`]*`/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/%[sdif@]|%\d+\$[sdif@]/g, " ");
-}
-function letters(text) {
-  return text.match(/\p{L}/gu)?.length ?? 0;
-}
-function words(text) {
-  return text.trim().split(/\s+/).filter(Boolean).length;
-}
-function deterministicHealth(input2) {
-  const findings = [];
-  const translation = input2.translation.trim();
-  const source = input2.source.trim();
-  if (!translation) return { findings, needsModel: false };
-  if (!comparePlaceholders(source, translation, {
-    dstLocale: input2.dstLocale
-  }).ok) {
-    findings.push("placeholder_mismatch");
+// src/utils/pattern-discovery.ts
+import fs9 from "fs/promises";
+var DEFAULT_NAMESPACE = "translation";
+async function parseFile(absolutePath, format) {
+  let content;
+  try {
+    content = await fs9.readFile(absolutePath, "utf-8");
+  } catch {
+    throw new Error("Could not read file");
   }
-  const prose = proseOf(translation);
-  const letterCount = letters(prose);
-  const sameLanguage = verifierLanguage(input2.srcLocale) !== void 0 && verifierLanguage(input2.srcLocale) === verifierLanguage(input2.dstLocale);
-  if (translation === source) {
-    if (!sameLanguage && words(prose) >= MIN_SENTENCE_WORDS && letterCount >= MIN_SENTENCE_LETTERS) {
-      findings.push("same_as_source");
+  const parsed = format === "ts" ? parseTsContent(content) : parseJsonContent(content);
+  const problem = parsed.issues?.find((issue2) => issue2.type === "error");
+  if (problem) throw new Error(problem.message);
+  return parsed.data;
+}
+async function discoverByPattern(root, scope) {
+  const format = formatOf(scope);
+  const files = await listLocaleFiles(root, scope);
+  if (files.length === 0) return null;
+  const filesByLocale = /* @__PURE__ */ new Map();
+  const parseErrors = [];
+  for (const file2 of files) {
+    try {
+      const data = await parseFile(file2.absolutePath, format);
+      const group = filesByLocale.get(file2.locale) ?? [];
+      group.push({
+        data,
+        path: file2.absolutePath,
+        relativePath: file2.relativePath,
+        locale: file2.locale,
+        namespace: file2.namespace ?? DEFAULT_NAMESPACE
+      });
+      filesByLocale.set(file2.locale, group);
+    } catch (error62) {
+      parseErrors.push({
+        path: file2.absolutePath,
+        relativePath: file2.relativePath,
+        locale: file2.locale,
+        message: error62 instanceof Error ? error62.message : String(error62)
+      });
     }
-    return { findings, needsModel: false };
-  }
-  if (letterCount < MIN_LETTERS) return { findings, needsModel: false };
-  const language = verifierLanguage(input2.dstLocale);
-  const script = language ? REQUIRED_SCRIPT[language] : void 0;
-  if (script && !script.test(prose)) {
-    findings.push("wrong_script");
-    return { findings, needsModel: false };
   }
-  return { findings, needsModel: true };
-}
-
-// ../ai/src/translations/consistency.ts
-function findSourceInconsistencies(pairs, referencePairs = []) {
-  const groups = /* @__PURE__ */ new Map();
-  const add = (p, reviewable) => {
-    const src = p.src.trim();
-    if (!src) return;
-    const list = groups.get(src) ?? [];
-    list.push({
-      key: p.key,
-      dst: p.dst,
-      reviewable,
-      ...p.context ? { context: p.context } : {}
-    });
-    groups.set(src, list);
+  const locales = [...new Set(files.map((file2) => file2.locale))];
+  return {
+    format,
+    pattern: fullPattern(scope),
+    filesByLocale,
+    locales,
+    baseLocale: detectBaseLocale(locales),
+    fileCount: files.length,
+    parseErrors
   };
-  for (const p of pairs) add(p, true);
-  for (const p of referencePairs) add(p, false);
-  const out = [];
-  for (const [src, variants] of groups) {
-    if (variants.length < 2) continue;
-    if (new Set(variants.map((v) => v.dst.trim())).size < 2) continue;
-    if (!variants.some((v) => v.reviewable)) continue;
-    const contexts = new Set(variants.map((v) => v.context?.trim() ?? ""));
-    out.push({ src, variants, unexplained: contexts.size === 1 });
-  }
-  return out;
 }
 
 // ../quality/src/load.ts
@@ -34777,7 +35160,7 @@ function finalize2(issues, stats, strict) {
 }
 
 // src/commands/validate.tsx
-import { jsx as jsx20, jsxs as jsxs20 } from "react/jsx-runtime";
+import { jsx as jsx19, jsxs as jsxs19 } from "react/jsx-runtime";
 var LEVEL_COLOR = {
   error: "red",
   warning: "yellow",
@@ -34786,12 +35169,12 @@ var LEVEL_COLOR = {
 var GUTTER = 9;
 function IssueLine({ issue: issue2 }) {
   const location = [issue2.file, issue2.key].filter(Boolean).join(" \xB7 ");
-  return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs20(Box20, { children: [
-      /* @__PURE__ */ jsx20(Box20, { width: GUTTER, flexShrink: 0, children: /* @__PURE__ */ jsx20(Text20, { color: LEVEL_COLOR[issue2.level], children: issue2.level }) }),
-      /* @__PURE__ */ jsx20(Box20, { flexGrow: 1, children: /* @__PURE__ */ jsx20(Text20, { children: issue2.message }) })
+  return /* @__PURE__ */ jsxs19(Box19, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs19(Box19, { children: [
+      /* @__PURE__ */ jsx19(Box19, { width: GUTTER, flexShrink: 0, children: /* @__PURE__ */ jsx19(Text19, { color: LEVEL_COLOR[issue2.level], children: issue2.level }) }),
+      /* @__PURE__ */ jsx19(Box19, { flexGrow: 1, children: /* @__PURE__ */ jsx19(Text19, { children: issue2.message }) })
     ] }),
-    /* @__PURE__ */ jsx20(Box20, { marginLeft: GUTTER, children: /* @__PURE__ */ jsxs20(Text20, { dimColor: true, children: [
+    /* @__PURE__ */ jsx19(Box19, { marginLeft: GUTTER, children: /* @__PURE__ */ jsxs19(Text19, { dimColor: true, children: [
       issue2.rule,
       location ? ` \u2014 ${location}` : ""
     ] }) })
@@ -34800,20 +35183,20 @@ function IssueLine({ issue: issue2 }) {
 function ReportUI({ report }) {
   const { counts, stats } = report;
   const summary = ["error", "warning", "info"].filter((level) => counts[level] > 0).map((level) => `${counts[level]} ${level}(s)`).join(", ");
-  return /* @__PURE__ */ jsxs20(Box20, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs20(Box20, { children: [
-      /* @__PURE__ */ jsx20(Text20, { color: report.valid ? "green" : "red", children: report.valid ? "\u2713" : "\u2717" }),
-      /* @__PURE__ */ jsxs20(Text20, { children: [
+  return /* @__PURE__ */ jsxs19(Box19, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs19(Box19, { children: [
+      /* @__PURE__ */ jsx19(Text19, { color: report.valid ? "green" : "red", children: report.valid ? "\u2713" : "\u2717" }),
+      /* @__PURE__ */ jsxs19(Text19, { children: [
         " Validation ",
         report.valid ? "passed" : "failed"
       ] }),
-      summary ? /* @__PURE__ */ jsxs20(Text20, { dimColor: true, children: [
+      summary ? /* @__PURE__ */ jsxs19(Text19, { dimColor: true, children: [
         " \u2014 ",
         summary
       ] }) : null
     ] }),
-    stats.locales.length > 0 && /* @__PURE__ */ jsxs20(Box20, { marginTop: 1, flexDirection: "column", children: [
-      /* @__PURE__ */ jsxs20(Text20, { dimColor: true, children: [
+    stats.locales.length > 0 && /* @__PURE__ */ jsxs19(Box19, { marginTop: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs19(Text19, { dimColor: true, children: [
         stats.filesChecked,
         " ",
         stats.format,
@@ -34822,18 +35205,18 @@ function ReportUI({ report }) {
         stats.totalKeys,
         " keys"
       ] }),
-      /* @__PURE__ */ jsxs20(Text20, { dimColor: true, children: [
+      /* @__PURE__ */ jsxs19(Text19, { dimColor: true, children: [
         "Locales: ",
         stats.locales.join(", "),
         stats.baseLocale ? ` (base: ${stats.baseLocale})` : ""
       ] }),
-      stats.pattern && /* @__PURE__ */ jsxs20(Text20, { dimColor: true, children: [
+      stats.pattern && /* @__PURE__ */ jsxs19(Text19, { dimColor: true, children: [
         "Pattern: ",
         stats.pattern
       ] })
     ] }),
-    report.issues.length > 0 && /* @__PURE__ */ jsx20(Box20, { marginTop: 1, flexDirection: "column", gap: 1, children: report.issues.map((issue2, idx) => /* @__PURE__ */ jsx20(IssueLine, { issue: issue2 }, idx)) }),
-    !report.strict && counts.warning > 0 && report.valid && /* @__PURE__ */ jsx20(Box20, { marginTop: 1, children: /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "Warnings did not fail this run. Use --strict to treat them as errors." }) })
+    report.issues.length > 0 && /* @__PURE__ */ jsx19(Box19, { marginTop: 1, flexDirection: "column", gap: 1, children: report.issues.map((issue2, idx) => /* @__PURE__ */ jsx19(IssueLine, { issue: issue2 }, idx)) }),
+    !report.strict && counts.warning > 0 && report.valid && /* @__PURE__ */ jsx19(Box19, { marginTop: 1, children: /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "Warnings did not fail this run. Use --strict to treat them as errors." }) })
   ] });
 }
 function emit(report, json2) {
@@ -34853,7 +35236,7 @@ function emit(report, json2) {
     if (!report.valid) fail(validationFailure(report));
     return;
   }
-  render17(/* @__PURE__ */ jsx20(ReportUI, { report })).unmount();
+  render16(/* @__PURE__ */ jsx19(ReportUI, { report })).unmount();
   process.exitCode = exitCode;
 }
 function validationFailure(report) {
@@ -34931,7 +35314,7 @@ function commandPath(command) {
   return names.join(" ");
 }
 function buildProgram() {
-  const program = new Command9().name("tolkbot").description("Localization workflow for your repo").version(version, "-v, --version", "Output the version number").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").option("--token <token>", TOKEN_HELP).enablePositionalOptions();
+  const program = new Command10().name("tolkbot").description("Localization workflow for your repo").version(version, "-v, --version", "Output the version number").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").option("--token <token>", TOKEN_HELP).enablePositionalOptions();
   program.hook("preAction", (_thisCommand, actionCommand) => {
     const { token } = actionCommand.optsWithGlobals();
     setTokenOverride(token);
@@ -34940,7 +35323,7 @@ function buildProgram() {
   });
   program.command("init").description("Initialize TolkBot in the current repo").option("--force", "Overwrite existing config").option(
     "-y, --yes",
-    "Skip all prompts, accepting detected settings. Required outside a terminal."
+    "Skip all prompts, accepting detected settings (the default without a terminal)"
   ).option("--json", "Output the result as JSON (implies --yes)").option("--base <locale>", "Base locale (default: detected, else en)").option(
     "--targets <locales>",
     "Comma-separated target locales (default: detected)"
@@ -34953,6 +35336,9 @@ function buildProgram() {
   ).option(
     "--project <slug>",
     "Link this project. Default: the project whose directory you are in, else a new project here."
+  ).option(
+    "--agents-file [path]",
+    "Add TolkBot's instructions for coding agents to this file, by default the nearest AGENTS.md or CLAUDE.md. At a terminal init asks; otherwise it writes them only with this option"
   ).action((opts) => runInit(opts));
   program.command("validate").description("Validate translation files and configuration").option("--json", "Output the report as JSON").option(
     "--strict",
@@ -34965,6 +35351,7 @@ function buildProgram() {
   program.addCommand(jobsCommand);
   program.addCommand(languagesCommand);
   program.addCommand(learningsCommand);
+  program.addCommand(setCommand);
   program.addCommand(statusCommand);
   program.addCommand(telemetryCommand);
   program.addCommand(translateCommand2);
@@ -35027,6 +35414,7 @@ Examples:
   $ tolkbot languages add nb
   $ tolkbot translate --all
   $ tolkbot translate --all --dry-run
+  $ tolkbot set common.save --locale nb --value "Lagre"
   $ tolkbot jobs list
   $ tolkbot validate