@kitnai/cli 0.1.15 → 0.1.17

package/README.md

@@ -27,14 +27,27 @@ pnpm dlx @kitnai/cli init
 Initialize kitn in your project. Creates `kitn.json`, installs the core engine and Hono routes, and sets up tsconfig path aliases.
 
 ```bash
+# Interactive (prompts for runtime and base directory)
 kitn init
+
+# Non-interactive with flags
+kitn init --runtime bun --base src/ai
+
+# Accept all defaults (runtime=bun, base=src/ai)
+kitn init -y
 ```
 
-Prompts for:
-- **Runtime**: bun, node, or deno
-- **Install path**: Base directory for kitn components (defaults to `src/ai`)
+**Flags:**
+
+| Flag | Description |
+|------|-------------|
+| `-r, --runtime <runtime>` | Runtime to use (`bun`, `node`, `deno`) — skips runtime prompt |
+| `-b, --base <path>` | Base directory for components (default: `src/ai`) — skips path prompt |
+| `-y, --yes` | Accept all defaults without prompting |
+
+When flags are provided, the corresponding prompts are skipped. This enables scripting and CI usage.
 
-After answering, the CLI automatically installs the core engine and HTTP routes into your project.
+After setup, the CLI automatically installs the core engine and HTTP routes into your project.
 
 ### `kitn add [components...]`
 
@@ -180,6 +193,16 @@ kitn build
 kitn build src/components --output dist/r
 ```
 
+### `kitn check`
+
+Check for CLI updates.
+
+```bash
+kitn check
+```
+
+Shows the current version and whether a newer version is available on npm.
+
 ### `kitn registry`
 
 Manage component registries.

package/dist/index.js

@@ -9,6 +9,86 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/utils/update-check.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { join } from "path";
+import { homedir } from "os";
+import pc from "picocolors";
+async function readCache() {
+  try {
+    const raw = await readFile(CACHE_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function writeCache(entry) {
+  try {
+    await mkdir(CACHE_DIR, { recursive: true });
+    await writeFile(CACHE_FILE, JSON.stringify(entry));
+  } catch {
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    const res = await fetch("https://registry.npmjs.org/@kitnai/cli/latest", {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewer(latest, current) {
+  const [lMaj, lMin, lPat] = latest.split(".").map(Number);
+  const [cMaj, cMin, cPat] = current.split(".").map(Number);
+  if (lMaj !== cMaj) return lMaj > cMaj;
+  if (lMin !== cMin) return lMin > cMin;
+  return lPat > cPat;
+}
+function startUpdateCheck(currentVersion) {
+  let message = "";
+  const check = (async () => {
+    const cache = await readCache();
+    let latest = null;
+    if (cache && Date.now() - cache.checkedAt < CHECK_INTERVAL) {
+      latest = cache.latest;
+    } else {
+      latest = await fetchLatestVersion();
+      if (latest) {
+        await writeCache({ latest, checkedAt: Date.now() });
+      }
+    }
+    if (latest && isNewer(latest, currentVersion)) {
+      message = [
+        "",
+        pc.yellow(`  Update available: ${pc.dim(currentVersion)} \u2192 ${pc.green(latest)}`),
+        pc.dim(`  Run ${pc.cyan("npx @kitnai/cli@latest")} or ${pc.cyan("npm i -g @kitnai/cli")}`),
+        ""
+      ].join("\n");
+    }
+  })();
+  check.catch(() => {
+  });
+  return () => {
+    if (message) process.stderr.write(message);
+  };
+}
+var CACHE_DIR, CACHE_FILE, CHECK_INTERVAL;
+var init_update_check = __esm({
+  "src/utils/update-check.ts"() {
+    "use strict";
+    CACHE_DIR = join(homedir(), ".kitn");
+    CACHE_FILE = join(CACHE_DIR, "update-check.json");
+    CHECK_INTERVAL = 60 * 60 * 1e3;
+  }
+});
+
 // src/utils/config.ts
 import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { join as join2 } from "path";
@@ -103,6 +183,20 @@ function patchTsconfig(tsconfigContent, paths, removePrefixes) {
   for (const [key, value] of Object.entries(paths)) {
     config.compilerOptions.paths[key] = value;
   }
+  const ES_TARGETS = ["es3", "es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021"];
+  const currentTarget = (config.compilerOptions.target ?? "").toLowerCase();
+  if (!currentTarget || ES_TARGETS.includes(currentTarget)) {
+    config.compilerOptions.target = "ES2022";
+  }
+  if (!config.compilerOptions.moduleResolution) {
+    config.compilerOptions.moduleResolution = "bundler";
+  }
+  if (!config.compilerOptions.module) {
+    config.compilerOptions.module = "ESNext";
+  }
+  if (config.compilerOptions.skipLibCheck === void 0) {
+    config.compilerOptions.skipLibCheck = true;
+  }
   return JSON.stringify(config, null, 2) + "\n";
 }
 async function patchProjectTsconfig(projectDir, paths, removePrefixes) {
@@ -341,6 +435,23 @@ function installDependencies(pm, deps, projectDir) {
   })();
   execSync(cmd, { cwd: projectDir, stdio: "pipe" });
 }
+function installDevDependencies(pm, deps, projectDir) {
+  if (deps.length === 0) return;
+  const pkgs = deps.join(" ");
+  const cmd = (() => {
+    switch (pm) {
+      case "bun":
+        return `bun add -d ${pkgs}`;
+      case "pnpm":
+        return `pnpm add -D ${pkgs}`;
+      case "yarn":
+        return `yarn add -D ${pkgs}`;
+      case "npm":
+        return `npm install -D ${pkgs}`;
+    }
+  })();
+  execSync(cmd, { cwd: projectDir, stdio: "pipe" });
+}
 var init_dep_installer = __esm({
   "src/installers/dep-installer.ts"() {
     "use strict";
@@ -679,8 +790,17 @@ async function addCommand(components, opts) {
   const updated = [];
   const skipped = [];
   const allDeps = [];
+  const allDevDeps = [];
   for (const item of resolved) {
     if (item.dependencies) allDeps.push(...item.dependencies);
+    if (item.devDependencies) allDevDeps.push(...item.devDependencies);
+    const existingInstall = (config.installed ?? {})[item.name];
+    if (existingInstall && item.type === "kitn:package") {
+      const allContent = item.files.map((f) => f.content).join("\n");
+      if (contentHash(allContent) === existingInstall.hash) {
+        continue;
+      }
+    }
     if (item.type === "kitn:package") {
       const baseDir2 = config.aliases.base ?? "src/ai";
       for (const file of item.files) {
@@ -850,12 +970,15 @@ async function addCommand(components, opts) {
   }
   await writeConfig(cwd, config);
   const uniqueDeps = [...new Set(allDeps)];
-  if (uniqueDeps.length > 0) {
+  const uniqueDevDeps = [...new Set(allDevDeps)].filter((d) => !uniqueDeps.includes(d));
+  const totalDeps = uniqueDeps.length + uniqueDevDeps.length;
+  if (totalDeps > 0) {
     const pm = await detectPackageManager(cwd);
     if (pm) {
-      s.start(`Installing ${uniqueDeps.length} npm dependenc${uniqueDeps.length === 1 ? "y" : "ies"}...`);
+      s.start(`Installing ${totalDeps} npm dependenc${totalDeps === 1 ? "y" : "ies"}...`);
       try {
-        installDependencies(pm, uniqueDeps, cwd);
+        if (uniqueDeps.length > 0) installDependencies(pm, uniqueDeps, cwd);
+        if (uniqueDevDeps.length > 0) installDevDependencies(pm, uniqueDevDeps, cwd);
         s.stop("Dependencies installed");
       } catch {
         s.stop(pc3.yellow("Some dependencies failed to install"));
@@ -863,7 +986,7 @@ async function addCommand(components, opts) {
     }
   }
   if (created.length > 0) {
-    p2.log.success(`Created ${created.length} file(s):
+    p2.log.success(`Added ${created.length} file(s):
 ` + created.map((f) => `  ${pc3.green("+")} ${f}`).join("\n"));
   }
   if (updated.length > 0) {
@@ -881,13 +1004,14 @@ async function addCommand(components, opts) {
       p2.log.info(`${pc3.bold(item.name)}: ${item.docs}`);
     }
   }
-  const installedNames = new Set(resolved.map((r) => r.name));
+  const resolvedNames = new Set(resolved.map((r) => r.name));
+  const projectInstalled = new Set(Object.keys(config.installed ?? {}));
   const hints = [];
-  if (installedNames.has("core") && !installedNames.has(config.framework ?? "hono")) {
+  const fw = config.framework ?? "hono";
+  if (resolvedNames.has("core") && !resolvedNames.has(fw) && !projectInstalled.has(fw)) {
     hints.push(`Run ${pc3.cyan(`kitn add routes`)} to install the HTTP adapter.`);
   }
-  const fw = config.framework ?? "hono";
-  if (installedNames.has(fw) || installedNames.has("core") && installedNames.has(fw)) {
+  if (resolvedNames.has(fw)) {
     hints.push(`Configure your AI provider in ${pc3.bold(baseDir + "/plugin.ts")}, then add to your server:`);
     hints.push("");
     hints.push(pc3.dim(`  import { ai } from "./${baseDir.replace(/^src\//, "")}/plugin";`));
@@ -928,43 +1052,66 @@ import * as p3 from "@clack/prompts";
 import pc4 from "picocolors";
 import { mkdir as mkdir4, writeFile as writeFile7 } from "fs/promises";
 import { join as join8 } from "path";
-async function initCommand() {
+async function initCommand(opts = {}) {
   p3.intro(pc4.bgCyan(pc4.black(" kitn init ")));
   const cwd = process.cwd();
   const existing = await readConfig(cwd);
   if (existing) {
-    p3.log.warn("kitn.json already exists in this directory.");
-    const shouldContinue = await p3.confirm({
-      message: "Overwrite existing configuration?",
-      initialValue: false
+    if (opts.yes) {
+      p3.log.warn("kitn.json already exists \u2014 overwriting (--yes).");
+    } else {
+      p3.log.warn("kitn.json already exists in this directory.");
+      const shouldContinue = await p3.confirm({
+        message: "Overwrite existing configuration?",
+        initialValue: false
+      });
+      if (p3.isCancel(shouldContinue) || !shouldContinue) {
+        p3.cancel("Init cancelled.");
+        process.exit(0);
+      }
+    }
+  }
+  let runtime;
+  if (opts.runtime) {
+    if (!["bun", "node", "deno"].includes(opts.runtime)) {
+      p3.log.error(`Invalid runtime: ${opts.runtime}. Must be bun, node, or deno.`);
+      process.exit(1);
+    }
+    runtime = opts.runtime;
+  } else if (opts.yes) {
+    runtime = "bun";
+  } else {
+    const selected = await p3.select({
+      message: "Which runtime do you use?",
+      options: [
+        { value: "bun", label: "Bun", hint: "recommended" },
+        { value: "node", label: "Node.js" },
+        { value: "deno", label: "Deno" }
+      ]
     });
-    if (p3.isCancel(shouldContinue) || !shouldContinue) {
+    if (p3.isCancel(selected)) {
       p3.cancel("Init cancelled.");
       process.exit(0);
     }
+    runtime = selected;
   }
-  const runtime = await p3.select({
-    message: "Which runtime do you use?",
-    options: [
-      { value: "bun", label: "Bun", hint: "recommended" },
-      { value: "node", label: "Node.js" },
-      { value: "deno", label: "Deno" }
-    ]
-  });
-  if (p3.isCancel(runtime)) {
-    p3.cancel("Init cancelled.");
-    process.exit(0);
-  }
-  const base = await p3.text({
-    message: "Where should kitn components be installed?",
-    initialValue: "src/ai",
-    placeholder: "src/ai"
-  });
-  if (p3.isCancel(base)) {
-    p3.cancel("Init cancelled.");
-    process.exit(0);
+  let baseDir;
+  if (opts.base) {
+    baseDir = opts.base;
+  } else if (opts.yes) {
+    baseDir = "src/ai";
+  } else {
+    const base = await p3.text({
+      message: "Where should kitn components be installed?",
+      initialValue: "src/ai",
+      placeholder: "src/ai"
+    });
+    if (p3.isCancel(base)) {
+      p3.cancel("Init cancelled.");
+      process.exit(0);
+    }
+    baseDir = base;
   }
-  const baseDir = base;
   const config = {
     runtime,
     framework: "hono",
@@ -1011,6 +1158,15 @@ async function initCommand() {
     ].join("\n"),
     "Add this to your server entry point:"
   );
+  p3.log.message(
+    [
+      pc4.bold("Add your first agent:"),
+      `  ${pc4.cyan("kitn add weather-agent")}`,
+      "",
+      pc4.bold("Browse all components:"),
+      `  ${pc4.cyan("kitn list")}`
+    ].join("\n")
+  );
   p3.outro("Done!");
 }
 var PLUGIN_TEMPLATE;
@@ -1422,8 +1578,8 @@ async function scanForComponents(cwd, paths) {
   const resolvedCwd = resolve(cwd);
   if (paths && paths.length > 0) {
     const results = [];
-    for (const p12 of paths) {
-      const absPath = resolve(resolvedCwd, p12);
+    for (const p13 of paths) {
+      const absPath = resolve(resolvedCwd, p13);
       if (await fileExists(join11(absPath, "registry.json"))) {
         results.push(absPath);
         continue;
@@ -2063,6 +2219,39 @@ var init_info = __esm({
   }
 });
 
+// src/commands/check.ts
+var check_exports = {};
+__export(check_exports, {
+  checkCommand: () => checkCommand
+});
+import * as p11 from "@clack/prompts";
+import pc10 from "picocolors";
+async function checkCommand(currentVersion) {
+  p11.intro(pc10.bgCyan(pc10.black(" kitn check ")));
+  p11.log.info(`kitn v${currentVersion}`);
+  const s = p11.spinner();
+  s.start("Checking for updates...");
+  const latest = await fetchLatestVersion();
+  if (!latest) {
+    s.stop(pc10.yellow("Could not reach the npm registry"));
+    p11.outro("Try again later.");
+    return;
+  }
+  if (isNewer(latest, currentVersion)) {
+    s.stop(pc10.yellow(`Update available: ${currentVersion} \u2192 ${latest}`));
+    p11.log.message(`  Run: ${pc10.cyan("npm i -g @kitnai/cli")}`);
+  } else {
+    s.stop(pc10.green("You're on the latest version"));
+  }
+  p11.outro("");
+}
+var init_check = __esm({
+  "src/commands/check.ts"() {
+    "use strict";
+    init_update_check();
+  }
+});
+
 // src/commands/registry.ts
 var registry_exports = {};
 __export(registry_exports, {
@@ -2070,8 +2259,8 @@ __export(registry_exports, {
   registryListCommand: () => registryListCommand,
   registryRemoveCommand: () => registryRemoveCommand
 });
-import * as p11 from "@clack/prompts";
-import pc10 from "picocolors";
+import * as p12 from "@clack/prompts";
+import pc11 from "picocolors";
 async function registryAddCommand(namespace, url, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
   const config = await readConfig(cwd);
@@ -2097,10 +2286,10 @@ async function registryAddCommand(namespace, url, opts = {}) {
     config.registries[namespace] = url;
   }
   await writeConfig(cwd, config);
-  p11.log.success(`Added registry ${pc10.bold(namespace)}`);
-  p11.log.message(pc10.dim(`  ${url}`));
-  if (opts.homepage) p11.log.message(pc10.dim(`  Homepage: ${opts.homepage}`));
-  if (opts.description) p11.log.message(pc10.dim(`  ${opts.description}`));
+  p12.log.success(`Added registry ${pc11.bold(namespace)}`);
+  p12.log.message(pc11.dim(`  ${url}`));
+  if (opts.homepage) p12.log.message(pc11.dim(`  Homepage: ${opts.homepage}`));
+  if (opts.description) p12.log.message(pc11.dim(`  ${opts.description}`));
 }
 async function registryRemoveCommand(namespace, opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
@@ -2122,10 +2311,10 @@ async function registryRemoveCommand(namespace, opts = {}) {
   }
   delete config.registries[namespace];
   await writeConfig(cwd, config);
-  p11.log.success(`Removed registry ${pc10.bold(namespace)}`);
+  p12.log.success(`Removed registry ${pc11.bold(namespace)}`);
   if (affectedComponents.length > 0) {
-    p11.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
-` + affectedComponents.map((name) => `  ${pc10.yellow("!")} ${name}`).join("\n"));
+    p12.log.warn(`${affectedComponents.length} installed component(s) referenced this registry:
+` + affectedComponents.map((name) => `  ${pc11.yellow("!")} ${name}`).join("\n"));
   }
   return { affectedComponents };
 }
@@ -2140,15 +2329,15 @@ async function registryListCommand(opts = {}) {
     return { namespace, url, homepage, description };
   });
   if (entries.length === 0) {
-    p11.log.message(pc10.dim("  No registries configured."));
+    p12.log.message(pc11.dim("  No registries configured."));
   } else {
     const lines = [];
     for (const { namespace, url, homepage, description } of entries) {
-      lines.push(`  ${pc10.bold(namespace.padEnd(16))} ${pc10.dim(url)}`);
+      lines.push(`  ${pc11.bold(namespace.padEnd(16))} ${pc11.dim(url)}`);
       if (description) lines.push(`  ${" ".repeat(16)} ${description}`);
-      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc10.dim(homepage)}`);
+      if (homepage) lines.push(`  ${" ".repeat(16)} ${pc11.dim(homepage)}`);
     }
-    p11.log.message(lines.join("\n"));
+    p12.log.message(lines.join("\n"));
   }
   return entries;
 }
@@ -2160,89 +2349,14 @@ var init_registry = __esm({
 });
 
 // src/index.ts
+init_update_check();
 import { Command } from "commander";
-
-// src/utils/update-check.ts
-import { readFile, writeFile, mkdir } from "fs/promises";
-import { join } from "path";
-import { homedir } from "os";
-import pc from "picocolors";
-var CACHE_DIR = join(homedir(), ".kitn");
-var CACHE_FILE = join(CACHE_DIR, "update-check.json");
-var CHECK_INTERVAL = 60 * 60 * 1e3;
-async function readCache() {
-  try {
-    const raw = await readFile(CACHE_FILE, "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}
-async function writeCache(entry) {
-  try {
-    await mkdir(CACHE_DIR, { recursive: true });
-    await writeFile(CACHE_FILE, JSON.stringify(entry));
-  } catch {
-  }
-}
-async function fetchLatestVersion() {
-  try {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 3e3);
-    const res = await fetch("https://registry.npmjs.org/@kitnai/cli/latest", {
-      signal: controller.signal
-    });
-    clearTimeout(timeout);
-    if (!res.ok) return null;
-    const data = await res.json();
-    return data.version ?? null;
-  } catch {
-    return null;
-  }
-}
-function isNewer(latest, current) {
-  const [lMaj, lMin, lPat] = latest.split(".").map(Number);
-  const [cMaj, cMin, cPat] = current.split(".").map(Number);
-  if (lMaj !== cMaj) return lMaj > cMaj;
-  if (lMin !== cMin) return lMin > cMin;
-  return lPat > cPat;
-}
-function startUpdateCheck(currentVersion) {
-  let message = "";
-  const check = (async () => {
-    const cache = await readCache();
-    let latest = null;
-    if (cache && Date.now() - cache.checkedAt < CHECK_INTERVAL) {
-      latest = cache.latest;
-    } else {
-      latest = await fetchLatestVersion();
-      if (latest) {
-        await writeCache({ latest, checkedAt: Date.now() });
-      }
-    }
-    if (latest && isNewer(latest, currentVersion)) {
-      message = [
-        "",
-        pc.yellow(`  Update available: ${pc.dim(currentVersion)} \u2192 ${pc.green(latest)}`),
-        pc.dim(`  Run ${pc.cyan("npx @kitnai/cli@latest")} or ${pc.cyan("npm i -g @kitnai/cli")}`),
-        ""
-      ].join("\n");
-    }
-  })();
-  check.catch(() => {
-  });
-  return () => {
-    if (message) process.stderr.write(message);
-  };
-}
-
-// src/index.ts
-var VERSION = true ? "0.1.15" : "0.0.0-dev";
+var VERSION = true ? "0.1.17" : "0.0.0-dev";
 var printUpdateNotice = startUpdateCheck(VERSION);
 var program = new Command().name("kitn").description("Install AI agent components from the kitn registry").version(VERSION);
-program.command("init").description("Initialize kitn in your project").action(async () => {
+program.command("init").description("Initialize kitn in your project").option("-r, --runtime <runtime>", "runtime to use (bun, node, deno)").option("-b, --base <path>", "base directory for components (default: src/ai)").option("-y, --yes", "accept all defaults without prompting").action(async (opts) => {
   const { initCommand: initCommand2 } = await Promise.resolve().then(() => (init_init(), init_exports));
-  await initCommand2();
+  await initCommand2(opts);
 });
 program.command("add").description("Add components from the kitn registry").argument("[components...]", "component names to install").option("-o, --overwrite", "overwrite existing files without prompting").option("-t, --type <type>", "filter by component type").action(async (components, opts) => {
   const { addCommand: addCommand2 } = await Promise.resolve().then(() => (init_add(), add_exports));
@@ -2276,6 +2390,10 @@ program.command("info").description("Show details about a component").argument("
   const { infoCommand: infoCommand2 } = await Promise.resolve().then(() => (init_info(), info_exports));
   await infoCommand2(component);
 });
+program.command("check").description("Check for CLI updates").action(async () => {
+  const { checkCommand: checkCommand2 } = await Promise.resolve().then(() => (init_check(), check_exports));
+  await checkCommand2(VERSION);
+});
 var registry = program.command("registry").description("Manage component registries");
 registry.command("add").description("Add a component registry").argument("<namespace>", "registry namespace (e.g. @myteam)").argument("<url>", "URL template with {type} and {name} placeholders").option("-o, --overwrite", "overwrite if namespace already exists").option("--homepage <url>", "registry homepage URL").option("--description <text>", "short description of the registry").action(async (namespace, url, opts) => {
   const { registryAddCommand: registryAddCommand2 } = await Promise.resolve().then(() => (init_registry(), registry_exports));