karajan-code 1.43.0 → 1.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "1.43.0",
+  "version": "1.44.0",
   "description": "Local multi-agent coding orchestrator with TDD, SonarQube, and code review pipeline",
   "type": "module",
   "license": "AGPL-3.0",

package/src/commands/init.js

@@ -9,6 +9,7 @@ import { detectAvailableAgents } from "../utils/agent-detect.js";
 import { createWizard, isTTY } from "../utils/wizard.js";
 import { runCommand } from "../utils/process.js";
 import { getInstallCommand } from "../utils/os-detect.js";
+import { detectOsLocale, SUPPORTED_LANGUAGES } from "../utils/locale.js";
 
 async function runWizard(config, logger) {
   const agents = await detectAvailableAgents();
@@ -88,6 +89,31 @@ async function runWizard(config, logger) {
     config.development.require_test_changes = methodology === "tdd";
     logger.info(`  -> Methodology: ${methodology}`);
 
+    const detectedLocale = detectOsLocale();
+    const allLangEntries = Object.entries(SUPPORTED_LANGUAGES).map(([code, name]) => ({
+      label: `${name} (${code})`,
+      value: code,
+      available: true
+    }));
+    // Put detected locale first so it becomes the default selection
+    const languageOptions = [
+      ...allLangEntries.filter((o) => o.value === detectedLocale),
+      ...allLangEntries.filter((o) => o.value !== detectedLocale)
+    ];
+
+    const pipelineLang = await wizard.select("Pipeline language:", languageOptions);
+    config.language = pipelineLang;
+    logger.info(`  -> Pipeline language: ${pipelineLang}`);
+
+    // Reorder for HU language with pipeline language as default
+    const huLangOptions = [
+      ...allLangEntries.filter((o) => o.value === pipelineLang),
+      ...allLangEntries.filter((o) => o.value !== pipelineLang)
+    ];
+    const huLang = await wizard.select("HU language (for user stories):", huLangOptions);
+    config.hu_language = huLang;
+    logger.info(`  -> HU language: ${huLang}`);
+
     logger.info("");
   } finally {
     wizard.close();
@@ -290,6 +316,13 @@ export async function initCommand({ logger, flags = {} }) {
   const { config, exists: configExists } = await loadConfig();
   const interactive = flags.noInteractive !== true && isTTY();
 
+  // Auto-detect language from OS locale for non-interactive mode
+  if (!interactive && !configExists) {
+    const detectedLocale = detectOsLocale();
+    config.language = detectedLocale;
+    config.hu_language = detectedLocale;
+  }
+
   await handleConfigSetup({ config, configExists, interactive, configPath, logger });
   await ensureReviewRules(reviewRulesPath, logger);
   await ensureCoderRules(coderRulesPath, logger);

package/src/config.js

@@ -123,6 +123,8 @@ const DEFAULTS = {
     port: 4000,
     auto_start: false
   },
+  language: "en",
+  hu_language: "en",
   policies: {},
   serena: { enabled: false },
   planning_game: { enabled: false, project_id: null, codeveloper: null },

package/src/prompts/architect.js

@@ -1,4 +1,5 @@
 import { loadAvailableSkills, buildSkillSection } from "../skills/skill-loader.js";
+import { getLanguageInstruction } from "../utils/locale.js";
 
 const SUBAGENT_PREAMBLE = [
   "IMPORTANT: You are running as a Karajan sub-agent.",
@@ -8,8 +9,9 @@ const SUBAGENT_PREAMBLE = [
 
 export const VALID_VERDICTS = new Set(["ready", "needs_clarification"]);
 
-export async function buildArchitectPrompt({ task, instructions, researchContext = null, productContext = null, projectDir = null }) {
-  const sections = [SUBAGENT_PREAMBLE];
+export async function buildArchitectPrompt({ task, instructions, researchContext = null, productContext = null, projectDir = null, language = "en" }) {
+  const langInstruction = getLanguageInstruction(language);
+  const sections = [SUBAGENT_PREAMBLE, ...(langInstruction ? [langInstruction] : [])];
 
   if (instructions) {
     sections.push(instructions);

package/src/prompts/coder.js

@@ -1,5 +1,6 @@
 import { RTK_INSTRUCTIONS } from "./rtk-snippet.js";
 import { loadAvailableSkills, buildSkillSection } from "../skills/skill-loader.js";
+import { getLanguageInstruction } from "../utils/locale.js";
 
 const SUBAGENT_PREAMBLE = [
   "IMPORTANT: You are running as a Karajan sub-agent.",
@@ -32,9 +33,11 @@ const SERENA_INSTRUCTIONS = [
   "Fall back to reading files only when Serena tools are not sufficient."
 ].join("\n");
 
-export async function buildCoderPrompt({ task, reviewerFeedback = null, sonarSummary = null, coderRules = null, methodology = "tdd", serenaEnabled = false, rtkAvailable = false, deferredContext = null, productContext = null, plan = null, projectDir = null }) {
+export async function buildCoderPrompt({ task, reviewerFeedback = null, sonarSummary = null, coderRules = null, methodology = "tdd", serenaEnabled = false, rtkAvailable = false, deferredContext = null, productContext = null, plan = null, projectDir = null, language = "en" }) {
+  const langInstruction = getLanguageInstruction(language);
   const sections = [
     serenaEnabled ? SUBAGENT_PREAMBLE_SERENA : SUBAGENT_PREAMBLE,
+    ...(langInstruction ? [langInstruction] : []),
     `Task:\n${task}`,
     "Implement directly in the repository.",
     "Keep changes minimal and production-ready.",

package/src/prompts/hu-reviewer.js

@@ -1,4 +1,5 @@
 import { extractFirstJson } from "../utils/json-extract.js";
+import { getLanguageInstruction } from "../utils/locale.js";
 
 const SUBAGENT_PREAMBLE = [
   "IMPORTANT: You are running as a Karajan sub-agent.",
@@ -21,8 +22,9 @@ const DIMENSION_KEYS = [
  * @param {{stories: Array<{id: string, text: string}>, instructions: string|null, context?: string|null}} params
  * @returns {string} The assembled prompt.
  */
-export function buildHuReviewerPrompt({ stories, instructions, context = null, productContext = null }) {
-  const sections = [SUBAGENT_PREAMBLE];
+export function buildHuReviewerPrompt({ stories, instructions, context = null, productContext = null, hu_language = "en" }) {
+  const langInstruction = getLanguageInstruction(hu_language);
+  const sections = [SUBAGENT_PREAMBLE, ...(langInstruction ? [langInstruction] : [])];
 
   if (instructions) {
     sections.push(instructions);

package/src/prompts/reviewer.js

@@ -1,5 +1,6 @@
 import { RTK_INSTRUCTIONS } from "./rtk-snippet.js";
 import { loadAvailableSkills, buildSkillSection } from "../skills/skill-loader.js";
+import { getLanguageInstruction } from "../utils/locale.js";
 
 const SUBAGENT_PREAMBLE = [
   "IMPORTANT: You are running as a Karajan sub-agent.",
@@ -23,11 +24,13 @@ const SERENA_INSTRUCTIONS = [
   "Fall back to reading files only when Serena tools are not sufficient."
 ].join("\n");
 
-export async function buildReviewerPrompt({ task, diff, reviewRules, mode, serenaEnabled = false, rtkAvailable = false, productContext = null, projectDir = null }) {
+export async function buildReviewerPrompt({ task, diff, reviewRules, mode, serenaEnabled = false, rtkAvailable = false, productContext = null, projectDir = null, language = "en" }) {
   const truncatedDiff = diff.length > 12000 ? `${diff.slice(0, 12000)}\n\n[TRUNCATED]` : diff;
 
+  const langInstruction = getLanguageInstruction(language);
   const sections = [
     serenaEnabled ? SUBAGENT_PREAMBLE_SERENA : SUBAGENT_PREAMBLE,
+    ...(langInstruction ? [langInstruction] : []),
     `You are a code reviewer in ${mode} mode.`,
     "CRITICAL SCOPE RULE: Only review changes that are part of the diff below. Do NOT flag issues in unchanged code, missing features planned for future tasks, or improvements outside the scope of this task. If the diff is correct for what the task asks, approve it — even if the broader codebase has other issues.",
     "Only block approval for issues IN THE DIFF that are bugs, security vulnerabilities, or clear violations of the review rules.",

package/src/utils/display.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
+// TODO: i18n display messages
 const DISPLAY_PKG_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
 const DISPLAY_VERSION = JSON.parse(readFileSync(DISPLAY_PKG_PATH, "utf8")).version;
 

package/src/utils/locale.js

@@ -0,0 +1,59 @@
+/**
+ * OS locale detection and language instruction generation for i18n support.
+ */
+
+export const SUPPORTED_LANGUAGES = {
+  en: "English",
+  es: "Español"
+};
+
+const LANG_ENV_VARS = ["LANG", "LANGUAGE", "LC_ALL", "LC_MESSAGES"];
+
+/**
+ * Detect the 2-letter language code from OS environment variables.
+ * Checks LANG, LANGUAGE, LC_ALL, LC_MESSAGES in order.
+ * @returns {string} 2-letter language code (e.g. "en", "es")
+ */
+export function detectOsLocale() {
+  for (const envVar of LANG_ENV_VARS) {
+    const value = process.env[envVar];
+    if (value) {
+      const code = extractLangCode(value);
+      if (code) return code;
+    }
+  }
+  return "en";
+}
+
+/**
+ * Extract a 2-letter language code from a locale string.
+ * Handles formats like "es_ES.UTF-8", "en_US", "es", "C.UTF-8".
+ * @param {string} locale
+ * @returns {string|null}
+ */
+function extractLangCode(locale) {
+  const trimmed = locale.trim();
+  if (!trimmed || trimmed === "C" || trimmed === "POSIX") return null;
+  // Match first 2 lowercase letters before _, ., or end
+  const match = /^([a-z]{2})(?:[_.\-]|$)/i.exec(trimmed);
+  if (match) return match[1].toLowerCase();
+  return null;
+}
+
+/**
+ * Get a prompt instruction string for the given language.
+ * Returns empty string for English (agents default to English).
+ * @param {string} lang - 2-letter language code
+ * @returns {string}
+ */
+export function getLanguageInstruction(lang) {
+  if (!lang || lang === "en") return "";
+  const languageName = SUPPORTED_LANGUAGES[lang];
+  if (lang === "es") {
+    return "IMPORTANT: Respond in Spanish. All output, explanations, and feedback must be in Spanish.";
+  }
+  if (languageName) {
+    return `IMPORTANT: Respond in ${languageName}. All output must be in ${languageName}.`;
+  }
+  return `IMPORTANT: Respond in ${lang}. All output must be in ${lang}.`;
+}