claudeos-core 1.0.7 → 1.2.0

package/bin/cli.js

@@ -5,12 +5,13 @@
  *
  * Node.js replacement for bootstrap.sh with cross-platform support.
  * Usage:
- *   npx claudeos-core init          ← Run 3-Pass pipeline
- *   npx claudeos-core health        ← Run health checker
- *   npx claudeos-core validate      ← Run plan validator (--check)
- *   npx claudeos-core restore       ← Restore from Master Plan
- *   npx claudeos-core refresh       ← Sync disk → Plan
- *   npx claudeos-core --help        ← Show help
+ *   npx claudeos-core init --lang ko  ← Run 3-Pass pipeline (Korean output)
+ *   npx claudeos-core init            ← Interactive language selection
+ *   npx claudeos-core health          ← Run health checker
+ *   npx claudeos-core validate        ← Run plan validator (--check)
+ *   npx claudeos-core restore         ← Restore from Master Plan
+ *   npx claudeos-core refresh         ← Sync disk → Plan
+ *   npx claudeos-core --help          ← Show help
  *
  * Also works when cloned directly:
  *   node claudeos-core-tools/bin/cli.js init
@@ -20,16 +21,75 @@ const { execSync } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 
-// ─── 경로 설정 ──────────────────────────────────────────
+// ─── Path configuration ──────────────────────────────────────────
 const TOOLS_DIR = path.resolve(__dirname, "..");
 const PROJECT_ROOT = process.cwd();
 const GENERATED_DIR = path.join(PROJECT_ROOT, "claudeos-core/generated");
 
-// 하위 도구(plan-installer 등)가 프로젝트 루트를 올바르게 인식하도록 환경변수 설정
-// (npm/npx 실행 시 __dirname 기반 계산이 틀리므로 필수)
+// Set env var so sub-tools (plan-installer, etc.) correctly resolve the project root
+// (Required because __dirname-based calculation is incorrect when run via npm/npx)
 process.env.CLAUDEOS_ROOT = PROJECT_ROOT;
 
-// ─── 유틸리티 ───────────────────────────────────────────
+// ─── Language configuration ──────────────────────────────────────
+const SUPPORTED_LANGS = {
+  en:      "English",
+  ko:      "한국어 (Korean)",
+  "zh-CN": "简体中文 (Chinese Simplified)",
+  ja:      "日本語 (Japanese)",
+  es:      "Español (Spanish)",
+  vi:      "Tiếng Việt (Vietnamese)",
+  hi:      "हिन्दी (Hindi)",
+  ru:      "Русский (Russian)",
+  fr:      "Français (French)",
+  de:      "Deutsch (German)",
+};
+const LANG_CODES = Object.keys(SUPPORTED_LANGS);
+
+function isValidLang(lang) {
+  return LANG_CODES.includes(lang);
+}
+
+// Interactive language selection (stdin prompt)
+function selectLangInteractive() {
+  return new Promise((resolve) => {
+    const readline = require("readline");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    log("");
+    log("╔══════════════════════════════════════════════════╗");
+    log("║  Select output 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();
+
+      // Accept number
+      const num = parseInt(trimmed);
+      if (num >= 1 && num <= LANG_CODES.length) {
+        resolve(LANG_CODES[num - 1]);
+        return;
+      }
+
+      // Accept language code
+      if (isValidLang(trimmed)) {
+        resolve(trimmed);
+        return;
+      }
+
+      log(`\n  ❌ Invalid selection: "${trimmed}"`);
+      log(`  Supported: ${LANG_CODES.join(", ")}\n`);
+      process.exit(1);
+    });
+  });
+}
+
+// ─── Utilities ───────────────────────────────────────────
 function log(msg) {
   console.log(msg);
 }
@@ -46,6 +106,7 @@ function run(cmd, options = {}) {
       cwd: options.cwd || PROJECT_ROOT,
       stdio: options.silent ? ["pipe", "pipe", "pipe"] : "inherit",
       encoding: "utf-8",
+      timeout: options.timeout || 0, // no timeout (Pass 1-3 can take 10+ minutes)
     });
     return true;
   } catch (e) {
@@ -54,26 +115,20 @@ function run(cmd, options = {}) {
   }
 }
 
-// claude -p 실행: 프롬프트를 파일에 저장 후 파이프로 전달 (Windows 8191자 제한 우회)
+// Run claude -p: pass prompt via stdin (no shell pipe — avoids command injection)
 function runClaudePrompt(prompt, options = {}) {
-  const tmpFile = path.join(GENERATED_DIR, "_tmp_prompt.md");
-  fs.writeFileSync(tmpFile, prompt, "utf-8");
   try {
-    const catCmd = process.platform === "win32" ? "type" : "cat";
-    const escaped = escapeShellArg(tmpFile);
-    const cmd = `${catCmd} ${escaped} | claude -p --dangerously-skip-permissions`;
-    execSync(cmd, {
+    execSync("claude -p --dangerously-skip-permissions", {
+      input: prompt,
       cwd: options.cwd || PROJECT_ROOT,
-      stdio: "inherit",
+      stdio: ["pipe", "inherit", "inherit"],
       encoding: "utf-8",
-      shell: true,
+      timeout: 0, // no timeout (Claude analysis can be long-running)
     });
     return true;
   } catch (e) {
     if (options.ignoreError) return false;
     throw e;
-  } finally {
-    try { fs.unlinkSync(tmpFile); } catch {}
   }
 }
 
@@ -95,9 +150,19 @@ function injectProjectRoot(text) {
   return text.replace(/\{\{PROJECT_ROOT\}\}/g, PROJECT_ROOT);
 }
 
-// ─── 명령어: init ───────────────────────────────────────
+// ─── Command: init ───────────────────────────────────────
 async function cmdInit() {
-  // ─── 사전 조건 체크 ───────────────────────────────────
+  // ─── Prerequisites check ───────────────────────────────────
+  // Validate PROJECT_ROOT is a plausible project directory
+  const hasProjectMarker = [".git", "package.json", "build.gradle", "build.gradle.kts", "pom.xml", "pyproject.toml", "requirements.txt"].some(
+    m => fs.existsSync(path.join(PROJECT_ROOT, m))
+  );
+  if (!hasProjectMarker) {
+    log(`\n  ⚠️  Warning: ${PROJECT_ROOT} does not look like a project root.`);
+    log("  No .git, package.json, build.gradle, or pom.xml found.");
+    log("  Run this command from your project directory.\n");
+  }
+
   const nodeVersion = parseInt(process.versions.node.split(".")[0]);
   if (nodeVersion < 18) {
     log(`\n  ❌ Node.js v18+ required (current: v${process.versions.node})`);
@@ -113,21 +178,44 @@ async function cmdInit() {
     process.exit(1);
   }
 
+  // Verify Claude is authenticated (quick prompt test)
+  const claudeAuth = run('claude -p "echo ok" --max-tokens 10', { silent: true, ignoreError: true });
+  if (!claudeAuth) {
+    log("\n  ⚠️  Claude Code may not be authenticated.");
+    log("  Run: claude (and complete authentication)");
+    log("  Then retry: npx claudeos-core init\n");
+    process.exit(1);
+  }
+
+  // ─── Language selection (required) ────────────────────────────
+  let lang = parsedArgs.lang;
+  if (!lang) {
+    // Interactive selection if --lang not provided
+    lang = await selectLangInteractive();
+  }
+  if (!isValidLang(lang)) {
+    log(`\n  ❌ Unsupported language: "${lang}"`);
+    log(`  Supported: ${LANG_CODES.join(", ")}\n`);
+    process.exit(1);
+  }
+  process.env.CLAUDEOS_LANG = lang;
+
   log("");
   log("╔════════════════════════════════════════════════════╗");
   log("║       ClaudeOS-Core — Bootstrap (3-Pass)          ║");
   log("╚════════════════════════════════════════════════════╝");
   log(`    Project root: ${PROJECT_ROOT}`);
+  log(`    Language:     ${SUPPORTED_LANGS[lang]} (${lang})`);
   log("");
 
-  // ─── [1] 의존성 설치 ────────────────────────────────
+  // ─── [1] Install dependencies ────────────────────────────────
   header("[1] Installing dependencies...");
   if (!fileExists(path.join(TOOLS_DIR, "node_modules"))) {
     run("npm install --silent", { cwd: TOOLS_DIR });
   }
   log("    ✅ Done\n");
 
-  // ─── [2] 디렉토리 구조 생성 ─────────────────────────
+  // ─── [2] Create directory structure ─────────────────────────
   header("[2] Creating directory structure...");
   const dirs = [
     ".claude/rules/00.core",
@@ -162,20 +250,27 @@ async function cmdInit() {
   }
   log("    ✅ Done\n");
 
-  // ─── [3] plan-installer 실행 ─────────────────────────
+  // ─── [3] Run plan-installer ─────────────────────────
   header("[3] Analyzing project (plan-installer)...");
   run(`node "${path.join(TOOLS_DIR, "plan-installer/index.js")}"`);
   log("");
 
-  // ─── [4] Pass 1: 도메인 그룹별 분석 ──────────────────
+  // ─── [4] Pass 1: Deep analysis per domain group ──────────────────
   header("[4] Pass 1 — Deep analysis per domain group...");
 
-  const domainGroups = JSON.parse(
-    readFile(path.join(GENERATED_DIR, "domain-groups.json"))
-  );
+  let domainGroups;
+  try {
+    domainGroups = JSON.parse(
+      readFile(path.join(GENERATED_DIR, "domain-groups.json"))
+    );
+  } catch (e) {
+    log(`    ❌ domain-groups.json is missing or malformed: ${e.message}`);
+    log("    Re-run plan-installer or check claudeos-core/generated/");
+    process.exit(1);
+  }
   const totalGroups = domainGroups.totalGroups;
 
-  // 타입별 pass1 프롬프트 로드
+  // Load pass1 prompts by type
   const pass1Prompts = {};
   for (const type of ["backend", "frontend"]) {
     const promptFile = path.join(GENERATED_DIR, `pass1-${type}-prompt.md`);
@@ -183,12 +278,16 @@ async function cmdInit() {
       pass1Prompts[type] = readFile(promptFile);
     }
   }
-  // 단일스택 하위 호환
+  // Single-stack backward compatibility
   if (Object.keys(pass1Prompts).length === 0) {
     const fallback = path.join(GENERATED_DIR, "pass1-prompt.md");
     if (fileExists(fallback)) pass1Prompts["backend"] = readFile(fallback);
   }
 
+  if (!domainGroups.groups || totalGroups !== domainGroups.groups.length) {
+    log(`    ❌ domain-groups.json is malformed: expected ${totalGroups} groups, found ${domainGroups.groups ? domainGroups.groups.length : 0}`);
+    process.exit(1);
+  }
   for (let i = 1; i <= totalGroups; i++) {
     const group = domainGroups.groups[i - 1];
     const domainList = group.domains.join(", ");
@@ -207,14 +306,14 @@ async function cmdInit() {
       continue;
     }
 
-    // 해당 타입의 프롬프트 선택
+    // Select prompt for this type
     const template = pass1Prompts[groupType] || pass1Prompts["backend"];
     if (!template) {
       log(`    ❌ No pass1 prompt found for type: ${groupType}. Aborting.`);
       process.exit(1);
     }
 
-    // 플레이스홀더 치환
+    // Placeholder substitution
     let prompt = template
       .replace(/\{\{DOMAIN_GROUP\}\}/g, domainList)
       .replace(/\{\{PASS_NUM\}\}/g, String(i));
@@ -236,7 +335,7 @@ async function cmdInit() {
   }
   log("");
 
-  // ─── [5] Pass 2: 분석 결과 통합 ──────────────────────
+  // ─── [5] Pass 2: Merge analysis results ──────────────────────
   header("[5] Pass 2 — Merging analysis results...");
 
   const pass2Json = path.join(GENERATED_DIR, "pass2-merged.json");
@@ -263,7 +362,7 @@ async function cmdInit() {
   }
   log("");
 
-  // ─── [6] Pass 3: 생성 + 검증 ─────────────────────────
+  // ─── [6] Pass 3: Generate + verify ─────────────────────────
   header("[6] Pass 3 — Generating all files...");
 
   let prompt = injectProjectRoot(
@@ -283,7 +382,7 @@ async function cmdInit() {
   }
   log("");
 
-  // ─── [7] 검증 도구 실행 ───────────────────────────────
+  // ─── [7] Run verification tools ───────────────────────────────
   header("[7] Running verification tools...");
 
   const verifyTools = [
@@ -303,7 +402,7 @@ async function cmdInit() {
   }
   log("");
 
-  // ─── 완료 ─────────────────────────────────────────────
+  // ─── Complete ─────────────────────────────────────────────
   const totalFiles = countFiles();
   const pass1Files = countPass1Files();
 
@@ -314,6 +413,7 @@ async function cmdInit() {
   log(`║   Files created:     ${pad(String(totalFiles), 29)}║`);
   log(`║   Domains analyzed:  ${pad(totalGroups + " groups", 29)}║`);
   log(`║   Analysis passes:   ${pad(pass1Files + " pass1 files", 29)}║`);
+  log(`║   Output language:   ${pad(SUPPORTED_LANGS[lang] || lang, 29)}║`);
   log("║                                                    ║");
   log("║   Verify anytime:                                  ║");
   log("║   npx claudeos-core health                         ║");
@@ -324,35 +424,27 @@ async function cmdInit() {
   log("");
 }
 
-// ─── 명령어: health ─────────────────────────────────────
+// ─── Command: health ─────────────────────────────────────
 function cmdHealth() {
   run(`node "${path.join(TOOLS_DIR, "health-checker/index.js")}"`);
 }
 
-// ─── 명령어: validate ───────────────────────────────────
+// ─── Command: validate ───────────────────────────────────
 function cmdValidate() {
   run(`node "${path.join(TOOLS_DIR, "plan-validator/index.js")}" --check`);
 }
 
-// ─── 명령어: restore ────────────────────────────────────
+// ─── Command: restore ────────────────────────────────────
 function cmdRestore() {
   run(`node "${path.join(TOOLS_DIR, "plan-validator/index.js")}" --execute`);
 }
 
-// ─── 명령어: refresh ────────────────────────────────────
+// ─── Command: refresh ────────────────────────────────────
 function cmdRefresh() {
   run(`node "${path.join(TOOLS_DIR, "plan-validator/index.js")}" --refresh`);
 }
 
-// ─── 헬퍼 ───────────────────────────────────────────────
-function escapeShellArg(arg) {
-  // Cross-platform shell argument escaping
-  if (process.platform === "win32") {
-    return `"${arg.replace(/"/g, '\\"')}"`;
-  }
-  return `'${arg.replace(/'/g, "'\\''")}'`;
-}
-
+// ─── Helpers ───────────────────────────────────────────────
 function pad(str, len) {
   return str.length >= len ? str : str + " ".repeat(len - str.length);
 }
@@ -360,10 +452,11 @@ function pad(str, len) {
 function countFiles() {
   try {
     let count = 0;
+    const skipDirs = ["node_modules", "generated"];
     const scan = (dir) => {
       if (!fs.existsSync(dir)) return;
       for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-        if (entry.name === "node_modules") continue;
+        if (skipDirs.includes(entry.name)) continue;
         const full = path.join(dir, entry.name);
         if (entry.isDirectory()) scan(full);
         else count++;
@@ -403,19 +496,44 @@ Commands:
   restore     Restore all files from Master Plan
 
 Options:
+  --lang CODE Output language for generated files (required for init)
+              Supported: en, ko, zh-CN, ja, es, vi, hi, ru, fr, de
+              If omitted, interactive selection is shown.
   --help      Show this help message
   --version   Show version
 
 Examples:
-  npx claudeos-core init       # First-time setup
-  npx claudeos-core health     # Check everything is consistent
-  npx claudeos-core restore    # Recover from corrupted docs
+  npx claudeos-core init --lang ko    # Generate in Korean
+  npx claudeos-core init --lang ja    # Generate in Japanese
+  npx claudeos-core init              # Interactive language selection
+  npx claudeos-core health            # Check everything is consistent
+  npx claudeos-core restore           # Recover from corrupted docs
 `);
 }
 
-// ─── 메인 ───────────────────────────────────────────────
+// ─── Argument parser ────────────────────────────────────────
+function parseArgs(argv) {
+  const result = { command: null, lang: null };
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--lang" && i + 1 < argv.length) {
+      result.lang = argv[++i];
+    } else if (argv[i].startsWith("--lang=")) {
+      result.lang = argv[i].split("=")[1];
+    } else if (argv[i] === "--help" || argv[i] === "-h") {
+      result.command = "--help";
+    } else if (argv[i] === "--version" || argv[i] === "-v") {
+      result.command = "--version";
+    } else if (!argv[i].startsWith("-") && !result.command) {
+      result.command = argv[i];
+    }
+  }
+  return result;
+}
+
+// ─── Main ───────────────────────────────────────────────
 const args = process.argv.slice(2);
-const command = args[0];
+const parsedArgs = parseArgs(args);
+const command = parsedArgs.command;
 
 if (!command || command === "--help" || command === "-h") {
   showHelp();
@@ -423,10 +541,14 @@ if (!command || command === "--help" || command === "-h") {
 }
 
 if (command === "--version" || command === "-v") {
-  const pkg = JSON.parse(
-    readFile(path.join(TOOLS_DIR, "package.json"))
-  );
-  log(`claudeos-core v${pkg.version}`);
+  try {
+    const pkg = JSON.parse(
+      readFile(path.join(TOOLS_DIR, "package.json"))
+    );
+    log(`claudeos-core v${pkg.version}`);
+  } catch {
+    log("claudeos-core (version unknown)");
+  }
   process.exit(0);
 }