karajan-code 1.42.0 → 1.44.0

package/README.md

@@ -52,6 +52,14 @@ If Claude Code is a smart pair programmer, Karajan is the CI/CD pipeline for AI-
 
 ## Install
 
+**One-liner** (detects your OS, installs via npm):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/manufosela/karajan-code/main/scripts/install-kj.sh | sh
+```
+
+**Or directly with npm:**
+
 ```bash
 npm install -g karajan-code
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karajan-code",
-  "version": "1.42.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/scripts/install-kj.sh

@@ -0,0 +1,193 @@
+#!/bin/sh
+# Karajan Code - Universal Installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/manufosela/karajan-code/main/scripts/install-kj.sh | sh
+#
+# Installs karajan-code globally via npm if Node.js >= 18 is available.
+# If Node.js is not installed, prints platform-specific instructions.
+
+# --- Color support ---
+setup_colors() {
+  if [ -t 1 ] && command -v tput >/dev/null 2>&1 && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; then
+    BOLD="$(tput bold)"
+    GREEN="$(tput setaf 2)"
+    YELLOW="$(tput setaf 3)"
+    RED="$(tput setaf 1)"
+    CYAN="$(tput setaf 6)"
+    RESET="$(tput sgr0)"
+  else
+    BOLD="" GREEN="" YELLOW="" RED="" CYAN="" RESET=""
+  fi
+}
+
+info()    { printf '%s[info]%s  %s\n' "$CYAN" "$RESET" "$1"; }
+success() { printf '%s[ok]%s    %s\n' "$GREEN" "$RESET" "$1"; }
+warn()    { printf '%s[warn]%s  %s\n' "$YELLOW" "$RESET" "$1"; }
+error()   { printf '%s[error]%s %s\n' "$RED" "$RESET" "$1"; }
+
+# --- Platform detection ---
+detect_platform() {
+  OS="$(uname -s)"
+  ARCH="$(uname -m)"
+
+  case "$OS" in
+    Linux*)  PLATFORM="linux" ;;
+    Darwin*) PLATFORM="macos" ;;
+    MINGW*|MSYS*|CYGWIN*) PLATFORM="windows" ;;
+    *)       PLATFORM="unknown" ;;
+  esac
+
+  case "$ARCH" in
+    x86_64|amd64) ARCH="x64" ;;
+    aarch64|arm64) ARCH="arm64" ;;
+    *)             ARCH="$ARCH" ;;
+  esac
+}
+
+# --- Check Node.js ---
+check_node() {
+  if ! command -v node >/dev/null 2>&1; then
+    return 1
+  fi
+
+  NODE_VERSION="$(node --version 2>/dev/null | sed 's/^v//')"
+  NODE_MAJOR="$(echo "$NODE_VERSION" | cut -d. -f1)"
+
+  if [ "$NODE_MAJOR" -lt 18 ] 2>/dev/null; then
+    warn "Node.js v${NODE_VERSION} found, but v18+ is required."
+    return 1
+  fi
+
+  return 0
+}
+
+# --- Print Node.js install instructions ---
+print_node_instructions() {
+  echo ""
+  error "Node.js >= 18 is required but not found."
+  echo ""
+  printf '%sInstall Node.js for your platform:%s\n' "$BOLD" "$RESET"
+  echo ""
+
+  case "$PLATFORM" in
+    linux)
+      echo "  Option 1 - nvm (recommended):"
+      echo "    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash"
+      echo "    nvm install 22"
+      echo ""
+      echo "  Option 2 - NodeSource:"
+      echo "    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -"
+      echo "    sudo apt-get install -y nodejs"
+      ;;
+    macos)
+      echo "  Option 1 - nvm (recommended):"
+      echo "    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash"
+      echo "    nvm install 22"
+      echo ""
+      echo "  Option 2 - Homebrew:"
+      echo "    brew install node@22"
+      ;;
+    windows)
+      echo "  Option 1 - nvm-windows:"
+      echo "    https://github.com/coreybutler/nvm-windows/releases"
+      echo ""
+      echo "  Option 2 - Download installer:"
+      echo "    https://nodejs.org/en/download/"
+      ;;
+    *)
+      echo "  Download from: https://nodejs.org/en/download/"
+      ;;
+  esac
+
+  echo ""
+  echo "  After installing Node.js, re-run this script:"
+  echo "    curl -fsSL https://raw.githubusercontent.com/manufosela/karajan-code/main/scripts/install-kj.sh | sh"
+  echo ""
+}
+
+# --- Install via npm ---
+install_karajan() {
+  info "Installing karajan-code via npm..."
+  echo ""
+
+  if npm install -g karajan-code; then
+    success "karajan-code installed successfully."
+  else
+    echo ""
+    error "npm install failed."
+    echo ""
+    echo "  Common fixes:"
+    echo "    - Permission error? Use: sudo npm install -g karajan-code"
+    echo "    - Or configure npm prefix: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally"
+    echo ""
+    exit 1
+  fi
+}
+
+# --- Verify installation ---
+verify_install() {
+  echo ""
+  if command -v kj >/dev/null 2>&1; then
+    KJ_VERSION="$(kj --version 2>/dev/null || echo "unknown")"
+    success "kj ${KJ_VERSION} is ready."
+  else
+    warn "kj command not found in PATH. You may need to restart your shell."
+    return 1
+  fi
+}
+
+# --- Run kj init ---
+run_init() {
+  if command -v kj >/dev/null 2>&1; then
+    info "Running kj init to detect installed agents..."
+    echo ""
+    kj init --no-interactive 2>/dev/null || true
+    echo ""
+  fi
+}
+
+# --- Print next steps ---
+print_next_steps() {
+  echo ""
+  printf '%s%s--- Karajan Code installed ---%s\n' "$BOLD" "$GREEN" "$RESET"
+  echo ""
+  echo "  Next steps:"
+  echo ""
+  echo "    1. Go to a project directory:"
+  echo "       cd your-project/"
+  echo ""
+  echo "    2. Run from CLI:"
+  echo "       kj run \"Add input validation with tests\""
+  echo ""
+  echo "    3. Or use as MCP server inside Claude Code / Codex:"
+  echo "       The MCP server auto-registers during install."
+  echo "       Open kj-tail in a separate terminal to see pipeline output."
+  echo ""
+  echo "  Docs: https://karajancode.com"
+  echo ""
+}
+
+# --- Main ---
+main() {
+  setup_colors
+
+  echo ""
+  printf '%s%sKarajan Code Installer%s\n' "$BOLD" "$CYAN" "$RESET"
+  echo ""
+
+  detect_platform
+  info "Detected: ${PLATFORM} (${ARCH})"
+
+  if ! check_node; then
+    print_node_instructions
+    exit 1
+  fi
+
+  success "Node.js v${NODE_VERSION} detected."
+
+  install_karajan
+  verify_install
+  run_init
+  print_next_steps
+}
+
+main

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}.`;
+}