claudeos-core 1.2.3 → 1.3.0

package/README.md

@@ -105,9 +105,50 @@ npx claudeos-core init
 
 # Option D: git clone (for development/contribution)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Cross-platform (PowerShell, CMD, Bash, Zsh — any terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Linux/macOS (Bash only)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Output Language (10 languages)
+
+When you run `init` without `--lang`, an interactive selector appears — use arrow keys to choose:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Generated files (CLAUDE.md, Standards, Rules,
+  Skills, Guides) will be written in English.
+
+  ❯  1. en     — English
+     2. ko     — 한국어 (Korean)
+     3. zh-CN  — 简体中文 (Chinese Simplified)
+     4. ja     — 日本語 (Japanese)
+     5. es     — Español (Spanish)
+     6. vi     — Tiếng Việt (Vietnamese)
+     7. hi     — हिन्दी (Hindi)
+     8. ru     — Русский (Russian)
+     9. fr     — Français (French)
+    10. de     — Deutsch (German)
+
+  ↑↓ Move  ↵ Select
+```
+
+The description changes to the selected language as you navigate. To skip the selector, pass `--lang` directly:
+
+```bash
+npx claudeos-core init --lang ko    # Korean
+npx claudeos-core init --lang ja    # Japanese
+npx claudeos-core init --lang en    # English (default)
+```
+
+> **Note:** This sets the language for generated documentation files only. Code analysis (Pass 1–2) always runs in English; generated output (Pass 3) is written in your chosen language. Code examples inside the generated files remain in their original programming language syntax.
+
 That's it. After 5–18 minutes, all documentation is generated and ready to use.
 
 ### Manual Step-by-Step Installation
@@ -168,18 +209,18 @@ cat claudeos-core/generated/domain-groups.json | node -e "
   g.groups.forEach((g,i) => console.log('Group '+(i+1)+': ['+g.domains.join(', ')+'] ('+g.type+', ~'+g.estimatedFiles+' files)'));
 "
 
-# Run Pass 1 for each group (replace N with group number)
+# Run Pass 1 for each group (replace domains and group number)
 # For group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
 # For group 2 (if exists):
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/payment, system, delivery/g" \
-  | sed "s/{{PASS_NUM}}/2/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="payment, system, delivery" PASS_NUM=2 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
 # For frontend groups, use pass1-frontend-prompt.md instead
 ```
@@ -224,7 +265,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # Pass JSON format check
 
 ```bash
 # Count generated files
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 
 # Check CLAUDE.md
 head -30 CLAUDE.md
@@ -452,6 +493,7 @@ npx claudeos-core restore
 | **Project-specific output** | ✅ Every file reflects your patterns | ❌ Generic commands | Partially | ❌ One-size-fits-all |
 | **Multi-stack** | ✅ Auto-detected + separate analysis | ❌ Stack-agnostic | Manual | Varies |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Multi-language** | ✅ 10 languages, interactive selector | ❌ | ❌ | ❌ |
 | **Self-verifying** | ✅ 5 validation tools | ❌ | ❌ | ❌ |
 | **Backup / Restore** | ✅ Master Plan system | ❌ | ❌ | ❌ |
 | **Setup time** | ~5–18min (automated) | ~5min (manual config) | Hours–Days | ~5min |
@@ -560,7 +602,7 @@ Contributions are welcome! Areas where help is most needed:
 
 - **New stack templates** — Ruby/Rails, Go/Gin, PHP/Laravel, Rust/Axum
 - **Monorepo deep support** — Separate sub-project roots, workspace detection
-- **Test coverage** — Unit tests for all verification tools
+- **Test coverage** — Expanding test suite (currently 57 tests covering stack detection, domain grouping, plan validation, and structure scanning)
 
 ---
 

package/README.ru.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Вариант D: git clone (для разработки/контрибуции)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Кроссплатформенный (PowerShell, CMD, Bash, Zsh — любой терминал)
+node claudeos-core-tools/bin/cli.js init
+
+# Только Linux/macOS (только Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Язык вывода (10 языков)
+
+При запуске `init` без `--lang` появляется интерактивный селектор со стрелками:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Сгенерированные файлы (CLAUDE.md, Standards, Rules,
+  Skills, Guides) будут написаны на русском языке.
+
+     1. en     — English
+     ...
+  ❯  8. ru     — Русский (Russian)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+При навигации описание переключается на соответствующий язык. Чтобы пропустить селектор:
+
+```bash
+npx claudeos-core init --lang ru    # Русский
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Примечание:** Эта настройка изменяет только язык генерируемых файлов документации. Анализ кода (Pass 1–2) всегда выполняется на английском; только результат генерации (Pass 3) пишется на выбранном языке.
+
 Это всё. Через 5–18 минут вся документация сгенерирована и готова к использованию.
 
 ### Ручная пошаговая установка
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# Для фронтенд-групп используйте pass1-frontend-prompt.md
 ```
 
 **Проверка:** `ls claudeos-core/generated/pass1-*.json` должен показать по одному JSON на группу.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Проверка результатов
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **Вывод под проект** | ✅ Каждый файл отражает ваши паттерны | ❌ Универсальные команды | Частично | ❌ Один размер для всех |
 | **Мульти-стек** | ✅ Автоопределение + раздельный анализ | ❌ Стек-агностик | Вручную | Неопределённо |
 | **Kotlin + CQRS/BFF** | ✅ Мультимодульный, разделение Command/Query | ❌ | ❌ | ❌ |
+| **Многоязычность** | ✅ 10 языков, интерактивный выбор | ❌ | ❌ | ❌ |
 | **Самопроверка** | ✅ 5 инструментов валидации | ❌ | ❌ | ❌ |
 | **Бэкап / Восстановление** | ✅ Система Master Plan | ❌ | ❌ | ❌ |
 | **Время настройки** | ~5–18 мин (автоматически) | ~5 мин (ручная настройка) | Часы–Дни | ~5 мин |

package/README.vi.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # Cách D: git clone (cho phát triển/đóng góp)
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# Đa nền tảng (PowerShell, CMD, Bash, Zsh — mọi terminal)
+node claudeos-core-tools/bin/cli.js init
+
+# Chỉ Linux/macOS (chỉ Bash)
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### Ngôn ngữ đầu ra (10 ngôn ngữ)
+
+Khi chạy `init` không có `--lang`, bộ chọn tương tác bằng phím mũi tên sẽ xuất hiện:
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  Các file được tạo (CLAUDE.md, Standards, Rules,
+  Skills, Guides) sẽ được viết bằng tiếng Việt.
+
+     1. en     — English
+     ...
+  ❯  6. vi     — Tiếng Việt (Vietnamese)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+Mô tả thay đổi sang ngôn ngữ tương ứng khi di chuyển. Bỏ qua bộ chọn:
+
+```bash
+npx claudeos-core init --lang vi    # Tiếng Việt
+npx claudeos-core init --lang en    # English
+npx claudeos-core init --lang ko    # 한국어
+```
+
+> **Lưu ý:** Chỉ thay đổi ngôn ngữ của file tài liệu được tạo. Phân tích mã (Pass 1–2) luôn chạy bằng tiếng Anh; chỉ kết quả tạo (Pass 3) được viết bằng ngôn ngữ đã chọn.
+
 Chỉ vậy thôi. Sau 5–18 phút, tất cả tài liệu được tạo và sẵn sàng sử dụng.
 
 ### Cài Đặt Thủ Công Từng Bước
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# Đối với nhóm frontend, sử dụng pass1-frontend-prompt.md
 ```
 
 **Xác minh:** `ls claudeos-core/generated/pass1-*.json` phải hiển thị một JSON cho mỗi nhóm.
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8: Xác minh kết quả
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **Đầu ra riêng dự án** | ✅ Mọi file phản ánh pattern của bạn | ❌ Lệnh chung | Một phần | ❌ Một cỡ cho tất cả |
 | **Multi-stack** | ✅ Tự phát hiện + phân tích riêng | ❌ Không phân biệt stack | Thủ công | Không chắc |
 | **Kotlin + CQRS/BFF** | ✅ Multi-module, Command/Query split | ❌ | ❌ | ❌ |
+| **Đa ngôn ngữ** | ✅ 10 ngôn ngữ, bộ chọn tương tác | ❌ | ❌ | ❌ |
 | **Tự xác thực** | ✅ 5 công cụ validation | ❌ | ❌ | ❌ |
 | **Backup / Khôi phục** | ✅ Hệ thống Master Plan | ❌ | ❌ | ❌ |
 | **Thời gian cài đặt** | ~5–18 phút (tự động) | ~5 phút (cấu hình thủ công) | Hàng giờ–ngày | ~5 phút |

package/README.zh-CN.md

@@ -107,9 +107,44 @@ npx claudeos-core init
 
 # 方式 D：git clone（用于开发/贡献）
 git clone https://github.com/claudeos-core/claudeos-core.git claudeos-core-tools
+
+# 跨平台（PowerShell、CMD、Bash、Zsh — 任何终端）
+node claudeos-core-tools/bin/cli.js init
+
+# 仅 Linux/macOS（仅 Bash）
 bash claudeos-core-tools/bootstrap.sh
 ```
 
+### 输出语言（支持 10 种语言）
+
+不带 `--lang` 运行 `init` 时，会显示箭头键交互选择器：
+
+```
+╔══════════════════════════════════════════════════╗
+║  Select generated document language (required)   ║
+╚══════════════════════════════════════════════════╝
+
+  生成的文件（CLAUDE.md、Standards、Rules、
+  Skills、Guides）将以简体中文编写。
+
+     1. en     — English
+     2. ko     — 한국어 (Korean)
+  ❯  3. zh-CN  — 简体中文 (Chinese Simplified)
+     ...
+
+  ↑↓ Move  ↵ Select
+```
+
+移动箭头时说明会切换为对应语言。跳过选择器直接指定：
+
+```bash
+npx claudeos-core init --lang zh-CN  # 简体中文
+npx claudeos-core init --lang en     # English
+npx claudeos-core init --lang ko     # 한국어
+```
+
+> **注意：** 此设置仅更改生成文档的语言。代码分析（Pass 1–2）始终以英文运行，仅生成结果（Pass 3）以所选语言编写。代码示例保持原始编程语言语法。
+
 就这样。5–18 分钟后，所有文档生成完毕，即可使用。
 
 ### 手动逐步安装
@@ -171,12 +206,12 @@ cat claudeos-core/generated/domain-groups.json | node -e "
 "
 
 # Run Pass 1 for group 1:
-cat claudeos-core/generated/pass1-backend-prompt.md \
-  | sed "s/{{DOMAIN_GROUP}}/user, order, product/g" \
-  | sed "s/{{PASS_NUM}}/1/g" \
-  | claude -p --dangerously-skip-permissions
+cp claudeos-core/generated/pass1-backend-prompt.md /tmp/_pass1.md
+DOMAIN_LIST="user, order, product" PASS_NUM=1 \
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{DOMAIN_LIST}/g; s/\{\{PASS_NUM\}\}/$ENV{PASS_NUM}/g' /tmp/_pass1.md
+cat /tmp/_pass1.md | claude -p --dangerously-skip-permissions
 
-# For frontend groups, use pass1-frontend-prompt.md instead
+# 前端分组请使用 pass1-frontend-prompt.md
 ```
 
 **验证：** `ls claudeos-core/generated/pass1-*.json` 应显示每组一个 JSON。
@@ -218,7 +253,7 @@ node claudeos-core-tools/pass-json-validator/index.js   # JSON format
 #### Step 8：验证结果
 
 ```bash
-find .claude claudeos-core -type f | grep -v node_modules | wc -l
+find .claude claudeos-core -type f | grep -v node_modules | grep -v '/generated/' | wc -l
 head -30 CLAUDE.md
 ls .claude/rules/*/
 ```
@@ -421,6 +456,7 @@ npx claudeos-core restore
 | **项目定制输出** | ✅ 每个文件反映你的模式 | ❌ 通用命令 | 部分 | ❌ 一刀切 |
 | **多栈支持** | ✅ 自动检测 + 分别分析 | ❌ 栈无关 | 手动 | 不一定 |
 | **Kotlin + CQRS/BFF** | ✅ 多模块, Command/Query 分离 | ❌ | ❌ | ❌ |
+| **多语言** | ✅ 10 种语言，交互式选择 | ❌ | ❌ | ❌ |
 | **自验证** | ✅ 5 个验证工具 | ❌ | ❌ | ❌ |
 | **备份 / 恢复** | ✅ Master Plan 系统 | ❌ | ❌ | ❌ |
 | **配置时间** | ~5–18分钟（自动） | ~5分钟（手动配置） | 数小时–数天 | ~5分钟 |

package/bin/cli.js

@@ -49,42 +49,154 @@ function isValidLang(lang) {
   return LANG_CODES.includes(lang);
 }
 
-// Interactive language selection (stdin prompt)
+// Interactive language selection (arrow key selector)
 function selectLangInteractive() {
   return new Promise((resolve) => {
-    const readline = require("readline");
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    // Fallback to number input if stdin is not a TTY (e.g., piped input)
+    if (!process.stdin.isTTY) {
+      const readline = require("readline");
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      log("");
+      log("╔══════════════════════════════════════════════════╗");
+      log("║  Select generated document language (required)   ║");
+      log("╚══════════════════════════════════════════════════╝");
+      log("");
+      log("  Generated files (CLAUDE.md, Standards, Rules,");
+      log("  Skills, Guides) will be written in this language.");
+      log("");
+      LANG_CODES.forEach((code, i) => {
+        log(`    ${String(i + 1).padStart(2)}. ${code.padEnd(6)} — ${SUPPORTED_LANGS[code]}`);
+      });
+      log("");
+      rl.question(`  Enter number (1-${LANG_CODES.length}) or language code: `, (answer) => {
+        rl.close();
+        const trimmed = answer.trim();
+        const num = parseInt(trimmed);
+        if (num >= 1 && num <= LANG_CODES.length) { resolve(LANG_CODES[num - 1]); return; }
+        if (isValidLang(trimmed)) { resolve(trimmed); return; }
+        log(`\n  ❌ Invalid selection: "${trimmed}"`);
+        process.exit(1);
+      });
+      return;
+    }
+
+    // Arrow key interactive selector
+    let selected = 0;
+    const total = LANG_CODES.length;
+
+    // Description text per language (shown when hovering)
+    const DESC = {
+      en:      "Generated files (CLAUDE.md, Standards, Rules,\n  Skills, Guides) will be written in English.",
+      ko:      "생성되는 파일(CLAUDE.md, Standards, Rules,\n  Skills, Guides)이 한국어로 작성됩니다.",
+      "zh-CN": "生成的文件（CLAUDE.md、Standards、Rules、\n  Skills、Guides）将以简体中文编写。",
+      ja:      "生成されるファイル（CLAUDE.md、Standards、Rules、\n  Skills、Guides）は日本語で作成されます。",
+      es:      "Los archivos generados (CLAUDE.md, Standards, Rules,\n  Skills, Guides) se escribirán en español.",
+      vi:      "Các file được tạo (CLAUDE.md, Standards, Rules,\n  Skills, Guides) sẽ được viết bằng tiếng Việt.",
+      hi:      "जनरेट की गई फ़ाइलें (CLAUDE.md, Standards, Rules,\n  Skills, Guides) हिन्दी में लिखी जाएंगी।",
+      ru:      "Сгенерированные файлы (CLAUDE.md, Standards, Rules,\n  Skills, Guides) будут написаны на русском языке.",
+      fr:      "Les fichiers générés (CLAUDE.md, Standards, Rules,\n  Skills, Guides) seront rédigés en français.",
+      de:      "Die generierten Dateien (CLAUDE.md, Standards, Rules,\n  Skills, Guides) werden auf Deutsch verfasst.",
+    };
+
+    function render() {
+      const output = [];
+      // Description line (changes with selection)
+      const code = LANG_CODES[selected];
+      const descLines = (DESC[code] || DESC.en).split("\n");
+      descLines.forEach(l => output.push(`  ${l}`));
+      output.push("");
+      // Language list
+      const BOLD_CYAN = "\x1b[1;36m";
+      const RESET = "\x1b[0m";
+      for (let i = 0; i < total; i++) {
+        const c = LANG_CODES[i];
+        const label = SUPPORTED_LANGS[c];
+        const num = String(i + 1).padStart(2);
+        if (i === selected) {
+          output.push(`  ${BOLD_CYAN}❯ ${num}. ${c.padEnd(6)} — ${label}${RESET}`);
+        } else {
+          output.push(`    ${num}. ${c.padEnd(6)} — ${label}`);
+        }
+      }
+      output.push("");
+      const DIM = "\x1b[2m";
+      output.push(`  \x1b[1m↑↓\x1b[0m${DIM} Move ${RESET} \x1b[1mEnter\x1b[0m${DIM} Select ${RESET} \x1b[1mESC\x1b[0m${DIM} Cancel${RESET}`);
+      return output;
+    }
 
+    // Print header once
     log("");
     log("╔══════════════════════════════════════════════════╗");
-    log("║  Select output language (required)               ║");
+    log("║  Select generated document language (required)   ║");
     log("╚══════════════════════════════════════════════════╝");
     log("");
-    LANG_CODES.forEach((code, i) => {
-      log(`    ${String(i + 1).padStart(2)}. ${code.padEnd(6)} — ${SUPPORTED_LANGS[code]}`);
-    });
-    log("");
 
-    rl.question(`  Enter number (1-${LANG_CODES.length}) or language code: `, (answer) => {
-      rl.close();
-      const trimmed = answer.trim();
+    // Initial render
+    const lines = render();
+    const listHeight = lines.length;
+    process.stdout.write(lines.join("\n") + "\n");
 
-      // Accept number
-      const num = parseInt(trimmed);
-      if (num >= 1 && num <= LANG_CODES.length) {
-        resolve(LANG_CODES[num - 1]);
-        return;
+    // Raw mode for keypress detection
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+
+    process.stdin.on("data", (key) => {
+      const k = key.toString();
+
+      // Ctrl+C
+      if (k === "\x03") {
+        process.stdin.setRawMode(false);
+        log("\n  Cancelled.\n");
+        process.exit(0);
+      }
+
+      // ESC (single byte only — arrow keys send \x1b[ which is 3 bytes)
+      if (k === "\x1b" && key.length === 1) {
+        process.stdin.setRawMode(false);
+        log("\n  Cancelled.\n");
+        process.exit(0);
       }
 
-      // Accept language code
-      if (isValidLang(trimmed)) {
-        resolve(trimmed);
+      // Up arrow
+      if (k === "\x1b[A") {
+        selected = (selected - 1 + total) % total;
+      }
+      // Down arrow
+      else if (k === "\x1b[B") {
+        selected = (selected + 1) % total;
+      }
+      // Number keys 1-9 (direct jump)
+      else if (k >= "1" && k <= "9" && parseInt(k) <= total) {
+        selected = parseInt(k) - 1;
+      }
+      // 0 for 10
+      else if (k === "0" && total >= 10) {
+        selected = 9;
+      }
+      // Enter
+      else if (k === "\r" || k === "\n") {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeAllListeners("data");
+        // Clear the list and reprint final selection
+        process.stdout.write(`\x1b[${listHeight}A`);
+        for (let i = 0; i < listHeight; i++) {
+          process.stdout.write("\x1b[2K\n");
+        }
+        process.stdout.write(`\x1b[${listHeight}A`);
+        log(`  ✅ ${LANG_CODES[selected]} — ${SUPPORTED_LANGS[LANG_CODES[selected]]}`);
+        log("");
+        resolve(LANG_CODES[selected]);
         return;
       }
+      else {
+        return; // Ignore other keys
+      }
 
-      log(`\n  ❌ Invalid selection: "${trimmed}"`);
-      log(`  Supported: ${LANG_CODES.join(", ")}\n`);
-      process.exit(1);
+      // Redraw list (clear each line to prevent ghost text from different-length strings)
+      process.stdout.write(`\x1b[${listHeight}A`);
+      const updated = render();
+      process.stdout.write(updated.map(l => `\x1b[2K${l}`).join("\n") + "\n");
     });
   });
 }
@@ -147,7 +259,9 @@ function readFile(p) {
 }
 
 function injectProjectRoot(text) {
-  return text.replace(/\{\{PROJECT_ROOT\}\}/g, PROJECT_ROOT);
+  // Normalize to forward slashes for prompts (Claude interprets backslashes as escapes)
+  const normalizedRoot = PROJECT_ROOT.replace(/\\/g, "/");
+  return text.replace(/\{\{PROJECT_ROOT\}\}/g, normalizedRoot);
 }
 
 // ─── Command: init ───────────────────────────────────────
@@ -269,6 +383,11 @@ async function cmdInit() {
     process.exit(1);
   }
   const totalGroups = domainGroups.totalGroups;
+  if (!totalGroups || typeof totalGroups !== "number" || totalGroups < 1) {
+    log(`    ❌ domain-groups.json has invalid totalGroups: ${totalGroups}`);
+    log("    Re-run plan-installer or check claudeos-core/generated/");
+    process.exit(1);
+  }
 
   // Load pass1 prompts by type
   const pass1Prompts = {};
@@ -302,8 +421,14 @@ async function cmdInit() {
 
     const pass1Json = path.join(GENERATED_DIR, `pass1-${i}.json`);
     if (fileExists(pass1Json)) {
-      log(`    ⏭️  pass1-${i}.json already exists, skipping`);
-      continue;
+      try {
+        const existing = JSON.parse(readFile(pass1Json));
+        if (existing && existing.analysisPerDomain) {
+          log(`    ⏭️  pass1-${i}.json already exists, skipping`);
+          continue;
+        }
+      } catch { /* malformed — re-run */ }
+      log(`    ⚠️  pass1-${i}.json exists but is malformed, re-running`);
     }
 
     // Select prompt for this type
@@ -342,9 +467,12 @@ async function cmdInit() {
   if (fileExists(pass2Json)) {
     log("    ⏭️  pass2-merged.json already exists, skipping");
   } else {
-    let prompt = injectProjectRoot(
-      readFile(path.join(GENERATED_DIR, "pass2-prompt.md"))
-    );
+    const pass2PromptFile = path.join(GENERATED_DIR, "pass2-prompt.md");
+    if (!fileExists(pass2PromptFile)) {
+      log("    ❌ pass2-prompt.md not found. Re-run plan-installer.");
+      process.exit(1);
+    }
+    let prompt = injectProjectRoot(readFile(pass2PromptFile));
 
     const ok = runClaudePrompt(prompt, { ignoreError: true });
 
@@ -365,9 +493,12 @@ async function cmdInit() {
   // ─── [6] Pass 3: Generate + verify ─────────────────────────
   header("[6] Pass 3 — Generating all files...");
 
-  let prompt = injectProjectRoot(
-    readFile(path.join(GENERATED_DIR, "pass3-prompt.md"))
-  );
+  const pass3PromptFile = path.join(GENERATED_DIR, "pass3-prompt.md");
+  if (!fileExists(pass3PromptFile)) {
+    log("    ❌ pass3-prompt.md not found. Re-run plan-installer.");
+    process.exit(1);
+  }
+  let prompt = injectProjectRoot(readFile(pass3PromptFile));
 
   const ok = runClaudePrompt(prompt, { ignoreError: true });
 
@@ -453,8 +584,12 @@ function countFiles() {
   try {
     let count = 0;
     const skipDirs = ["node_modules", "generated"];
+    const visited = new Set();
     const scan = (dir) => {
       if (!fs.existsSync(dir)) return;
+      const realDir = fs.realpathSync(dir);
+      if (visited.has(realDir)) return;
+      visited.add(realDir);
       for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
         if (skipDirs.includes(entry.name)) continue;
         const full = path.join(dir, entry.name);
@@ -465,7 +600,7 @@ function countFiles() {
     scan(path.join(PROJECT_ROOT, ".claude"));
     scan(path.join(PROJECT_ROOT, "claudeos-core"));
     return count;
-  } catch {
+  } catch (e) {
     return "?";
   }
 }
@@ -475,7 +610,7 @@ function countPass1Files() {
     return fs
       .readdirSync(GENERATED_DIR)
       .filter((f) => f.startsWith("pass1-") && f.endsWith(".json")).length;
-  } catch {
+  } catch (e) {
     return 0;
   }
 }
@@ -535,18 +670,18 @@ const args = process.argv.slice(2);
 const parsedArgs = parseArgs(args);
 const command = parsedArgs.command;
 
-if (!command || command === "--help" || command === "-h") {
+if (!command || command === "--help") {
   showHelp();
   process.exit(0);
 }
 
-if (command === "--version" || command === "-v") {
+if (command === "--version") {
   try {
     const pkg = JSON.parse(
       readFile(path.join(TOOLS_DIR, "package.json"))
     );
     log(`claudeos-core v${pkg.version}`);
-  } catch {
+  } catch (e) {
     log("claudeos-core (version unknown)");
   }
   process.exit(0);