claudeos-core 1.0.7 → 1.2.0

package/bootstrap.sh

@@ -2,10 +2,17 @@
 
 # ClaudeOS-Core — Bootstrap (3-Pass Auto)
 #
-# 원클릭 전체 시스템 자동 구축
-# 프로젝트 크기에 따라 Pass 1을 자동으로 N회 분할 실행
+# One-click full system auto-build
+# Automatically splits Pass 1 into N runs based on project size
 #
-# 실행: bash claudeos-core-tools/bootstrap.sh
+# Usage: bash claudeos-core-tools/bootstrap.sh --lang ko
+#        bash claudeos-core-tools/bootstrap.sh              (interactive)
+
+# Require bash (not sh/dash) — script uses bash arrays and [[ ]]
+if [ -z "$BASH_VERSION" ]; then
+  echo "❌ This script requires bash. Run with: bash $0" >&2
+  exit 1
+fi
 
 set -e
 
@@ -16,9 +23,63 @@ GENERATED_DIR="$PROJECT_ROOT/claudeos-core/generated"
 
 cd "$PROJECT_ROOT"
 
-# ─── 프롬프트 플레이스홀더 치환 헬퍼 ────────────────────
+# ─── Language selection (required) ──────────────────────────────
+SUPPORTED_LANGS=("en" "ko" "zh-CN" "ja" "es" "vi" "hi" "ru" "fr" "de")
+LANG_LABELS=("English" "한국어 (Korean)" "简体中文 (Chinese Simplified)" "日本語 (Japanese)" "Español (Spanish)" "Tiếng Việt (Vietnamese)" "हिन्दी (Hindi)" "Русский (Russian)" "Français (French)" "Deutsch (German)")
+
+CLAUDEOS_LANG=""
+
+# Parse --lang argument
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --lang) CLAUDEOS_LANG="$2"; shift 2 ;;
+    --lang=*) CLAUDEOS_LANG="${1#*=}"; shift ;;
+    *) echo "⚠️  Unknown argument: $1 (ignored)"; shift ;;
+  esac
+done
+
+# Interactive selection if --lang not provided
+if [ -z "$CLAUDEOS_LANG" ]; then
+  echo ""
+  echo "╔══════════════════════════════════════════════════╗"
+  echo "║  Select output language (required)               ║"
+  echo "╚══════════════════════════════════════════════════╝"
+  echo ""
+  for i in "${!SUPPORTED_LANGS[@]}"; do
+    printf "    %2d. %-6s — %s\n" "$((i+1))" "${SUPPORTED_LANGS[$i]}" "${LANG_LABELS[$i]}"
+  done
+  echo ""
+  read -p "  Enter number (1-10) or language code: " LANG_INPUT
+
+  # Accept number
+  if [[ "$LANG_INPUT" =~ ^[0-9]+$ ]] && [ "$LANG_INPUT" -ge 1 ] && [ "$LANG_INPUT" -le 10 ]; then
+    CLAUDEOS_LANG="${SUPPORTED_LANGS[$((LANG_INPUT-1))]}"
+  else
+    # Accept language code
+    CLAUDEOS_LANG="$LANG_INPUT"
+  fi
+fi
+
+# Validate
+VALID=false
+for l in "${SUPPORTED_LANGS[@]}"; do
+  if [ "$l" = "$CLAUDEOS_LANG" ]; then VALID=true; break; fi
+done
+if [ "$VALID" = false ]; then
+  echo ""
+  printf '  ❌ Unsupported language: "%s"\n' "$CLAUDEOS_LANG"
+  echo "  Supported: ${SUPPORTED_LANGS[*]}"
+  echo ""
+  exit 1
+fi
+
+export CLAUDEOS_LANG
+
+# ─── Prompt placeholder substitution helper ────────────────────
 inject_project_root() {
-  sed "s|{{PROJECT_ROOT}}|${PROJECT_ROOT}|g"
+  # Use perl with $ENV{} to avoid sed metachar issues with &, \, etc. in paths
+  export _PROJECT_ROOT="$PROJECT_ROOT"
+  perl -pe 's/\{\{PROJECT_ROOT\}\}/$ENV{_PROJECT_ROOT}/g'
 }
 
 echo ""
@@ -26,21 +87,28 @@ echo "╔═══════════════════════
 echo "║       ClaudeOS-Core — Bootstrap (3-Pass)          ║"
 echo "╚════════════════════════════════════════════════════╝"
 echo "    Project root: $PROJECT_ROOT"
+# Find label for selected lang
+for i in "${!SUPPORTED_LANGS[@]}"; do
+  if [ "${SUPPORTED_LANGS[$i]}" = "$CLAUDEOS_LANG" ]; then
+    echo "    Language:     ${LANG_LABELS[$i]} ($CLAUDEOS_LANG)"
+    break
+  fi
+done
 echo ""
 
-# ─── [1] 의존성 설치 ────────────────────────────────────
+# ─── [1] Install dependencies ────────────────────────────────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[1] Installing dependencies..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 cd "$TOOLS_DIR"
 if [ ! -d "node_modules" ]; then
-  npm install --silent 2>/dev/null
+  npm install --silent
 fi
 cd "$PROJECT_ROOT"
 echo "    ✅ Done"
 echo ""
 
-# ─── [2] 디렉토리 구조 생성 ─────────────────────────────
+# ─── [2] Create directory structure ─────────────────────────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[2] Creating directory structure..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -55,25 +123,31 @@ mkdir -p claudeos-core/mcp-guide
 echo "    ✅ Done"
 echo ""
 
-# ─── [3] plan-installer 실행 (프로젝트 분석) ────────────
+# ─── [3] Run plan-installer (project analysis) ────────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[3] Analyzing project (plan-installer)..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 node "$TOOLS_DIR/plan-installer/index.js"
 echo ""
 
-# ─── [4] Pass 1: 도메인 그룹별 분석 (멀티스택) ──────────
+# ─── [4] Pass 1: Deep analysis per domain group (multi-stack) ──────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[4] Pass 1 — Deep analysis per domain group..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# domain-groups.json에서 그룹 읽기
+# Read groups from domain-groups.json
 TOTAL_GROUPS=$(node -e "
   const g = require(process.argv[1]);
   console.log(g.totalGroups);
 " "$GENERATED_DIR/domain-groups.json")
 
-for i in $(seq 1 $TOTAL_GROUPS); do
+# Validate TOTAL_GROUPS is a positive integer
+if ! [[ "$TOTAL_GROUPS" =~ ^[0-9]+$ ]] || [ "$TOTAL_GROUPS" -lt 1 ]; then
+  echo "    ❌ Invalid TOTAL_GROUPS: '${TOTAL_GROUPS}'. domain-groups.json may be malformed."
+  exit 1
+fi
+
+for i in $(seq 1 "$TOTAL_GROUPS"); do
   DOMAIN_LIST=$(node -e "
     const g = require(process.argv[1]);
     console.log(g.groups[process.argv[2] - 1].domains.join(', '));
@@ -90,28 +164,37 @@ for i in $(seq 1 $TOTAL_GROUPS); do
   echo ""
   echo "    [Pass 1-${i}/${TOTAL_GROUPS}] (${GROUP_TYPE}) Analyzing: ${DOMAIN_LIST} (~${EST_FILES} files)"
 
-  # 이미 완료된 Pass는 skip
+  # Skip already completed passes
   if [ -f "$GENERATED_DIR/pass1-${i}.json" ]; then
     echo "    ⏭️  pass1-${i}.json already exists, skipping"
     continue
   fi
 
-  # 타입별 프롬프트 선택
+  # Select prompt by type
   PROMPT_FILE="$GENERATED_DIR/pass1-${GROUP_TYPE}-prompt.md"
   if [ ! -f "$PROMPT_FILE" ]; then
     PROMPT_FILE="$GENERATED_DIR/pass1-prompt.md"
   fi
   PASS1_TEMPLATE=$(cat "$PROMPT_FILE")
 
-  # 템플릿에서 플레이스홀더 치환
-  PASS1_PROMPT=$(echo "$PASS1_TEMPLATE" | sed "s|{{DOMAIN_GROUP}}|${DOMAIN_LIST}|g" | sed "s|{{PASS_NUM}}|${i}|g" | inject_project_root)
+  # Substitute placeholders via temp file (avoids sed special char issues with &, \, etc.)
+  TMP_PROMPT="$GENERATED_DIR/_tmp_pass1_prompt.md"
+  printf '%s' "$PASS1_TEMPLATE" > "$TMP_PROMPT"
+  # Use perl with $ENV{} for safe literal replacement (no shell interpolation into Perl code)
+  export _DOMAIN_LIST="$DOMAIN_LIST"
+  export _PASS_NUM="$i"
+  perl -pi -e 's/\{\{DOMAIN_GROUP\}\}/$ENV{_DOMAIN_LIST}/g' "$TMP_PROMPT"
+  perl -pi -e 's/\{\{PASS_NUM\}\}/$ENV{_PASS_NUM}/g' "$TMP_PROMPT"
+  # inject_project_root uses perl with $ENV{} which is safe for special chars in paths
+  PASS1_PROMPT=$(cat "$TMP_PROMPT" | inject_project_root)
+  rm -f "$TMP_PROMPT"
 
   if ! (cd "$PROJECT_ROOT" && claude -p "$PASS1_PROMPT" --dangerously-skip-permissions); then
     echo "    ❌ Pass 1-${i} failed. Aborting."
     exit 1
   fi
 
-  # JSON 생성 여부 확인
+  # Verify JSON was created
   if [ ! -f "$GENERATED_DIR/pass1-${i}.json" ]; then
     echo "    ❌ pass1-${i}.json was not created. Aborting."
     exit 1
@@ -121,7 +204,7 @@ for i in $(seq 1 $TOTAL_GROUPS); do
 done
 echo ""
 
-# ─── [5] Pass 2: 분석 결과 통합 ─────────────────────────
+# ─── [5] Pass 2: Merge analysis results ─────────────────────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[5] Pass 2 — Merging analysis results..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -145,7 +228,7 @@ else
 fi
 echo ""
 
-# ─── [6] Pass 3: 생성 + 마스터 플랜 빌드 + 검증 ────────
+# ─── [6] Pass 3: Generate + Master Plan build + verification ────────
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "[6] Pass 3 — Generating all files..."
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -162,7 +245,31 @@ if [ ! -f "$PROJECT_ROOT/CLAUDE.md" ]; then
 fi
 echo ""
 
-# ─── 완료 ───────────────────────────────────────────────
+# ─── [7] Run verification tools ───────────────────────────────
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "[7] Running verification tools..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ -f "$TOOLS_DIR/manifest-generator/index.js" ]; then
+  echo -n "    ⏳ manifest-generator..."
+  if node "$TOOLS_DIR/manifest-generator/index.js" > /dev/null 2>&1; then
+    echo " ✅"
+  else
+    echo " ❌ (non-fatal)"
+  fi
+fi
+
+if [ -f "$TOOLS_DIR/health-checker/index.js" ]; then
+  echo -n "    ⏳ health-checker..."
+  if node "$TOOLS_DIR/health-checker/index.js" > /dev/null 2>&1; then
+    echo " ✅"
+  else
+    echo " ⚠️  issues found (non-fatal)"
+  fi
+fi
+echo ""
+
+# ─── Complete ───────────────────────────────────────────────
 TOTAL_FILES=$(find .claude claudeos-core -type f 2>/dev/null | grep -v node_modules | wc -l | tr -d ' ')
 TOTAL_GROUPS_DONE=$TOTAL_GROUPS
 PASS1_FILES=$(ls -1 "$GENERATED_DIR"/pass1-*.json 2>/dev/null | wc -l | tr -d ' ')
@@ -179,6 +286,6 @@ echo "║   Verify anytime:                                  ║"
 echo "║   node claudeos-core-tools/health-checker/index.js ║"
 echo "║                                                    ║"
 echo "║   Start using:                                     ║"
-echo "║   \"CRUD 만들어줘\"                                   ║"
+echo "║   \"Create a CRUD for orders\"                     ║"
 echo "╚════════════════════════════════════════════════════╝"
 echo ""

package/content-validator/index.js

@@ -3,17 +3,17 @@
 /**
  * ClaudeOS-Core — Content Validator
  *
- * 역할: 생성된 파일의 내용 품질을 검증
- * 검증 항목:
- *   - 파일이 비어있지 않은지
- *   - standard 파일에 ✅/❌ 예시 + 규칙 테이블이 있는지
- *   - rules 파일에 paths: frontmatter + @import가 있는지
- *   - CLAUDE.md 필수 섹션 존재 여부
- *   - guide 9개 파일 전부 생성됐는지
- *   - skills 오케스트레이터 + 하위 스킬 존재 여부
- *   - database/, mcp-guide/ 파일 생성 여부
+ * Role: Validate content quality of generated files
+ * Validation items:
+ *   - File is not empty
+ *   - standard files contain ✅/❌ examples + rules table
+ *   - rules files contain paths: frontmatter + @import
+ *   - CLAUDE.md required sections exist
+ *   - All 9 guide files are generated
+ *   - Skills orchestrator + sub-skills exist
+ *   - database/, mcp-guide/ files are generated
  *
- * 실행: npx claudeos-core <cmd> 또는 node claudeos-core-tools/content-validator/index.js
+ * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/content-validator/index.js
  */
 
 const fs = require("fs");
@@ -41,21 +41,51 @@ async function main() {
   const warnings = [];
   let checked = 0;
 
+  // ─── Detect language and stack from project-analysis.json ────────
+  let detectedLanguage = null;
+  let outputLang = "en";
+  const paPath = path.join(GEN_DIR, "project-analysis.json");
+  if (fs.existsSync(paPath)) {
+    try {
+      const pa = JSON.parse(fs.readFileSync(paPath, "utf-8"));
+      detectedLanguage = pa.stack?.language || null;
+      outputLang = pa.lang || "en";
+    } catch { /* ignore */ }
+  }
+
+  // Language-aware section keywords for CLAUDE.md validation
+  const SECTION_KEYWORDS = {
+    en: ["Role", "Build", "Run", "Standard", "Skills"],
+    ko: ["역할", "빌드", "실행", "표준", "스킬"],
+    "zh-CN": ["角色", "构建", "运行", "标准", "技能"],
+    ja: ["役割", "ビルド", "実行", "標準", "スキル"],
+    es: ["Rol", "Compilar", "Ejecutar", "Estándar", "Habilidades"],
+    vi: ["Vai trò", "Build", "Chạy", "Tiêu chuẩn", "Kỹ năng"],
+    hi: ["भूमिका", "बिल्ड", "रन", "मानक", "कौशल"],
+    ru: ["Роль", "Сборка", "Запуск", "Стандарт", "Навыки"],
+    fr: ["Rôle", "Build", "Exécuter", "Standard", "Compétences"],
+    de: ["Rolle", "Build", "Ausführen", "Standard", "Fähigkeiten"],
+  };
+
   // ─── 1. CLAUDE.md ──────────────────────────────────────
   console.log("  [1/8] CLAUDE.md...");
   const claudeMd = path.join(ROOT, "CLAUDE.md");
   if (!fs.existsSync(claudeMd)) {
-    errors.push({ file: "CLAUDE.md", type: "MISSING", msg: "CLAUDE.md가 존재하지 않음" });
+    errors.push({ file: "CLAUDE.md", type: "MISSING", msg: "CLAUDE.md does not exist" });
   } else {
     checked++;
     const content = fs.readFileSync(claudeMd, "utf-8");
     if (content.trim().length < 100) {
-      errors.push({ file: "CLAUDE.md", type: "EMPTY", msg: "CLAUDE.md 내용이 너무 짧음 (<100자)" });
+      errors.push({ file: "CLAUDE.md", type: "EMPTY", msg: "CLAUDE.md content is too short (<100 chars)" });
     }
-    const requiredSections = ["Role", "Build", "Run", "Standard", "Skills"];
-    for (const sec of requiredSections) {
-      if (!content.toLowerCase().includes(sec.toLowerCase())) {
-        warnings.push({ file: "CLAUDE.md", type: "MISSING_SECTION", msg: `'${sec}' 섹션이 없음` });
+    // Check sections in both English (fallback) and output language
+    const langKeywords = SECTION_KEYWORDS[outputLang] || SECTION_KEYWORDS.en;
+    const enKeywords = SECTION_KEYWORDS.en;
+    for (let i = 0; i < enKeywords.length; i++) {
+      const candidates = [enKeywords[i], langKeywords[i]].filter(Boolean);
+      const found = candidates.some(kw => content.toLowerCase().includes(kw.toLowerCase()));
+      if (!found) {
+        warnings.push({ file: "CLAUDE.md", type: "MISSING_SECTION", msg: `'${enKeywords[i]}' / '${langKeywords[i]}' section is missing` });
       }
     }
   }
@@ -69,22 +99,26 @@ async function main() {
       const c = fs.readFileSync(f, "utf-8");
       const r = rel(f);
       if (c.trim().length === 0) {
-        errors.push({ file: r, type: "EMPTY", msg: "빈 파일" });
+        errors.push({ file: r, type: "EMPTY", msg: "Empty file" });
         continue;
       }
-      // sync 규칙은 paths 불필요
+      // sync rules don't need paths
       if (!r.includes("50.sync")) {
-        if (!c.includes("paths:") && !c.startsWith("---")) {
-          warnings.push({ file: r, type: "NO_FRONTMATTER", msg: "paths: frontmatter 없음" });
+        const hasFrontmatter = c.startsWith("---");
+        const hasPathsKey = c.includes("paths:");
+        if (!hasFrontmatter) {
+          warnings.push({ file: r, type: "NO_FRONTMATTER", msg: "Missing YAML frontmatter (---)" });
+        } else if (!hasPathsKey) {
+          warnings.push({ file: r, type: "NO_PATHS", msg: "Frontmatter exists but missing paths: key" });
         }
         if (!/^@[^\s]+/m.test(c)) {
-          warnings.push({ file: r, type: "NO_IMPORT", msg: "@import 참조 없음" });
+          warnings.push({ file: r, type: "NO_IMPORT", msg: "No @import reference found" });
         }
       }
     }
-    console.log(`    ${ruleFiles.length}개 파일 검사`);
+    console.log(`    ${ruleFiles.length} files checked`);
   } else {
-    errors.push({ file: ".claude/rules/", type: "MISSING", msg: "rules 디렉토리 없음" });
+    errors.push({ file: ".claude/rules/", type: "MISSING", msg: "rules directory not found" });
   }
 
   // ─── 3. claudeos-core/standard/** ─────────────────────
@@ -96,25 +130,59 @@ async function main() {
       const c = fs.readFileSync(f, "utf-8");
       const r = rel(f);
       if (c.trim().length === 0) {
-        errors.push({ file: r, type: "EMPTY", msg: "빈 파일" });
+        errors.push({ file: r, type: "EMPTY", msg: "Empty file" });
         continue;
       }
       if (c.length < 200) {
-        warnings.push({ file: r, type: "TOO_SHORT", msg: `내용이 짧음 (${c.length}자)` });
+        warnings.push({ file: r, type: "TOO_SHORT", msg: `Content is short (${c.length} chars)` });
       }
-      if (!c.includes("✅") && !c.includes("올바른") && !c.includes("correct") && !c.includes("GOOD")) {
-        warnings.push({ file: r, type: "NO_GOOD_EXAMPLE", msg: "올바른 예시(✅)가 없음" });
+      // Language-aware ✅/❌ example detection (all 10 supported languages)
+      const goodKeywords = [
+        "✅", "Correct", "correct", "GOOD",
+        "올바른",       // ko
+        "正确",         // zh-CN
+        "正しい",       // ja
+        "Correcto",    // es
+        "Đúng",        // vi
+        "सही",          // hi
+        "Правильн",    // ru
+        "Correct",     // fr (same as en)
+        "Richtig",     // de
+      ];
+      const badKeywords = [
+        "❌", "Incorrect", "incorrect", "BAD",
+        "잘못된",       // ko
+        "错误",         // zh-CN
+        "誤った",       // ja
+        "Incorrecto",  // es
+        "Sai",         // vi
+        "गलत",         // hi
+        "Неправильн",  // ru
+        "Incorrect",   // fr (same as en)
+        "Falsch",      // de
+      ];
+      if (!goodKeywords.some(kw => c.includes(kw))) {
+        warnings.push({ file: r, type: "NO_GOOD_EXAMPLE", msg: "No correct example (✅) found" });
       }
-      if (!c.includes("❌") && !c.includes("잘못된") && !c.includes("incorrect") && !c.includes("BAD")) {
-        warnings.push({ file: r, type: "NO_BAD_EXAMPLE", msg: "잘못된 예시(❌)가 없음" });
+      if (!badKeywords.some(kw => c.includes(kw))) {
+        warnings.push({ file: r, type: "NO_BAD_EXAMPLE", msg: "No incorrect example (❌) found" });
       }
-      if (!c.includes("|") && !c.includes("규칙") && !c.includes("Rule") && !c.includes("table")) {
-        warnings.push({ file: r, type: "NO_TABLE", msg: "규칙 요약 테이블이 없는 것으로 보임" });
+      if (!c.includes("|") && !c.includes("rule") && !c.includes("Rule") && !c.includes("table")) {
+        warnings.push({ file: r, type: "NO_TABLE", msg: "Rules summary table appears to be missing" });
+      }
+      // Kotlin code block check: core and backend standard files should contain ```kotlin blocks
+      if (detectedLanguage === "kotlin") {
+        const kotlinRelevantPaths = ["backend-api", "00.core/02.", "00.core/03.", "30.security-db"];
+        if (kotlinRelevantPaths.some(p => r.includes(p))) {
+          if (!c.includes("```kotlin") && !c.includes("```kt")) {
+            warnings.push({ file: r, type: "NO_KOTLIN_BLOCK", msg: "No ```kotlin code block found (expected for Kotlin project)" });
+          }
+        }
       }
     }
-    console.log(`    ${stdFiles.length}개 파일 검사`);
+    console.log(`    ${stdFiles.length} files checked`);
   } else {
-    errors.push({ file: "claudeos-core/standard/", type: "MISSING", msg: "standard 디렉토리 없음" });
+    errors.push({ file: "claudeos-core/standard/", type: "MISSING", msg: "standard directory not found" });
   }
 
   // ─── 4. claudeos-core/skills/** ────────────────────────
@@ -125,17 +193,17 @@ async function main() {
     for (const f of skillFiles) {
       const c = fs.readFileSync(f, "utf-8");
       if (c.trim().length === 0) {
-        errors.push({ file: rel(f), type: "EMPTY", msg: "빈 파일" });
+        errors.push({ file: rel(f), type: "EMPTY", msg: "Empty file" });
       }
     }
-    // 오케스트레이터 존재 확인
+    // Check orchestrator existence
     const orchestrators = skillFiles.filter(f => f.includes("01.scaffold") || f.includes("MANIFEST"));
     if (orchestrators.length === 0) {
-      warnings.push({ file: "claudeos-core/skills/", type: "NO_ORCHESTRATOR", msg: "오케스트레이터 또는 MANIFEST 없음" });
+      warnings.push({ file: "claudeos-core/skills/", type: "NO_ORCHESTRATOR", msg: "No orchestrator or MANIFEST found" });
     }
-    console.log(`    ${skillFiles.length}개 파일 검사 (오케스트레이터 ${orchestrators.length}개)`);
+    console.log(`    ${skillFiles.length} files checked (${orchestrators.length} orchestrators)`);
   } else {
-    errors.push({ file: "claudeos-core/skills/", type: "MISSING", msg: "skills 디렉토리 없음" });
+    errors.push({ file: "claudeos-core/skills/", type: "MISSING", msg: "skills directory not found" });
   }
 
   // ─── 5. claudeos-core/guide/** ─────────────────────────
@@ -156,17 +224,17 @@ async function main() {
       const gp = path.join(GUIDE_DIR, g);
       checked++;
       if (!fs.existsSync(gp)) {
-        errors.push({ file: `claudeos-core/guide/${g}`, type: "MISSING", msg: "가이드 파일 미생성" });
+        errors.push({ file: `claudeos-core/guide/${g}`, type: "MISSING", msg: "Guide file not generated" });
       } else {
         const c = fs.readFileSync(gp, "utf-8");
         if (c.trim().length === 0) {
-          errors.push({ file: `claudeos-core/guide/${g}`, type: "EMPTY", msg: "빈 파일" });
+          errors.push({ file: `claudeos-core/guide/${g}`, type: "EMPTY", msg: "Empty file" });
         }
       }
     }
-    console.log(`    ${expectedGuides.length}개 예상 파일 중 ${expectedGuides.filter(g => fs.existsSync(path.join(GUIDE_DIR, g))).length}개 존재`);
+    console.log(`    ${expectedGuides.filter(g => fs.existsSync(path.join(GUIDE_DIR, g))).length} of ${expectedGuides.length} expected files exist`);
   } else {
-    errors.push({ file: "claudeos-core/guide/", type: "MISSING", msg: "guide 디렉토리 없음" });
+    errors.push({ file: "claudeos-core/guide/", type: "MISSING", msg: "guide directory not found" });
   }
 
   // ─── 6. claudeos-core/plan/** ──────────────────────────
@@ -177,61 +245,61 @@ async function main() {
       checked++;
       const c = fs.readFileSync(f, "utf-8");
       if (c.trim().length === 0) {
-        errors.push({ file: rel(f), type: "EMPTY", msg: "빈 플랜 파일" });
+        errors.push({ file: rel(f), type: "EMPTY", msg: "Empty plan file" });
         continue;
       }
-      // <file> 블록이 있어야 함 (sync-rules-master는 코드블록 방식)
+      // Must contain <file> blocks (sync-rules-master uses code block format)
       const bn = path.basename(f);
       if (!bn.includes("sync")) {
         if (!c.includes("<file") && !c.includes("```")) {
-          warnings.push({ file: rel(f), type: "NO_FILE_BLOCKS", msg: "<file> 블록 또는 코드블록 없음" });
+          warnings.push({ file: rel(f), type: "NO_FILE_BLOCKS", msg: "No <file> blocks or code blocks found" });
         }
       }
     }
-    console.log(`    ${planFiles.length}개 파일 검사`);
+    console.log(`    ${planFiles.length} files checked`);
   } else {
-    errors.push({ file: "claudeos-core/plan/", type: "MISSING", msg: "plan 디렉토리 없음" });
+    errors.push({ file: "claudeos-core/plan/", type: "MISSING", msg: "plan directory not found" });
   }
 
   // ─── 7. claudeos-core/database/** ──────────────────────
   console.log("  [7/8] claudeos-core/database/...");
   if (fs.existsSync(DB_DIR)) {
-    const dbFiles = await glob("*.md", { cwd: DB_DIR, absolute: true });
+    const dbFiles = await glob("**/*.md", { cwd: DB_DIR, absolute: true });
     checked += dbFiles.length;
     if (dbFiles.length === 0) {
-      warnings.push({ file: "claudeos-core/database/", type: "NO_FILES", msg: "database 파일 없음" });
+      warnings.push({ file: "claudeos-core/database/", type: "NO_FILES", msg: "No database files found" });
     }
     for (const f of dbFiles) {
       const c = fs.readFileSync(f, "utf-8");
       if (c.trim().length === 0) {
-        errors.push({ file: rel(f), type: "EMPTY", msg: "빈 파일" });
+        errors.push({ file: rel(f), type: "EMPTY", msg: "Empty file" });
       }
     }
-    console.log(`    ${dbFiles.length}개 파일`);
+    console.log(`    ${dbFiles.length} files`);
   } else {
-    warnings.push({ file: "claudeos-core/database/", type: "MISSING", msg: "database 디렉토리 없음" });
+    warnings.push({ file: "claudeos-core/database/", type: "MISSING", msg: "database directory not found" });
   }
 
   // ─── 8. claudeos-core/mcp-guide/** ─────────────────────
   console.log("  [8/8] claudeos-core/mcp-guide/...");
   if (fs.existsSync(MCP_DIR)) {
-    const mcpFiles = await glob("*.md", { cwd: MCP_DIR, absolute: true });
+    const mcpFiles = await glob("**/*.md", { cwd: MCP_DIR, absolute: true });
     checked += mcpFiles.length;
     if (mcpFiles.length === 0) {
-      warnings.push({ file: "claudeos-core/mcp-guide/", type: "NO_FILES", msg: "mcp-guide 파일 없음" });
+      warnings.push({ file: "claudeos-core/mcp-guide/", type: "NO_FILES", msg: "No mcp-guide files found" });
     }
     for (const f of mcpFiles) {
       const c = fs.readFileSync(f, "utf-8");
       if (c.trim().length === 0) {
-        errors.push({ file: rel(f), type: "EMPTY", msg: "빈 파일" });
+        errors.push({ file: rel(f), type: "EMPTY", msg: "Empty file" });
       }
     }
-    console.log(`    ${mcpFiles.length}개 파일`);
+    console.log(`    ${mcpFiles.length} files`);
   } else {
-    warnings.push({ file: "claudeos-core/mcp-guide/", type: "MISSING", msg: "mcp-guide 디렉토리 없음" });
+    warnings.push({ file: "claudeos-core/mcp-guide/", type: "MISSING", msg: "mcp-guide directory not found" });
   }
 
-  // ─── 결과 출력 ─────────────────────────────────────────
+  // ─── Output results ─────────────────────────────────────────
   console.log(`\n  Checked ${checked} files\n`);
   if (errors.length) {
     console.log(`  ❌ ERRORS (${errors.length}):`);
@@ -247,10 +315,13 @@ async function main() {
     console.log("  ✅ All content validation passed\n");
   }
 
-  // stale-report에 기록
+  // Record in stale-report
   if (fs.existsSync(GEN_DIR)) {
     const rp = path.join(GEN_DIR, "stale-report.json");
-    const ex = fs.existsSync(rp) ? JSON.parse(fs.readFileSync(rp, "utf-8")) : {};
+    let ex = {};
+    if (fs.existsSync(rp)) {
+      try { ex = JSON.parse(fs.readFileSync(rp, "utf-8")); } catch { ex = {}; }
+    }
     ex.contentValidation = { checkedAt: new Date().toISOString(), checked, errors: errors.length, warnings: warnings.length, details: { errors, warnings } };
     ex.summary = { ...ex.summary, contentErrors: errors.length, contentWarnings: warnings.length };
     fs.writeFileSync(rp, JSON.stringify(ex, null, 2));