// 스킬 문서의 최소 규약을 검사한다. CI 와 `pnpm test` 가 함께 쓴다.
// - SKILL.md 존재와 프론트매터 필수 필드
// - description 길이(트리거 정확도에 직접 영향)
// - references 링크가 실제 파일을 가리키는지
import fs from "node:fs/promises";
import path from "node:path";

const root = path.resolve(process.argv[2] ?? ".");
const errors = [];
const warnings = [];

const skillPath = path.join(root, "SKILL.md");
let md;
try {
  md = await fs.readFile(skillPath, "utf8");
} catch {
  console.error(`SKILL.md 를 찾을 수 없다: ${skillPath}`);
  process.exit(1);
}

const fmMatch = /^---\r?\n([\s\S]*?)\r?\n---/.exec(md);
if (!fmMatch) {
  errors.push("프론트매터(---)가 없다");
} else {
  const fm = Object.fromEntries(
    fmMatch[1]
      .split(/\r?\n/)
      .map((l) => /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(l))
      .filter(Boolean)
      .map((m) => [m[1], m[2].replace(/^["']|["']$/g, "")]),
  );
  if (fm.name !== "designpaca") errors.push(`name 이 designpaca 가 아니다: ${fm.name}`);
  if (!fm.description) errors.push("description 이 없다");
  else {
    const len = fm.description.length;
    if (len < 80) warnings.push(`description 이 짧다(${len}자) — 트리거 정확도가 떨어진다`);
    if (len > 700) warnings.push(`description 이 길다(${len}자) — 요약해라`);
  }
}

// 본문이 참조하는 파일이 실제로 있는지 확인한다 (references/xxx.md 형태)
const refs = [...md.matchAll(/references\/[A-Za-z0-9._/-]+\.md/g)].map((m) => m[0]);
for (const rel of new Set(refs)) {
  try {
    await fs.access(path.join(root, rel));
  } catch {
    errors.push(`본문이 가리키는 참조 문서가 없다: ${rel}`);
  }
}

// 참조 문서가 본문 어디에서도 언급되지 않으면 죽은 문서다
async function walk(dir, base = dir) {
  const out = [];
  let entries = [];
  try {
    entries = await fs.readdir(dir, { withFileTypes: true });
  } catch {
    return out;
  }
  for (const e of entries) {
    const full = path.join(dir, e.name);
    if (e.isDirectory()) out.push(...(await walk(full, base)));
    else out.push(path.relative(base, full).split(path.sep).join("/"));
  }
  return out;
}
const refDir = path.join(root, "references");
for (const f of await walk(refDir, root)) {
  if (!f.endsWith(".md")) continue;
  const rel = f.split(path.sep).join("/");
  if (!md.includes(rel)) warnings.push(`본문에서 참조되지 않는 문서: ${rel}`);
}

for (const w of warnings) console.warn(`  경고: ${w}`);
if (errors.length > 0) {
  for (const e of errors) console.error(`  오류: ${e}`);
  console.error(`\n스킬 검사 실패 — 오류 ${errors.length}건`);
  process.exit(1);
}
console.log(`스킬 검사 통과 (경고 ${warnings.length}건)`);