claudeos-core 1.0.7 → 1.2.0

package/health-checker/index.js

@@ -3,16 +3,16 @@
 /**
  * ClaudeOS-Core — Health Checker
  *
- * 역할: 모든 검증 도구를 순서대로 실행하고 종합 결과를 출력
- * 실행 순서:
- *   [0] manifest-generator  ← 선행 필수: sync-map.json 등 메타데이터 생성
- *   [1] import-linter        ← @import 경로 검증
- *   [2] plan-validator       ← Plan ↔ 디스크 정합성
- *   [3] sync-checker         ← sync-map.json 기반 동기화 확인 (manifest 필요)
- *   [4] content-validator    ← 생성 파일 품질 검증
- *   [5] pass-json-validator  ← Pass 1~3 JSON 포맷 검증
+ * Role: Execute all verification tools sequentially and output consolidated results
+ * Execution order:
+ *   [0] manifest-generator  ← prerequisite: generates metadata like sync-map.json
+ *   [1] import-linter        ← @import path validation
+ *   [2] plan-validator       ← Plan ↔ disk consistency
+ *   [3] sync-checker         ← sync verification based on sync-map.json (requires manifest)
+ *   [4] content-validator    ← generated file quality validation
+ *   [5] pass-json-validator  ← Pass 1-3 JSON format validation
  *
- * 실행: npx claudeos-core <cmd> 또는 node claudeos-core-tools/health-checker/index.js
+ * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/health-checker/index.js
  */
 
 const { execSync } = require("child_process");
@@ -41,30 +41,30 @@ function main() {
   console.log("║  ClaudeOS-Core — Health Checker       ║");
   console.log("╚══════════════════════════════════════╝\n");
 
-  // ─── [0] manifest-generator 선행 실행 ──────────────────
-  // sync-checker가 sync-map.json을 읽으므로 반드시 먼저 실행해야 함
+  // ─── [0] Run manifest-generator first (prerequisite) ──────────────────
+  // Must run first because sync-checker reads sync-map.json
   const manifestScript = path.join(TOOLS, "manifest-generator/index.js");
   if (fs.existsSync(manifestScript)) {
-    process.stdout.write("  ⏳ manifest-generator — 메타데이터 생성...");
+    process.stdout.write("  ⏳ manifest-generator — generating metadata...");
     const r = run("manifest-generator", manifestScript);
     if (r.ok) {
       console.log(" ✅");
     } else {
       console.log(" ❌");
-      console.log("  ⚠️  manifest-generator 실패. 이후 sync-checker 결과가 부정확할 수 있음.");
+      console.log("  ⚠️  manifest-generator failed. Subsequent sync-checker results may be inaccurate.");
     }
   } else {
     console.log("  ⏭️  manifest-generator — not found");
   }
   console.log();
 
-  // ─── [1~5] 검증 도구 순서대로 실행 ────────────────────
+  // ─── [1-5] Run verification tools sequentially ────────────────────
   const tools = [
-    { name: "import-linter",       script: path.join(TOOLS, "import-linter/index.js"),       desc: "@import 검증"   },
-    { name: "plan-validator",      script: path.join(TOOLS, "plan-validator/index.js"),      desc: "Plan 정합성"    },
-    { name: "sync-checker",        script: path.join(TOOLS, "sync-checker/index.js"),        desc: "동기화 상태"    },
-    { name: "content-validator",   script: path.join(TOOLS, "content-validator/index.js"),   desc: "내용 품질"      },
-    { name: "pass-json-validator", script: path.join(TOOLS, "pass-json-validator/index.js"), desc: "JSON 포맷"      },
+    { name: "import-linter",       script: path.join(TOOLS, "import-linter/index.js"),       desc: "@import validation"          },
+    { name: "plan-validator",      script: path.join(TOOLS, "plan-validator/index.js"),      desc: "Plan consistency"           },
+    { name: "sync-checker",        script: path.join(TOOLS, "sync-checker/index.js"),        desc: "Sync status"                },
+    { name: "content-validator",   script: path.join(TOOLS, "content-validator/index.js"),   desc: "Content quality"            },
+    { name: "pass-json-validator", script: path.join(TOOLS, "pass-json-validator/index.js"), desc: "JSON format", warnOnly: true },
   ];
 
   const results = [];
@@ -81,6 +81,9 @@ function main() {
     if (r.ok) {
       console.log(" ✅");
       results.push({ name: t.name, status: "pass" });
+    } else if (t.warnOnly) {
+      console.log(" ⚠️");
+      results.push({ name: t.name, status: "warn" });
     } else {
       console.log(" ❌");
       results.push({ name: t.name, status: "fail" });
@@ -88,10 +91,10 @@ function main() {
     }
   }
 
-  // ─── 결과 요약 ──────────────────────────────────────────
+  // ─── Results summary ──────────────────────────────────────────
   console.log("\n  ══════════════════════════════");
   results.forEach((r) => {
-    const icon = r.status === "pass" ? "✅" : r.status === "fail" ? "❌" : "⏭️";
+    const icon = r.status === "pass" ? "✅" : r.status === "fail" ? "❌" : r.status === "warn" ? "⚠️" : "⏭️";
     console.log(`  ${icon} ${r.name.padEnd(22)} ${r.status}`);
   });
   console.log("  ──────────────────────────────");
@@ -102,10 +105,13 @@ function main() {
   );
   console.log("  ══════════════════════════════\n");
 
-  // ─── stale-report.json 갱신 ────────────────────────────
+  // ─── Update stale-report.json ────────────────────────────
   if (fs.existsSync(GEN)) {
     const rp = path.join(GEN, "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.generatedAt = new Date().toISOString();
     ex.healthCheck = { results, status: hasErr ? "fail" : "pass" };
     ex.summary = {

package/import-linter/index.js

@@ -3,13 +3,13 @@
 /**
  * ClaudeOS-Core — Import Linter
  *
- * 역할: .claude/rules/, standard/, skills/, guide/ 내 @import 경로 검증
- * 검증 항목:
- *   - BROKEN:   대상 파일이 존재하지 않는 @import
- *   - DUPLICATE: 같은 파일에서 동일 경로를 중복 @import
- *   - CIRCULAR: @import 체인이 순환하는 경우 (DFS 탐지)
+ * Role: Validate @import paths in .claude/rules/, standard/, skills/, guide/
+ * Validation items:
+ *   - BROKEN:   @import pointing to non-existent file
+ *   - DUPLICATE: Same path imported multiple times in the same file
+ *   - CIRCULAR: Circular @import chain detected (DFS)
  *
- * 실행: npx claudeos-core <cmd> 또는 node claudeos-core-tools/import-linter/index.js
+ * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/import-linter/index.js
  */
 
 const fs = require("fs");
@@ -22,6 +22,8 @@ const SCAN = [
   "claudeos-core/standard",
   "claudeos-core/skills",
   "claudeos-core/guide",
+  "claudeos-core/database",
+  "claudeos-core/mcp-guide",
 ];
 
 function rel(p) {
@@ -31,8 +33,12 @@ function rel(p) {
 function extractImports(f) {
   const content = fs.readFileSync(f, "utf-8");
   const result = [];
+  let inCodeFence = false;
   content.split("\n").forEach((line, i) => {
-    const m = line.match(/^@([^\s]+)/);
+    // Track code fence boundaries to skip @-lines inside code blocks
+    if (/^```/.test(line)) { inCodeFence = !inCodeFence; return; }
+    if (inCodeFence) return;
+    const m = line.match(/^@(\.\.?\/[^\s]+)/);
     if (m) {
       const target = path.resolve(path.dirname(f), m[1]);
       result.push({
@@ -133,7 +139,7 @@ async function main() {
     }
   }
 
-  // 순환 참조 탐지
+  // Cycle detection
   for (const c of detectCycles(adj)) {
     errors.push({
       type: "CIRCULAR",

package/manifest-generator/index.js

@@ -3,15 +3,15 @@
 /**
  * ClaudeOS-Core — Manifest Generator
  *
- * 역할: 생성된 파일들의 메타데이터 JSON 4종 + stale-report 초기화
- * 출력 (claudeos-core/generated/):
- *   - rule-manifest.json   : rules/standard/skills/guide 파일 목록 + frontmatter
- *   - import-graph.json    : @import 의존성 그래프 (노드 + 엣지)
- *   - sync-map.json        : plan/ <file> 블록 → 파일 경로 매핑
- *   - plan-manifest.json   : plan/ 파일 목록 + <file> 블록 수
- *   - stale-report.json    : 초기화 (이후 각 검증 도구가 누적 기록)
+ * Role: Generate 4 types of metadata JSON + initialize stale-report
+ * Output (claudeos-core/generated/):
+ *   - rule-manifest.json   : rules/standard/skills/guide file list + frontmatter
+ *   - import-graph.json    : @import dependency graph (nodes + edges)
+ *   - sync-map.json        : plan/ <file> block → file path mapping
+ *   - plan-manifest.json   : plan/ file list + <file> block count
+ *   - stale-report.json    : initialized (each verification tool appends results)
  *
- * 실행: npx claudeos-core <cmd> 또는 node claudeos-core-tools/manifest-generator/index.js
+ * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/manifest-generator/index.js
  */
 
 const fs = require("fs");
@@ -57,15 +57,19 @@ function frontmatter(f) {
 function extractImports(f) {
   const content = fs.readFileSync(f, "utf-8");
   const result = [];
-  let m;
-  const re = /^@([^\s]+)/gm;
-  while ((m = re.exec(content)) !== null) {
-    const target = path.resolve(path.dirname(f), m[1]);
-    result.push({
-      raw: m[0],
-      resolved: rel(target),
-      exists: fs.existsSync(target),
-    });
+  let inCodeFence = false;
+  for (const line of content.split("\n")) {
+    if (/^```/.test(line)) { inCodeFence = !inCodeFence; continue; }
+    if (inCodeFence) continue;
+    const m = line.match(/^@(\.\.?\/[^\s]+)/);
+    if (m) {
+      const target = path.resolve(path.dirname(f), m[1]);
+      result.push({
+        raw: m[0],
+        resolved: rel(target),
+        exists: fs.existsSync(target),
+      });
+    }
   }
   return result;
 }
@@ -136,8 +140,10 @@ async function main() {
   const gr = { generatedAt: new Date().toISOString(), nodes: [], edges: [], errors: [] };
   const ns = new Set();
 
-  if (fs.existsSync(DIRS.rules)) {
-    for (const f of await glob("**/*.md", { cwd: DIRS.rules, absolute: true })) {
+  const importScanDirs = [DIRS.rules, DIRS.standard, DIRS.skills, DIRS.guide, DIRS.database, DIRS.mcpGuide].filter(Boolean);
+  for (const scanDir of importScanDirs) {
+    if (!fs.existsSync(scanDir)) continue;
+    for (const f of await glob("**/*.md", { cwd: scanDir, absolute: true })) {
       const r = rel(f);
       ns.add(r);
       for (const i of extractImports(f)) {
@@ -183,7 +189,7 @@ async function main() {
   fs.writeFileSync(path.join(GEN, "plan-manifest.json"), JSON.stringify(pm, null, 2));
   console.log(`  ✅ plan-manifest.json — ${pm.plans.length} plans`);
 
-  // ─── stale-report.json 초기화 ──────────────────────────
+  // ─── Initialize stale-report.json ──────────────────────────
   fs.writeFileSync(
     path.join(GEN, "stale-report.json"),
     JSON.stringify({ generatedAt: new Date().toISOString(), summary: { totalIssues: 0, status: "initial" } }, null, 2)

package/package.json

@@ -1,75 +1,84 @@
-{
-  "name": "claudeos-core",
-  "version": "1.0.7",
-  "description": "Auto-generate Claude Code documentation from your actual source code — Standards, Rules, Skills, and Guides tailored to your project",
-  "main": "health-checker/index.js",
-  "bin": {
-    "claudeos-core": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "content-validator/",
-    "health-checker/",
-    "import-linter/",
-    "manifest-generator/",
-    "pass-json-validator/",
-    "pass-prompts/",
-    "plan-installer/",
-    "plan-validator/",
-    "sync-checker/",
-    "bootstrap.sh",
-    "README.md",
-    "README.ko.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
-    "README.zh-CN.md",
-    "README.ja.md",
-    "README.es.md",
-    "README.vi.md",
-    "README.hi.md",
-    "README.ru.md",
-    "README.fr.md",
-    "README.de.md"
-  ],
-  "scripts": {
-    "init": "node bin/cli.js init",
-    "health": "node bin/cli.js health",
-    "validate": "node bin/cli.js validate",
-    "refresh": "node bin/cli.js refresh",
-    "restore": "node bin/cli.js restore",
-    "test": "node health-checker/index.js"
-  },
-  "keywords": [
-    "claude-code",
-    "automation",
-    "code-analysis",
-    "CLAUDE.md",
-    "standards",
-    "rules",
-    "skills",
-    "scaffolding",
-    "spring-boot",
-    "nextjs",
-    "express",
-    "django",
-    "fastapi"
-  ],
-  "author": "claudeos-core <claudeoscore@gmail.com> (https://github.com/claudeos-core)",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/claudeos-core/claudeos-core.git"
-  },
-  "homepage": "https://github.com/claudeos-core/claudeos-core#readme",
-  "bugs": {
-    "url": "https://github.com/claudeos-core/claudeos-core/issues"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "glob": "^13.0.6",
-    "gray-matter": "^4.0.3"
-  }
-}
+{
+  "name": "claudeos-core",
+  "version": "1.2.0",
+  "description": "Auto-generate Claude Code documentation from your actual source code — Standards, Rules, Skills, and Guides tailored to your project",
+  "main": "bin/cli.js",
+  "bin": {
+    "claudeos-core": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "content-validator/",
+    "health-checker/",
+    "import-linter/",
+    "manifest-generator/",
+    "pass-json-validator/",
+    "pass-prompts/",
+    "plan-installer/",
+    "plan-validator/",
+    "sync-checker/",
+    "bootstrap.sh",
+    "README.md",
+    "README.ko.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "README.zh-CN.md",
+    "README.ja.md",
+    "README.es.md",
+    "README.vi.md",
+    "README.hi.md",
+    "README.ru.md",
+    "README.fr.md",
+    "README.de.md"
+  ],
+  "scripts": {
+    "init": "node bin/cli.js init",
+    "health": "node bin/cli.js health",
+    "validate": "node bin/cli.js validate",
+    "refresh": "node bin/cli.js refresh",
+    "restore": "node bin/cli.js restore",
+    "test": "node health-checker/index.js"
+  },
+  "keywords": [
+    "claude-code",
+    "automation",
+    "code-analysis",
+    "CLAUDE.md",
+    "standards",
+    "rules",
+    "skills",
+    "scaffolding",
+    "i18n",
+    "multi-language",
+    "spring-boot",
+    "kotlin",
+    "exposed",
+    "jooq",
+    "cqrs",
+    "bff",
+    "multi-module",
+    "monorepo",
+    "nextjs",
+    "express",
+    "django",
+    "fastapi"
+  ],
+  "author": "claudeos-core <claudeoscore@gmail.com> (https://github.com/claudeos-core)",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/claudeos-core/claudeos-core.git"
+  },
+  "homepage": "https://github.com/claudeos-core/claudeos-core#readme",
+  "bugs": {
+    "url": "https://github.com/claudeos-core/claudeos-core/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "glob": "^13.0.6",
+    "gray-matter": "^4.0.3"
+  }
+}