create-quiver 0.15.2 → 0.15.4

package/src/create-quiver/commands/ai.js

@@ -15,6 +15,7 @@ const { parseContextProposalOutput } = require('../lib/ai/context-proposal');
 const { openEditor } = require('../lib/cli/editor');
 const { selectOption, promptText } = require('../lib/cli/selectors');
 const { createUx } = require('../lib/cli/ux');
+const { createTranslator } = require('../lib/i18n/catalog');
 const { runExecuteSlice, runPromptSlice } = require('../lib/ai/executor');
 const { runExecutePlan } = require('../lib/ai/execution-plan');
 const { buildPrCreatePlan, formatPreflightReport, formatPrCreateReport, preflightGitHubPr, runGhPrCreate } = require('../lib/ai/github');
@@ -90,6 +91,7 @@ const {
   formatApprovalDecisionLines,
 } = require('../lib/ai/approval-candidates');
 const { assertPlannerPhaseReady, getPlannerPhaseDetails, normalizePlannerPhase, PlannerPhaseError } = require('../lib/ai/phase-gates');
+const { formatStatus, translatorForHuman } = require('../lib/i18n/read-only-format');
 const { collectActiveSliceState, resolveProjectState } = require('../lib/project-state-resolver');
 
 const DEFAULT_ONBOARD_PROVIDER = 'codex';
@@ -106,6 +108,23 @@ function formatError(message) {
   return `create-quiver: ${message}`;
 }
 
+function formatLocalizedActionableError({ failure, impact, fix, nextCommand } = {}, options = {}) {
+  const translator = createTranslator(options.language);
+  const lines = [`create-quiver: ${String(failure || 'operation failed').trim()}`];
+
+  if (impact) {
+    lines.push(`${translator.t('ai.actionable.impact')}: ${String(impact).trim()}`);
+  }
+  if (fix) {
+    lines.push(`${translator.t('ai.actionable.fix')}: ${String(fix).trim()}`);
+  }
+  if (nextCommand) {
+    lines.push(`${translator.t('ai.actionable.next_command')}: ${String(nextCommand).trim()}`);
+  }
+
+  return lines.join('\n');
+}
+
 function readTextFile(filePath, repoRoot) {
   if (!filePath) {
     return '';
@@ -226,8 +245,12 @@ function shouldShowHumanProgress(ux, options = {}) {
     && ux?.mode?.decoration === true;
 }
 
-function plannerProgressTitle(action, runtimeProfile) {
-  return `${action} con ${runtimeProfile.displayName || runtimeProfile.model || runtimeProfile.provider}`;
+function plannerProgressTitle(action, runtimeProfile, options = {}) {
+  const translator = createTranslator(options.language);
+  return translator.t('ai.planner.progress.title', {
+    action,
+    profile: runtimeProfile.displayName || runtimeProfile.model || runtimeProfile.provider,
+  });
 }
 
 function writeProgressChecks(ux, enabled, title, checks = []) {
@@ -240,7 +263,7 @@ function writeProgressChecks(ux, enabled, title, checks = []) {
   }
 }
 
-async function runProviderWithProgress({ ux, enabled, message = 'Ejecutando agente...', successMessage = 'Agente finalizado', failureMessage = 'Fallo ejecutando agente', run }) {
+async function runProviderWithProgress({ ux, enabled, message = 'Running agent...', successMessage = 'Agent finished', failureMessage = 'Agent failed', run }) {
   async function runAndFailOnProviderResult() {
     const result = await run();
     if (result && result.ok === false) {
@@ -327,77 +350,85 @@ function buildOnboardContext({ role, context, inputText, inputPath, repoRoot })
   };
 }
 
-function formatDryRunReport({ task, provider, role, contextPack, phase, invocation, onboardingPlan }) {
+function formatDryRunReport({ task, provider, role, contextPack, phase, invocation, onboardingPlan, language = 'en' }) {
+  const translator = createTranslator(language);
+  const modelStatus = invocation.modelSelection?.supported
+    ? translator.t('ai_task.model_supported')
+    : translator.t('ai_task.model_unsupported');
   const lines = [
-    `AI ${task} dry-run`,
-    `Provider: ${provider}`,
-    `Role: ${role}`,
-    `Context pack: ${contextPack}`,
+    translator.t('ai_task.title.dry_run', { task }),
+    translator.t('ai_task.provider', { provider }),
+    translator.t('ai_task.role', { role }),
+    translator.t('ai_task.context_pack', { context: contextPack }),
   ];
 
   if (phase) {
-    lines.push(`Phase: ${phase}`);
+    lines.push(translator.t('ai_task.phase', { phase }));
   }
 
-  lines.push(`Command: ${invocation.command} ${invocation.args.join(' ')}`);
-  lines.push(`Timeout: ${invocation.timeoutMs}ms`);
-  lines.push(`Prompt transport: ${invocation.promptTransport.mode}`);
-  lines.push(`Prompt length: ${invocation.promptLength} bytes`);
+  lines.push(translator.t('ai_task.command', { command: `${invocation.command} ${invocation.args.join(' ')}`.trim() }));
+  lines.push(translator.t('ai_task.timeout', { timeout: invocation.timeoutMs }));
+  lines.push(translator.t('ai_task.prompt_transport', { mode: invocation.promptTransport.mode }));
+  lines.push(translator.t('ai_task.prompt_length', { bytes: invocation.promptLength }));
   if (invocation.modelSelection && invocation.modelSelection.model) {
-    lines.push(`Model: ${invocation.modelSelection.model}`);
-    lines.push(`Model support: ${invocation.modelSelection.supported ? 'supported' : 'unsupported'} (${invocation.modelSelection.reason})`);
+    lines.push(translator.t('ai_task.model', { model: invocation.modelSelection.model }));
+    lines.push(translator.t('ai_task.model_support', { status: modelStatus, reason: invocation.modelSelection.reason }));
   }
 
   if (onboardingPlan) {
-    lines.push(`Prompt source: ${onboardingPlan.promptSource}`);
-    lines.push(`Selected docs: ${onboardingPlan.selectedDocs.length}`);
-    lines.push(`Documentation debt: ${onboardingPlan.missingDocs.length}`);
+    lines.push(translator.t('ai_task.prompt_source', { source: onboardingPlan.promptSource }));
+    lines.push(translator.t('ai_task.selected_docs', { count: onboardingPlan.selectedDocs.length }));
+    lines.push(translator.t('ai_task.documentation_debt', { count: onboardingPlan.missingDocs.length }));
   }
 
   return `${lines.join('\n')}\n`;
 }
 
-function formatPromptOnlyReport({ task, provider, role, contextPack, phase, invocation, prompt, onboardingPlan, promptSource, inputPath, inputKind, inputVersion }) {
+function formatPromptOnlyReport({ task, provider, role, contextPack, phase, invocation, prompt, onboardingPlan, promptSource, inputPath, inputKind, inputVersion, language = 'en' }) {
+  const translator = createTranslator(language);
+  const modelStatus = invocation.modelSelection?.supported
+    ? translator.t('ai_task.model_supported')
+    : translator.t('ai_task.model_unsupported');
   const lines = [
-    `AI ${task} prompt-only`,
-    `Provider: ${provider}`,
-    `Role: ${role}`,
-    `Context pack: ${contextPack}`,
+    translator.t('ai_task.title.prompt_only', { task }),
+    translator.t('ai_task.provider', { provider }),
+    translator.t('ai_task.role', { role }),
+    translator.t('ai_task.context_pack', { context: contextPack }),
   ];
 
   if (phase) {
-    lines.push(`Phase: ${phase}`);
+    lines.push(translator.t('ai_task.phase', { phase }));
   }
 
-  lines.push(`Command: ${invocation.command} ${invocation.args.join(' ')}`);
-  lines.push(`Timeout: ${invocation.timeoutMs}ms`);
-  lines.push(`Prompt transport: ${invocation.promptTransport.mode}`);
-  lines.push(`Prompt length: ${invocation.promptLength} bytes`);
+  lines.push(translator.t('ai_task.command', { command: `${invocation.command} ${invocation.args.join(' ')}`.trim() }));
+  lines.push(translator.t('ai_task.timeout', { timeout: invocation.timeoutMs }));
+  lines.push(translator.t('ai_task.prompt_transport', { mode: invocation.promptTransport.mode }));
+  lines.push(translator.t('ai_task.prompt_length', { bytes: invocation.promptLength }));
   if (invocation.modelSelection && invocation.modelSelection.model) {
-    lines.push(`Model: ${invocation.modelSelection.model}`);
-    lines.push(`Model support: ${invocation.modelSelection.supported ? 'supported' : 'unsupported'} (${invocation.modelSelection.reason})`);
+    lines.push(translator.t('ai_task.model', { model: invocation.modelSelection.model }));
+    lines.push(translator.t('ai_task.model_support', { status: modelStatus, reason: invocation.modelSelection.reason }));
   }
 
   if (onboardingPlan) {
-    lines.push(`Prompt source: ${onboardingPlan.promptSource}`);
-    lines.push(`Selected docs: ${onboardingPlan.selectedDocs.length}`);
-    lines.push(`Documentation debt: ${onboardingPlan.missingDocs.length}`);
+    lines.push(translator.t('ai_task.prompt_source', { source: onboardingPlan.promptSource }));
+    lines.push(translator.t('ai_task.selected_docs', { count: onboardingPlan.selectedDocs.length }));
+    lines.push(translator.t('ai_task.documentation_debt', { count: onboardingPlan.missingDocs.length }));
   }
 
   if (promptSource) {
-    lines.push(`Prompt source: ${promptSource}`);
+    lines.push(translator.t('ai_task.prompt_source', { source: promptSource }));
   }
 
   if (inputPath) {
-    lines.push(`Input file: ${inputPath}`);
+    lines.push(translator.t('ai_task.input_file', { path: inputPath }));
   }
 
   if (inputKind) {
-    lines.push(`Input kind: ${inputKind}`);
+    lines.push(translator.t('ai_task.input_kind', { kind: inputKind }));
   }
 
   if (inputVersion) {
-    lines.push(`Input version: v${inputVersion}`);
+    lines.push(translator.t('ai_task.input_version', { version: inputVersion }));
   }
 
   lines.push('--- PROMPT START ---');
@@ -415,21 +446,22 @@ function formatPathList(items, emptyLabel = 'none') {
   return items.map((item) => `- ${item}`);
 }
 
-function formatContextPreparationReport({ dryRun, plan, writePlan, writtenDocs, snapshot, completed = false }) {
+function formatContextPreparationReport({ dryRun, plan, writePlan, writtenDocs, snapshot, completed = false, language = 'en' }) {
+  const translator = createTranslator(language);
   const lines = [
-    dryRun ? 'AI prepare-context dry-run' : completed ? 'AI prepare-context completed' : 'AI prepare-context write plan',
-    `Mode: ${dryRun ? 'dry-run' : 'live'}`,
-    `Project: ${plan.projectName}`,
-    `Project slug: ${plan.projectSlug}`,
-    'Writes: docs-only',
-    'Product code: untouched',
-    `Proposed docs: ${writePlan.length > 0 ? writePlan.map((item) => item.path).join(', ') : 'none'}`,
+    dryRun ? translator.t('prepare_context.title.dry_run') : completed ? translator.t('prepare_context.title.completed') : translator.t('prepare_context.title.write_plan'),
+    translator.t('prepare_context.mode', { mode: dryRun ? 'dry-run' : 'live' }),
+    translator.t('prepare_context.project', { project: plan.projectName }),
+    translator.t('prepare_context.project_slug', { slug: plan.projectSlug }),
+    translator.t('prepare_context.writes_docs_only'),
+    translator.t('prepare_context.product_code_untouched'),
+    translator.t('prepare_context.proposed_docs', { docs: writePlan.length > 0 ? writePlan.map((item) => item.path).join(', ') : translator.t('common.none') }),
   ];
 
   if (!dryRun) {
-    lines.push(`${completed ? 'Written docs' : 'Planned writes'}: ${writtenDocs.length > 0 ? writtenDocs.join(', ') : 'none'}`);
+    lines.push(translator.t(completed ? 'prepare_context.written_docs' : 'prepare_context.planned_writes', { docs: writtenDocs.length > 0 ? writtenDocs.join(', ') : translator.t('common.none') }));
     if (snapshot) {
-      lines.push(`Snapshot: ${snapshot.root}`);
+      lines.push(translator.t('prepare_context.snapshot', { path: snapshot.root }));
     }
   }
 
@@ -438,21 +470,21 @@ function formatContextPreparationReport({ dryRun, plan, writePlan, writtenDocs,
   }
 
   lines.push(
-    'Proposed changes:',
+    translator.t('prepare_context.proposed_changes'),
     ...writePlan.map((item) => `- ${item.path}: ${item.action}${item.reason ? ` (${item.reason})` : ''}`),
-    'Diff preview:',
+    translator.t('prepare_context.diff_preview'),
     ...formatDiffPreview(writePlan),
-    'Files considered:',
-    ...plan.filesConsidered.map((item) => `- ${item.path}: ${item.present ? 'present' : 'absent'}${item.reason ? ` (${item.reason})` : ''}`),
-    'Assumptions:',
-    ...formatPathList(plan.assumptions),
-    'Risks:',
-    ...formatPathList(plan.risks),
-    'Contradictions:',
-    ...formatPathList(plan.contradictions),
-    'Omitted paths:',
-    ...formatPathList(plan.omittedPaths),
-    'Uncertainty markers: TODO | Assumption | Pending confirmation',
+    translator.t('prepare_context.files_considered'),
+    ...plan.filesConsidered.map((item) => `- ${item.path}: ${item.present ? translator.t('prepare_context.present') : translator.t('prepare_context.absent')}${item.reason ? ` (${item.reason})` : ''}`),
+    translator.t('prepare_context.assumptions'),
+    ...formatPathList(plan.assumptions, translator.t('common.none')),
+    translator.t('prepare_context.risks'),
+    ...formatPathList(plan.risks, translator.t('common.none')),
+    translator.t('prepare_context.contradictions'),
+    ...formatPathList(plan.contradictions, translator.t('common.none')),
+    translator.t('prepare_context.omitted_paths'),
+    ...formatPathList(plan.omittedPaths, translator.t('common.none')),
+    translator.t('prepare_context.uncertainty_markers'),
   );
 
   return `${lines.join('\n')}\n`;
@@ -537,12 +569,13 @@ function buildPrepareContextPlannerPrompt({ pack, draftPack }) {
   };
 }
 
-function formatPrepareContextPlannerDryRunReport({ provider, role, context, invocation, promptInfo, review, interactive }) {
+function formatPrepareContextPlannerDryRunReport({ provider, role, context, invocation, promptInfo, review, interactive, language = 'en' }) {
+  const translator = createTranslator(language);
   const plan = promptInfo.plan;
   const lines = [
-    'AI prepare-context planner dry-run',
-    'Mode: dry-run',
-    'Planner: enabled',
+    translator.t('prepare_context_planner.title.dry_run'),
+    translator.t('prepare_context.mode', { mode: 'dry-run' }),
+    translator.t('prepare_context_planner.enabled'),
     `Provider: ${provider}`,
     `Role: ${role}`,
     `Context pack: ${context}`,
@@ -554,18 +587,18 @@ function formatPrepareContextPlannerDryRunReport({ provider, role, context, invo
     invocation.modelSelection && invocation.modelSelection.model
       ? `Model support: ${invocation.modelSelection.supported ? 'supported' : 'unsupported'} (${invocation.modelSelection.reason})`
       : '',
-    `Prompt source: ${promptInfo.promptSource}`,
-    `Review requested: ${review ? 'yes' : 'no'}`,
-    `Interactive requested: ${interactive ? 'yes' : 'no'}`,
-    'Provider execution: skipped',
-    'Writes: none',
-    'Product code: untouched',
-    `Candidate docs: ${promptInfo.allowedPaths.join(', ')}`,
-    'Files considered:',
-    ...plan.filesConsidered.map((item) => `- ${item.path}: ${item.present ? 'present' : 'absent'}`),
-    'Allowed docs-only paths:',
+    translator.t('prepare_context.prompt_source', { source: promptInfo.promptSource }),
+    translator.t('prepare_context_planner.review_requested', { value: review ? translator.t('common.yes') : translator.t('common.no') }),
+    translator.t('prepare_context_planner.interactive_requested', { value: interactive ? translator.t('common.yes') : translator.t('common.no') }),
+    translator.t('prepare_context_planner.provider_execution_skipped'),
+    translator.t('prepare_context.writes_none'),
+    translator.t('prepare_context.product_code_untouched'),
+    translator.t('prepare_context_planner.candidate_docs', { docs: promptInfo.allowedPaths.join(', ') }),
+    translator.t('prepare_context.files_considered'),
+    ...plan.filesConsidered.map((item) => `- ${item.path}: ${item.present ? translator.t('prepare_context.present') : translator.t('prepare_context.absent')}`),
+    translator.t('prepare_context_planner.allowed_docs_only_paths'),
     ...promptInfo.allowedPaths.map((item) => `- ${item}`),
-    'Next safe commands:',
+    translator.t('prepare_context_planner.next_safe_commands'),
     '- npx create-quiver ai prepare-context --with-planner --print-prompt',
     '- npx create-quiver ai prepare-context --with-planner --dry-run --review',
     '- npx create-quiver ai prepare-context --with-planner',
@@ -909,17 +942,18 @@ function writeDraftDocs(writePlan) {
   return writtenDocs;
 }
 
-function formatSpecDryRunReport({ manifest, repoRoot }) {
+function formatSpecDryRunReport({ manifest, repoRoot, language }) {
+  const translator = createTranslator(language);
   const preview = describeSpecGeneration(manifest, repoRoot);
   const relativeSpecDir = path.relative(repoRoot, preview.specDir).split(path.sep).join('/');
   const lines = [
-    'AI plan dry-run',
-    'Phase: spec',
-    `Spec slug: ${manifest.slug}`,
-    `Title: ${manifest.title}`,
-    `Input file: ${manifest.sourcePath}`,
-    `Target: ${relativeSpecDir}`,
-    `Planned files: ${preview.files.length}`,
+    translator.t('ai.plan.spec.dry_run.title'),
+    translator.t('ai_task.phase', { phase: 'spec' }),
+    translator.t('ai.plan.spec.slug', { slug: manifest.slug }),
+    translator.t('ai.plan.spec.title', { title: manifest.title }),
+    translator.t('ai_task.input_file', { path: manifest.sourcePath }),
+    translator.t('ai.plan.spec.target', { target: relativeSpecDir }),
+    translator.t('ai.plan.spec.planned_files', { count: preview.files.length }),
   ];
 
   for (const file of preview.files) {
@@ -929,13 +963,14 @@ function formatSpecDryRunReport({ manifest, repoRoot }) {
   return `${lines.join('\n')}\n`;
 }
 
-function formatSpecGenerationResult(result, repoRoot) {
+function formatSpecGenerationResult(result, repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const relativeSpecDir = path.relative(repoRoot, result.specDir).split(path.sep).join('/');
   const lines = [
-    'AI plan spec generation completed',
-    `Spec slug: ${result.manifest.slug}`,
-    `Target: ${relativeSpecDir}`,
-    `Files written: ${result.files.length}`,
+    translator.t('ai.plan.spec.completed'),
+    translator.t('ai.plan.spec.slug', { slug: result.manifest.slug }),
+    translator.t('ai.plan.spec.target', { target: relativeSpecDir }),
+    translator.t('ai.plan.spec.files_written', { count: result.files.length }),
   ];
 
   for (const filePath of result.files) {
@@ -945,30 +980,32 @@ function formatSpecGenerationResult(result, repoRoot) {
   return `${lines.join('\n')}\n`;
 }
 
-function formatApprovalResult(result, repoRoot) {
+function formatApprovalResult(result, repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const relativePath = path.relative(repoRoot, result.filePath).split(path.sep).join('/');
   const lines = [
-    'AI approval saved',
-    `Phase: ${result.phase}`,
-    `Status: approved`,
-    `Artifact: ${relativePath}`,
-    `Source file: ${result.sourceFile}`,
-    `Timestamp: ${result.createdAt}`,
+    translator.t('ai.approve.saved'),
+    translator.t('ai_task.phase', { phase: result.phase }),
+    `${translator.t('ai.table.status')}: ${translator.t('ai.approve.status.approved')}`,
+    `${translator.t('ai.approve.artifact')}: ${relativePath}`,
+    `${translator.t('ai.approvals.source_file')}: ${result.sourceFile}`,
+    `${translator.t('ai.approve.timestamp')}: ${result.createdAt}`,
   ];
   if (result.version) {
-    lines.push(`Version: v${result.version}`);
+    lines.push(`${translator.t('ai.approve.version')}: v${result.version}`);
   }
 
   return `${lines.join('\n')}\n`;
 }
 
-function formatApprovalDryRunResult({ phase, input, version }) {
-  const lines = ['AI approval dry-run', `Phase: ${phase}`];
+function formatApprovalDryRunResult({ phase, input, version, language }) {
+  const translator = createTranslator(language);
+  const lines = [translator.t('ai.approve.dry_run.title'), translator.t('ai_task.phase', { phase })];
   if (version) {
-    lines.push(`Version: v${version}`);
+    lines.push(`${translator.t('ai.approve.version')}: v${version}`);
   }
   if (input) {
-    lines.push(`Input file: ${input}`);
+    lines.push(translator.t('ai_task.input_file', { path: input }));
   }
   return `${lines.join('\n')}\n`;
 }
@@ -1076,15 +1113,16 @@ function buildRepairPlanContext({ context, inputText, inputPath, repoRoot, role,
   };
 }
 
-function formatRepairPlanResult(result, repoRoot) {
+function formatRepairPlanResult(result, repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const relativePath = path.relative(repoRoot, result.filePath).split(path.sep).join('/');
   return [
-    'AI technical-plan repair draft saved',
-    `Draft: ${relativePath}`,
-    `Version: v${result.version}`,
-    `Source approved artifact: ${result.sourcePath}`,
-    'Original approved artifact: preserved',
-    'Next safe commands:',
+    translator.t('ai.repair_plan.saved'),
+    `${translator.t('ai.approvals.draft')}: ${relativePath}`,
+    `${translator.t('ai.approve.version')}: v${result.version}`,
+    `${translator.t('ai.repair_plan.source_approved_artifact')}: ${result.sourcePath}`,
+    translator.t('ai.repair_plan.original_preserved'),
+    `${translator.t('ai.label.next_safe_commands')}:`,
     '- npx create-quiver ai review-plan --dry-run',
     '- npx create-quiver ai review-plan',
     `- npx create-quiver ai approve --phase technical-plan --version ${result.version}`,
@@ -1188,16 +1226,17 @@ function classifyGlobalApprovalRelation(report, runApprovalRows) {
   return 'orphaned';
 }
 
-function formatRunScopedApprovals(repoRoot, runApprovalRows) {
+function formatRunScopedApprovals(repoRoot, runApprovalRows, options = {}) {
+  const translator = translatorForHuman(options);
   const runs = listAiRuns(repoRoot);
   const activeRun = resolveAiRun(repoRoot, '');
   const lines = [
-    'Run-scoped approvals',
-    `Active run: ${activeRun ? activeRun.run_id : '(none)'}`,
+    translator.t('ai.approvals.run_scoped'),
+    `${translator.t('ai.approvals.active_run')}: ${activeRun ? activeRun.run_id : translator.t('ai.approvals.none_value')}`,
   ];
 
   if (runs.length === 0) {
-    lines.push('- no AI runs found');
+    lines.push(`- ${translator.t('ai.approvals.no_ai_runs')}`);
     return `${lines.join('\n')}\n`;
   }
 
@@ -1208,9 +1247,9 @@ function formatRunScopedApprovals(repoRoot, runApprovalRows) {
         ? 'historical'
         : 'other-open';
     const approvals = runApprovalRows.filter((row) => row.run.run_id === run.run_id);
-    lines.push(`Run: ${run.run_id} (${relation}, phase: ${run.phase}, status: ${run.status})`);
+    lines.push(`${translator.t('ai.run.run')}: ${run.run_id} (${translator.t(`ai.approvals.relation.${relation}`)}, ${translator.t('ai.run.phase').toLowerCase()}: ${run.phase}, ${translator.t('ai.run.status').toLowerCase()}: ${formatStatus(run.status, translator)})`);
     if (approvals.length === 0) {
-      lines.push('- no run-scoped approvals');
+      lines.push(`- ${translator.t('ai.approvals.no_run_scoped')}`);
       continue;
     }
     for (const row of approvals) {
@@ -1223,18 +1262,76 @@ function formatRunScopedApprovals(repoRoot, runApprovalRows) {
 }
 
 function formatApprovalStatusReport(repoRoot) {
+  return formatApprovalStatusReportWithOptions(repoRoot);
+}
+
+function localizeApprovalSummary(text, translator) {
+  if (translator.language === 'en') {
+    return text;
+  }
+
+  return String(text || '')
+    .split('\n')
+    .map((line) => {
+      let match = line.match(/^Phase: (.+)$/);
+      if (match) return `${translator.t('ai.run.phase')}: ${match[1]}`;
+      match = line.match(/^Status: (.+)$/);
+      if (match) return `${translator.t('ai.run.status')}: ${formatStatus(match[1], translator)}`;
+      match = line.match(/^Draft( v\d+)?: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.draft')}${match[1] || ''}: ${match[2]}`;
+      if (line === 'Draft history:') return `${translator.t('ai.approvals.draft_history')}:`;
+      match = line.match(/^Approved( v\d+)?: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.approved')}${match[1] || ''}: ${match[2]}`;
+      match = line.match(/^Source file: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.source_file')}: ${match[1]}`;
+      match = line.match(/^Review: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.review')}: ${match[1]}`;
+      match = line.match(/^Approval recommendation: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.approval_recommendation')}: ${match[1]}`;
+      match = line.match(/^Blocking: (yes|no)$/);
+      if (match) return `${translator.t('ai.approvals.blocking')}: ${translator.t(match[1] === 'yes' ? 'common.yes' : 'common.no')}`;
+      match = line.match(/^Required fixes: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.required_fixes')}: ${match[1]}`;
+      match = line.match(/^Optional hardening: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.optional_hardening')}: ${match[1]}`;
+      match = line.match(/^Next command: (.+)$/);
+      if (match) return `${translator.t('ai.approvals.next_command')}: ${match[1]}`;
+      return line;
+    })
+    .join('\n');
+}
+
+function localizeApprovalDecisionLine(line, translator) {
+  if (translator.language === 'en') {
+    return line;
+  }
+  return String(line || '')
+    .replace(/^Candidates:/, translator.t('ai.approvals.candidates') + ':')
+    .replace(/^Latest draft:/, translator.t('ai.approvals.latest_draft') + ':')
+    .replace(/^Current candidate:/, translator.t('ai.approvals.current_candidate') + ':')
+    .replace(/^Recommended approval:/, translator.t('ai.approvals.recommended_approval') + ':')
+    .replace(/^Recommended next command:/, translator.t('ai.approvals.recommended_next_command') + ':')
+    .replace(/^Review status:/, translator.t('ai.approvals.review_status') + ':');
+}
+
+function formatApprovalStatusReportWithOptions(repoRoot, options = {}) {
+  const translator = translatorForHuman(options);
   const runApprovalRows = collectRunApprovalRows(repoRoot);
-  const sections = ['AI approvals status', formatRunScopedApprovals(repoRoot, runApprovalRows).trimEnd(), 'Global planner approvals'];
+  const sections = [
+    translator.t('ai.approvals.title'),
+    formatRunScopedApprovals(repoRoot, runApprovalRows, options).trimEnd(),
+    translator.t('ai.approvals.global_planner'),
+  ];
   for (const phase of PLANNER_APPROVAL_PHASES) {
-    const summary = summarizePlannerApproval(repoRoot, phase).trimEnd();
+    const summary = localizeApprovalSummary(summarizePlannerApproval(repoRoot, phase).trimEnd(), translator);
     const relation = classifyGlobalApprovalRelation(readPhaseApproval(repoRoot, phase), runApprovalRows);
     const candidates = buildApprovalCandidateReport(repoRoot, phase);
     const decisionLines = formatApprovalDecisionLines(candidates)
-      .map((line) => `- ${line}`)
+      .map((line) => `- ${localizeApprovalDecisionLine(line, translator)}`)
       .join('\n');
-    sections.push(`${summary}\nRun relation: ${relation}${decisionLines ? `\nApproval candidates:\n${decisionLines}` : ''}`);
+    sections.push(`${summary}\n${translator.t('ai.approvals.run_relation')}: ${translator.t(`ai.approvals.relation.${relation}`)}${decisionLines ? `\n${translator.t('ai.approvals.approval_candidates')}:\n${decisionLines}` : ''}`);
   }
-  sections.push(summarizePlanReview(repoRoot).trimEnd());
+  sections.push(localizeApprovalSummary(summarizePlanReview(repoRoot).trimEnd(), translator));
   return `${sections.join('\n\n')}\n`;
 }
 
@@ -1291,6 +1388,7 @@ async function runOnboard(repoRoot, options = {}) {
       role,
       contextPack: context,
       invocation,
+      language: options.language,
       onboardingPlan: contextInfo.plan,
       profile: runtimeProfile,
     };
@@ -1305,6 +1403,7 @@ async function runOnboard(repoRoot, options = {}) {
       role,
       contextPack: context,
       invocation,
+      language: options.language,
       onboardingPlan: contextInfo.plan,
       prompt,
       profile: runtimeProfile,
@@ -1315,11 +1414,16 @@ async function runOnboard(repoRoot, options = {}) {
 
   const ux = createCommandUx(options);
   const showProgress = shouldShowHumanProgress(ux, options);
+  const progressTranslator = createTranslator(options.language);
   writeProgressChecks(
     ux,
     showProgress,
-    plannerProgressTitle('Ejecutando onboarding', runtimeProfile),
-    ['Leyendo docs base', 'Detectando estructura', 'Preparando prompt'],
+    plannerProgressTitle(progressTranslator.t('ai.planner.progress.onboarding'), runtimeProfile, options),
+    [
+      progressTranslator.t('ai.planner.progress.reading_base_docs'),
+      progressTranslator.t('ai.planner.progress.detecting_structure'),
+      progressTranslator.t('ai.planner.progress.preparing_prompt'),
+    ],
   );
 
   let result;
@@ -1327,6 +1431,9 @@ async function runOnboard(repoRoot, options = {}) {
     result = await runProviderWithProgress({
       ux,
       enabled: showProgress,
+      message: progressTranslator.t('ai.planner.progress.running_agent'),
+      successMessage: progressTranslator.t('ai.planner.progress.agent_finished'),
+      failureMessage: progressTranslator.t('ai.planner.progress.agent_failed'),
       run: () => (options.runProviderFn || runProvider)(provider, {
         prompt,
         cwd: repoRoot,
@@ -1390,6 +1497,7 @@ async function runPrepareContext(repoRoot, options = {}) {
       plan: draftPack.plan,
       writePlan,
       writtenDocs: [],
+      language: options.language,
     }));
     return report;
   }
@@ -1408,6 +1516,7 @@ async function runPrepareContext(repoRoot, options = {}) {
     writePlan,
     writtenDocs: plannedDocs,
     snapshot,
+    language: options.language,
   }));
   const writtenDocs = writeDraftDocs(writePlan);
   updateAiRunPhase(repoRoot, lifecycleRun.run_id, 'onboarding-ready', {
@@ -1421,6 +1530,7 @@ async function runPrepareContext(repoRoot, options = {}) {
     writtenDocs,
     snapshot,
     completed: true,
+    language: options.language,
   }));
 
   return {
@@ -1485,6 +1595,7 @@ async function runPrepareContextWithPlanner(repoRoot, options = {}) {
       promptInfo,
       review: options.review === true,
       interactive: options.interactive === true,
+      language: options.language,
     }));
     return report;
   }
@@ -1506,11 +1617,16 @@ async function runPrepareContextWithPlanner(repoRoot, options = {}) {
 
   const ux = createCommandUx(options);
   const showProgress = shouldShowHumanProgress(ux, options);
+  const progressTranslator = createTranslator(options.language);
   writeProgressChecks(
     ux,
     showProgress,
-    plannerProgressTitle('Ejecutando onboarding', runtimeProfile),
-    ['Leyendo docs base', 'Detectando estructura', 'Preparando prompt'],
+    plannerProgressTitle(progressTranslator.t('ai.planner.progress.onboarding'), runtimeProfile, options),
+    [
+      progressTranslator.t('ai.planner.progress.reading_base_docs'),
+      progressTranslator.t('ai.planner.progress.detecting_structure'),
+      progressTranslator.t('ai.planner.progress.preparing_prompt'),
+    ],
   );
 
   let result;
@@ -1518,6 +1634,9 @@ async function runPrepareContextWithPlanner(repoRoot, options = {}) {
     result = await runProviderWithProgress({
       ux,
       enabled: showProgress,
+      message: progressTranslator.t('ai.planner.progress.running_agent'),
+      successMessage: progressTranslator.t('ai.planner.progress.agent_finished'),
+      failureMessage: progressTranslator.t('ai.planner.progress.agent_failed'),
       run: () => (options.runProviderFn || runProvider)(provider, {
         prompt,
         cwd: repoRoot,
@@ -1569,6 +1688,7 @@ async function runPrepareContextWithPlanner(repoRoot, options = {}) {
     writePlan,
     writtenDocs: plannedDocs,
     snapshot,
+    language: options.language,
   }));
 
   const writtenDocs = writeDraftDocs(writePlan);
@@ -1583,6 +1703,7 @@ async function runPrepareContextWithPlanner(repoRoot, options = {}) {
     writtenDocs,
     snapshot,
     completed: true,
+    language: options.language,
   }));
 
   return {
@@ -1628,8 +1749,9 @@ async function runPlan(repoRoot, options = {}) {
         phase,
         manifest,
       };
-      process.stdout.write('AI plan prompt-only\nPhase: spec\nNo provider prompt is used for spec generation; showing the local generation plan instead.\n');
-      process.stdout.write(formatSpecDryRunReport({ manifest, repoRoot }));
+      const translator = createTranslator(options.language);
+      process.stdout.write(`${translator.t('ai_task.title.prompt_only', { task: 'plan' })}\n${translator.t('ai_task.phase', { phase: 'spec' })}\n${translator.t('ai.plan.spec.prompt_only_no_provider')}\n`);
+      process.stdout.write(formatSpecDryRunReport({ manifest, repoRoot, language: options.language }));
       return report;
     }
 
@@ -1639,7 +1761,7 @@ async function runPlan(repoRoot, options = {}) {
         phase,
         manifest,
       };
-      process.stdout.write(formatSpecDryRunReport({ manifest, repoRoot }));
+      process.stdout.write(formatSpecDryRunReport({ manifest, repoRoot, language: options.language }));
       return report;
     }
 
@@ -1647,7 +1769,7 @@ async function runPlan(repoRoot, options = {}) {
       input: inputPath,
       specSlug: options.specSlug,
     });
-    process.stdout.write(formatSpecGenerationResult(result, repoRoot));
+    process.stdout.write(formatSpecGenerationResult(result, repoRoot, options));
 
     return {
       task: 'plan',
@@ -1728,15 +1850,15 @@ async function runPlan(repoRoot, options = {}) {
       invocation,
       profile: runtimeProfile,
     };
-    process.stdout.write(formatDryRunReport(report));
+    process.stdout.write(formatDryRunReport({ ...report, language: options.language }));
     if (options.withPlanner === true) {
-      process.stdout.write('Planner mode: already active for ai plan; --with-planner is accepted for UX consistency.\n');
+      process.stdout.write(`${createTranslator(options.language).t('ai.plan.with_planner_already_active')}\n`);
     }
     if (options.review === true) {
-      process.stdout.write('Review requested: provider output will be opened for review before saving the draft in live mode.\n');
+      process.stdout.write(`${createTranslator(options.language).t('ai.plan.review_requested')}\n`);
     }
     if (options.interactive === true) {
-      process.stdout.write('Interactive requested: live mode will ask before saving the draft.\n');
+      process.stdout.write(`${createTranslator(options.language).t('ai.plan.interactive_requested')}\n`);
     }
     return report;
   }
@@ -1752,7 +1874,7 @@ async function runPlan(repoRoot, options = {}) {
       prompt,
       profile: runtimeProfile,
     };
-    process.stdout.write(formatPromptOnlyReport(report));
+    process.stdout.write(formatPromptOnlyReport({ ...report, language: options.language }));
     return report;
   }
 
@@ -1761,8 +1883,12 @@ async function runPlan(repoRoot, options = {}) {
   writeProgressChecks(
     ux,
     showProgress,
-    plannerProgressTitle(`Ejecutando plan ${phase}`, runtimeProfile),
-    ['Leyendo entrada', 'Preparando contexto', 'Preparando prompt'],
+    plannerProgressTitle(createTranslator(options.language).t('ai.planner.progress.plan', { phase }), runtimeProfile, options),
+    [
+      createTranslator(options.language).t('ai.planner.progress.reading_input'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_context'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_prompt'),
+    ],
   );
 
   let result;
@@ -1905,12 +2031,14 @@ async function runReviewPlan(repoRoot, options = {}) {
       contextPack: pack.packName,
       phase: 'plan-review',
       invocation,
+      language: options.language,
     }));
-    process.stdout.write(`Prompt source: ${built.promptSource}\n`);
-    process.stdout.write(`Input file: ${inputPath}\n`);
-    process.stdout.write(`Input kind: ${resolved.kind}\n`);
+    const translator = createTranslator(options.language);
+    process.stdout.write(`${translator.t('ai_task.prompt_source', { source: built.promptSource })}\n`);
+    process.stdout.write(`${translator.t('ai_task.input_file', { path: inputPath })}\n`);
+    process.stdout.write(`${translator.t('ai_task.input_kind', { kind: resolved.kind })}\n`);
     if (resolved.version) {
-      process.stdout.write(`Input version: v${resolved.version}\n`);
+      process.stdout.write(`${translator.t('ai_task.input_version', { version: resolved.version })}\n`);
     }
     return report;
   }
@@ -1930,7 +2058,7 @@ async function runReviewPlan(repoRoot, options = {}) {
       inputVersion: resolved.version,
       profile: runtimeProfile,
     };
-    process.stdout.write(formatPromptOnlyReport(report));
+    process.stdout.write(formatPromptOnlyReport({ ...report, language: options.language }));
     return report;
   }
 
@@ -1939,8 +2067,12 @@ async function runReviewPlan(repoRoot, options = {}) {
   writeProgressChecks(
     ux,
     showProgress,
-    plannerProgressTitle('Ejecutando revisión del plan', runtimeProfile),
-    ['Leyendo plan técnico', 'Preparando contexto', 'Preparando prompt'],
+    plannerProgressTitle(createTranslator(options.language).t('ai.planner.progress.review_plan'), runtimeProfile, options),
+    [
+      createTranslator(options.language).t('ai.planner.progress.reading_technical_plan'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_context'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_prompt'),
+    ],
   );
 
   let result;
@@ -1999,8 +2131,9 @@ async function runReviewPlan(repoRoot, options = {}) {
     rawArtifactPath: rawArtifact.path,
   });
   const relativePath = path.relative(repoRoot, saved.filePath).split(path.sep).join('/');
-  const summary = summarizePlanReview(repoRoot).trimEnd();
-  process.stdout.write(`AI plan review saved\nArtifact: ${relativePath}\nPrompt source: ${PLAN_REVIEW_PROMPT_SOURCE}\n${summary}\n`);
+  const summary = localizeApprovalSummary(summarizePlanReview(repoRoot), createTranslator(options.language)).trimEnd();
+  const translator = createTranslator(options.language);
+  process.stdout.write(`${translator.t('ai.review_plan.saved')}\n${translator.t('ai.approve.artifact')}: ${relativePath}\n${translator.t('ai_task.prompt_source', { source: PLAN_REVIEW_PROMPT_SOURCE })}\n${summary}\n`);
 
   return {
     task: 'review-plan',
@@ -2060,9 +2193,10 @@ async function runRepairPlan(repoRoot, options = {}) {
       invocation,
       profile: runtimeProfile,
     };
-    process.stdout.write(formatDryRunReport(report));
-    process.stdout.write(`Source approved artifact: ${source.path}\n`);
-    process.stdout.write(`Validation failure: ${source.validationError}\n`);
+    process.stdout.write(formatDryRunReport({ ...report, language: options.language }));
+    const translator = createTranslator(options.language);
+    process.stdout.write(`${translator.t('ai.repair_plan.source_approved_artifact')}: ${source.path}\n`);
+    process.stdout.write(`${translator.t('ai.repair_plan.validation_failure')}: ${source.validationError}\n`);
     return report;
   }
 
@@ -2080,7 +2214,7 @@ async function runRepairPlan(repoRoot, options = {}) {
       inputVersion: source.approval.meta?.approved?.version || null,
       profile: runtimeProfile,
     };
-    process.stdout.write(formatPromptOnlyReport(report));
+    process.stdout.write(formatPromptOnlyReport({ ...report, language: options.language }));
     return report;
   }
 
@@ -2089,15 +2223,23 @@ async function runRepairPlan(repoRoot, options = {}) {
   writeProgressChecks(
     ux,
     showProgress,
-    plannerProgressTitle('Ejecutando reparación del plan', runtimeProfile),
-    ['Leyendo plan aprobado', 'Preparando contexto', 'Preparando prompt'],
+    plannerProgressTitle(createTranslator(options.language).t('ai.planner.progress.repair_plan'), runtimeProfile, options),
+    [
+      createTranslator(options.language).t('ai.planner.progress.reading_approved_plan'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_context'),
+      createTranslator(options.language).t('ai.planner.progress.preparing_prompt'),
+    ],
   );
 
   let providerResult;
   try {
+    const progressTranslator = createTranslator(options.language);
     providerResult = await runProviderWithProgress({
       ux,
       enabled: showProgress,
+      message: progressTranslator.t('ai.planner.progress.running_agent'),
+      successMessage: progressTranslator.t('ai.planner.progress.agent_finished'),
+      failureMessage: progressTranslator.t('ai.planner.progress.agent_failed'),
       run: () => (options.runProviderFn || runProvider)(provider, {
         prompt: built.prompt,
         cwd: repoRoot,
@@ -2164,7 +2306,7 @@ async function runRepairPlan(repoRoot, options = {}) {
   process.stdout.write(formatRepairPlanResult({
     ...draft,
     sourcePath: source.path,
-  }, repoRoot));
+  }, repoRoot, options));
 
   return {
     task: 'repair-plan',
@@ -2181,14 +2323,18 @@ async function runRepairPlan(repoRoot, options = {}) {
 }
 
 async function runRevise(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const phase = normalizePlannerPhase(options.phase || DEFAULT_PLAN_PHASE);
   if (phase === 'spec') {
-    throw new Error(formatError(`ai revise does not support phase '${phase}'`));
+    throw new Error(formatError(translator.t('ai.revise.error.unsupported_phase', { phase })));
   }
 
   const approval = readPhaseApproval(repoRoot, phase);
   if (approval.status !== 'draft' && approval.status !== 'stale') {
-    throw new Error(formatError(`ai revise --phase ${phase} requires an existing draft; current status is ${approval.status}. Run \`npx create-quiver ai plan --phase ${phase} --input <file>\` first.`));
+    throw new Error(formatError(translator.t('ai.revise.error.requires_draft', {
+      phase,
+      status: approval.status,
+    })));
   }
 
   return runPlan(repoRoot, {
@@ -2198,10 +2344,11 @@ async function runRevise(repoRoot, options = {}) {
   });
 }
 
-function formatApprovalCandidateHint(candidate) {
+function formatApprovalCandidateHint(candidate, options = {}) {
+  const translator = createTranslator(options.language);
   const parts = [];
   if (candidate.current) {
-    parts.push('current');
+    parts.push(translator.t('ai.approvals.current_candidate').toLowerCase());
   }
   if (candidate.created_at) {
     parts.push(candidate.created_at);
@@ -2210,10 +2357,10 @@ function formatApprovalCandidateHint(candidate) {
     parts.push(`review=${candidate.review.recommendation}`);
   }
   if (candidate.review?.required_fixes_count) {
-    parts.push(`required fixes=${candidate.review.required_fixes_count}`);
+    parts.push(`${translator.t('ai.approvals.required_fixes').toLowerCase()}=${candidate.review.required_fixes_count}`);
   }
   if (candidate.review?.optional_hardening_count) {
-    parts.push(`optional=${candidate.review.optional_hardening_count}`);
+    parts.push(`${translator.t('ai.approvals.optional_hardening').toLowerCase()}=${candidate.review.optional_hardening_count}`);
   }
   if (candidate.review?.risks_count) {
     parts.push(`risks=${candidate.review.risks_count}`);
@@ -2222,17 +2369,19 @@ function formatApprovalCandidateHint(candidate) {
   return parts.filter(Boolean).join(', ');
 }
 
-function approvalSelectionOptions(report) {
+function approvalSelectionOptions(report, options = {}) {
+  const translator = createTranslator(options.language);
   return report.candidates.map((candidate) => ({
-    label: `${candidate.label}${candidate.recommended ? ' (recommended)' : candidate.current ? ' (current)' : ' (history)'}`,
+    label: `${candidate.label}${candidate.recommended ? ` (${translator.t('ai.approvals.recommended_approval').toLowerCase()})` : candidate.current ? ` (${translator.t('ai.approvals.current_candidate').toLowerCase()})` : ` (${translator.t('ai.approvals.draft_history').toLowerCase()})`}`,
     value: String(candidate.version || ''),
-    hint: formatApprovalCandidateHint(candidate),
+    hint: formatApprovalCandidateHint(candidate, options),
     default: candidate.recommended === true,
     raw: candidate,
   }));
 }
 
 async function resolveApprovalVersion(repoRoot, phase, options = {}) {
+  const translator = createTranslator(options.language);
   if (options.version) {
     return options.version;
   }
@@ -2243,24 +2392,24 @@ async function resolveApprovalVersion(repoRoot, phase, options = {}) {
 
   if (!shouldPrompt || !canPrompt) {
     const recommended = report.recommended?.version || report.latest_version || '<n>';
-    throw new Error(formatActionableError({
-      failure: `ai approve --phase ${phase} requires --version <n> when prompts are not available.`,
-      impact: 'Quiver cannot safely guess which saved planner draft the human approved.',
-      fix: 'Review drafts with `npx create-quiver ai approvals`, then pass the version explicitly.',
+    throw new Error(formatLocalizedActionableError({
+      failure: translator.t('ai.approve.error.no_prompt.failure', { phase }),
+      impact: translator.t('ai.approve.error.no_prompt.impact'),
+      fix: translator.t('ai.approve.error.no_prompt.fix'),
       nextCommand: `npx create-quiver ai approve --phase ${phase} --version ${recommended}`,
-    }));
+    }, options));
   }
 
   if (report.candidates.length === 0) {
-    throw new Error(formatActionableError({
-      failure: `ai approve --phase ${phase} has no saved drafts to approve.`,
-      impact: 'There is no planner artifact that can pass the approval gate.',
-      fix: `Generate a ${phase} draft first.`,
+    throw new Error(formatLocalizedActionableError({
+      failure: translator.t('ai.approve.error.no_drafts.failure', { phase }),
+      impact: translator.t('ai.approve.error.no_drafts.impact'),
+      fix: translator.t('ai.approve.error.no_drafts.fix', { phase }),
       nextCommand: `npx create-quiver ai plan --phase ${phase}${phase === 'acceptance' ? ' --input <requirements.md>' : ''} --dry-run`,
-    }));
+    }, options));
   }
 
-  const selected = await selectOption(`¿Qué ${phase} draft querés aprobar?`, approvalSelectionOptions(report), {
+  const selected = await selectOption(translator.t('ai.approve.prompt.version', { phase }), approvalSelectionOptions(report, options), {
     env: options.env,
     error: options.error,
     input: options.input,
@@ -2279,27 +2428,28 @@ async function resolveApprovalVersion(repoRoot, phase, options = {}) {
 
   const candidate = selected.raw;
   if (!candidate?.approvable) {
-    throw new Error(formatActionableError({
-      failure: `${phase} draft ${selected.label} is not approvable.`,
+    throw new Error(formatLocalizedActionableError({
+      failure: translator.t('ai.approve.error.not_approvable.failure', { phase, label: selected.label }),
       impact: candidate?.review?.blocking
-        ? 'The current review gate blocks technical-plan approval.'
-        : 'Quiver only approves the current eligible draft version.',
-      fix: candidate?.reason || 'Inspect planner approvals before approving.',
+        ? translator.t('ai.approve.error.not_approvable.impact_blocked')
+        : translator.t('ai.approve.error.not_approvable.impact'),
+      fix: candidate?.reason || translator.t('ai.approve.error.not_approvable.fix'),
       nextCommand: candidate?.next_command || `npx create-quiver ai approvals`,
-    }));
+    }, options));
   }
 
   return selected.value;
 }
 
 async function runApprove(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const phase = normalizePlannerPhase(options.phase || DEFAULT_PLAN_PHASE);
   if (phase === 'spec') {
-    throw new Error(formatError(`ai approve does not support phase '${phase}'`));
+    throw new Error(formatError(translator.t('ai.approve.error.unsupported_phase', { phase })));
   }
 
   if (options.input) {
-    throw new Error(formatError(`ai approve --phase ${phase} approves saved draft versions only. Use \`npx create-quiver ai revise --phase ${phase} --input ${options.input}\` to create a new draft first.`));
+    throw new Error(formatError(translator.t('ai.approve.error.input_not_supported', { phase, input: options.input })));
   }
 
   const version = await resolveApprovalVersion(repoRoot, phase, options);
@@ -2307,12 +2457,16 @@ async function runApprove(repoRoot, options = {}) {
   if (phase === 'technical-plan') {
     const review = readPlanReview(repoRoot);
     if (review.status !== 'unapproved' && review.status !== 'reviewed') {
-      throw new Error(formatError(`ai approve --phase technical-plan requires a production review for the current draft; current review status is ${review.status}. Run \`npx create-quiver ai review-plan --dry-run\`, then \`npx create-quiver ai review-plan\`.`));
+      throw new Error(formatError(translator.t('ai.approve.error.review_required', { status: review.status })));
     }
     if (reviewBlocksApproval(review)) {
       const result = review.meta.review_result;
       const requiredFixes = Array.isArray(result.required_fixes) ? result.required_fixes.length : 0;
-      throw new Error(formatError(`ai approve --phase technical-plan is blocked by plan review; approval recommendation is ${result.approval_recommendation}. Required fixes: ${requiredFixes}. Next command: ${result.next_command}`));
+      throw new Error(formatError(translator.t('ai.approve.error.review_blocked', {
+        recommendation: result.approval_recommendation,
+        fixes: requiredFixes,
+        command: result.next_command,
+      })));
     }
     assertTechnicalPlanDraftHasSpecContract(repoRoot, version);
   }
@@ -2320,7 +2474,7 @@ async function runApprove(repoRoot, options = {}) {
   const inputText = '';
 
   if (options.dryRun) {
-    process.stdout.write(formatApprovalDryRunResult({ phase, input: options.input, version }));
+    process.stdout.write(formatApprovalDryRunResult({ phase, input: options.input, version, language: options.language }));
     return {
       task: 'approve',
       phase,
@@ -2351,7 +2505,7 @@ async function runApprove(repoRoot, options = {}) {
   process.stdout.write(formatApprovalResult({
     ...result,
     sourceFile: options.input || `draft version ${version}`,
-  }, repoRoot));
+  }, repoRoot, options));
 
   return {
     task: 'approve',
@@ -2363,8 +2517,8 @@ async function runApprove(repoRoot, options = {}) {
   };
 }
 
-async function runApprovalStatus(repoRoot) {
-  const report = formatApprovalStatusReport(repoRoot);
+async function runApprovalStatus(repoRoot, options = {}) {
+  const report = formatApprovalStatusReportWithOptions(repoRoot, options);
   process.stdout.write(report);
   return {
     task: 'approval-status',
@@ -2374,7 +2528,7 @@ async function runApprovalStatus(repoRoot) {
 
 function runLifecycleStatus(repoRoot, options = {}) {
   const run = resolveAiRun(repoRoot, options.runId || '');
-  const report = formatAiRunStatus(repoRoot, run);
+  const report = formatAiRunStatus(repoRoot, run, options);
   process.stdout.write(report);
   return {
     task: 'status',
@@ -2385,7 +2539,7 @@ function runLifecycleStatus(repoRoot, options = {}) {
 
 function runLifecycleResume(repoRoot, options = {}) {
   const run = resolveAiRun(repoRoot, options.runId || '');
-  const report = formatAiRunResume(repoRoot, run);
+  const report = formatAiRunResume(repoRoot, run, options);
   process.stdout.write(report);
   return {
     task: 'resume',
@@ -2398,7 +2552,7 @@ function runInspect(repoRoot, options = {}) {
   const report = collectLifecycleExport(repoRoot, {
     includeCompleted: options.includeCompleted === true,
   });
-  process.stdout.write(formatLifecycleInspect(report));
+  process.stdout.write(formatLifecycleInspect(report, options));
   return {
     task: 'inspect',
     report,
@@ -2421,7 +2575,7 @@ function runExport(repoRoot, options = {}) {
   }
 
   if (format === 'markdown' || format === 'md') {
-    process.stdout.write(formatLifecycleExportMarkdown(report));
+    process.stdout.write(formatLifecycleExportMarkdown(report, options));
     return {
       task: 'export',
       format: 'markdown',
@@ -2439,7 +2593,7 @@ function runSpecsList(repoRoot, options = {}) {
   if (options.json === true) {
     process.stdout.write(`${JSON.stringify({ specs: report.specs }, null, 2)}\n`);
   } else {
-    process.stdout.write(formatSpecsList(report));
+    process.stdout.write(formatSpecsList(report, options));
   }
   return {
     task: 'specs',
@@ -2454,7 +2608,7 @@ function runSlicesList(repoRoot, options = {}) {
   if (options.json === true) {
     process.stdout.write(`${JSON.stringify({ slices: report.slices }, null, 2)}\n`);
   } else {
-    process.stdout.write(formatSlicesList(report));
+    process.stdout.write(formatSlicesList(report, options));
   }
   return {
     task: 'slices',
@@ -2466,7 +2620,7 @@ function runTraceReport(repoRoot, options = {}) {
   const report = collectLifecycleExport(repoRoot, {
     includeCompleted: options.includeCompleted === true,
   });
-  process.stdout.write(formatTraceReport(report));
+  process.stdout.write(formatTraceReport(report, options));
   return {
     task: 'trace',
     report,
@@ -2496,22 +2650,23 @@ function runActiveSlice(repoRoot, options = {}) {
 }
 
 function runLifecycleRun(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const command = String(options.command || '').trim().toLowerCase();
   if (command !== 'create' && command !== 'close') {
-    throw new Error(formatError(`unsupported ai run subcommand: ${command}. Supported tasks: create, close`));
+    throw new Error(formatError(translator.t('ai.run.error.unsupported_subcommand', { command })));
   }
   if (command === 'create' && !options.input) {
-    throw new Error(formatError('ai run create requires --input <requirements.md>'));
+    throw new Error(formatError(translator.t('ai.run.error.create_requires_input')));
   }
   if (command === 'close') {
     const current = resolveAiRun(repoRoot, options.runId || '');
     if (!current) {
-      throw new Error(formatError('ai run close requires an active run or --run <id>'));
+      throw new Error(formatError(translator.t('ai.run.error.close_requires_run')));
     }
     const run = updateAiRunPhase(repoRoot, current.run_id, 'closed', {
       command: 'ai run close',
     });
-    const report = `AI run closed\n${formatAiRunStatus(repoRoot, run)}`;
+    const report = `${translator.t('ai.run.closed.title')}\n${formatAiRunStatus(repoRoot, run, options)}`;
     process.stdout.write(report);
     return {
       task: 'run',
@@ -2526,7 +2681,7 @@ function runLifecycleRun(repoRoot, options = {}) {
     runId: options.runId,
     specSlug: options.specSlug,
   });
-  const report = formatAiRunStatus(repoRoot, run);
+  const report = formatAiRunStatus(repoRoot, run, options);
   process.stdout.write(report);
   return {
     task: 'run',
@@ -2543,7 +2698,7 @@ function isInteractiveAgentPromptAvailable(options = {}) {
   return stdinIsTTY && stdoutIsTTY && ci !== '1' && ci !== 'true';
 }
 
-function providerInstallHint(repoRoot, providerId, options = {}) {
+function providerInstallStatus(repoRoot, providerId, options = {}) {
   const probe = options.preflightProvider || preflightProvider;
   try {
     probe(providerId, {
@@ -2554,19 +2709,23 @@ function providerInstallHint(repoRoot, providerId, options = {}) {
     return 'installed';
   } catch (error) {
     if (error && error.code === 'MISSING_PROVIDER_CLI') {
-      return 'not installed';
+      return 'not_installed';
     }
-    return 'not verified';
+    return 'not_verified';
   }
 }
 
 function buildAgentProviderChoices(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   return listCatalogProviders().map((provider) => {
-    const status = providerInstallHint(repoRoot, provider.id, options);
+    const status = providerInstallStatus(repoRoot, provider.id, options);
     return {
       label: provider.displayName,
       value: provider.id,
-      hint: `${provider.modelCount} models, ${status}`,
+      hint: translator.t('ai.agent.choice.provider_hint', {
+        count: provider.modelCount,
+        status: translator.t(`ai.agent.install_status.${status}`),
+      }),
       raw: {
         ...provider,
         installStatus: status,
@@ -2575,12 +2734,15 @@ function buildAgentProviderChoices(repoRoot, options = {}) {
   });
 }
 
-function buildAgentModelChoices(provider, role) {
+function buildAgentModelChoices(provider, role, options = {}) {
+  const translator = createTranslator(options.language);
   return getKnownModelsForProvider(provider, { role }).map((model) => {
-    const recommended = model.recommendedFor.includes(role) ? 'recommended' : 'available';
+    const recommended = model.recommendedFor.includes(role)
+      ? translator.t('ai.agent.choice.model_recommended')
+      : translator.t('ai.agent.choice.model_available');
     const tier = [model.costTier, model.qualityTier, model.stability].filter(Boolean).join('/');
     return {
-      label: model.displayName,
+      label: model.id === 'custom' ? translator.t('ai.agent.choice.model_custom') : model.displayName,
       value: model.id,
       hint: [recommended, tier].filter(Boolean).join(', '),
       default: model.recommendedFor.includes(role),
@@ -2590,6 +2752,7 @@ function buildAgentModelChoices(provider, role) {
 }
 
 async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const role = normalizeAgentProfileRole(options.role);
   const hasProvider = Boolean(String(options.provider || '').trim());
   const hasModel = Boolean(String(options.model || '').trim());
@@ -2603,12 +2766,12 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
   const canPrompt = isInteractiveAgentPromptAvailable(options);
   const shouldPrompt = options.interactive === true || canPrompt;
   if (!shouldPrompt || !canPrompt) {
-    throw new Error(formatActionableError({
-      failure: `ai agent set ${role} requires --provider and --model when prompts are not available.`,
-      impact: 'Quiver cannot safely guess the provider or technical model id for an agent profile.',
-      fix: 'Pass both flags explicitly, or rerun from an interactive terminal with --interactive.',
+    throw new Error(formatLocalizedActionableError({
+      failure: translator.t('ai.agent.error.no_prompt.failure', { role }),
+      impact: translator.t('ai.agent.error.no_prompt.impact'),
+      fix: translator.t('ai.agent.error.no_prompt.fix'),
       nextCommand: `npx create-quiver ai agent set ${role} --provider codex --model gpt-5.5`,
-    }));
+    }, options));
   }
 
   const promptOptions = {
@@ -2633,16 +2796,16 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
     const ux = createCommandUx(promptOptions);
     ux.summary(existingProfiles.map((profile) => ({
       label: profile.id,
-      value: `${profile.provider} ${profile.model || '(no model)'}${profile.default ? ' default' : ''}`,
+      value: `${profile.provider} ${profile.model || translator.t('ai.agent.value.no_model')}${profile.default ? ` ${translator.t('ai.agent.value.default')}` : ''}`,
     })), {
-      title: `Existing ${role} profiles`,
+      title: translator.t('ai.agent.prompt.existing_title', { role }),
     });
 
-    const action = await selectOption(`Ya existe al menos un perfil ${role}. ¿Qué querés hacer?`, [
-      { label: 'Actualizar perfil actual', value: 'update-current', hint: 'Reutiliza el perfil default', default: true },
-      { label: 'Crear perfil nuevo', value: 'create-new', hint: 'Permite guardar otro modelo o provider' },
-      { label: 'Cambiar default', value: 'change-default', hint: 'Marca un perfil existente como default' },
-      { label: 'Cancelar', value: 'cancel', hint: 'No escribe archivos' },
+    const action = await selectOption(translator.t('ai.agent.prompt.existing_action', { role }), [
+      { label: translator.t('ai.agent.prompt.action.update_current.label'), value: 'update-current', hint: translator.t('ai.agent.prompt.action.update_current.hint'), default: true },
+      { label: translator.t('ai.agent.prompt.action.create_new.label'), value: 'create-new', hint: translator.t('ai.agent.prompt.action.create_new.hint') },
+      { label: translator.t('ai.agent.prompt.action.change_default.label'), value: 'change-default', hint: translator.t('ai.agent.prompt.action.change_default.hint') },
+      { label: translator.t('ai.agent.prompt.action.cancel.label'), value: 'cancel', hint: translator.t('ai.agent.prompt.action.cancel.hint') },
     ], {
       ...promptOptions,
       name: 'agent profile action',
@@ -2650,14 +2813,14 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
     });
 
     if (action.value === 'cancel') {
-      throw new Error(formatError('ai agent set canceled. No files were written.'));
+      throw new Error(formatError(translator.t('ai.agent.error.canceled')));
     }
 
     if (action.value === 'change-default') {
-      const profile = await selectOption(`Elegí el perfil ${role} default`, existingProfiles.map((item) => ({
+      const profile = await selectOption(translator.t('ai.agent.prompt.default_profile', { role }), existingProfiles.map((item) => ({
         label: resolveAgentProfileDisplayName(item),
         value: item.id,
-        hint: `${item.provider} ${item.model || '(no model)'}`,
+        hint: `${item.provider} ${item.model || translator.t('ai.agent.value.no_model')}`,
         default: item.default === true,
         raw: item,
       })), {
@@ -2688,7 +2851,7 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
     }
 
     if (action.value === 'create-new') {
-      const id = await promptText(`ID para el nuevo perfil ${role}`, {
+      const id = await promptText(translator.t('ai.agent.prompt.new_id', { role }), {
         ...promptOptions,
         name: 'agent profile id',
         flag: '--id',
@@ -2700,7 +2863,7 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
   }
 
   if (!next.provider) {
-    const selectedProvider = await selectOption(`Elegí un provider para ${role}`, buildAgentProviderChoices(repoRoot, options), {
+    const selectedProvider = await selectOption(translator.t('ai.agent.prompt.provider', { role }), buildAgentProviderChoices(repoRoot, options), {
       ...promptOptions,
       name: 'agent provider',
       flag: '--provider',
@@ -2709,19 +2872,19 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
   }
 
   if (!next.model) {
-    const selectedModel = await selectOption(`Elegí un modelo para ${role}`, buildAgentModelChoices(next.provider, role), {
+    const selectedModel = await selectOption(translator.t('ai.agent.prompt.model', { role }), buildAgentModelChoices(next.provider, role, options), {
       ...promptOptions,
       name: 'agent model',
       flag: '--model',
     });
     if (selectedModel.value === 'custom') {
-      const model = await promptText(`Modelo custom para ${next.provider}`, {
+      const model = await promptText(translator.t('ai.agent.prompt.custom_model', { provider: next.provider }), {
         ...promptOptions,
         name: 'agent model',
         flag: '--model',
         placeholder: `${next.provider}-model-id`,
       });
-      const displayName = await promptText('Nombre visible del modelo custom', {
+      const displayName = await promptText(translator.t('ai.agent.prompt.custom_model_display'), {
         ...promptOptions,
         name: 'agent model display name',
         flag: '--display-name',
@@ -2742,48 +2905,53 @@ async function resolveInteractiveAgentSetOptions(repoRoot, options = {}) {
   };
 }
 
-function formatAgentProfile(profile) {
+function formatAgentProfile(profile, options = {}) {
+  const translator = createTranslator(options.language);
   const lines = [
-    `ID: ${profile.id || 'default'}`,
-    `Role: ${profile.role}`,
-    `Provider: ${profile.provider}`,
-    `Model: ${profile.model || '(not set)'}`,
-    `Label: ${profile.label || '(not set)'}`,
-    `Display name: ${resolveAgentProfileDisplayName(profile) || '(not set)'}`,
-    `Default: ${profile.default === true ? 'yes' : 'no'}`,
-    `Context: ${profile.context || '(not set)'}`,
-    `Updated: ${profile.updated_at}`,
+    `${translator.t('ai.agent.field.id')}: ${profile.id || translator.t('ai.agent.value.default')}`,
+    `${translator.t('ai.agent.field.role')}: ${profile.role}`,
+    `${translator.t('ai.agent.field.provider')}: ${profile.provider}`,
+    `${translator.t('ai.agent.field.model')}: ${profile.model || translator.t('ai.agent.value.not_set')}`,
+    `${translator.t('ai.agent.field.label')}: ${profile.label || translator.t('ai.agent.value.not_set')}`,
+    `${translator.t('ai.agent.field.display_name')}: ${resolveAgentProfileDisplayName(profile) || translator.t('ai.agent.value.not_set')}`,
+    `${translator.t('ai.agent.field.default')}: ${profile.default === true ? translator.t('ai.agent.value.yes') : translator.t('ai.agent.value.no')}`,
+    `${translator.t('ai.agent.field.context')}: ${profile.context || translator.t('ai.agent.value.not_set')}`,
+    `${translator.t('ai.agent.field.updated')}: ${profile.updated_at}`,
   ];
   return `${lines.join('\n')}\n`;
 }
 
-function formatAgentProfileList(profiles) {
-  const lines = ['AI agent profiles'];
+function formatAgentProfileList(profiles, options = {}) {
+  const translator = createTranslator(options.language);
+  const lines = [translator.t('ai.agent.list.title')];
   for (const item of profiles) {
     if (!item.configured) {
-      lines.push(`- ${item.role}: not configured`);
+      lines.push(`- ${item.role}: ${translator.t('ai.agent.list.not_configured')}`);
       continue;
     }
     const model = item.profile.model ? ` model=${item.profile.model}` : '';
     const label = item.profile.label ? ` label=${item.profile.label}` : '';
     const displayName = resolveAgentProfileDisplayName(item.profile);
-    const alternatives = item.profiles.length > 1 ? ` options=${item.profiles.length}` : '';
-    lines.push(`- ${item.role}: provider=${item.profile.provider}${model}${label} displayName=${displayName}${alternatives}`);
+    const alternatives = item.profiles.length > 1 ? ` ${translator.t('ai.agent.list.options')}=${item.profiles.length}` : '';
+    lines.push(`- ${item.role}: provider=${item.profile.provider}${model}${label} ${translator.t('ai.agent.list.display_name')}=${displayName}${alternatives}`);
   }
   return `${lines.join('\n')}\n`;
 }
 
-function formatAgentProfileDryRun(repoRoot, result) {
+function formatAgentProfileDryRun(repoRoot, result, options = {}) {
+  const translator = createTranslator(options.language);
   const relativePath = path.relative(repoRoot, result.filePath).split(path.sep).join('/');
-  const verb = result.action === 'update' ? 'update' : 'create';
+  const verb = result.action === 'update'
+    ? translator.t('ai.agent.dry_run.verb_update')
+    : translator.t('ai.agent.dry_run.verb_create');
   return [
-    'AI agent profile dry-run',
-    '- Writes: none',
-    `- Would ${verb}: ${relativePath}`,
+    translator.t('ai.agent.dry_run.title'),
+    `- ${translator.t('ai.agent.dry_run.writes')}: ${translator.t('ai.agent.value.none')}`,
+    `- ${translator.t('ai.agent.dry_run.would', { verb, path: relativePath })}`,
     '',
-    formatAgentProfile(result.profile).trimEnd(),
+    formatAgentProfile(result.profile, options).trimEnd(),
     '',
-    'No secrets or provider credentials are stored in agent profiles.',
+    translator.t('ai.agent.dry_run.no_secrets'),
     '',
   ].join('\n');
 }
@@ -2794,58 +2962,60 @@ function agentDoctorSymbol(status) {
   return 'OK';
 }
 
-function formatAgentDoctorReport(report) {
+function formatAgentDoctorReport(report, options = {}) {
+  const translator = createTranslator(options.language);
   const lines = [
-    'Quiver Agent Doctor',
+    translator.t('ai.agent.doctor.title'),
     '',
-    'Checks',
+    translator.t('ai.agent.doctor.checks'),
   ];
 
   if (report.checks.length === 0) {
-    lines.push('  ! No agent profiles configured');
+    lines.push(`  ! ${translator.t('ai.agent.doctor.no_profiles')}`);
   }
 
   for (const check of report.checks) {
     const target = `${check.role}/${check.id}`;
-    const model = check.model || '(no model)';
-    const provider = check.provider || '(no provider)';
-    const defaultText = check.default ? ' default' : '';
+    const model = check.model || translator.t('ai.agent.value.no_model');
+    const provider = check.provider || translator.t('ai.agent.value.no_provider');
+    const defaultText = check.default ? ` ${translator.t('ai.agent.value.default')}` : '';
     lines.push(`  ${agentDoctorSymbol(check.status)} ${target}: provider=${provider} model=${model}${defaultText}`);
     for (const finding of check.findings.filter((item) => item.severity !== 'info')) {
       lines.push(`    - ${finding.severity}: ${finding.message}`);
     }
   }
 
-  lines.push('', 'Suggested fixes');
+  lines.push('', translator.t('ai.agent.doctor.suggested_fixes'));
   if (report.suggestedFixes.length === 0) {
-    lines.push('  OK No fixes suggested.');
+    lines.push(`  OK ${translator.t('ai.agent.doctor.no_fixes')}`);
   } else {
     for (const fix of report.suggestedFixes) {
       lines.push(`  - ${fix}`);
     }
   }
   lines.push('');
-  lines.push(`Summary: profiles=${report.summary.profiles} errors=${report.summary.errors} warnings=${report.summary.warnings} info=${report.summary.info}`);
+  lines.push(`${translator.t('ai.agent.doctor.summary')}: profiles=${report.summary.profiles} errors=${report.summary.errors} warnings=${report.summary.warnings} info=${report.summary.info}`);
   lines.push('');
   return `${lines.join('\n')}\n`;
 }
 
-function formatAgentRepairPlan(plan) {
+function formatAgentRepairPlan(plan, options = {}) {
+  const translator = createTranslator(options.language);
   const lines = [
-    'AI agent profile repair dry-run',
-    '- Writes: none',
+    translator.t('ai.agent.repair.title'),
+    `- ${translator.t('ai.agent.dry_run.writes')}: ${translator.t('ai.agent.value.none')}`,
     '',
-    'Proposed changes',
+    translator.t('ai.agent.repair.proposed_changes'),
   ];
 
   if (plan.changes.length === 0) {
-    lines.push('  OK No safe repairs found.');
+    lines.push(`  OK ${translator.t('ai.agent.repair.no_repairs')}`);
   }
 
   for (const change of plan.changes) {
     lines.push(`  - ${change.role}/${change.profileId}: ${change.reason}`);
-    lines.push(`    Before: model=${change.before.model || '(not set)'} displayName=${change.before.displayName || '(not set)'}`);
-    lines.push(`    After: model=${change.after.model || '(not set)'} displayName=${change.after.displayName || '(not set)'}`);
+    lines.push(`    ${translator.t('ai.agent.repair.before')}: model=${change.before.model || translator.t('ai.agent.value.not_set')} displayName=${change.before.displayName || translator.t('ai.agent.value.not_set')}`);
+    lines.push(`    ${translator.t('ai.agent.repair.after')}: model=${change.after.model || translator.t('ai.agent.value.not_set')} displayName=${change.after.displayName || translator.t('ai.agent.value.not_set')}`);
   }
 
   lines.push('');
@@ -2853,13 +3023,17 @@ function formatAgentRepairPlan(plan) {
 }
 
 function buildModelsListReport(options = {}) {
+  const translator = createTranslator(options.language);
   const providerFilter = String(options.provider || '').trim().toLowerCase();
   const providers = providerFilter
     ? [listCatalogProviders().find((provider) => provider.id === providerFilter)].filter(Boolean)
     : listCatalogProviders();
 
   if (providerFilter && providers.length === 0) {
-    throw new Error(formatError(`unsupported provider filter '${options.provider}'. Supported providers: ${listCatalogProviders().map((provider) => provider.id).join(', ')}.`));
+    throw new Error(formatError(translator.t('ai.models.error.unsupported_provider_filter', {
+      provider: options.provider,
+      providers: listCatalogProviders().map((provider) => provider.id).join(', '),
+    })));
   }
 
   return {
@@ -2882,21 +3056,22 @@ function buildModelsListReport(options = {}) {
   };
 }
 
-function formatModelsListReport(report) {
+function formatModelsListReport(report, options = {}) {
+  const translator = createTranslator(options.language);
   const lines = [
-    'AI models known by Quiver',
-    `Catalog version: ${report.catalogVersion}`,
-    `Last updated: ${report.lastUpdated}`,
-    'Note: Models are known by Quiver; provider account access is not guaranteed.',
+    translator.t('ai.models.title'),
+    `${translator.t('ai.models.catalog_version')}: ${report.catalogVersion}`,
+    `${translator.t('ai.models.last_updated')}: ${report.lastUpdated}`,
+    `${translator.t('ai.models.note')}`,
     '',
   ];
 
   for (const provider of report.providers) {
     lines.push(`${provider.displayName} (${provider.id})`);
     for (const model of provider.models) {
-      const roles = model.recommendedFor.length > 0 ? model.recommendedFor.join(', ') : 'custom/manual';
+      const roles = model.recommendedFor.length > 0 ? model.recommendedFor.join(', ') : translator.t('ai.models.roles.custom_manual');
       lines.push(`  - ${model.id} (${model.displayName})`);
-      lines.push(`    roles: ${roles}`);
+      lines.push(`    ${translator.t('ai.models.roles')}: ${roles}`);
       lines.push(`    cost=${model.costTier} quality=${model.qualityTier} stability=${model.stability}`);
     }
     lines.push('');
@@ -2907,12 +3082,13 @@ function formatModelsListReport(report) {
 
 function runModelsList(options = {}) {
   const report = buildModelsListReport({
+    language: options.language,
     provider: options.provider,
   });
   if (options.json) {
     process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
   } else {
-    process.stdout.write(formatModelsListReport(report));
+    process.stdout.write(formatModelsListReport(report, options));
   }
   return {
     task: 'models',
@@ -2922,11 +3098,12 @@ function runModelsList(options = {}) {
 }
 
 async function runAgent(repoRoot, options = {}) {
+  const translator = createTranslator(options.language);
   const command = String(options.command || '').trim().toLowerCase();
 
   if (command === 'set') {
     if (!options.role) {
-      throw new Error(formatError('missing agent role. Use: npx create-quiver ai agent set <planner|executor|reviewer|doctor> --provider <provider> --model <model>'));
+      throw new Error(formatError(translator.t('ai.agent.error.missing_set_role')));
     }
     const profileOptions = await resolveInteractiveAgentSetOptions(repoRoot, options);
     if (options.dryRun) {
@@ -2939,7 +3116,7 @@ async function runAgent(repoRoot, options = {}) {
         model: profileOptions.model,
         provider: profileOptions.provider,
       });
-      process.stdout.write(formatAgentProfileDryRun(repoRoot, preview));
+      process.stdout.write(formatAgentProfileDryRun(repoRoot, preview, options));
       return {
         task: 'agent',
         command,
@@ -2960,13 +3137,13 @@ async function runAgent(repoRoot, options = {}) {
       });
       const ux = createCommandUx(profileOptions);
       ux.summary([
-        { label: 'Role', value: preview.profile.role },
-        { label: 'Provider', value: preview.profile.provider },
-        { label: 'Model', value: preview.profile.model || '(not set)' },
-        { label: 'Display name', value: resolveAgentProfileDisplayName(preview.profile) || '(not set)' },
-        { label: 'Default', value: preview.profile.default === true ? 'yes' : 'no' },
+        { label: translator.t('ai.agent.field.role'), value: preview.profile.role },
+        { label: translator.t('ai.agent.field.provider'), value: preview.profile.provider },
+        { label: translator.t('ai.agent.field.model'), value: preview.profile.model || translator.t('ai.agent.value.not_set') },
+        { label: translator.t('ai.agent.field.display_name'), value: resolveAgentProfileDisplayName(preview.profile) || translator.t('ai.agent.value.not_set') },
+        { label: translator.t('ai.agent.field.default'), value: preview.profile.default === true ? translator.t('ai.agent.value.yes') : translator.t('ai.agent.value.no') },
       ], {
-        title: 'Profile to save',
+        title: translator.t('ai.agent.profile_to_save.title'),
       });
     }
     const result = setAgentProfile(repoRoot, profileOptions.role, {
@@ -2978,9 +3155,9 @@ async function runAgent(repoRoot, options = {}) {
       model: profileOptions.model,
       provider: profileOptions.provider,
     });
-    process.stdout.write('AI agent profile saved\n');
-    process.stdout.write(formatAgentProfile(result.profile));
-    process.stdout.write(`State: ${path.relative(repoRoot, result.filePath).split(path.sep).join('/')}\n`);
+    process.stdout.write(`${translator.t('ai.agent.saved.title')}\n`);
+    process.stdout.write(formatAgentProfile(result.profile, options));
+    process.stdout.write(`${translator.t('ai.agent.field.state')}: ${path.relative(repoRoot, result.filePath).split(path.sep).join('/')}\n`);
     return {
       task: 'agent',
       command,
@@ -2991,22 +3168,22 @@ async function runAgent(repoRoot, options = {}) {
 
   if (command === 'show') {
     if (!options.role) {
-      throw new Error(formatError('missing agent role. Use: npx create-quiver ai agent show <planner|executor|reviewer|doctor>'));
+      throw new Error(formatError(translator.t('ai.agent.error.missing_show_role')));
     }
     const profile = options.id
       ? getAgentProfileById(repoRoot, options.role, options.id)
       : getAgentProfile(repoRoot, options.role);
     if (!profile) {
-      throw new Error(formatActionableError({
+      throw new Error(formatLocalizedActionableError({
         failure: options.id
-          ? `agent profile '${options.role}/${options.id}' is not configured.`
-          : `agent profile '${options.role}' is not configured.`,
-        impact: 'Quiver will fall back to default provider behavior and may use the wrong model/cost profile.',
-        fix: `Configure the ${options.role} profile with a supported provider and technical model id.`,
+          ? translator.t('ai.agent.error.missing_profile_id.failure', { role: options.role, id: options.id })
+          : translator.t('ai.agent.error.missing_profile.failure', { role: options.role }),
+        impact: translator.t('ai.agent.error.missing_profile.impact'),
+        fix: translator.t('ai.agent.error.missing_profile.fix', { role: options.role }),
         nextCommand: `npx create-quiver ai agent set ${options.role} --provider <provider> --model <model-id>`,
-      }));
+      }, options));
     }
-    process.stdout.write(formatAgentProfile(profile));
+    process.stdout.write(formatAgentProfile(profile, options));
     return {
       task: 'agent',
       command,
@@ -3016,8 +3193,8 @@ async function runAgent(repoRoot, options = {}) {
 
   if (command === 'list' || command === 'ls' || command === '') {
     const profiles = listAgentProfiles(repoRoot);
-    process.stdout.write(formatAgentProfileList(profiles));
-    process.stdout.write(`State: ${path.relative(repoRoot, agentProfilesPath(repoRoot)).split(path.sep).join('/')}\n`);
+    process.stdout.write(formatAgentProfileList(profiles, options));
+    process.stdout.write(`${translator.t('ai.agent.field.state')}: ${path.relative(repoRoot, agentProfilesPath(repoRoot)).split(path.sep).join('/')}\n`);
     return {
       task: 'agent',
       command: 'list',
@@ -3030,7 +3207,7 @@ async function runAgent(repoRoot, options = {}) {
     if (options.json) {
       process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
     } else {
-      process.stdout.write(formatAgentDoctorReport(report));
+      process.stdout.write(formatAgentDoctorReport(report, options));
     }
     if (report.summary.errors > 0) {
       process.exitCode = 1;
@@ -3044,7 +3221,7 @@ async function runAgent(repoRoot, options = {}) {
 
   if (command === 'repair') {
     if (options.dryRun !== true) {
-      throw new Error(formatError('ai agent repair only supports --dry-run for now. No files were written.'));
+      throw new Error(formatError(translator.t('ai.agent.error.repair_requires_dry_run')));
     }
     const plan = buildAgentProfileRepairPlan(repoRoot, {
       includeState: options.json === true,
@@ -3052,7 +3229,7 @@ async function runAgent(repoRoot, options = {}) {
     if (options.json) {
       process.stdout.write(`${JSON.stringify(plan, null, 2)}\n`);
     } else {
-      process.stdout.write(formatAgentRepairPlan(plan));
+      process.stdout.write(formatAgentRepairPlan(plan, options));
     }
     return {
       task: 'agent',
@@ -3062,7 +3239,7 @@ async function runAgent(repoRoot, options = {}) {
     };
   }
 
-  throw new Error(formatError(`unsupported ai agent subcommand: ${command}. Supported tasks: set, list, show, doctor, repair`));
+  throw new Error(formatError(translator.t('ai.agent.error.unsupported_subcommand', { command })));
 }
 
 async function runGitHubTask(repoRoot, options = {}, mode = 'pr') {
@@ -3086,7 +3263,7 @@ async function runGitHubTask(repoRoot, options = {}, mode = 'pr') {
     throw annotateGitHubError(error, mode);
   }
 
-  process.stdout.write(formatPreflightReport(report, { mode, dryRun }));
+  process.stdout.write(formatPreflightReport(report, { mode, dryRun, language: options.language }));
 
   return {
     task: mode,
@@ -3098,10 +3275,11 @@ async function runGitHubTask(repoRoot, options = {}, mode = 'pr') {
 async function runPr(repoRoot, options = {}) {
   const dryRun = options.dryRun === true;
   const create = options.create === true;
+  const translator = createTranslator(options.language);
   const ux = createCommandUx(options);
   const showProgress = create && !dryRun && shouldShowHumanProgress(ux, options);
   if (showProgress) {
-    ux.heading('Creando PR con gh');
+    ux.heading(translator.t('ai.github.progress.heading'));
   }
   let preflight;
 
@@ -3109,9 +3287,9 @@ async function runPr(repoRoot, options = {}) {
     preflight = await runProviderWithProgress({
       ux,
       enabled: showProgress,
-      message: 'Ejecutando preflight de GitHub...',
-      successMessage: 'Preflight de GitHub listo',
-      failureMessage: 'Falló preflight de GitHub',
+      message: translator.t('ai.github.progress.preflight.running'),
+      successMessage: translator.t('ai.github.progress.preflight.done'),
+      failureMessage: translator.t('ai.github.progress.preflight.failed'),
       run: () => (options.preflightFn || preflightGitHubPr)(repoRoot, {
         remote: options.remote,
         sshHostAlias: options.sshHostAlias,
@@ -3139,7 +3317,7 @@ async function runPr(repoRoot, options = {}) {
       title: options.title,
     });
     if (showProgress) {
-      ux.check('Cuerpo del PR preparado');
+      ux.check(translator.t('ai.github.progress.body_ready'));
     }
   } catch (error) {
     throw annotateGitHubError(error, 'pr');
@@ -3171,7 +3349,7 @@ async function runPr(repoRoot, options = {}) {
   }
 
   if (dryRun || !create) {
-    process.stdout.write(formatPrCreateReport({ preflight, plan }, { dryRun, create }));
+    process.stdout.write(formatPrCreateReport({ preflight, plan }, { dryRun, create, language: options.language }));
     return {
       task: 'pr',
       dryRun,
@@ -3188,9 +3366,9 @@ async function runPr(repoRoot, options = {}) {
     result = await runProviderWithProgress({
       ux,
       enabled: showProgress,
-      message: 'Creando PR en GitHub...',
-      successMessage: 'PR creado',
-      failureMessage: 'Falló creación del PR',
+      message: translator.t('ai.github.progress.create.running'),
+      successMessage: translator.t('ai.github.progress.create.done'),
+      failureMessage: translator.t('ai.github.progress.create.failed'),
       run: () => runGhPrCreate(plan, {
         ghCreateRunner: options.ghCreateRunner,
       }),
@@ -3199,7 +3377,7 @@ async function runPr(repoRoot, options = {}) {
     throw annotateGitHubError(error, 'pr');
   }
 
-  process.stdout.write(formatPrCreateReport({ preflight, plan, result }, { dryRun: false, create: true }));
+  process.stdout.write(formatPrCreateReport({ preflight, plan, result }, { dryRun: false, create: true, language: options.language }));
   return {
     task: 'pr',
     dryRun: false,