create-quiver 0.15.3 → 0.15.4

package/src/create-quiver/index.js

@@ -35,6 +35,7 @@ const {
   runSpecsList: runAiSpecsList,
   runTraceReport: runAiTraceReport,
 } = require('./commands/ai');
+const { runConfig } = require('./commands/config');
 const { runDashboard } = require('./commands/dashboard');
 const { runDemo } = require('./commands/demo');
 const { runPrepare } = require('./commands/prepare');
@@ -59,6 +60,16 @@ const { getContextPathExclusionReason } = require('./lib/ai/safety');
 const { selectOption } = require('./lib/cli/selectors');
 const { createUx } = require('./lib/cli/ux');
 const { validateUxFlags } = require('./lib/cli/ux-flags');
+const {
+  DEFAULT_LANGUAGE,
+  extractCliLanguageFlag,
+  normalizeLanguage,
+  readProjectLanguageConfig,
+  resolveLanguage,
+  writeProjectLanguageConfig,
+} = require('./lib/i18n/language');
+const { createTranslator, getCatalog, translate } = require('./lib/i18n/catalog');
+const { formatWarningPrefix } = require('./lib/i18n/read-only-format');
 const { relativePosixPath, resolveTargetRoot } = require('./lib/paths');
 const {
   CURRENT_SCAN_RELATIVE_PATH,
@@ -78,8 +89,60 @@ const {
 const cliPackageJson = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../..', 'package.json'), 'utf8'));
 const CLI_VERSION = cliPackageJson.version || '0.0.0';
 
+let currentErrorLanguage = DEFAULT_LANGUAGE;
+
+function setCurrentErrorLanguage(language) {
+  currentErrorLanguage = language || DEFAULT_LANGUAGE;
+}
+
+function localizeParserMessage(message, language = currentErrorLanguage) {
+  const raw = String(message || '');
+  const missingValue = raw.match(/^missing value for (--[a-z0-9-]+)$/i);
+  if (missingValue) {
+    return translate(language, 'error.flag.missing_value', { flag: missingValue[1] });
+  }
+
+  const invalidValue = raw.match(/^invalid value for (--[a-z0-9-]+)$/i);
+  if (invalidValue) {
+    return translate(language, 'error.flag.invalid_value', { flag: invalidValue[1] });
+  }
+
+  const unknownFlag = raw.match(/^unknown flag: (.+)$/);
+  if (unknownFlag) {
+    return translate(language, 'error.flag.unknown', { flag: unknownFlag[1] });
+  }
+
+  return raw;
+}
+
 function formatError(message) {
-  return `create-quiver: ${message}`;
+  return `create-quiver: ${localizeParserMessage(message)}`;
+}
+
+function helpCatalog(language = DEFAULT_LANGUAGE) {
+  const catalog = getCatalog(language);
+  return catalog.messages['cli.help'] || getCatalog(DEFAULT_LANGUAGE).messages['cli.help'] || {};
+}
+
+function helpText(help, section, key, fallback) {
+  return help?.[section]?.[key] || fallback;
+}
+
+function optionDescription(help, fallback) {
+  return helpText(help, 'optionDescriptions', fallback, fallback);
+}
+
+function formatLanguageWarningForCli(warning, language = DEFAULT_LANGUAGE) {
+  if (!warning || warning.code !== 'UNSUPPORTED_LANGUAGE') {
+    return '';
+  }
+
+  return formatError(translate(language, 'warning.language.unsupported_source', {
+    fallback: warning.fallbackLanguage,
+    language: warning.requestedLanguage,
+    source: warning.source,
+    supported: warning.supportedLanguages.join(', '),
+  }));
 }
 
 const SUPPORTED_COMMAND_MODES = new Set([
@@ -101,6 +164,7 @@ const SUPPORTED_COMMAND_MODES = new Set([
   'new-handoff',
   'cleanup-slice',
   'check-scope',
+  'config',
   'refresh-active-slices',
   'spec',
   'evidence',
@@ -138,13 +202,16 @@ const SUPPORTED_AI_COMMANDS = new Set([
 
 const SUPPORTED_SPEC_COMMANDS = new Set(['close', 'create', 'start', 'status', 'validate']);
 const SUPPORTED_DEMO_COMMANDS = new Set(['create']);
+const SUPPORTED_CONFIG_SECTIONS = new Set(['language']);
+const SUPPORTED_CONFIG_LANGUAGE_COMMANDS = new Set(['show', 'set']);
 
 function unsupportedCommandMessage(commandName) {
+  const translator = createTranslator(currentErrorLanguage);
   return [
-    `unsupported command: ${commandName}`,
-    'Run: npx create-quiver --help',
-    `If you meant to initialize a project, use: npx create-quiver init --name "${commandName}"`,
-    'If this command exists in newer docs, update create-quiver and rerun the command.',
+    translator.t('error.command.unsupported', { commandName }),
+    translator.t('error.command.help'),
+    translator.t('error.command.init_hint', { commandName }),
+    translator.t('error.command.update_hint'),
   ].join('\n');
 }
 
@@ -158,6 +225,7 @@ const COMMAND_HELP_GROUPS = [
       ['flow', 'Show the read-only guided workflow stage, blockers, and next safe command.'],
       ['dashboard', 'Show compact read-only project, spec, slice, run, approval, and agent status.'],
       ['version', 'Show a Quiver-branded version report; use --json for metadata.'],
+      ['config language show|set', 'Inspect or update the effective Quiver language without editing JSON by hand.'],
       ['prepare', 'Run setup diagnostics for providers, GitHub, SSH, and project readiness.'],
       ['migrate', 'Upgrade an already initialized Quiver project to the current contract.'],
     ],
@@ -240,25 +308,29 @@ const COMMAND_HELP_GROUPS = [
   },
 ];
 
-function formatCommandHelpGroups() {
-  const lines = ['Commands:'];
+function formatCommandHelpGroups(language = DEFAULT_LANGUAGE) {
+  const help = helpCatalog(language);
+  const lines = [helpText(help, 'headings', 'commands', 'Commands:')];
   for (const group of COMMAND_HELP_GROUPS) {
-    lines.push('', `${group.title}:`);
+    lines.push('', `${helpText(help, 'groupTitles', group.title, group.title)}:`);
     for (const [command, description] of group.commands) {
-      lines.push(`  ${command.padEnd(24)} ${description}`);
+      lines.push(`  ${command.padEnd(24)} ${helpText(help, 'commandDescriptions', command, description)}`);
     }
   }
   return lines.join('\n');
 }
 
-function printUsage() {
-  console.log(`Usage:
+function printUsage(language = DEFAULT_LANGUAGE) {
+  const help = helpCatalog(language);
+  console.log(`${helpText(help, 'headings', 'usage', 'Usage:')}
   npx create-quiver [options]
   npx create-quiver init [options]
   npx create-quiver analyze [options]
   npx create-quiver flow [options]
   npx create-quiver dashboard [options]
   npx create-quiver version [--json]
+  npx create-quiver config language show [--json]
+  npx create-quiver config language set <en|es> [--global]
   npx create-quiver plan [options]
   npx create-quiver ai <task> [options]
   npx create-quiver ai run create --input <requirements.md>
@@ -297,59 +369,61 @@ function printUsage() {
   npx create-quiver evidence run [options] -- <command>
   npx create-quiver demo create spec-viewer [options]
 
-${formatCommandHelpGroups()}
-
-Options:
-  -n, --name <project-name>   Project name to generate
-  -d, --dir <target-dir>      Target directory to scaffold into or inspect
-      --spec <slug>           Restrict plan, graph, next, or dashboard output to one spec
-      --format <name>         Graph or AI export output format (tree, mermaid, dot, json, markdown)
-      --show-conflicts        Show shared file paths in graph output
-      --level <n>             Restrict graph output to one level
-      --json                  Emit machine-readable JSON
-      --include-completed     Include completed slices in dashboard, plan, graph, or next history output
-      --details               Show the full human dashboard report
-      --section <name>        Show one human dashboard section
-      --limit <n>             Limit dashboard human lists (1-100)
-      --only-ready            Show only slices with no pending dependencies
-      --all-ready             List every ready slice returned by next
-      --auto-start            Prompt for confirmation and run start-slice on next
-      --local                 For check-slice, run structural validation without remote/base checks
-      --strict                Treat supported validation warnings as failures
-      --unicode               Prefer Unicode output when supported
-      --minimal               Plan or run the minimal init profile
-      --full                  Plan or run the full compatibility init profile
-      --legacy-scripts        Include legacy Bash wrappers in init profile
-      --include-templates     Export packaged templates in init profile
-      --dry-run               Preview init, analyze, migrate, prepare, spec create/start/close, demo, ai agent set, or AI work without executing writes/providers
-      --print-prompt          Print the exact AI prompt and exit without executing provider CLIs
-      --with-planner          Enable planner-assisted behavior on commands that explicitly support it
-      --interactive           Enable prompts on commands that explicitly support interactive choices
-      --review                Open or prepare human review before persistent writes where supported
-      --methodology <name>    Select methodology where supported (currently wdd-sdd)
-      --no-color              Disable ANSI colors in human output
-      --fix                   For doctor, apply safe non-destructive repairs
-      --execute               For ai execute-plan, run the planned slices instead of printing commands
-      --create                For ai pr, create the PR after preflight instead of printing the plan only
-      --commit                For ai execute-slice, commit validated slice changes after provider, scope, and tests pass
-      --allow-dirty           For ai execute-slice, allow pre-existing dirty files and ignore them for scope diff
-      --mode <name>           Execution mode for ai execute-plan (auto, manual, delegated)
-      --provider <name>       Provider CLI to preflight for prepare or AI commands
-      --model <model-id>      Technical model id for AI agent profiles or provider-backed AI commands
-      --version <n>           Draft version to approve for AI planner phases
-      --run <id>              AI lifecycle run id
-      --ssh-host-alias <name> SSH host alias to validate for prepare or AI commands
-      --identity-file <path>  SSH identity file to validate for prepare or AI commands
-      --remote <name>         Git remote name for check-slice or AI PR checks
-      --base <branch>         Base branch for check-slice, check-scope, ai pr, or spec close (default: main)
-      --output <file>         Output file for evidence run
-      --max-output <n>        Maximum stdout/stderr chars per evidence section
-      --title <text>          Override PR title for ai pr create
-  -y, --yes                   Skip prompts and use the provided inputs
-  -V, --version               Show the installed create-quiver version
-  -h, --help                  Show this help message
-
-Examples:
+${formatCommandHelpGroups(language)}
+
+${helpText(help, 'headings', 'options', 'Options:')}
+  -n, --name <project-name>   ${optionDescription(help, 'Project name to generate')}
+  -d, --dir <target-dir>      ${optionDescription(help, 'Target directory to scaffold into or inspect')}
+      --spec <slug>           ${optionDescription(help, 'Restrict plan, graph, next, or dashboard output to one spec')}
+      --format <name>         ${optionDescription(help, 'Graph or AI export output format (tree, mermaid, dot, json, markdown)')}
+      --show-conflicts        ${optionDescription(help, 'Show shared file paths in graph output')}
+      --level <n>             ${optionDescription(help, 'Restrict graph output to one level')}
+      --json                  ${optionDescription(help, 'Emit machine-readable JSON')}
+      --lang <en|es>          ${optionDescription(help, 'Override CLI human output language')}
+      --global                ${optionDescription(help, 'For config language set, write the global user config')}
+      --include-completed     ${optionDescription(help, 'Include completed slices in dashboard, plan, graph, or next history output')}
+      --details               ${optionDescription(help, 'Show the full human dashboard report')}
+      --section <name>        ${optionDescription(help, 'Show one human dashboard section')}
+      --limit <n>             ${optionDescription(help, 'Limit dashboard human lists (1-100)')}
+      --only-ready            ${optionDescription(help, 'Show only slices with no pending dependencies')}
+      --all-ready             ${optionDescription(help, 'List every ready slice returned by next')}
+      --auto-start            ${optionDescription(help, 'Prompt for confirmation and run start-slice on next')}
+      --local                 ${optionDescription(help, 'For check-slice, run structural validation without remote/base checks')}
+      --strict                ${optionDescription(help, 'Treat supported validation warnings as failures')}
+      --unicode               ${optionDescription(help, 'Prefer Unicode output when supported')}
+      --minimal               ${optionDescription(help, 'Plan or run the minimal init profile')}
+      --full                  ${optionDescription(help, 'Plan or run the full compatibility init profile')}
+      --legacy-scripts        ${optionDescription(help, 'Include legacy Bash wrappers in init profile')}
+      --include-templates     ${optionDescription(help, 'Export packaged templates in init profile')}
+      --dry-run               ${optionDescription(help, 'Preview init, analyze, migrate, prepare, spec create/start/close, demo, ai agent set, or AI work without executing writes/providers')}
+      --print-prompt          ${optionDescription(help, 'Print the exact AI prompt and exit without executing provider CLIs')}
+      --with-planner          ${optionDescription(help, 'Enable planner-assisted behavior on commands that explicitly support it')}
+      --interactive           ${optionDescription(help, 'Enable prompts on commands that explicitly support interactive choices')}
+      --review                ${optionDescription(help, 'Open or prepare human review before persistent writes where supported')}
+      --methodology <name>    ${optionDescription(help, 'Select methodology where supported (currently wdd-sdd)')}
+      --no-color              ${optionDescription(help, 'Disable ANSI colors in human output')}
+      --fix                   ${optionDescription(help, 'For doctor, apply safe non-destructive repairs')}
+      --execute               ${optionDescription(help, 'For ai execute-plan, run the planned slices instead of printing commands')}
+      --create                ${optionDescription(help, 'For ai pr, create the PR after preflight instead of printing the plan only')}
+      --commit                ${optionDescription(help, 'For ai execute-slice, commit validated slice changes after provider, scope, and tests pass')}
+      --allow-dirty           ${optionDescription(help, 'For ai execute-slice, allow pre-existing dirty files and ignore them for scope diff')}
+      --mode <name>           ${optionDescription(help, 'Execution mode for ai execute-plan (auto, manual, delegated)')}
+      --provider <name>       ${optionDescription(help, 'Provider CLI to preflight for prepare or AI commands')}
+      --model <model-id>      ${optionDescription(help, 'Technical model id for AI agent profiles or provider-backed AI commands')}
+      --version <n>           ${optionDescription(help, 'Draft version to approve for AI planner phases')}
+      --run <id>              ${optionDescription(help, 'AI lifecycle run id')}
+      --ssh-host-alias <name> ${optionDescription(help, 'SSH host alias to validate for prepare or AI commands')}
+      --identity-file <path>  ${optionDescription(help, 'SSH identity file to validate for prepare or AI commands')}
+      --remote <name>         ${optionDescription(help, 'Git remote name for check-slice or AI PR checks')}
+      --base <branch>         ${optionDescription(help, 'Base branch for check-slice, check-scope, ai pr, or spec close (default: main)')}
+      --output <file>         ${optionDescription(help, 'Output file for evidence run')}
+      --max-output <n>        ${optionDescription(help, 'Maximum stdout/stderr chars per evidence section')}
+      --title <text>          ${optionDescription(help, 'Override PR title for ai pr create')}
+  -y, --yes                   ${optionDescription(help, 'Skip prompts and use the provided inputs')}
+  -V, --version               ${optionDescription(help, 'Show the installed create-quiver version')}
+  -h, --help                  ${optionDescription(help, 'Show this help message')}
+
+${helpText(help, 'headings', 'examples', 'Examples:')}
   npx create-quiver init --name "My Project"
   npx create-quiver init --interactive
   npx create-quiver init --name "My Project" --dry-run
@@ -361,6 +435,9 @@ Examples:
   cd ./my-project && npx create-quiver dashboard --json
   cd ./my-project && npx create-quiver version
   cd ./my-project && npx create-quiver version --json
+  cd ./my-project && npx create-quiver config language show
+  cd ./my-project && npx create-quiver config language set es
+  npx create-quiver config language set en --global
   cd ./my-project && npx create-quiver analyze
   cd ./my-project && npx create-quiver plan --json
   cd ./my-project && npx create-quiver ai onboard --dry-run
@@ -428,7 +505,7 @@ Examples:
 `);
 }
 
-function parseArgs(argv) {
+function parseArgs(argv, options = {}) {
   const result = {
     help: false,
     force: false,
@@ -448,8 +525,14 @@ function parseArgs(argv) {
     strict: false,
     strictOverlap: false,
     json: false,
+    language: options.language || '',
+    languageResolution: null,
     noColor: false,
     withPlanner: false,
+    configGlobal: false,
+    configSection: '',
+    configCommand: '',
+    configValue: '',
     interactive: false,
     review: false,
     includeCompleted: false,
@@ -700,6 +783,11 @@ function parseArgs(argv) {
       continue;
     }
 
+    if (arg === '--global') {
+      result.configGlobal = true;
+      continue;
+    }
+
     if (arg === '--with-planner') {
       result.withPlanner = true;
       continue;
@@ -1104,6 +1192,28 @@ function parseArgs(argv) {
     if (positional.length > 0) {
       throw new Error(formatError('dashboard does not accept positional arguments; use --spec <slug>'));
     }
+  } else if (result.mode === 'config') {
+    if (!result.configSection && positional.length > 0) {
+      result.configSection = positional.shift();
+    }
+    if (!SUPPORTED_CONFIG_SECTIONS.has(result.configSection)) {
+      throw new Error(formatError(`unsupported config section: ${result.configSection || '(missing)'}. Supported sections: language`));
+    }
+    if (!result.configCommand && positional.length > 0) {
+      result.configCommand = positional.shift();
+    }
+    if (!SUPPORTED_CONFIG_LANGUAGE_COMMANDS.has(result.configCommand)) {
+      throw new Error(formatError(`unsupported config language command: ${result.configCommand || '(missing)'}. Supported commands: show, set`));
+    }
+    if (result.configCommand === 'set') {
+      if (positional.length === 0) {
+        throw new Error(formatError('missing language for config language set. Use: npx create-quiver config language set <en|es>'));
+      }
+      result.configValue = positional.shift();
+    }
+    if (result.configCommand === 'show' && positional.length > 0) {
+      throw new Error(formatError('config language show does not accept a language value'));
+    }
   } else if (result.mode === 'ai') {
     if (!result.aiCommand && positional.length > 0) {
       result.aiCommand = positional.shift();
@@ -1205,6 +1315,14 @@ function parseArgs(argv) {
     throw new Error(formatError(`${requestedDashboardFlags.join(', ')} ${requestedDashboardFlags.length === 1 ? 'is' : 'are'} only supported by dashboard. Use: npx create-quiver dashboard ${requestedDashboardFlags[0]}${requestedDashboardFlags[0] === '--section' ? ' <name>' : requestedDashboardFlags[0] === '--limit' ? ' <n>' : ''}`));
   }
 
+  if (result.mode !== 'config' && result.configGlobal) {
+    throw new Error(formatError('--global is only supported by config language set. Use: npx create-quiver config language set <en|es> --global'));
+  }
+
+  if (result.mode === 'config' && result.configGlobal && result.configCommand !== 'set') {
+    throw new Error(formatError('--global is only supported by config language set. Use: npx create-quiver config language set <en|es> --global'));
+  }
+
   return result;
 }
 
@@ -1349,6 +1467,7 @@ function runInitDocs(repoRoot, projectName, options = {}) {
     migrateMode: false,
     profile: options.profile || 'default',
     templateRoot: templateRoot.path,
+    language: options.language || '',
   });
 }
 
@@ -2204,6 +2323,7 @@ function writeProjectScanArtifacts(projectRoot, scan) {
 
 function runAnalyze(targetDir, options = {}) {
   const projectRoot = resolveTargetRoot(process.cwd(), targetDir);
+  const translator = createTranslator(options.language);
 
   if (!fs.existsSync(projectRoot)) {
     throw new Error(formatError(`target directory does not exist: ${projectRoot}`));
@@ -2212,14 +2332,14 @@ function runAnalyze(targetDir, options = {}) {
   const scan = buildProjectScan(projectRoot);
 
   if (options.dryRun) {
-    console.log(`Project analysis dry-run for ${projectRoot}`);
-    console.log('Writes: none');
-    console.log(`Would write ${CURRENT_SCAN_RELATIVE_PATH}`);
-    console.log(`Would write ${PROJECT_MAP_RELATIVE_PATH}`);
-    console.log('Would refresh docs/AI_CONTEXT.md');
-    console.log(`Detected primary stack: ${scan.stack.primary}`);
-    console.log(`Detected frameworks: ${scan.stack.frameworks.length > 0 ? scan.stack.frameworks.join(', ') : 'none detected'}`);
-    console.log(`Detected package manager: ${scan.project.package_manager}`);
+    console.log(translator.t('analyze.dry_run_for', { path: projectRoot }));
+    console.log(translator.t('analyze.writes_none'));
+    console.log(translator.t('analyze.would_write', { path: CURRENT_SCAN_RELATIVE_PATH }));
+    console.log(translator.t('analyze.would_write', { path: PROJECT_MAP_RELATIVE_PATH }));
+    console.log(translator.t('analyze.would_refresh', { path: 'docs/AI_CONTEXT.md' }));
+    console.log(translator.t('analyze.detected_primary_stack', { stack: scan.stack.primary }));
+    console.log(translator.t('analyze.detected_frameworks', { frameworks: scan.stack.frameworks.length > 0 ? scan.stack.frameworks.join(', ') : translator.t('common.none_detected') }));
+    console.log(translator.t('analyze.detected_package_manager', { manager: scan.project.package_manager }));
     return {
       artifacts: {
         jsonPath: path.join(projectRoot, CURRENT_SCAN_RELATIVE_PATH),
@@ -2234,12 +2354,12 @@ function runAnalyze(targetDir, options = {}) {
   const aiContextPath = refreshAiContextDoc(projectRoot, scan);
   updateStateForAnalyze(projectRoot, CLI_VERSION);
 
-  console.log(`Project analysis completed for ${projectRoot}`);
-  console.log(`Wrote ${relativePosixPath(projectRoot, artifacts.jsonPath)}`);
-  console.log(`Wrote ${relativePosixPath(projectRoot, artifacts.mdPath)}`);
-  console.log(`Wrote ${relativePosixPath(projectRoot, aiContextPath)}`);
-  console.log(`Detected primary stack: ${scan.stack.primary}`);
-  console.log(`Detected package manager: ${scan.project.package_manager}`);
+  console.log(translator.t('analyze.completed_for', { path: projectRoot }));
+  console.log(translator.t('analyze.wrote', { path: relativePosixPath(projectRoot, artifacts.jsonPath) }));
+  console.log(translator.t('analyze.wrote', { path: relativePosixPath(projectRoot, artifacts.mdPath) }));
+  console.log(translator.t('analyze.wrote', { path: relativePosixPath(projectRoot, aiContextPath) }));
+  console.log(translator.t('analyze.detected_primary_stack', { stack: scan.stack.primary }));
+  console.log(translator.t('analyze.detected_package_manager', { manager: scan.project.package_manager }));
 
   return {
     artifacts,
@@ -2251,6 +2371,7 @@ function runAnalyze(targetDir, options = {}) {
 
 function runMigrate(targetDir, options = {}) {
   const projectRoot = resolveTargetRoot(process.cwd(), targetDir);
+  const translator = createTranslator(options.language);
 
   if (!fs.existsSync(projectRoot)) {
     throw new Error(formatError(`target directory does not exist: ${projectRoot}`));
@@ -2273,17 +2394,17 @@ function runMigrate(targetDir, options = {}) {
       projectName,
       skipInstall: options.skipInstall === true,
     });
-    console.log('Quiver migration dry-run');
-    console.log(`- Project: ${projectName}`);
-    console.log(`- Target: ${projectRoot}`);
-    console.log('- Writes: none');
-    console.log(`- Planned create: ${migrationPlan.summary.create}`);
-    console.log(`- Planned update: ${migrationPlan.summary.update}`);
-    console.log(`- Planned preserve: ${migrationPlan.summary.preserve}`);
+    console.log(translator.t('migrate.dry_run_title'));
+    console.log(`- ${translator.t('migrate.project', { project: projectName })}`);
+    console.log(`- ${translator.t('migrate.target', { path: projectRoot })}`);
+    console.log(`- ${translator.t('migrate.writes_none')}`);
+    console.log(`- ${translator.t('migrate.planned_create', { count: migrationPlan.summary.create })}`);
+    console.log(`- ${translator.t('migrate.planned_update', { count: migrationPlan.summary.update })}`);
+    console.log(`- ${translator.t('migrate.planned_preserve', { count: migrationPlan.summary.preserve })}`);
     if (legacyLayout.hasLegacyLayout) {
-      console.log(`- Legacy layout detected and preserved: ${legacyLayout.legacyPaths.join(', ')}`);
+      console.log(`- ${translator.t('migrate.legacy_preserved', { paths: legacyLayout.legacyPaths.join(', ') })}`);
     }
-    console.log('- Next command: npx create-quiver migrate --skip-install');
+    console.log(`- ${translator.t('migrate.next_command', { command: 'npx create-quiver migrate --skip-install' })}`);
     console.log('');
     console.log(formatInitLayoutPlan(migrationPlan));
     return;
@@ -2314,10 +2435,10 @@ function runMigrate(targetDir, options = {}) {
       }
     }
 
-    console.log(`Quiver migration completed for ${projectRoot}`);
-    console.log('Missing workflow files were restored without overwriting existing project files.');
+    console.log(translator.t('migrate.completed_for', { path: projectRoot }));
+    console.log(translator.t('migrate.restored_missing'));
     if (legacyLayout.hasLegacyLayout) {
-      console.log(`Legacy layout detected and preserved: ${legacyLayout.legacyPaths.join(', ')}`);
+      console.log(translator.t('migrate.legacy_preserved', { paths: legacyLayout.legacyPaths.join(', ') }));
     }
   } finally {
     fs.rmSync(tempRoot, { recursive: true, force: true });
@@ -2558,6 +2679,7 @@ function buildDoctorCommandReport(projectRoot) {
 }
 
 function formatDoctorHumanReport(report, options = {}) {
+  const translator = createTranslator(options.language);
   const lines = [];
   const ux = createUx({
     ...options,
@@ -2574,19 +2696,39 @@ function formatDoctorHumanReport(report, options = {}) {
     if (status === 'error') return 'error';
     return 'warning';
   };
+  const localizeDoctorText = (message) => {
+    const text = String(message || '');
+    let match = text.match(/^Quiver doctor passed for (.+)$/);
+    if (match) return translator.t('doctor.check.passed_for', { path: match[1] });
+    match = text.match(/^Layout: (.+)$/);
+    if (match) return translator.t('doctor.check.layout', { layout: match[1] });
+    if (text === 'Specs: none yet') return translator.t('doctor.check.specs_none');
+    match = text.match(/^Specs: (.+)$/);
+    if (match) return translator.t('doctor.check.specs_found', { specs: match[1] });
+    if (text === 'Required files found') return translator.t('doctor.check.required_files_found');
+    if (text === 'Workflow scripts available') return translator.t('doctor.check.workflow_scripts_available');
+    if (text === 'Quiver state metadata found') return translator.t('doctor.check.state_found');
+    if (text === 'Project analysis artifacts found') return translator.t('doctor.check.project_analysis_found');
+    if (text === 'No specs yet. That is valid after the AI-first init flow.') return translator.t('doctor.fix.no_specs_yet');
+    if (text === 'Run `npx create-quiver analyze` to generate docs/PROJECT_MAP.md when you want the visible project map.') return translator.t('doctor.fix.generate_project_map');
+    if (text === 'Analyze the project first: npx create-quiver analyze') return translator.t('doctor.fix.analyze_first');
+    if (text === 'Check the next ready slice: npx create-quiver next') return translator.t('doctor.fix.check_next');
+    if (text === 'Create real specs and slices only after acceptance criteria are approved and the technical plan is reviewed and approved.') return translator.t('doctor.fix.create_specs_after_approval');
+    return formatWarningPrefix(text, translator);
+  };
 
-  ux.section('Quiver Doctor');
+  ux.section(translator.t('doctor.title'));
   ux.line('');
-  ux.line('Checks');
+  ux.line(translator.t('doctor.checks'));
   for (const check of report.checks) {
-    const line = `  ${symbolForStatus(check.status)} ${check.message}`;
+    const line = `  ${symbolForStatus(check.status)} ${localizeDoctorText(check.message)}`;
     ux.line(ux.mode.decoration ? ux.theme.status(colorForStatus(check.status), line) : line);
   }
 
   ux.line('');
-  ux.line('Suggested fixes');
+  ux.line(translator.t('doctor.suggested_fixes'));
   for (const fix of report.suggested_fixes) {
-    const line = `  ${ux.theme.symbols.bullet} ${fix}`;
+    const line = `  ${ux.theme.symbols.bullet} ${localizeDoctorText(fix)}`;
     ux.line(ux.mode.decoration ? ux.theme.status('command', line) : line);
   }
 
@@ -2640,6 +2782,74 @@ const INIT_PROFILE_OPTIONS = Object.freeze([
   },
 ]);
 
+function initModeOptions(translator) {
+  return [
+    {
+      label: translator.t('init.mode.existing.label'),
+      value: 'existing',
+      hint: translator.t('init.mode.existing.hint'),
+      default: true,
+    },
+    {
+      label: translator.t('init.mode.new.label'),
+      value: 'new',
+      hint: translator.t('init.mode.new.hint'),
+    },
+    {
+      label: translator.t('init.mode.validate.label'),
+      value: 'validate',
+      hint: translator.t('init.mode.validate.hint'),
+    },
+  ];
+}
+
+function methodologyOptions(translator) {
+  return [
+    {
+      label: translator.t('init.methodology.wdd_sdd.label'),
+      value: 'wdd-sdd',
+      hint: translator.t('init.methodology.wdd_sdd.hint'),
+      default: true,
+    },
+  ];
+}
+
+function initProfileOptions(translator) {
+  return [
+    {
+      label: 'Default',
+      value: 'default',
+      hint: translator.t('init.profile.default.hint'),
+      default: true,
+    },
+    {
+      label: 'Minimal',
+      value: 'minimal',
+      hint: translator.t('init.profile.minimal.hint'),
+    },
+    {
+      label: 'Full compatibility',
+      value: 'full',
+      hint: translator.t('init.profile.full.hint'),
+    },
+  ];
+}
+
+function initLanguageOptions() {
+  return [
+    {
+      label: 'English',
+      value: 'en',
+      hint: 'en',
+    },
+    {
+      label: 'Español',
+      value: 'es',
+      hint: 'es',
+    },
+  ];
+}
+
 function hasDirectoryContent(dirPath) {
   return fs.existsSync(dirPath)
     && fs.statSync(dirPath).isDirectory()
@@ -2657,8 +2867,16 @@ function assertSupportedMethodology(value) {
   return normalized;
 }
 
+function resolveExistingProjectLanguage(targetDir) {
+  const config = readProjectLanguageConfig(targetDir);
+  return normalizeLanguage(config.language);
+}
+
 async function resolveInteractiveInitOptions(args, targetDir, projectName, options = {}) {
   const explicitMethodology = assertSupportedMethodology(args.methodology);
+  const language = normalizeLanguage(options.language || args.language) || DEFAULT_LANGUAGE;
+  const translator = createTranslator(language);
+  const existingProjectLanguage = resolveExistingProjectLanguage(targetDir);
 
   if (args.interactive !== true) {
     return {
@@ -2669,6 +2887,7 @@ async function resolveInteractiveInitOptions(args, targetDir, projectName, optio
       methodology: explicitMethodology,
       minimal: args.initMinimal,
       projectName,
+      language: '',
     };
   }
 
@@ -2702,58 +2921,66 @@ async function resolveInteractiveInitOptions(args, targetDir, projectName, optio
     stdoutIsTTY: options.stdoutIsTTY,
   };
 
-  ux.heading('Bienvenido a Quiver');
-  const selectedMode = await selectOption('¿Qué querés configurar?', INIT_MODE_OPTIONS, {
+  ux.heading(translator.t('init.heading'));
+  const selectedMode = await selectOption(translator.t('init.prompt.mode'), initModeOptions(translator), {
     ...selectorOptions,
     defaultValue: hasDirectoryContent(targetDir) ? 'existing' : 'new',
     flag: 'init|doctor',
     name: 'init mode',
   });
-  const selectedMethodology = await selectOption('¿Qué metodología vas a usar?', METHODOLOGY_OPTIONS, {
+  const selectedMethodology = await selectOption(translator.t('init.prompt.methodology'), methodologyOptions(translator), {
     ...selectorOptions,
     defaultValue: explicitMethodology,
     flag: '--methodology',
     name: 'methodology',
     value: args.methodology || '',
   });
+  const selectedLanguage = await selectOption(translator.t('init.prompt.language'), initLanguageOptions(), {
+    ...selectorOptions,
+    defaultValue: existingProjectLanguage || language,
+    flag: '--lang|config language set',
+    name: 'project language',
+  });
 
   assertSupportedMethodology(selectedMethodology.value);
 
   if (selectedMode.value === 'validate') {
     ux.summary([
-      { label: 'Modo', value: 'Solo validar estructura' },
-      { label: 'Metodologia', value: selectedMethodology.label },
-      { label: 'Comando equivalente', value: 'npx create-quiver doctor' },
-    ], { title: 'Configuracion elegida' });
+      { label: translator.t('init.summary.mode'), value: selectedMode.label },
+      { label: translator.t('init.summary.methodology'), value: selectedMethodology.label },
+      { label: translator.t('init.summary.language'), value: selectedLanguage.value },
+      { label: translator.t('init.summary.equivalent_command'), value: 'npx create-quiver doctor' },
+    ], { title: translator.t('init.summary.title') });
     if (!args.force && !args.dryRun) {
-      const confirmed = await ux.promptConfirm('Ejecutar Doctor ahora?', { initialValue: true });
+      const confirmed = await ux.promptConfirm(translator.t('init.confirm.doctor'), { initialValue: true });
       if (!confirmed) {
         throw new Error(formatError('init interactive validation declined. No files were written.'));
       }
     }
     return {
       action: 'doctor',
+      language: selectedLanguage.value,
       methodology: selectedMethodology.value,
       projectName,
     };
   }
 
   const defaultProfile = args.initFull ? 'full' : args.initMinimal ? 'minimal' : 'default';
-  const selectedProfile = await selectOption('¿Qué contrato inicial querés crear?', INIT_PROFILE_OPTIONS, {
+  const selectedProfile = await selectOption(translator.t('init.prompt.profile'), initProfileOptions(translator), {
     ...selectorOptions,
     defaultValue: defaultProfile,
     flag: '--minimal|--full',
     name: 'init profile',
   });
-  const agentGuidance = await selectOption('¿Querés ver el próximo paso para perfiles de agentes?', [
+  const agentGuidance = await selectOption(translator.t('init.prompt.agent_guidance'), [
     {
-      label: 'Mostrar comandos sugeridos',
+      label: translator.t('init.agent_guidance.show.label'),
       value: 'show',
-      hint: 'No guarda credenciales ni ejecuta proveedores',
+      hint: translator.t('init.agent_guidance.show.hint'),
       default: true,
     },
     {
-      label: 'Omitir por ahora',
+      label: translator.t('init.agent_guidance.skip.label'),
       value: 'skip',
     },
   ], {
@@ -2766,28 +2993,30 @@ async function resolveInteractiveInitOptions(args, targetDir, projectName, optio
     full: selectedProfile.value === 'full',
     includeTemplates: args.initIncludeTemplates || selectedProfile.value === 'full',
     legacyScripts: args.initLegacyScripts,
+    language: selectedLanguage.value,
     methodology: selectedMethodology.value,
     minimal: selectedProfile.value === 'minimal',
     projectName,
   };
 
   ux.summary([
-    { label: 'Proyecto', value: projectName },
-    { label: 'Modo', value: selectedMode.label },
-    { label: 'Metodologia', value: selectedMethodology.label },
-    { label: 'Perfil', value: selectedProfile.label },
-    { label: 'Perfiles de agentes', value: agentGuidance.value === 'show' ? 'mostrar proximo paso' : 'omitir' },
-  ], { title: 'Configuracion elegida' });
+    { label: translator.t('init.summary.project'), value: projectName },
+    { label: translator.t('init.summary.mode'), value: selectedMode.label },
+    { label: translator.t('init.summary.methodology'), value: selectedMethodology.label },
+    { label: translator.t('init.summary.language'), value: selectedLanguage.value },
+    { label: translator.t('init.summary.profile'), value: selectedProfile.label },
+    { label: translator.t('init.summary.agent_profiles'), value: agentGuidance.value === 'show' ? translator.t('init.agent_guidance.show.summary') : translator.t('init.agent_guidance.skip.summary') },
+  ], { title: translator.t('init.summary.title') });
 
   if (agentGuidance.value === 'show') {
     ux.nextSteps([
       'npx create-quiver ai agent set planner --provider codex --model gpt-5.5 --dry-run',
       'npx create-quiver ai agent set executor --provider claude --model claude-sonnet-4-6 --dry-run',
-    ], { title: 'Despues de inicializar' });
+    ], { title: translator.t('init.next_steps.after_init') });
   }
 
   if (!args.force && !args.dryRun) {
-    const confirmed = await ux.promptConfirm(`Inicializar Quiver en ${targetDir}?`, { initialValue: true });
+    const confirmed = await ux.promptConfirm(translator.t('init.confirm.initialize', { path: targetDir }), { initialValue: true });
     if (!confirmed) {
       throw new Error(formatError('init interactive approval declined. No files were written.'));
     }
@@ -2799,6 +3028,46 @@ async function resolveInteractiveInitOptions(args, targetDir, projectName, optio
   };
 }
 
+function persistInitLanguage(targetDir, initOptions = {}) {
+  if (!initOptions.language) {
+    return null;
+  }
+  writeProjectLanguageConfig(targetDir, initOptions.language);
+  return {
+    language: initOptions.language,
+    path: path.join(targetDir, '.quiver', 'config.json'),
+  };
+}
+
+function resolveInitGeneratedLanguage(args, targetDir, initOptions = {}) {
+  if (initOptions.language) {
+    return {
+      configLanguage: initOptions.language,
+      docsLanguage: initOptions.language,
+    };
+  }
+
+  if (args.languageResolution?.source === '--lang') {
+    return {
+      configLanguage: args.language,
+      docsLanguage: args.language,
+    };
+  }
+
+  const existingProjectLanguage = resolveExistingProjectLanguage(targetDir);
+  if (existingProjectLanguage) {
+    return {
+      configLanguage: existingProjectLanguage,
+      docsLanguage: existingProjectLanguage,
+    };
+  }
+
+  return {
+    configLanguage: '',
+    docsLanguage: args.language || DEFAULT_LANGUAGE,
+  };
+}
+
 function runDoctor(targetDir, options = {}) {
   const projectRoot = resolveTargetRoot(process.cwd(), targetDir);
 
@@ -2837,6 +3106,7 @@ function runDoctor(targetDir, options = {}) {
     console.log(JSON.stringify(commandReport, null, 2));
   } else {
     process.stdout.write(formatDoctorHumanReport(commandReport, {
+      language: options.language,
       noColor: options.noColor,
       unicode: options.unicode,
     }));
@@ -2847,38 +3117,75 @@ function runDoctor(targetDir, options = {}) {
   }
 }
 
-function printInitNextSteps(targetDir, projectName) {
+function printInitNextSteps(targetDir, projectName, options = {}) {
+  const translator = createTranslator(options.language);
   console.log('');
-  console.log('Next steps:');
-  console.log(`- Review AGENTS.md, then ${path.join(targetDir, 'docs', 'AI_ONBOARDING_PROMPT.md')}`);
-  console.log(`- Review ${path.join(targetDir, 'docs', 'WORKFLOW.md')}`);
-  console.log('- Analyze the project with npx create-quiver analyze');
-  console.log('- Create real specs and slices after acceptance criteria are approved and the technical plan is reviewed and approved.');
+  console.log(translator.t('init.next_steps.title'));
+  console.log(`- ${translator.t('init.next_steps.review_agents', { path: path.join(targetDir, 'docs', 'AI_ONBOARDING_PROMPT.md') })}`);
+  console.log(`- ${translator.t('init.next_steps.review_workflow', { path: path.join(targetDir, 'docs', 'WORKFLOW.md') })}`);
+  console.log(`- ${translator.t('init.next_steps.analyze')}`);
+  console.log(`- ${translator.t('init.next_steps.create_specs')}`);
 }
 
 async function run(argv) {
-  if (argv.length === 1 && argv[0] === 'help') {
-    printUsage();
+  let languageArgs;
+  try {
+    languageArgs = extractCliLanguageFlag(argv);
+  } catch (error) {
+    const languageResolution = resolveLanguage({
+      env: process.env,
+      projectRoot: process.cwd(),
+    });
+    setCurrentErrorLanguage(languageResolution.language);
+    throw new Error(formatError(error.message));
+  }
+
+  const normalizedArgv = languageArgs.argv;
+  const languageResolution = resolveLanguage({
+    cliLanguage: languageArgs.language,
+    env: process.env,
+    projectRoot: process.cwd(),
+  });
+  setCurrentErrorLanguage(languageResolution.language);
+
+  if (normalizedArgv.length === 1 && normalizedArgv[0] === 'help') {
+    printUsage(languageResolution.language);
     return;
   }
 
-  if (argv.length === 1 && (argv[0] === '-V' || argv[0] === '--version')) {
+  if (normalizedArgv.length === 1 && (normalizedArgv[0] === '-V' || normalizedArgv[0] === '--version')) {
     console.log(CLI_VERSION);
     return;
   }
 
-  const args = parseArgs(argv);
+  const args = parseArgs(normalizedArgv, {
+    language: languageArgs.language,
+  });
+  args.languageResolution = languageResolution;
+  args.language = args.languageResolution.language;
 
   if (args.help) {
-    printUsage();
+    if (!args.json) {
+      for (const warning of args.languageResolution.warnings || []) {
+        process.stderr.write(`${formatLanguageWarningForCli(warning, args.language)}\n`);
+      }
+    }
+    printUsage(args.language);
     return;
   }
 
   validateUxFlags(args);
 
+  if (!args.json) {
+    for (const warning of args.languageResolution.warnings || []) {
+      process.stderr.write(`${formatLanguageWarningForCli(warning, args.language)}\n`);
+    }
+  }
+
   if (args.mode === 'analyze') {
     runAnalyze(args.targetDir, {
       dryRun: args.dryRun,
+      language: args.language,
     });
     return;
   }
@@ -2886,6 +3193,7 @@ async function run(argv) {
   if (args.mode === 'flow') {
     await runFlow(process.cwd(), {
       json: args.json,
+      language: args.language,
     });
     return;
   }
@@ -2895,6 +3203,7 @@ async function run(argv) {
       details: args.dashboardDetails,
       includeCompleted: args.includeCompleted,
       json: args.json,
+      language: args.language,
       limit: args.dashboardLimit,
       noColor: args.noColor,
       optionErrors: args.dashboardOptionErrors,
@@ -2914,6 +3223,7 @@ async function run(argv) {
     } else {
       process.stdout.write(formatHumanVersionReport(report, {
         env: process.env,
+        language: args.language,
         noColor: args.noColor,
         stdoutIsTTY: Boolean(process.stdout.isTTY),
       }));
@@ -2921,10 +3231,23 @@ async function run(argv) {
     return;
   }
 
+  if (args.mode === 'config') {
+    runConfig(process.cwd(), {
+      command: args.configCommand,
+      global: args.configGlobal,
+      json: args.json,
+      languageResolution: args.languageResolution,
+      section: args.configSection,
+      value: args.configValue,
+    });
+    return;
+  }
+
   if (args.mode === 'plan') {
     runPlan(process.cwd(), {
       includeCompleted: args.includeCompleted,
       json: args.json,
+      language: args.language,
       onlyReady: args.onlyReady,
       specSlug: args.specSlug,
       unicode: args.unicode,
@@ -2951,6 +3274,7 @@ async function run(argv) {
       runAiLifecycleRun(process.cwd(), {
         command: args.aiRunCommand,
         input: args.aiInput || undefined,
+        language: args.language,
         runId: args.aiRunId || undefined,
         specSlug: args.specSlug || undefined,
       });
@@ -2961,12 +3285,14 @@ async function run(argv) {
       runAiActiveSlice(process.cwd(), {
         command: args.aiSecondaryCommand || 'status',
         dryRun: args.dryRun,
+        language: args.language,
       });
       return;
     }
 
     if (args.aiCommand === 'status') {
       runAiLifecycleStatus(process.cwd(), {
+        language: args.language,
         runId: args.aiRunId || undefined,
       });
       return;
@@ -2974,6 +3300,7 @@ async function run(argv) {
 
     if (args.aiCommand === 'resume') {
       runAiLifecycleResume(process.cwd(), {
+        language: args.language,
         runId: args.aiRunId || undefined,
       });
       return;
@@ -2982,6 +3309,7 @@ async function run(argv) {
     if (args.aiCommand === 'inspect') {
       runAiInspect(process.cwd(), {
         includeCompleted: args.includeCompleted,
+        language: args.language,
       });
       return;
     }
@@ -2990,6 +3318,7 @@ async function run(argv) {
       runAiExport(process.cwd(), {
         format: args.formatExplicit ? args.format : 'json',
         includeCompleted: args.includeCompleted,
+        language: args.language,
       });
       return;
     }
@@ -2998,6 +3327,7 @@ async function run(argv) {
       runAiSpecsList(process.cwd(), {
         includeCompleted: args.includeCompleted,
         json: args.json,
+        language: args.language,
       });
       return;
     }
@@ -3006,6 +3336,7 @@ async function run(argv) {
       runAiSlicesList(process.cwd(), {
         includeCompleted: args.includeCompleted,
         json: args.json,
+        language: args.language,
       });
       return;
     }
@@ -3013,6 +3344,7 @@ async function run(argv) {
     if (args.aiCommand === 'trace') {
       runAiTraceReport(process.cwd(), {
         includeCompleted: args.includeCompleted,
+        language: args.language,
       });
       return;
     }
@@ -3020,6 +3352,7 @@ async function run(argv) {
     if (args.aiCommand === 'models') {
       runAiModelsList({
         json: args.json,
+        language: args.language,
         provider: args.aiProviderExplicit ? args.aiProvider : undefined,
       });
       return;
@@ -3034,6 +3367,7 @@ async function run(argv) {
         id: args.aiProfileId || undefined,
         interactive: args.interactive,
         json: args.json,
+        language: args.language,
         label: args.aiLabel || undefined,
         model: args.aiModel || undefined,
         provider: args.aiProviderExplicit ? args.aiProvider : undefined,
@@ -3052,6 +3386,7 @@ async function run(argv) {
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
         model: args.aiModel || undefined,
+        language: args.language,
         plannerProfile: args.aiPlannerProfile || undefined,
         role: args.aiRole,
         timeout: args.aiTimeout,
@@ -3064,6 +3399,7 @@ async function run(argv) {
         context: args.aiContext || undefined,
         dryRun: args.dryRun,
         interactive: args.interactive,
+        language: args.language,
         printPrompt: args.aiPrintPrompt,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3084,6 +3420,7 @@ async function run(argv) {
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
         phase: args.aiPhase,
+        language: args.language,
         printPrompt: args.aiPrintPrompt,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3105,6 +3442,7 @@ async function run(argv) {
         context: args.aiContext || undefined,
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
+        language: args.language,
         printPrompt: args.aiPrintPrompt,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3120,6 +3458,7 @@ async function run(argv) {
         context: args.aiContext || undefined,
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
+        language: args.language,
         printPrompt: args.aiPrintPrompt,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3138,6 +3477,7 @@ async function run(argv) {
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
         phase: args.aiPhase,
+        language: args.language,
         printPrompt: args.aiPrintPrompt,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3154,6 +3494,7 @@ async function run(argv) {
       await runAiApprove(process.cwd(), {
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
+        language: args.language,
         phase: args.aiPhase,
         runId: args.aiRunId || undefined,
         version: args.aiVersion || undefined,
@@ -3162,7 +3503,9 @@ async function run(argv) {
     }
 
     if (args.aiCommand === 'approvals' || args.aiCommand === 'approval-status') {
-      await runAiApprovalStatus(process.cwd());
+      await runAiApprovalStatus(process.cwd(), {
+        language: args.language,
+      });
       return;
     }
 
@@ -3174,6 +3517,7 @@ async function run(argv) {
         dryRun: args.dryRun,
         executorProfile: args.aiExecutorProfile || undefined,
         interactive: args.interactive,
+        language: args.language,
         model: args.aiModel || undefined,
         provider: args.aiProvider,
         providerExplicit: args.aiProviderExplicit,
@@ -3186,6 +3530,7 @@ async function run(argv) {
 
     if (args.aiCommand === 'prompt-slice' || args.aiCommand === 'executor-prompt') {
       runAiPromptSlice(process.cwd(), {
+        language: args.language,
         slice: args.aiSlice || undefined,
       });
       return;
@@ -3201,6 +3546,7 @@ async function run(argv) {
         executorProfile: args.aiExecutorProfile || undefined,
         interactive: args.interactive,
         json: args.json,
+        language: args.language,
         model: args.aiModel || undefined,
         mode: args.aiExecutionMode,
         provider: args.aiProvider,
@@ -3229,6 +3575,7 @@ async function run(argv) {
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
         interactive: args.interactive,
+        language: args.language,
         remote: args.aiRemote || undefined,
         review: args.review,
         sshHostAlias: args.aiSshHostAlias || undefined,
@@ -3246,6 +3593,7 @@ async function run(argv) {
       format: args.format,
       includeCompleted: args.includeCompleted,
       json: args.json,
+      language: args.language,
       level: args.level,
       showConflicts: args.showConflicts,
       specSlug: args.specSlug,
@@ -3260,6 +3608,7 @@ async function run(argv) {
       autoStart: args.autoStart,
       includeCompleted: args.includeCompleted,
       json: args.json,
+      language: args.language,
       specSlug: args.specSlug,
     });
     return;
@@ -3268,6 +3617,7 @@ async function run(argv) {
   if (args.mode === 'evidence') {
     const result = runEvidence(process.cwd(), {
       command: args.evidenceArgs,
+      language: args.language,
       maxOutput: args.evidenceMaxOutput || undefined,
       output: args.evidenceOutput || undefined,
       subcommand: args.evidenceCommand,
@@ -3282,6 +3632,7 @@ async function run(argv) {
       command: args.demoCommand,
       demo: args.demoName,
       dryRun: args.dryRun,
+      language: args.language,
       targetRoot: demoTarget,
     });
     return;
@@ -3290,6 +3641,7 @@ async function run(argv) {
   if (args.mode === 'migrate') {
     runMigrate(args.targetDir, {
       dryRun: args.dryRun,
+      language: args.language,
       skipInstall: args.skipInstall,
     });
     return;
@@ -3300,6 +3652,7 @@ async function run(argv) {
       dryRun: args.dryRun,
       fix: args.doctorFix,
       json: args.json,
+      language: args.language,
       noColor: args.noColor,
       unicode: args.unicode,
     });
@@ -3307,7 +3660,10 @@ async function run(argv) {
   }
 
   if (args.mode === 'start-slice') {
-    startSlice(args.targetDir, { allowDraft: args.allowDraft });
+    startSlice(args.targetDir, {
+      allowDraft: args.allowDraft,
+      language: args.language,
+    });
     return;
   }
 
@@ -3315,6 +3671,7 @@ async function run(argv) {
     checkSliceReadiness(args.targetDir, {
       baseBranch: args.baseBranchExplicit ? args.aiBaseBranch : '',
       gate: args.gate,
+      language: args.language,
       local: args.checkSliceLocal,
       remote: args.aiRemote,
       strictOverlap: args.strictOverlap,
@@ -3323,7 +3680,7 @@ async function run(argv) {
   }
 
   if (args.mode === 'check-pr') {
-    checkPrReadiness(args.targetDir);
+    checkPrReadiness(args.targetDir, { language: args.language });
     return;
   }
 
@@ -3333,16 +3690,21 @@ async function run(argv) {
     if (!handoffInput || handoffInput === '.') {
       throw new Error(formatError('missing handoff or brief path. Use: npx create-quiver check-handoff specs/<spec-slug>/HANDOFF.md or specs/<spec-slug>/slices/<slice-id>/EXECUTION_BRIEF.md'));
     }
-    const resolved = checkHandoff(handoffInput, repoRoot);
-    console.log(`PASS: ${resolved.label} validated at ${resolved.relativePath}`);
+    const translator = createTranslator(args.language);
+    const resolved = checkHandoff(handoffInput, repoRoot, { language: args.language });
+    console.log(translator.t('handoff.validated', {
+      path: resolved.relativePath,
+      subject: translator.t(`handoff.label.${resolved.kind}`),
+    }));
     return;
   }
 
   if (args.mode === 'new-handoff') {
     const repoRoot = process.cwd();
     const handoffSlug = args.targetDir;
+    const translator = createTranslator(args.language);
     const resolved = scaffoldHandoff(handoffSlug, repoRoot);
-    console.log(`PASS: Handoff scaffolded at ${resolved.relativePath}`);
+    console.log(translator.t('handoff.scaffolded', { path: resolved.relativePath }));
     return;
   }
 
@@ -3352,6 +3714,7 @@ async function run(argv) {
       discard: args.discard,
       dryRun: args.dryRun,
       force: args.force,
+      language: args.language,
     });
     return;
   }
@@ -3359,6 +3722,7 @@ async function run(argv) {
   if (args.mode === 'check-scope') {
     checkScope(args.targetDir, {
       baseBranch: args.baseBranchExplicit ? args.aiBaseBranch : '',
+      language: args.language,
       remote: args.aiRemote,
       strict: args.strict,
     });
@@ -3377,6 +3741,7 @@ async function run(argv) {
         dryRun: args.dryRun,
         input: args.aiInput || undefined,
         interactive: args.interactive,
+        language: args.language,
         methodology: args.methodology || undefined,
         review: args.review,
         specSlug: args.specSlug || undefined,
@@ -3393,18 +3758,19 @@ async function run(argv) {
       const report = startSpecWorktree(process.cwd(), args.targetDir, {
         dryRun: args.dryRun,
       });
-      process.stdout.write(formatSpecStartResult(report));
+      process.stdout.write(formatSpecStartResult(report, { language: args.language }));
       return;
     }
 
     if (args.specCommand === 'status') {
       const report = buildSpecStatus(process.cwd(), args.targetDir);
-      process.stdout.write(formatSpecStatus(report));
+      process.stdout.write(formatSpecStatus(report, { language: args.language }));
       return;
     }
 
     if (args.specCommand === 'validate') {
       runValidateSpec(process.cwd(), args.targetDir, {
+        language: args.language,
         strict: args.strict,
       });
       return;
@@ -3418,7 +3784,7 @@ async function run(argv) {
         force: args.force,
         remote: args.aiRemote,
       });
-      process.stdout.write(formatSpecCloseResult(report));
+      process.stdout.write(formatSpecCloseResult(report, { language: args.language }));
       return;
     }
 
@@ -3439,11 +3805,13 @@ async function run(argv) {
     });
     return;
   }
+  const initLanguage = resolveInitGeneratedLanguage(args, targetDir, initOptions);
   const initLayout = buildInitLayout(targetDir, {
     compatibilityAlias: !args.explicitInit,
     dryRun: args.dryRun,
     full: initOptions.full,
     includeTemplates: initOptions.includeTemplates,
+    language: initLanguage.configLanguage,
     legacyScripts: initOptions.legacyScripts,
     minimal: initOptions.minimal,
     projectName: initOptions.projectName,
@@ -3466,10 +3834,12 @@ async function run(argv) {
     }
     runInitDocs(targetDir, initOptions.projectName, {
       includeTemplates: initOptions.includeTemplates,
+      language: initLanguage.docsLanguage,
       legacyScripts: initOptions.legacyScripts,
       profile: initLayout.profile,
       templateRoot,
     });
+    const languageWrite = persistInitLanguage(targetDir, { language: initLanguage.configLanguage });
 
     if (!args.skipInstall) {
       const installResult = installSelfAsDevDep(targetDir, CLI_VERSION);
@@ -3480,14 +3850,19 @@ async function run(argv) {
       }
     }
 
-    console.log(`Installed Quiver into ${targetDir}`);
-    printInitNextSteps(targetDir, initOptions.projectName);
+    const translator = createTranslator(args.language);
+    console.log(translator.t('init.installed', { path: targetDir }));
+    if (languageWrite) {
+      console.log(translator.t('init.language.saved', { language: languageWrite.language }));
+    }
+    printInitNextSteps(targetDir, initOptions.projectName, { language: args.language });
   } finally {
     fs.rmSync(tempRoot, { recursive: true, force: true });
   }
 }
 
 module.exports = {
+  persistInitLanguage,
   resolveInteractiveInitOptions,
   runAnalyze,
   runDashboard,