@ozzylabs/feedradar 0.2.0 → 0.2.2

package/dist/cli/source.js

@@ -5,7 +5,9 @@ import { createProgressReporter } from "../core/progress.js";
 import { listRecipes, loadRecipe, mergeRecipeWithOverrides, } from "../core/recipes.js";
 import { loadSourceState } from "../core/state.js";
 import { watchRun } from "../core/watcher.js";
+import { createTranslator } from "../i18n/index.js";
 import { SourceKindSchema, SourceSchema, SourceSelectorsSchema } from "../schemas/source.js";
+import { LangFlagError, parseLangFlag, resolveWorkspaceLocale } from "./_locale.js";
 async function pathExists(p) {
     try {
         await access(p);
@@ -282,112 +284,23 @@ function parseRemoveArgs(args) {
     }
     return out;
 }
-function printAddHelp(log) {
-    log("Usage: radar source add <id> --kind <kind> --url <url> [options]");
-    log("       radar source add <id> --recipe <name> [overrides]");
-    log("");
-    log("Options:");
-    log("  --kind <kind>            rss | html | html-js | github-releases | npm-registry | json-feed | json-api");
-    log("  --url <url>              fetch target URL");
-    log("  --recipe <name>          apply a bundled recipe (see `radar source recipes`).");
-    log("                           Mutually exclusive with --kind / --url / --selector-* /");
-    log("                           --pagination-*; --name / --tags / --keywords /");
-    log("                           --exclude-keywords still override the recipe defaults.");
-    log("  --name <name>            display name (defaults to <id>)");
-    log("  --tags <a,b>             comma-separated tags");
-    log("  --keywords <a,b>         comma-separated include keywords");
-    log("                           (required for useful output — empty = match nothing)");
-    log("  --exclude-keywords <a,b> comma-separated exclude keywords");
-    log("  --selector-<field> <css> CSS selector for kind=html / html-js (required: item, title, link)");
-    log("                           optional: summary, publishedAt, body, tags");
-    log("                           For kind=html-js, selectors evaluate against the post-JS DOM.");
-    log("                           The `js:` block (waitFor / timeout / userAgent) cannot be set");
-    log("                           via flags; edit sources/<id>.yaml after add. See ADR-0010.");
-    log("");
-    log("  For kind=json-api (ADR-0012 / #174):");
-    log("    --pagination-strategy <s>  page | offset | cursor | link-header | token | none (default: page)");
-    log("    --pagination-param <name>  query param name for the page/offset/cursor value");
-    log("    --pagination-start N       initial page/offset value (default: 0)");
-    log("    --page-size N              items per page");
-    log("    --page-size-param <name>   query param name for the page-size value");
-    log("    --max-pages N              hard cap on pages traversed (default: 20)");
-    log("    --next-cursor-path <jp>    JSONPath-lite to the next-cursor value (cursor/token strategy)");
-    log("    --total-path <jp>          JSONPath-lite to the total-count value (backfill early-stop hint)");
-    log("");
-    log("  Selector fields (`jsonSelectors.*`) for kind=json-api cannot be set via flags;");
-    log("  the schema has a default fallback chain (items / title / link / publishedAt / summary),");
-    log("  so simple APIs work without selectors. Edit sources/<id>.yaml directly when explicit");
-    log("  selectors are needed (nested fields, non-standard envelopes).");
-    log("");
-    log("  Facet sweep (e.g. year-by-year sweep) cannot be configured via flags; see ADR-0017");
-    log("  and bundle the year sweep through `--recipe aws-whats-new`. Recipe-only structural field.");
+function printAddHelp(t, log) {
+    log(t("cli.source.addHelp"));
 }
-function printListHelp(log) {
-    log("Usage: radar source list [--enabled-only] [-v|--verbose]");
-    log("");
-    log("Lists sources/*.yaml in tabular form: id / kind / url / tags.");
-    log("");
-    log("Options:");
-    log("  --enabled-only   Reserved for forward compatibility (currently a no-op).");
-    log("  -v, --verbose    Print a detailed block per source including keywords,");
-    log("                   trustLevel, and lastFetchedAt (from state/<id>.yaml).");
+function printListHelp(t, log) {
+    log(t("cli.source.listHelp"));
 }
-function printRemoveHelp(log) {
-    log("Usage: radar source remove <id>");
-    log("");
-    log("Deletes sources/<id>.yaml. state/<id>.yaml and items/ are preserved.");
+function printRemoveHelp(t, log) {
+    log(t("cli.source.removeHelp"));
 }
-function printTestHelp(log) {
-    log("Usage: radar source test <id> [--limit N] [--show-content]");
-    log("");
-    log("Dry-run a single source: fetch, filter, and print matched items.");
-    log("state/ and items/ are not touched (no persistence). Useful for tuning");
-    log("keywords when adding a new source.");
-    log("");
-    log("For kind=json-api (ADR-0012 / #174), `source test` fetches PAGE 0 ONLY.");
-    log("Pagination is NOT walked even when the recipe declares multiple pages —");
-    log("`--limit N` caps how many matched items are PRINTED, it does not change");
-    log("the page budget. Use `radar watch run --backfill` for full-history ingest.");
-    log("Page 0's `Link` header / `nextCursor` extraction is surfaced via");
-    log("`--show-content` for pagination tuning without state mutation.");
-    log("");
-    log("For facet-sweep recipes (ADR-0017 / #256), `source test` probes a SINGLE");
-    log("facet value: range facets use the upper bound (latest year), enum facets");
-    log("use the first listed value. A warning names which value was tested so");
-    log("keyword tuning is not silently scoped to one slice. Run `radar watch run");
-    log("--backfill` to sweep every facet value.");
-    log("");
-    log("Options:");
-    log("  --limit N        Maximum number of matched items to print (default 10)");
-    log("  --show-content   Also print the first 200 chars of each item's body, plus");
-    log("                   (kind=json-api) the selector adoption table and pagination");
-    log("                   preview (would-be next URL / Link header / nextCursor).");
-    log("  -v, --verbose    Enable progress-reporter raw() pass-through (adapter stdout).");
-    log("                   Most useful with kind=html-js (Playwright phase markers).");
-    log("  -q, --quiet      Suppress the progress reporter entirely. RADAR_NO_PROGRESS=1");
-    log("                   has the same effect.");
+function printTestHelp(t, log) {
+    log(t("cli.source.testHelp"));
 }
-function printRecipesHelp(log) {
-    log("Usage: radar source recipes");
-    log("");
-    log("List bundled recipes (recipes/*.yaml in the radar package — ADR-0012 §D3).");
-    log("Each recipe can be applied via:");
-    log("  radar source add <id> --recipe <name> [--keywords <kw>] [--tags <t>] [--name <display>]");
-    log("");
-    log("Bundled recipes ship with the radar npm package; user-authored recipes are");
-    log("not yet supported. To add a new bundled recipe, contribute a YAML to the");
-    log("radar repo's recipes/ directory.");
+function printRecipesHelp(t, log) {
+    log(t("cli.source.recipesHelp"));
 }
-function printSourceHelp(log) {
-    log("Usage: radar source <add|list|recipes|remove|test> [...]");
-    log("");
-    log("Subcommands:");
-    log("  add <id> --kind <kind> --url <url> [...]");
-    log("  add <id> --recipe <name> [--keywords <kw>] [--tags <t>] [--name <display>]");
-    log("  list [--enabled-only]");
-    log("  recipes");
-    log("  remove <id>");
-    log("  test <id> [--limit N] [--show-content]");
+function printSourceHelp(t, log) {
+    log(t("cli.source.help"));
 }
 /**
  * Implementation of `source add`.
@@ -402,25 +315,38 @@ export async function addSource(args, options = {}) {
     const log = options.io?.log ?? ((m) => console.log(m));
     const warn = options.io?.warn ?? ((m) => console.warn(m));
     const error = options.io?.error ?? ((m) => console.error(m));
+    let langState;
+    try {
+        langState = parseLangFlag(args);
+    }
+    catch (e) {
+        if (e instanceof LangFlagError) {
+            error(`source add: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    const locale = await resolveWorkspaceLocale({ flag: langState.flag, cwd, warn: error });
+    const t = createTranslator(locale);
     let parsed;
     try {
-        parsed = parseAddArgs(args);
+        parsed = parseAddArgs(langState.rest);
     }
     catch (e) {
         error(`source add: ${e instanceof Error ? e.message : String(e)}`);
         return 2;
     }
     if (parsed.help) {
-        printAddHelp(log);
+        printAddHelp(t, log);
         return 0;
     }
     if (!parsed.id) {
-        error("source add: missing <id>");
-        printAddHelp(error);
+        error(t("cli.source.missingId", { sub: "add" }));
+        printAddHelp(t, error);
         return 2;
     }
     if (!isSafeSourceId(parsed.id)) {
-        error(`source add: invalid <id> '${parsed.id}' (must match [A-Za-z0-9][A-Za-z0-9._-]*)`);
+        error(t("cli.source.invalidId", { sub: "add", id: parsed.id }));
         return 2;
     }
     // `--recipe <name>` short-circuits the flag-based composition: the
@@ -431,19 +357,19 @@ export async function addSource(args, options = {}) {
     // `--pagination-*`) is rejected so the user gets an immediate, targeted
     // error instead of silently-ignored flags. ADR-0012 §D3.
     if (parsed.recipe !== undefined) {
-        return addSourceFromRecipe(parsed, cwd, options, log, warn, error);
+        return addSourceFromRecipe(parsed, cwd, options, log, warn, error, t);
     }
     if (!parsed.kind) {
-        error("source add: --kind is required");
+        error(t("cli.source.kindRequired"));
         return 2;
     }
     if (!parsed.url) {
-        error("source add: --url is required");
+        error(t("cli.source.urlRequired"));
         return 2;
     }
     const kindResult = SourceKindSchema.safeParse(parsed.kind);
     if (!kindResult.success) {
-        error(`source add: invalid --kind '${parsed.kind}' (expected: rss | html | html-js | github-releases | npm-registry | json-feed | json-api)`);
+        error(t("cli.source.invalidKind", { kind: parsed.kind }));
         return 2;
     }
     // Compose the object before schema validation so url-format errors et al.
@@ -474,7 +400,7 @@ export async function addSource(args, options = {}) {
         const selectorsResult = SourceSelectorsSchema.safeParse(parsed.selectors);
         if (!selectorsResult.success) {
             const issues = selectorsResult.error.issues.map((i) => `selectors.${i.path.join(".") || "<root>"}: ${i.message}`);
-            error(`source add: validation failed`);
+            error(t("cli.source.validationFailed"));
             for (const issue of issues) {
                 error(`  - ${issue}`);
             }
@@ -525,13 +451,13 @@ export async function addSource(args, options = {}) {
         // Reject pagination flags on non-json-api kinds early so the user sees
         // a targeted hint instead of a deep schema refinement error ("pagination
         // is required when kind is 'json-api'" makes no sense for `kind: rss`).
-        error(`source add: --pagination-* flags are only valid with --kind json-api (got --kind '${kindResult.data}')`);
+        error(t("cli.source.paginationOnlyJsonApi", { kind: kindResult.data }));
         return 2;
     }
     const validated = SourceSchema.safeParse(candidate);
     if (!validated.success) {
         const issues = validated.error.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`);
-        error(`source add: validation failed`);
+        error(t("cli.source.validationFailed"));
         for (const issue of issues) {
             error(`  - ${issue}`);
         }
@@ -539,11 +465,11 @@ export async function addSource(args, options = {}) {
     }
     const file = sourceFile(cwd, validated.data.id);
     if (await pathExists(file)) {
-        error(`source add: '${validated.data.id}' already exists (sources/${validated.data.id}.yaml)`);
+        error(t("cli.source.alreadyExists", { id: validated.data.id }));
         return 1;
     }
     await writeFile(file, stringifyYaml(validated.data), "utf8");
-    log(`source add: created sources/${validated.data.id}.yaml`);
+    log(t("cli.source.created", { id: validated.data.id }));
     // ADR-0006 / src/core/filter.ts treats an empty include-keyword list as
     // "match nothing" (firehose guard). A source with no keywords is therefore
     // valid YAML but inert — `watch run` will fetch it and drop every item
@@ -552,7 +478,7 @@ export async function addSource(args, options = {}) {
     // (stderr) so scripts that parse stdout are unaffected and the exit code
     // stays 0.
     if (validated.data.filters.keywords.length === 0) {
-        warn(`source add: warning — '${validated.data.id}' has no keywords; all fetched items will be filtered out. Edit sources/${validated.data.id}.yaml or re-add with --keywords to start ingesting.`);
+        warn(t("cli.source.noKeywordsWarn", { id: validated.data.id }));
     }
     return 0;
 }
@@ -572,7 +498,7 @@ export async function addSource(args, options = {}) {
  *   structurally edit `sources/<id>.yaml` after generation, same as for
  *   any other source.
  */
-async function addSourceFromRecipe(parsed, cwd, options, log, warn, error) {
+async function addSourceFromRecipe(parsed, cwd, options, log, warn, error, t) {
     const recipeName = parsed.recipe;
     // Defensive — should be guaranteed by the caller, but `parsed.recipe`
     // is typed as `string | undefined` so a quick narrow here keeps the
@@ -602,7 +528,7 @@ async function addSourceFromRecipe(parsed, cwd, options, log, warn, error) {
         forbidden.push("--pagination-*");
     }
     if (forbidden.length > 0) {
-        error(`source add: --recipe '${recipeName}' supplies kind / url / structural fields; the following flags are not allowed with --recipe: ${forbidden.join(", ")}`);
+        error(t("cli.source.recipeForbiddenFlags", { recipe: recipeName, flags: forbidden.join(", ") }));
         return 2;
     }
     let loaded;
@@ -632,7 +558,7 @@ async function addSourceFromRecipe(parsed, cwd, options, log, warn, error) {
         // illegal combination). Surface every issue verbatim so recipe
         // authors and end users can both diagnose.
         const issues = validated.error.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`);
-        error(`source add: recipe '${recipeName}' produced an invalid source`);
+        error(t("cli.source.recipeInvalidSource", { recipe: recipeName }));
         for (const issue of issues) {
             error(`  - ${issue}`);
         }
@@ -640,17 +566,17 @@ async function addSourceFromRecipe(parsed, cwd, options, log, warn, error) {
     }
     const file = sourceFile(cwd, validated.data.id);
     if (await pathExists(file)) {
-        error(`source add: '${validated.data.id}' already exists (sources/${validated.data.id}.yaml)`);
+        error(t("cli.source.alreadyExists", { id: validated.data.id }));
         return 1;
     }
     await writeFile(file, stringifyYaml(validated.data), "utf8");
-    log(`source add: created sources/${validated.data.id}.yaml from recipe '${recipeName}'`);
+    log(t("cli.source.createdFromRecipe", { id: validated.data.id, recipe: recipeName }));
     // Same firehose-guard hint as the flag-based path: an empty
     // include-keyword list silently drops every fetched item, which
     // surprises users when they thought the recipe came with sensible
     // defaults.
     if (validated.data.filters.keywords.length === 0) {
-        warn(`source add: warning — '${validated.data.id}' has no keywords; all fetched items will be filtered out. Re-add with --keywords or edit sources/${validated.data.id}.yaml to start ingesting.`);
+        warn(t("cli.source.noKeywordsWarnRecipe", { id: validated.data.id }));
     }
     return 0;
 }
@@ -701,16 +627,29 @@ export async function listSources(args, options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const log = options.io?.log ?? ((m) => console.log(m));
     const error = options.io?.error ?? ((m) => console.error(m));
+    let langState;
+    try {
+        langState = parseLangFlag(args);
+    }
+    catch (e) {
+        if (e instanceof LangFlagError) {
+            error(`source list: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    const locale = await resolveWorkspaceLocale({ flag: langState.flag, cwd, warn: error });
+    const t = createTranslator(locale);
     let parsed;
     try {
-        parsed = parseListArgs(args);
+        parsed = parseListArgs(langState.rest);
     }
     catch (e) {
         error(`source list: ${e instanceof Error ? e.message : String(e)}`);
         return 2;
     }
     if (parsed.help) {
-        printListHelp(log);
+        printListHelp(t, log);
         return 0;
     }
     // --enabled-only is wired through for forward compatibility; the schema does
@@ -719,7 +658,7 @@ export async function listSources(args, options = {}) {
     // surface stable.
     const dir = sourcesDir(cwd);
     if (!(await pathExists(dir))) {
-        log("source list: no sources directory (run `radar init` first)");
+        log(t("cli.source.listNoDir"));
         return 0;
     }
     let entries;
@@ -732,7 +671,7 @@ export async function listSources(args, options = {}) {
     }
     const yamlFiles = entries.filter((f) => f.endsWith(".yaml")).sort();
     if (yamlFiles.length === 0) {
-        log("source list: no sources defined (use `radar source add ...`)");
+        log(t("cli.source.listNoSources"));
         return 0;
     }
     const sources = [];
@@ -758,22 +697,29 @@ export async function listSources(args, options = {}) {
             if (i > 0)
                 log("");
             const lastFetchedAt = await readLastFetchedAt(cwd, s.id, error);
+            const none = t("cli.source.valueNone");
             log(`${s.id}`);
-            log(`  kind:           ${s.kind}`);
-            log(`  url:            ${s.url}`);
-            log(`  name:           ${s.name ?? "-"}`);
-            log(`  tags:           ${s.tags.length > 0 ? s.tags.join(",") : "-"}`);
-            log(`  keywords:       ${s.filters.keywords.length > 0 ? s.filters.keywords.join(",") : "(none — items will be filtered out)"}`);
-            log(`  excludeKeywords: ${s.filters.excludeKeywords.length > 0 ? s.filters.excludeKeywords.join(",") : "-"}`);
-            log(`  trustLevel:     ${s.trustLevel}`);
-            log(`  lastFetchedAt:  ${lastFetchedAt}`);
+            log(t("cli.source.fieldKind", { value: s.kind }));
+            log(t("cli.source.fieldUrl", { value: s.url }));
+            log(t("cli.source.fieldName", { value: s.name ?? none }));
+            log(t("cli.source.fieldTags", { value: s.tags.length > 0 ? s.tags.join(",") : none }));
+            log(t("cli.source.fieldKeywords", {
+                value: s.filters.keywords.length > 0
+                    ? s.filters.keywords.join(",")
+                    : t("cli.source.keywordsEmpty"),
+            }));
+            log(t("cli.source.fieldExcludeKeywords", {
+                value: s.filters.excludeKeywords.length > 0 ? s.filters.excludeKeywords.join(",") : none,
+            }));
+            log(t("cli.source.fieldTrustLevel", { value: s.trustLevel }));
+            log(t("cli.source.fieldLastFetchedAt", { value: lastFetchedAt }));
         }
         return 0;
     }
     const idWidth = Math.max(2, ...sources.map((s) => s.id.length));
     const kindWidth = Math.max(4, ...sources.map((s) => s.kind.length));
     const urlWidth = Math.max(3, ...sources.map((s) => s.url.length));
-    log(`${pad("ID", idWidth)}  ${pad("KIND", kindWidth)}  ${pad("URL", urlWidth)}  TAGS`);
+    log(`${pad(t("cli.source.listHeaderId"), idWidth)}  ${pad(t("cli.source.listHeaderKind"), kindWidth)}  ${pad(t("cli.source.listHeaderUrl"), urlWidth)}  ${t("cli.source.listHeaderTags")}`);
     for (const s of sources) {
         log(`${pad(s.id, idWidth)}  ${pad(s.kind, kindWidth)}  ${pad(s.url, urlWidth)}  ${s.tags.join(",")}`);
     }
@@ -810,34 +756,47 @@ export async function removeSource(args, options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const log = options.io?.log ?? ((m) => console.log(m));
     const error = options.io?.error ?? ((m) => console.error(m));
+    let langState;
+    try {
+        langState = parseLangFlag(args);
+    }
+    catch (e) {
+        if (e instanceof LangFlagError) {
+            error(`source remove: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    const locale = await resolveWorkspaceLocale({ flag: langState.flag, cwd, warn: error });
+    const t = createTranslator(locale);
     let parsed;
     try {
-        parsed = parseRemoveArgs(args);
+        parsed = parseRemoveArgs(langState.rest);
     }
     catch (e) {
         error(`source remove: ${e instanceof Error ? e.message : String(e)}`);
         return 2;
     }
     if (parsed.help) {
-        printRemoveHelp(log);
+        printRemoveHelp(t, log);
         return 0;
     }
     if (!parsed.id) {
-        error("source remove: missing <id>");
-        printRemoveHelp(error);
+        error(t("cli.source.missingId", { sub: "remove" }));
+        printRemoveHelp(t, error);
         return 2;
     }
     if (!isSafeSourceId(parsed.id)) {
-        error(`source remove: invalid <id> '${parsed.id}' (must match [A-Za-z0-9][A-Za-z0-9._-]*)`);
+        error(t("cli.source.invalidId", { sub: "remove", id: parsed.id }));
         return 2;
     }
     const file = sourceFile(cwd, parsed.id);
     if (!(await pathExists(file))) {
-        error(`source remove: '${parsed.id}' not found (sources/${parsed.id}.yaml)`);
+        error(t("cli.source.removeNotFound", { id: parsed.id }));
         return 1;
     }
     await unlink(file);
-    log(`source remove: deleted sources/${parsed.id}.yaml`);
+    log(t("cli.source.deleted", { id: parsed.id }));
     return 0;
 }
 /**
@@ -869,25 +828,38 @@ export async function testSource(args, options = {}) {
     const log = options.io?.log ?? ((m) => console.log(m));
     const warn = options.io?.warn ?? ((m) => console.warn(m));
     const error = options.io?.error ?? ((m) => console.error(m));
+    let langState;
+    try {
+        langState = parseLangFlag(args);
+    }
+    catch (e) {
+        if (e instanceof LangFlagError) {
+            error(`source test: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    const locale = await resolveWorkspaceLocale({ flag: langState.flag, cwd, warn: error });
+    const t = createTranslator(locale);
     let parsed;
     try {
-        parsed = parseTestArgs(args);
+        parsed = parseTestArgs(langState.rest);
     }
     catch (e) {
         error(`source test: ${e instanceof Error ? e.message : String(e)}`);
         return 2;
     }
     if (parsed.help) {
-        printTestHelp(log);
+        printTestHelp(t, log);
         return 0;
     }
     if (!parsed.id) {
-        error("source test: missing <id>");
-        printTestHelp(error);
+        error(t("cli.source.missingId", { sub: "test" }));
+        printTestHelp(t, error);
         return 2;
     }
     if (!isSafeSourceId(parsed.id)) {
-        error(`source test: invalid <id> '${parsed.id}' (must match [A-Za-z0-9][A-Za-z0-9._-]*)`);
+        error(t("cli.source.invalidId", { sub: "test", id: parsed.id }));
         return 2;
     }
     // Check the YAML exists *before* delegating to watchRun. `watchRun` would
@@ -896,7 +868,7 @@ export async function testSource(args, options = {}) {
     // the user typed the id explicitly.
     const file = sourceFile(cwd, parsed.id);
     if (!(await pathExists(file))) {
-        error(`source test: '${parsed.id}' not found (sources/${parsed.id}.yaml)`);
+        error(t("cli.source.testNotFound", { id: parsed.id }));
         return 1;
     }
     const limit = parsed.limit ?? 10;
@@ -918,6 +890,9 @@ export async function testSource(args, options = {}) {
             warn,
             error,
             progress,
+            // Localize the watch-flow progress markers on the same path as the
+            // reporter (#337).
+            translate: t,
         });
     }
     catch (e) {
@@ -934,8 +909,8 @@ export async function testSource(args, options = {}) {
     const fetched = stats?.fetched ?? 0;
     const filtered = stats?.filtered ?? matched.length;
     log("");
-    log(`source test: ${parsed.id}`);
-    log(`  fetched: ${fetched} / filtered: ${filtered} / matched: ${matched.length}`);
+    log(t("cli.source.testHeading", { id: parsed.id }));
+    log(t("cli.source.testCounts", { fetched, filtered, matched: matched.length }));
     // Facet sweep notice (#256). A dry-run `source test` probes exactly ONE
     // facet value, so keyword verification only reflects that single slice. We
     // surface this as a non-fatal warning regardless of --show-content because
@@ -945,8 +920,11 @@ export async function testSource(args, options = {}) {
     // facet values were not walked.
     const facetSweep = result.diag[parsed.id]?.facetSweep;
     if (facetSweep) {
-        warn(`source test: facet sweep 有効: ${facetSweep.facet}=${facetSweep.testedValue} のみ test 中（全 ${facetSweep.totalValues} 件の facet 値は walk しない）。` +
-            `range facet は上端（最新値）を test します。全 facet 値を確認するには \`radar watch run --backfill\` を使用してください。`);
+        warn(t("cli.source.facetSweepNotice", {
+            facet: facetSweep.facet,
+            testedValue: facetSweep.testedValue,
+            totalValues: facetSweep.totalValues,
+        }));
     }
     // Render the adapter diag for `kind: json-api` when --show-content is on.
     // The diag block is intentionally gated behind --show-content so the
@@ -958,58 +936,69 @@ export async function testSource(args, options = {}) {
         if (diag) {
             if (diag.selectorAdoption) {
                 log("");
-                log("  selector adoption:");
+                log(t("cli.source.selectorAdoptionHeading"));
                 for (const [field, path] of Object.entries(diag.selectorAdoption)) {
                     if (path === null) {
-                        log(`    ${field}: (no candidate matched)`);
+                        log(t("cli.source.selectorNoCandidate", { field }));
                     }
                     else {
-                        log(`    ${field} ← ${path} を採用`);
+                        log(t("cli.source.selectorAdopted", { field, path }));
                     }
                 }
             }
             if (diag.paginationPreview) {
                 const p = diag.paginationPreview;
                 log("");
-                log("  pagination preview (page 0 only — state not mutated):");
-                log(`    strategy:  ${p.strategy}`);
-                log(`    nextUrl:   ${p.nextUrl ?? "(end of pagination)"}`);
+                log(t("cli.source.paginationPreviewHeading"));
+                log(t("cli.source.paginationStrategy", { strategy: p.strategy }));
+                log(t("cli.source.paginationNextUrl", {
+                    nextUrl: p.nextUrl ?? t("cli.source.paginationEndOfPagination"),
+                }));
                 if (p.linkHeaderNext !== undefined) {
-                    log(`    Link rel=next: ${p.linkHeaderNext ?? "(absent)"}`);
+                    log(t("cli.source.paginationLinkNext", {
+                        value: p.linkHeaderNext ?? t("cli.source.paginationAbsent"),
+                    }));
                 }
                 if (p.nextCursor !== undefined) {
-                    log(`    nextCursor: ${p.nextCursor ?? "(absent)"}`);
+                    log(t("cli.source.paginationNextCursor", {
+                        value: p.nextCursor ?? t("cli.source.paginationAbsent"),
+                    }));
                 }
             }
         }
     }
     if (matched.length === 0) {
-        log("  (no matched items)");
+        log(t("cli.source.testNoMatched"));
         return 0;
     }
     const shown = matched.slice(0, limit);
+    const none = t("cli.source.valueNone");
     log("");
-    log(`Showing ${shown.length} of ${matched.length} matched item(s):`);
+    log(t("cli.source.testShowing", { shown: shown.length, total: matched.length }));
     for (let i = 0; i < shown.length; i++) {
         const item = shown[i];
         if (!item)
             continue;
         log("");
-        log(`  ${i + 1}. ${item.title}`);
-        log(`     url:             ${item.url}`);
-        log(`     matchedKeywords: ${item.matchedKeywords.length > 0 ? item.matchedKeywords.join(",") : "-"}`);
+        log(t("cli.source.testItemTitle", { index: i + 1, title: item.title }));
+        log(t("cli.source.testItemUrl", { url: item.url }));
+        log(t("cli.source.testItemMatchedKeywords", {
+            value: item.matchedKeywords.length > 0 ? item.matchedKeywords.join(",") : none,
+        }));
         if (parsed.showContent) {
             const body = item.summary && item.summary.length > 0
                 ? item.summary
                 : typeof item.raw === "string"
                     ? item.raw
                     : "";
-            log(`     content:         ${body.length > 0 ? truncatePreview(body, 200) : "-"}`);
+            log(t("cli.source.testItemContent", {
+                value: body.length > 0 ? truncatePreview(body, 200) : none,
+            }));
         }
     }
     if (matched.length > shown.length) {
         log("");
-        log(`  … ${matched.length - shown.length} more (raise --limit to see them)`);
+        log(t("cli.source.testMoreItems", { count: matched.length - shown.length }));
     }
     return 0;
 }
@@ -1027,14 +1016,28 @@ export async function testSource(args, options = {}) {
  * the recipe library is empty.
  */
 export async function recipesSubcommand(args, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
     const log = options.io?.log ?? ((m) => console.log(m));
     const error = options.io?.error ?? ((m) => console.error(m));
-    // The only flag accepted today is `-h` / `--help`. Keep the parser
-    // tiny rather than introducing a typed args struct for a single
-    // option — easier to extend if/when filters land.
-    for (const a of args) {
+    let langState;
+    try {
+        langState = parseLangFlag(args);
+    }
+    catch (e) {
+        if (e instanceof LangFlagError) {
+            error(`source recipes: ${e.message}`);
+            return 2;
+        }
+        throw e;
+    }
+    const locale = await resolveWorkspaceLocale({ flag: langState.flag, cwd, warn: error });
+    const t = createTranslator(locale);
+    // The only flag accepted today is `-h` / `--help` (plus the already-stripped
+    // `--lang`). Keep the parser tiny rather than introducing a typed args struct
+    // for a single option — easier to extend if/when filters land.
+    for (const a of langState.rest) {
         if (a === "-h" || a === "--help") {
-            printRecipesHelp(log);
+            printRecipesHelp(t, log);
             return 0;
         }
         if (a.startsWith("--")) {
@@ -1053,7 +1056,7 @@ export async function recipesSubcommand(args, options = {}) {
         return 1;
     }
     if (entries.length === 0) {
-        log("source recipes: no recipes bundled (recipes/ is empty or absent)");
+        log(t("cli.source.recipesNone"));
         return 0;
     }
     const valid = entries.filter((e) => e.recipe !== null);
@@ -1061,7 +1064,7 @@ export async function recipesSubcommand(args, options = {}) {
     if (valid.length > 0) {
         const nameWidth = Math.max(4, ...valid.map((e) => e.name.length));
         const kindWidth = Math.max(4, ...valid.map((e) => (e.recipe ? e.recipe.kind.length : 0)));
-        log(`${pad("NAME", nameWidth)}  ${pad("KIND", kindWidth)}  DESCRIPTION`);
+        log(`${pad(t("cli.source.recipesHeaderName"), nameWidth)}  ${pad(t("cli.source.recipesHeaderKind"), kindWidth)}  ${t("cli.source.recipesHeaderDescription")}`);
         for (const e of valid) {
             if (!e.recipe)
                 continue;
@@ -1070,18 +1073,21 @@ export async function recipesSubcommand(args, options = {}) {
         }
     }
     else {
-        log("source recipes: no valid recipes found (all bundled entries failed to load)");
+        log(t("cli.source.recipesNoValid"));
     }
     if (invalid.length > 0) {
         log("");
-        log("Recipes with errors:");
+        log(t("cli.source.recipesErrorsHeading"));
         for (const e of invalid) {
-            log(`  ${e.name}: ${e.error ?? "(unknown error)"}`);
+            log(t("cli.source.recipesErrorRow", {
+                name: e.name,
+                error: e.error ?? t("cli.source.recipesErrorUnknown"),
+            }));
         }
     }
     log("");
-    log("Apply a recipe with:");
-    log("  radar source add <id> --recipe <name> [--keywords <kw>] [--tags <t>] [--name <display>]");
+    log(t("cli.source.recipesApplyHeading"));
+    log(t("cli.source.recipesApplyExample"));
     // Returning 0 even when individual recipes have errors keeps the
     // listing useful in CI: a single malformed recipe should not break
     // the discovery command for the rest of the bundle.
@@ -1095,11 +1101,28 @@ export async function recipesSubcommand(args, options = {}) {
  * IO sinks without spawning the full CLI.
  */
 export async function runSource(args, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
     const log = options.io?.log ?? ((m) => console.log(m));
     const error = options.io?.error ?? ((m) => console.error(m));
+    // Resolve the dispatcher help locale from any leading `--lang` (read-only;
+    // each subcommand strips and resolves its own from `rest`).
+    const dispatcherLangFlag = (() => {
+        try {
+            return parseLangFlag(args).flag;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    const dispatcherLocale = await resolveWorkspaceLocale({
+        flag: dispatcherLangFlag,
+        cwd,
+        warn: error,
+    });
+    const t = createTranslator(dispatcherLocale);
     const [sub, ...rest] = args;
     if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
-        printSourceHelp(log);
+        printSourceHelp(t, log);
         return sub ? 0 : 2;
     }
     switch (sub) {
@@ -1114,14 +1137,15 @@ export async function runSource(args, options = {}) {
         case "test":
             return testSource(rest, options);
         default:
-            error(`source: unknown subcommand '${sub}'`);
-            printSourceHelp(error);
+            error(t("cli.source.unknownSubcommand", { sub }));
+            printSourceHelp(t, error);
             return 2;
     }
 }
 export const sourceCommand = {
     name: "source",
     summary: "Manage feed sources (add | list | recipes | remove | test)",
+    summaryKey: "cli.summary.source",
     run: (args) => runSource(args),
 };
 //# sourceMappingURL=source.js.map