aiakiv 0.2.1 → 0.3.0

package/dist/enterprise/reportMarkdown.js

@@ -0,0 +1,188 @@
+// 점검 보고서 파일(report.json, report.md). 점검 본체의 `--out` 이 쓰는 것과 같은 이름과 형식을 이 CLI 가 쓴다.
+// 컨테이너에 --out 을 넘기지 않는 까닭: Linux 에서는 점검 컨테이너가 사용자 10001 로 돌아 붙인 폴더에 쓰지 못할 수
+// 있다(K2G packaging/enterprise/precheck/README.md §5 Q14). 그래서 --json 의 마지막 줄(보고서)을 받아 여기서 쓴다.
+//
+// 형식은 K2G src/k2g/selfhost/precheck/runner.py `_write_outputs` 와 report.py `to_markdown` 을 옮긴 것이다.
+// - report.json: json.dumps(보고서, ensure_ascii=False, indent=2) + "\n"
+// - report.md: to_markdown(보고서). 말은 설치 언어(en 기본, ko)를 따른다. 저쪽 문장을 바꾸면 여기도 함께 바꾼다.
+// 값을 글자로 바꾸는 str() 은 Python 과 같게 흉내 낸다(True, False, 목록과 사전의 repr). 깊은 중첩의 따옴표
+// 고르기 같은 세부는 다를 수 있다.
+import { parse as parseToml } from "smol-toml";
+const T = {
+    "status.pass": ["PASS", "통과"],
+    "status.warn": ["WARN", "주의"],
+    "status.fail": ["FAIL", "실패"],
+    "status.skip": ["SKIP", "건너뜀"],
+    "status.info": ["INFO", "정보"],
+    seconds: ["{s}s", "{s}초"],
+    minutes: ["{m}m {s}s", "{m}분 {s}초"],
+    "md.title": ["# AiAkiv enterprise pre-install check report", "# AiAkiv 유료 기업판 설치 전 점검 보고서"],
+    "md.tool": ["- Tool: {tool} {version}, engine {engine}", "- 도구: {tool} {version}, 엔진 {engine}"],
+    "md.time": ["- Started: {started}, finished: {finished}", "- 시작: {started}, 끝: {finished}"],
+    "md.result": ["- Result: {verdict} {counts}", "- 결과: {verdict}{counts}"],
+    "verdict.ok": ["no failures", "실패 없음"],
+    "verdict.fail": ["has failures", "실패 있음"],
+    counts: ["(pass {p}, warn {w}, fail {f}, skip {s}, info {i})", "(통과 {p}, 주의 {w}, 실패 {f}, 건너뜀 {s}, 정보 {i})"],
+    "md.mode": [
+        "- Login mode: {mode}, meets the quote and license conditions: {eligible}",
+        "- 로그인 방식: {mode}, 견적과 발급 조건 충족: {eligible}",
+    ],
+    yes: ["yes", "예"],
+    no: ["no", "아니오"],
+    "md.failed_required": ["- Required checks not met: {ids}", "- 충족하지 못한 필수 점검: {ids}"],
+    "md.sha": ["- Settings file sha256: {sha}", "- 설정 파일 sha256: {sha}"],
+    "md.warnings": ["## Settings warnings", "## 설정 경고"],
+    "md.target": ["## Target", "## 대상"],
+    "md.host": ["## Host", "## 호스트"],
+    "md.measurements": ["## Measurements", "## 측정값"],
+    "md.checks": ["## Checks", "## 점검"],
+    "md.header": ["| id | Result | Details | How to fix | Time |", "| id | 결과 | 내용 | 고칠 방법 | 시간 |"],
+    "md.details": ["## Check details", "## 점검 세부 값"],
+};
+function t(lang, key, args = {}) {
+    const pair = T[key];
+    const text = pair[lang === "ko" ? 1 : 0];
+    return text.replace(/\{(\w+)\}/g, (m, k) => (k in args ? String(args[k]) : m));
+}
+/**
+ * 점검의 설치 언어. 점검 본체(K2G k2g.selfhost.i18n.current_language)와 같은 순서로 이 CLI 가 볼 수 있는 것만 본다:
+ * 이 CLI 의 환경 변수 AIAKIV_LANGUAGE, 설정 파일 맨 위의 language, 기본 en. 작업 폴더 .env 의 AIAKIV_LANGUAGE 는
+ * 읽지 않는다(.env 는 열지 않는다).
+ */
+export function reportLanguage(env, configText) {
+    const norm = (v) => {
+        const s = typeof v === "string" ? v.trim().toLowerCase() : "";
+        return s === "en" || s === "ko" ? s : null;
+    };
+    const fromEnv = env.AIAKIV_LANGUAGE;
+    if (fromEnv !== undefined && fromEnv.trim())
+        return norm(fromEnv) ?? "en";
+    if (configText) {
+        try {
+            const v = parseToml(configText).language;
+            if (v !== undefined)
+                return norm(v) ?? "en";
+        }
+        catch {
+            /* 설정 파일을 못 읽으면 점검도 설정 오류로 끝난다. 말은 기본 */
+        }
+    }
+    return "en";
+}
+/** Python repr 흉내(목록과 사전 안의 값). */
+function pyRepr(v) {
+    if (v === null || v === undefined)
+        return "None";
+    if (typeof v === "boolean")
+        return v ? "True" : "False";
+    if (typeof v === "number")
+        return pyNumber(v);
+    if (typeof v === "string") {
+        const q = v.includes("'") && !v.includes('"') ? '"' : "'";
+        const body = v.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+        return q + (q === "'" ? body.replace(/'/g, "\\'") : body) + q;
+    }
+    if (Array.isArray(v))
+        return `[${v.map(pyRepr).join(", ")}]`;
+    if (typeof v === "object") {
+        return `{${Object.entries(v).map(([k, x]) => `${pyRepr(k)}: ${pyRepr(x)}`).join(", ")}}`;
+    }
+    return String(v);
+}
+function pyNumber(n) {
+    if (!Number.isFinite(n))
+        return n > 0 ? "inf" : n < 0 ? "-inf" : "nan";
+    return String(n);
+}
+/** Python str() 흉내. */
+function pyStr(v) {
+    if (typeof v === "string")
+        return v;
+    return pyRepr(v);
+}
+/** report.py `_cell`: None 은 빈 칸, | 는 \|, 줄바꿈은 빈칸. */
+function cell(v) {
+    return (v === null || v === undefined ? "" : pyStr(v)).replace(/\|/g, "\\|").replace(/\r/g, " ").replace(/\n/g, " ");
+}
+/** Python round() 의 짝수 쪽 반올림. */
+function roundHalfEven(x) {
+    const f = Math.floor(x);
+    const d = x - f;
+    if (d > 0.5)
+        return f + 1;
+    if (d < 0.5)
+        return f;
+    return f % 2 === 0 ? f : f + 1;
+}
+/**
+ * Python f"{ms/1000:.1f}". 정수 ms 에서 반 올림 경계가 정확히 걸리는 것은 ms % 500 == 250(1250 은 1.25 가 이진수로
+ * 정확하다)뿐이고, Python 은 그때 짝수 쪽(1.2), JS toFixed 는 큰 쪽(1.3)으로 간다. 그 경우만 따로 맞춘다.
+ */
+function oneDecimal(ms) {
+    if (Number.isInteger(ms) && ms % 500 === 250) {
+        const tenths = Math.floor(ms / 100);
+        return ((tenths % 2 === 0 ? tenths : tenths + 1) / 10).toFixed(1);
+    }
+    return (ms / 1000).toFixed(1);
+}
+/** report.py `fmt_ms`. */
+export function fmtMs(lang, ms) {
+    if (ms === null || ms === undefined)
+        return "-";
+    if (ms < 1000)
+        return `${Math.trunc(ms)}ms`;
+    const s = ms / 1000;
+    if (s < 60)
+        return t(lang, "seconds", { s: oneDecimal(ms) });
+    const m = Math.floor(s / 60);
+    return t(lang, "minutes", { m, s: roundHalfEven(s - m * 60) });
+}
+const STATUSES = ["pass", "warn", "fail", "skip", "info"];
+const statusLabel = (lang, s) => typeof s === "string" && STATUSES.includes(s) ? t(lang, `status.${s}`) : String(s);
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const entries = (v) => (isObj(v) ? Object.entries(v) : []);
+/** report.json 의 본문. */
+export function reportJsonText(report) {
+    return `${JSON.stringify(report, null, 2)}\n`;
+}
+/** report.md 의 본문(report.py `to_markdown`). */
+export function toMarkdown(r, lang) {
+    const q = isObj(r.quote) ? r.quote : {};
+    const s = isObj(r.summary) ? r.summary : {};
+    const n = (k) => s[k] ?? 0;
+    const verdict = t(lang, r.ok ? "verdict.ok" : "verdict.fail");
+    const counts = t(lang, "counts", { p: n("pass"), w: n("warn"), f: n("fail"), s: n("skip"), i: n("info") });
+    const lines = [
+        t(lang, "md.title"),
+        "",
+        t(lang, "md.tool", { tool: pyStr(r.tool), version: pyStr(r.tool_version), engine: pyStr(q.engine_version ?? "-") }),
+        t(lang, "md.time", { started: pyStr(r.started_at), finished: r.finished_at ? pyStr(r.finished_at) : "-" }),
+        t(lang, "md.result", { verdict, counts }),
+        t(lang, "md.mode", { mode: pyStr(q.mode ?? "-"), eligible: t(lang, q.eligible ? "yes" : "no") }),
+    ];
+    if (Array.isArray(q.failed_required) && q.failed_required.length) {
+        lines.push(t(lang, "md.failed_required", { ids: q.failed_required.map(pyStr).join(", ") }));
+    }
+    lines.push(t(lang, "md.sha", { sha: pyStr(q.config_sha256 ?? "-") }));
+    if (Array.isArray(r.warnings) && r.warnings.length) {
+        lines.push("", t(lang, "md.warnings"), "", ...r.warnings.map((w) => `- ${pyStr(w)}`));
+    }
+    lines.push("", t(lang, "md.target"), "", ...entries(r.target).map(([k, v]) => `- ${k}: ${cell(v)}`));
+    lines.push("", t(lang, "md.host"), "", ...entries(r.host).map(([k, v]) => `- ${k}: ${cell(v)}`));
+    lines.push("", t(lang, "md.measurements"), "", ...entries(r.measurements).map(([k, v]) => `- ${k}: ${cell(v)}`));
+    lines.push("", t(lang, "md.checks"), "", t(lang, "md.header"), "|---|---|---|---|---|");
+    const checks = Array.isArray(r.checks) ? r.checks.filter(isObj) : [];
+    for (const c of checks) {
+        const ms = typeof c.ms === "number" ? fmtMs(lang, c.ms) : "";
+        lines.push(`| ${cell(c.id)} | ${statusLabel(lang, c.status)} | ${cell(c.detail)} | ${cell(c.fix)} | ${ms} |`);
+    }
+    const withData = checks.filter((c) => c.data !== undefined && c.data !== null);
+    if (withData.length) {
+        lines.push("", t(lang, "md.details"));
+        for (const c of withData) {
+            lines.push("", `### ${pyStr(c.id)}`, "", "```json", JSON.stringify(c.data, null, 2), "```");
+        }
+    }
+    lines.push("", "## quote", "", "```json", JSON.stringify(q, null, 2), "```", "");
+    return lines.join("\n");
+}