@kitn.ai/cli 0.1.0

package/dist/doctor.es.js

@@ -0,0 +1,193 @@
+import { readFileSync, statSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+const KIT = "@kitn.ai/ui";
+const MCP = "@kitn.ai/mcp";
+const KAI_JSON = "kai.json";
+function readJson(file) {
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function compareVersions(a, b) {
+  const parts = (v) => v.split(/[.+-]/).map((p) => /^\d+$/.test(p) ? Number(p) : p);
+  const left = parts(a);
+  const right = parts(b);
+  for (let i = 0; i < Math.max(left.length, right.length); i += 1) {
+    const l = left[i] ?? 0;
+    const r = right[i] ?? 0;
+    if (l === r) continue;
+    if (typeof l !== typeof r) return typeof l === "number" ? 1 : -1;
+    return l < r ? -1 : 1;
+  }
+  return 0;
+}
+function sourceFiles(dir, limit = 400) {
+  const out = [];
+  const skip = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", ".next", ".svelte-kit", "coverage", ".astro", ".output"]);
+  const walk = (current) => {
+    if (out.length >= limit) return;
+    let entries;
+    try {
+      entries = readdirSync(current, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (out.length >= limit) return;
+      if (entry.isDirectory()) {
+        if (!skip.has(entry.name)) walk(join(current, entry.name));
+      } else if (/\.(?:[cm]?[jt]sx?|mdx?|astro|svelte|vue|html|css)$/.test(entry.name)) {
+        out.push(join(current, entry.name));
+      }
+    }
+  };
+  if (statSync(dir, { throwIfNoEntry: false })?.isDirectory()) walk(dir);
+  return out;
+}
+const readAll = (files) => files.flatMap((f) => {
+  try {
+    return [readFileSync(f, "utf8")];
+  } catch {
+    return [];
+  }
+});
+function diagnose(input) {
+  const findings = [];
+  const manifest = readJson(join(input.cwd, "package.json"));
+  if (!manifest) {
+    return [
+      {
+        severity: "error",
+        title: `no package.json in ${input.cwd}`,
+        detail: "kai doctor diagnoses a project, so run it from the project root."
+      }
+    ];
+  }
+  findings.push({
+    severity: "ok",
+    title: `kai ${input.cliVersion}`,
+    detail: `this CLI was built against @kitn.ai/ui ${input.builtAgainstKit}`
+  });
+  const deps = manifest.dependencies ?? {};
+  const devDeps = manifest.devDependencies ?? {};
+  const declared = deps[KIT] ?? devDeps[KIT];
+  if (declared === void 0) {
+    findings.push({
+      severity: "warn",
+      title: `this project does not depend on ${KIT}`,
+      detail: "nothing in package.json declares it, so the components cannot be imported yet."
+    });
+  } else {
+    findings.push({ severity: "ok", title: `${KIT} is declared as ${declared}` });
+  }
+  const installed = readJson(join(input.cwd, "node_modules", KIT, "package.json"));
+  const installedVersion = typeof installed?.version === "string" ? installed.version : void 0;
+  if (declared !== void 0 && installedVersion === void 0) {
+    findings.push({
+      severity: "error",
+      title: `${KIT} is declared but not installed`,
+      detail: "run your package manager's install (npm install / pnpm install / yarn)."
+    });
+  } else if (installedVersion !== void 0) {
+    findings.push({ severity: "ok", title: `${KIT} ${installedVersion} is installed` });
+    const cmp = compareVersions(installedVersion, input.builtAgainstKit);
+    if (cmp < 0) {
+      findings.push({
+        severity: "warn",
+        title: `this project's kit (${installedVersion}) is older than the kit this CLI was built against (${input.builtAgainstKit})`,
+        detail: "upgrade the kit, or install a CLI that matches it."
+      });
+    } else if (cmp > 0) {
+      findings.push({
+        severity: "info",
+        title: `this project's kit (${installedVersion}) is newer than the one this CLI was built against (${input.builtAgainstKit})`,
+        detail: "the CLI's own commands may lag the API it is describing; a newer CLI would match."
+      });
+    }
+  }
+  const kaiJson = readJson(join(input.cwd, KAI_JSON));
+  if (kaiJson) {
+    const framework = kaiJson.framework ?? "?";
+    const built = kaiJson.kitBuiltAgainst ?? "?";
+    const features = Array.isArray(kaiJson.features) ? kaiJson.features.join(", ") : "?";
+    findings.push({ severity: "ok", title: `${KAI_JSON}: framework ${framework}, features ${features}`, detail: `scaffolded against kit ${built}` });
+  } else {
+    findings.push({
+      severity: "info",
+      title: `no ${KAI_JSON}`,
+      detail: "this project was not scaffolded with `npm create kai`, which is fine for a hand-built app: nothing here depends on it."
+    });
+  }
+  if (declared !== void 0) {
+    const files = sourceFiles(join(input.cwd, "src"));
+    const contents = readAll(files);
+    const referencing = contents.filter((text) => text.includes(KIT)).length;
+    if (files.length > 0 && referencing === 0) {
+      findings.push({
+        severity: "warn",
+        title: `nothing under src/ references ${KIT}`,
+        detail: "the dependency is declared but unused, so no chat surface is rendering."
+      });
+    } else if (referencing > 0) {
+      findings.push({ severity: "ok", title: `${referencing} file(s) under src/ reference ${KIT}` });
+    }
+    const styled = contents.some((text) => /theme\.tokens\.css|theme\.css|solid\.css/.test(text));
+    if (files.length > 0 && !styled) {
+      findings.push({
+        severity: "info",
+        title: "no kit stylesheet is referenced",
+        detail: "import @kitn.ai/ui/theme.tokens.css (or theme.css inside a Tailwind build), or the components render unstyled."
+      });
+    }
+  }
+  const mcp = readJson(join(input.cwd, "node_modules", MCP, "package.json"));
+  findings.push(
+    mcp ? { severity: "ok", title: `${MCP} ${String(mcp.version)} is installed locally` } : {
+      severity: "info",
+      title: `${MCP} is not installed in this project`,
+      detail: "normal: an MCP client config runs it as `npx -y @kitn.ai/mcp`, so it needs no local install."
+    }
+  );
+  return findings;
+}
+function exitCodeFor(findings) {
+  return findings.some((f) => f.severity === "error") ? 1 : 0;
+}
+const MARK = { ok: "✓", info: "·", warn: "!", error: "✗" };
+function render(findings, out = console.log) {
+  for (const finding of findings) {
+    out(`${MARK[finding.severity]} ${finding.title}`);
+    if (finding.detail) out(`    ${finding.detail}`);
+  }
+  const errors = findings.filter((f) => f.severity === "error").length;
+  const warns = findings.filter((f) => f.severity === "warn").length;
+  out("");
+  out(
+    errors > 0 ? `✗ kai doctor: ${errors} problem(s)${warns > 0 ? `, ${warns} warning(s)` : ""}.` : `✓ kai doctor: no problems${warns > 0 ? `, ${warns} warning(s)` : ""}.`
+  );
+  return exitCodeFor(findings);
+}
+function cliVersion() {
+  try {
+    return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+async function runDoctor(argv = [], io = {}) {
+  const findings = diagnose({
+    cwd: io.cwd ?? process.cwd(),
+    cliVersion: cliVersion(),
+    builtAgainstKit: "0.33.0"
+  });
+  if (argv.includes("--json")) {
+    (io.out ?? console.log)(JSON.stringify({ findings }, null, 2));
+    return findings.some((f) => f.severity === "error") ? 1 : 0;
+  }
+  return render(findings, io.out);
+}
+export {
+  runDoctor
+};