aiakiv 0.2.2 → 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");
+}

package/dist/local/checks.js

@@ -309,6 +309,40 @@ export function checkEngineVersion(h) {
     const v = h.engine_version;
     return info(`엔진 판 ${typeof v === "string" && v ? v : "알 수 없음"}`);
 }
+// ---- 엔진 status 의 vectors 칸 --------------------------------------------------------------
+/**
+ * `aiakiv-admin --json status` 의 결과 문서(K2G src/k2g/selfhost/admin/status.py)에서 `vectors` 칸
+ * (vector_check.status_block: status 는 ok, info, warn, skip, 그리고 detail, fix)을 점검 한 줄로 옮긴다.
+ * 엔진의 detail 과 fix 는 그대로 싣는다. doc 이 null 이면 결과를 읽지 못한 것이고 why 가 이유다.
+ * 이 칸이 없는 옛 엔진 판은 알림으로 둔다.
+ */
+export function checkEngineVectors(doc, why = "") {
+    const logsFix = "엔진 로그(docker logs <엔진 컨테이너>)를 보세요.";
+    if (!doc)
+        return warn(`엔진 상태(aiakiv-admin status)를 읽지 못했습니다${why ? `: ${why}` : ""}`, logsFix);
+    if (doc.ok !== true) {
+        const msg = typeof doc.message === "string" && doc.message ? doc.message : String(doc.error ?? "이유 없음");
+        return warn(`엔진 상태(aiakiv-admin status)가 실패했습니다: ${msg}`, logsFix);
+    }
+    const v = doc.vectors;
+    if (!v || typeof v !== "object" || Array.isArray(v)) {
+        const ver = typeof doc.engine_version === "string" && doc.engine_version ? `, 엔진 판 ${doc.engine_version}` : "";
+        return info(`엔진 판이 벡터 없는 기억 점검을 지원하지 않아 보지 않았습니다(status 에 vectors 칸 없음${ver})`);
+    }
+    const b = v;
+    const detail = typeof b.detail === "string" && b.detail ? b.detail : "벡터 상태 내용 없음";
+    const fix = typeof b.fix === "string" && b.fix ? b.fix : null;
+    switch (b.status) {
+        case "ok":
+            return pass(detail);
+        case "warn":
+            return warn(detail, fix);
+        case "skip":
+            return skip(detail);
+        default:
+            return info(detail, fix);
+    }
+}
 /** `docker ps --format "{{.Image}}\t{{.Names}}\t{{.Ports}}"` 출력. */
 export function parseDockerPs(stdout) {
     return stdout

package/dist/local/doctor.js

@@ -1,6 +1,7 @@
 // `aiakiv local doctor [--json] [--out <파일.md>] [--port <n>] [--offline]` — 자체 설치판(무료 5인 엔진)을
 // 깔기 전에 이 컴퓨터를 점검한다(docs/211 §17.2 ~ §17.4). 엔진이 떠 있으면(그 포트의 /health 가 엔진처럼
-// 응답하면) 상태, 판 이름, 판, 포트가 묶인 주소도 본다. 보고서는 §17.3 형식이고 tool 은 aiakiv-local-doctor.
+// 응답하면) 상태, 판 이름, 판, 포트가 묶인 주소도 본다. 엔진 컨테이너가 떠 있으면 엔진의 `aiakiv-admin status` 에서
+// 벡터 없는 기억(vectors 칸)도 본다(engine.vectors). 보고서는 §17.3 형식이고 tool 은 aiakiv-local-doctor.
 // 호스티드 연결을 보는 `aiakiv doctor`(../doctor.ts)와는 별개다.
 //
 // 종료 코드: 0 fail 없음, 3 fail 있음, 4 docker 실행 파일이나 데몬에 닿지 못함(이때도 보고서는 낸다),
@@ -12,7 +13,8 @@ import { performance } from "node:perf_hooks";
 import { failReason } from "../proc.js";
 import { table } from "../render.js";
 import { VERSION } from "../version.js";
-import { checkCompose, checkDesktopLicense, checkDiskFree, checkDockerArch, checkDockerCpus, checkDockerMem, checkDockerOs, checkDockerVersion, checkEngineBind, checkEngineEdition, checkEngineHealth, checkEngineVersion, checkNodeVersion, checkOs, checkProxy, checkWsl2, daemonFix, diskCandidates, dockerInstallUrl, fail, hasProxyEnv, hostAddrsForPort, info, isDockerDesktop, isEngineContainer, isPermissionDenied, looksLikeEngineHealth, NET_TARGETS, NET_TIMEOUT_MS, netVerdict, parseDfAvailable, parseDockerInfo, parseDockerPs, parsePsFree, pass, publicIPv4s, reach, skip, gbText, } from "./checks.js";
+import { checkCompose, checkDesktopLicense, checkDiskFree, checkDockerArch, checkDockerCpus, checkDockerMem, checkDockerOs, checkDockerVersion, checkEngineBind, checkEngineEdition, checkEngineHealth, checkEngineVectors, checkEngineVersion, checkNodeVersion, checkOs, checkProxy, checkWsl2, daemonFix, diskCandidates, dockerInstallUrl, fail, hasProxyEnv, hostAddrsForPort, info, isDockerDesktop, isEngineContainer, isPermissionDenied, looksLikeEngineHealth, NET_TARGETS, NET_TIMEOUT_MS, netVerdict, parseDfAvailable, parseDockerInfo, parseDockerPs, parsePsFree, pass, publicIPv4s, reach, skip, gbText, } from "./checks.js";
+import { listContainers, parseEngineDoc, pickEngine } from "./portable.js";
 export const DEFAULT_ENGINE_PORT = 7777;
 export const LOCAL_DOCTOR_TOOL = "aiakiv-local-doctor";
 const DOCKER_TIMEOUT_MS = 30_000;
@@ -228,6 +230,30 @@ export async function collectLocalReport(ctx, opts, host) {
             return { ...v, detail: `${v.detail}(컨테이너 ${rows.map((r) => r.names).join(", ")})` };
         }, "engine");
     }
+    // 무료 5인판 엔진 컨테이너가 있으면 엔진의 status 에서 벡터 없는 기억(검색에 나오지 않음)을 본다. 컨테이너 찾기는
+    // local export, import 와 같다(portable.ts). 엔진 컨테이너가 하나도 없으면(설치 전) 이 줄을 내지 않는다.
+    // 엔진을 부르다 실패해도 주의나 알림까지만 낸다(종료 코드는 fail 만 바꾼다).
+    if (docker && st.info) {
+        const listed = await listContainers(ctx, docker);
+        const pick = listed.ok ? pickEngine(listed.rows) : null;
+        if (pick && pick.engines.length) {
+            await add("engine.vectors", async () => {
+                if (pick.running.length > 1) {
+                    return skip(`떠 있는 엔진 컨테이너가 여럿이라 보지 않았습니다(${pick.running.map((x) => x.name).join(", ")})`);
+                }
+                if (!pick.running.length) {
+                    const stopped = pick.engines.map((x) => `${x.name}(${x.state || "알 수 없음"})`).join(", ");
+                    return skip(`엔진 컨테이너가 떠 있지 않아 보지 않았습니다(${stopped})`);
+                }
+                const c = pick.running[0];
+                // 이 보고서의 말에 맞춰 엔진 문장도 한국어로 받는다(이 호출에만, 설치 언어는 그대로).
+                const r = await ctx.run(docker, ["exec", "-e", "AIAKIV_LANGUAGE=ko", c.name, "aiakiv-admin", "--json", "status"], { capture: true, timeoutMs: DOCKER_TIMEOUT_MS });
+                // 엔진은 실패해도(DB 연결 실패 등) JSON 문서를 낸다. 문서가 없을 때만 실행 실패로 본다.
+                const v = checkEngineVectors(parseEngineDoc(r.stdout), oneLine(failReason(r)));
+                return { ...v, detail: `${v.detail}(컨테이너 ${c.name})` };
+            }, "engine");
+        }
+    }
     const summary = { pass: 0, warn: 0, fail: 0, skip: 0, info: 0 };
     for (const c of checks)
         summary[c.status] += 1;