@kitnai/cli 0.1.24 → 0.1.26

package/README.md

@@ -140,7 +140,7 @@ Outputs a unified diff for each file in the component. Shows "up to date" if the
 
 ### `kitn remove <component>`
 
-Remove an installed component. Deletes files and removes tracking from `kitn.json`.
+Remove an installed component. Deletes files and removes tracking from `kitn.lock`.
 
 ```bash
 kitn remove weather-agent
@@ -279,7 +279,8 @@ Created by `kitn init`. Controls where components are installed and which regist
 | `framework` | `hono` |
 | `aliases` | Directory paths for each component type |
 | `registries` | Named registries — each value is a URL string or an object with `url`, `homepage`, `description` |
-| `installed` | Auto-managed tracking of installed components (don't edit manually) |
+
+> Installed component tracking (file paths, content hashes, versions) is stored separately in `kitn.lock`. This file is auto-managed — don't edit it manually.
 
 ### Registry entries
 
@@ -313,7 +314,7 @@ The CLI automatically detects your package manager by checking for lockfiles in
 
 Components are **source code**, not packages. `kitn add` copies TypeScript files directly into your project. You own the code and can modify it freely.
 
-The CLI tracks what it installed in `kitn.json` under `installed`, storing file paths and content hashes. This enables `kitn diff` to detect local changes and `kitn update` to apply registry updates.
+The CLI tracks what it installed in `kitn.lock`, storing file paths and content hashes. This enables `kitn diff` to detect local changes and `kitn update` to apply registry updates.
 
 ### Hosting your own registry
 

package/dist/index.js

@@ -157,7 +157,7 @@ var init_update_check = __esm({
 });
 
 // src/utils/config.ts
-import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { readFile as readFile2, writeFile as writeFile2, unlink } from "fs/promises";
 import { join as join3 } from "path";
 import { z } from "zod";
 function getRegistryUrl(entry) {
@@ -179,6 +179,24 @@ async function writeConfig(projectDir, config) {
   const data = { $schema: "https://kitn.dev/schema/config.json", ...config };
   await writeFile2(join3(projectDir, CONFIG_FILE), JSON.stringify(data, null, 2) + "\n");
 }
+async function readLock(projectDir) {
+  try {
+    const raw = await readFile2(join3(projectDir, LOCK_FILE), "utf-8");
+    return lockSchema.parse(JSON.parse(raw));
+  } catch {
+    return {};
+  }
+}
+async function writeLock(projectDir, lock) {
+  if (Object.keys(lock).length === 0) {
+    try {
+      await unlink(join3(projectDir, LOCK_FILE));
+    } catch {
+    }
+    return;
+  }
+  await writeFile2(join3(projectDir, LOCK_FILE), JSON.stringify(lock, null, 2) + "\n");
+}
 function getInstallPath(config, type, fileName, namespace) {
   const aliasKey = typeToAliasKey[type];
   const base = config.aliases[aliasKey];
@@ -188,14 +206,14 @@ function getInstallPath(config, type, fileName, namespace) {
   }
   return join3(base, fileName);
 }
-var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, typeToAliasKey;
+var componentType, installedComponentSchema, registryEntrySchema, registryValueSchema, configSchema, FRAMEWORK_TO_ADAPTER, CONFIG_FILE, LOCK_FILE, lockSchema, typeToAliasKey;
 var init_config = __esm({
   "src/utils/config.ts"() {
     "use strict";
     componentType = z.enum(["kitn:agent", "kitn:tool", "kitn:skill", "kitn:storage", "kitn:package"]);
     installedComponentSchema = z.object({
       registry: z.string().optional(),
-      type: componentType,
+      type: componentType.optional(),
       slot: z.string().optional(),
       version: z.string(),
       installedAt: z.string(),
@@ -220,8 +238,7 @@ var init_config = __esm({
         skills: z.string(),
         storage: z.string()
       }),
-      registries: z.record(z.string(), registryValueSchema),
-      installed: z.record(z.string(), installedComponentSchema).optional()
+      registries: z.record(z.string(), registryValueSchema)
     });
     FRAMEWORK_TO_ADAPTER = {
       hono: "hono",
@@ -229,6 +246,8 @@ var init_config = __esm({
       elysia: "elysia"
     };
     CONFIG_FILE = "kitn.json";
+    LOCK_FILE = "kitn.lock";
+    lockSchema = z.record(z.string(), installedComponentSchema);
     typeToAliasKey = {
       "kitn:agent": "agents",
       "kitn:tool": "tools",
@@ -830,7 +849,7 @@ import * as p2 from "@clack/prompts";
 import pc3 from "picocolors";
 import { join as join7, dirname as dirname3 } from "path";
 import { existsSync } from "fs";
-import { readFile as readFile6, writeFile as writeFile6, mkdir as mkdir3, unlink } from "fs/promises";
+import { readFile as readFile6, writeFile as writeFile6, mkdir as mkdir3, unlink as unlink2 } from "fs/promises";
 import { relative as relative2 } from "path";
 async function addCommand(components, opts) {
   p2.intro(pc3.bgCyan(pc3.black(" kitn add ")));
@@ -840,6 +859,7 @@ async function addCommand(components, opts) {
     p2.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
+  const lock = await readLock(cwd);
   if (components.length === 0) {
     const fetcher2 = new RegistryFetcher(config.registries);
     const s2 = p2.spinner();
@@ -859,7 +879,7 @@ async function addCommand(components, opts) {
       p2.log.warn("No components found in configured registries.");
       process.exit(0);
     }
-    const installed = new Set(Object.keys(config.installed ?? {}));
+    const installed = new Set(Object.keys(lock));
     const typeLabels = {
       "kitn:agent": "Agents",
       "kitn:tool": "Tools",
@@ -1056,7 +1076,7 @@ async function addCommand(components, opts) {
   const slotReplacements = /* @__PURE__ */ new Map();
   for (const item of resolved) {
     if (!item.slot) continue;
-    const existing = Object.entries(config.installed ?? {}).find(
+    const existing = Object.entries(lock).find(
       ([key, entry]) => key !== item.name && entry.slot === item.slot
     );
     if (!existing) continue;
@@ -1079,11 +1099,11 @@ async function addCommand(components, opts) {
   if (slotReplacements.size > 0) {
     const baseDir2 = config.aliases.base ?? "src/ai";
     for (const [oldKey] of slotReplacements) {
-      const oldEntry = config.installed[oldKey];
+      const oldEntry = lock[oldKey];
       if (!oldEntry) continue;
       for (const filePath of oldEntry.files) {
         try {
-          await unlink(join7(cwd, filePath));
+          await unlink2(join7(cwd, filePath));
         } catch {
         }
       }
@@ -1111,7 +1131,7 @@ async function addCommand(components, opts) {
           await writeFile6(barrelPath2, barrelContent);
         }
       }
-      delete config.installed[oldKey];
+      delete lock[oldKey];
       p2.log.info(`Replaced ${pc3.dim(oldKey)} \u2192 ${pc3.cyan(slotReplacements.get(oldKey))}`);
     }
   }
@@ -1128,7 +1148,7 @@ async function addCommand(components, opts) {
   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];
+    const existingInstall = lock[item.name];
     if (existingInstall && item.type === "kitn:package") {
       const allContent = item.files.map((f) => f.content).join("\n");
       if (contentHash(allContent) === existingInstall.hash) {
@@ -1174,11 +1194,10 @@ async function addCommand(components, opts) {
             break;
         }
       }
-      const installed = config.installed ?? {};
       const allContent = item.files.map((f) => f.content).join("\n");
       const ref = refs.find((r) => r.name === item.name) ?? { namespace: "@kitn", name: item.name, version: void 0 };
       const installedKey = ref.namespace === "@kitn" ? item.name : `${ref.namespace}/${item.name}`;
-      installed[installedKey] = {
+      lock[installedKey] = {
         registry: ref.namespace,
         type: item.type,
         ...item.slot && { slot: item.slot },
@@ -1188,7 +1207,6 @@ async function addCommand(components, opts) {
         hash: contentHash(allContent),
         registryDependencies: item.registryDependencies
       };
-      config.installed = installed;
     } else {
       const ref = refs.find((r) => r.name === item.name) ?? { namespace: "@kitn", name: item.name, version: void 0 };
       const ns = ref.namespace;
@@ -1244,13 +1262,12 @@ async function addCommand(components, opts) {
             break;
         }
       }
-      const installed = config.installed ?? {};
       const allContent = item.files.map((f) => {
         const fn = f.path.split("/").pop();
         return rewriteKitnImports(f.content, item.type, fn, config.aliases);
       }).join("\n");
       const installedKey = ns === "@kitn" ? item.name : `${ns}/${item.name}`;
-      installed[installedKey] = {
+      lock[installedKey] = {
         registry: ns,
         type: item.type,
         ...item.slot && { slot: item.slot },
@@ -1263,7 +1280,6 @@ async function addCommand(components, opts) {
         hash: contentHash(allContent),
         registryDependencies: item.registryDependencies
       };
-      config.installed = installed;
     }
   }
   const BARREL_ELIGIBLE = /* @__PURE__ */ new Set(["kitn:agent", "kitn:tool", "kitn:skill"]);
@@ -1299,7 +1315,7 @@ async function addCommand(components, opts) {
     if (!barrelExisted) {
       p2.note(
         [
-          `import { ai } from "./${baseDir.replace(/^src\//, "")}/plugin";`,
+          `import { ai } from "@kitn/plugin";`,
           ``,
           `app.route("/api", ai.router);`
         ].join("\n"),
@@ -1308,6 +1324,7 @@ async function addCommand(components, opts) {
     }
   }
   await writeConfig(cwd, config);
+  await writeLock(cwd, lock);
   const uniqueDeps = [...new Set(allDeps)];
   const uniqueDevDeps = [...new Set(allDevDeps)].filter((d) => !uniqueDeps.includes(d));
   const totalDeps = uniqueDeps.length + uniqueDevDeps.length;
@@ -1344,7 +1361,7 @@ async function addCommand(components, opts) {
     }
   }
   const resolvedNames = new Set(resolved.map((r) => r.name));
-  const projectInstalled = new Set(Object.keys(config.installed ?? {}));
+  const projectInstalled = new Set(Object.keys(lock));
   const hints = [];
   const adapterName = resolveRoutesAlias(config);
   if (resolvedNames.has("core") && !resolvedNames.has(adapterName) && !projectInstalled.has(adapterName)) {
@@ -1530,7 +1547,7 @@ async function initCommand(opts = {}) {
   const mountCode = framework === "elysia" ? `app.use(ai.router);` : `app.route("/api", ai.router);`;
   p3.note(
     [
-      `import { ai } from "./${baseDir.replace(/^src\//, "")}/plugin";`,
+      `import { ai } from "@kitn/plugin";`,
       ``,
       mountCode
     ].join("\n"),
@@ -1606,7 +1623,7 @@ async function listCommand(typeFilter, opts) {
   for (const e of errors) {
     p4.log.warn(`${pc5.yellow("\u26A0")} Failed to fetch ${e}`);
   }
-  const installed = config.installed ?? {};
+  const installed = await readLock(cwd);
   const typeGroups = /* @__PURE__ */ new Map();
   for (const item of allItems) {
     const group = item.type.replace("kitn:", "");
@@ -1699,8 +1716,9 @@ async function diffCommand(componentName) {
   }
   const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
   const ref = parseComponentRef(input);
+  const lock = await readLock(cwd);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
-  const installed = config.installed?.[installedKey];
+  const installed = lock[installedKey];
   if (!installed) {
     p5.log.error(`Component '${ref.name}' is not installed.`);
     process.exit(1);
@@ -1779,15 +1797,15 @@ __export(remove_exports, {
 import * as p6 from "@clack/prompts";
 import pc6 from "picocolors";
 import { join as join10, relative as relative3, dirname as dirname4 } from "path";
-import { unlink as unlink2, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
+import { unlink as unlink3, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-async function removeSingleComponent(installedKey, config, cwd) {
-  const installed = config.installed?.[installedKey];
-  if (!installed) return;
+async function removeSingleComponent(installedKey, lock, config, cwd) {
+  const entry = lock[installedKey];
+  if (!entry) return;
   const deleted = [];
-  for (const filePath of installed.files) {
+  for (const filePath of entry.files) {
     try {
-      await unlink2(join10(cwd, filePath));
+      await unlink3(join10(cwd, filePath));
       deleted.push(filePath);
     } catch {
       p6.log.warn(`Could not delete ${filePath} (may have been moved or renamed)`);
@@ -1819,26 +1837,25 @@ async function removeSingleComponent(installedKey, config, cwd) {
       p6.log.info(`Updated barrel file: ${join10(baseDir, "index.ts")}`);
     }
   }
-  delete config.installed[installedKey];
+  delete lock[installedKey];
   if (deleted.length > 0) {
     p6.log.success(`Removed ${installedKey}:
 ` + deleted.map((f) => `  ${pc6.red("-")} ${f}`).join("\n"));
   }
 }
-async function offerOrphanRemoval(removedDeps, config, cwd) {
+async function offerOrphanRemoval(removedDeps, lock, config, cwd) {
   if (removedDeps.size === 0) return;
-  const remaining = Object.entries(config.installed ?? {});
+  const remaining = Object.entries(lock);
   const neededDeps = /* @__PURE__ */ new Set();
   for (const [, entry] of remaining) {
-    const deps = entry.registryDependencies;
-    if (deps) {
-      for (const dep of deps) {
+    if (entry.registryDependencies) {
+      for (const dep of entry.registryDependencies) {
         neededDeps.add(dep);
       }
     }
   }
   const orphans = [...removedDeps].filter(
-    (dep) => dep !== "core" && !neededDeps.has(dep) && config.installed?.[dep]
+    (dep) => dep !== "core" && !neededDeps.has(dep) && lock[dep]
   );
   if (orphans.length === 0) return;
   const selected = await p6.multiselect({
@@ -1846,14 +1863,14 @@ async function offerOrphanRemoval(removedDeps, config, cwd) {
     options: orphans.map((dep) => ({
       value: dep,
       label: dep,
-      hint: `${config.installed[dep].files.length} file(s)`
+      hint: `${lock[dep].files.length} file(s)`
     })),
     initialValues: orphans
     // all checked by default
   });
   if (p6.isCancel(selected)) return;
   for (const key of selected) {
-    await removeSingleComponent(key, config, cwd);
+    await removeSingleComponent(key, lock, config, cwd);
   }
 }
 async function removeCommand(componentName) {
@@ -1863,9 +1880,9 @@ async function removeCommand(componentName) {
     p6.log.error("No kitn.json found. Run `kitn init` first.");
     process.exit(1);
   }
+  const lock = await readLock(cwd);
   if (!componentName) {
-    const installed2 = config.installed ?? {};
-    const installedKeys = Object.keys(installed2);
+    const installedKeys = Object.keys(lock);
     if (installedKeys.length === 0) {
       p6.log.warn("No components installed.");
       process.exit(0);
@@ -1875,7 +1892,7 @@ async function removeCommand(componentName) {
       options: installedKeys.map((key) => ({
         value: key,
         label: key,
-        hint: `${installed2[key].files.length} file(s)`
+        hint: `${lock[key].files.length} file(s)`
       }))
     });
     if (p6.isCancel(selected)) {
@@ -1887,46 +1904,43 @@ async function removeCommand(componentName) {
       p6.log.warn("No components selected.");
       process.exit(0);
     }
-    for (const key of selectedKeys) {
-      await removeSingleComponent(key, config, cwd);
-    }
     const allRemovedDeps = /* @__PURE__ */ new Set();
     for (const key of selectedKeys) {
-      const entry = installed2[key];
-      if (entry?.registryDependencies) {
-        for (const dep of entry.registryDependencies) {
+      const entry2 = lock[key];
+      if (entry2?.registryDependencies) {
+        for (const dep of entry2.registryDependencies) {
           allRemovedDeps.add(dep);
         }
       }
     }
-    await offerOrphanRemoval(allRemovedDeps, config, cwd);
-    await writeConfig(cwd, config);
+    for (const key of selectedKeys) {
+      await removeSingleComponent(key, lock, config, cwd);
+    }
+    await offerOrphanRemoval(allRemovedDeps, lock, config, cwd);
+    await writeLock(cwd, lock);
     p6.outro(pc6.green("Done!"));
     return;
   }
   const input = componentName === "routes" ? resolveRoutesAlias(config) : componentName;
   const ref = parseComponentRef(input);
   const installedKey = ref.namespace === "@kitn" ? ref.name : `${ref.namespace}/${ref.name}`;
-  const installed = config.installed?.[installedKey];
-  if (!installed) {
+  const entry = lock[installedKey];
+  if (!entry) {
     p6.log.error(`Component '${ref.name}' is not installed.`);
     process.exit(1);
   }
   const shouldRemove = await p6.confirm({
-    message: `Remove ${ref.name}? This will delete ${installed.files.length} file(s).`,
+    message: `Remove ${ref.name}? This will delete ${entry.files.length} file(s).`,
     initialValue: false
   });
   if (p6.isCancel(shouldRemove) || !shouldRemove) {
     p6.cancel("Remove cancelled.");
     process.exit(0);
   }
-  await removeSingleComponent(installedKey, config, cwd);
-  const removedDeps = new Set(installed.registryDependencies ?? []);
-  await offerOrphanRemoval(removedDeps, config, cwd);
-  if (Object.keys(config.installed).length === 0) {
-    delete config.installed;
-  }
-  await writeConfig(cwd, config);
+  const removedDeps = new Set(entry.registryDependencies ?? []);
+  await removeSingleComponent(installedKey, lock, config, cwd);
+  await offerOrphanRemoval(removedDeps, lock, config, cwd);
+  await writeLock(cwd, lock);
 }
 var init_remove = __esm({
   "src/commands/remove.ts"() {
@@ -1951,12 +1965,12 @@ async function updateCommand(components) {
       p7.log.error("No kitn.json found. Run `kitn init` first.");
       process.exit(1);
     }
-    const installed = config.installed;
-    if (!installed || Object.keys(installed).length === 0) {
+    const lock = await readLock(cwd);
+    if (Object.keys(lock).length === 0) {
       p7.log.info("No installed components to update.");
       return;
     }
-    components = Object.keys(installed);
+    components = Object.keys(lock);
   }
   await addCommand(components, { overwrite: true });
 }
@@ -2232,7 +2246,8 @@ async function infoCommand(component) {
   if (fileCount > maxShown) {
     console.log(`    ${pc8.dim(`... and ${fileCount - maxShown} more`)}`);
   }
-  const installed = config.installed?.[item.name];
+  const lock = await readLock(cwd);
+  const installed = lock[item.name];
   if (installed) {
     console.log();
     console.log(
@@ -2355,12 +2370,11 @@ async function registryRemoveCommand(namespace, opts = {}) {
   if (namespace === "@kitn" && !opts.force) {
     throw new Error("Cannot remove the default @kitn registry. Use --force to override.");
   }
+  const lock = await readLock(cwd);
   const affectedComponents = [];
-  if (config.installed) {
-    for (const [name, entry] of Object.entries(config.installed)) {
-      if (entry.registry === namespace) {
-        affectedComponents.push(name);
-      }
+  for (const [name, entry] of Object.entries(lock)) {
+    if (entry.registry === namespace) {
+      affectedComponents.push(name);
     }
   }
   delete config.registries[namespace];
@@ -2405,7 +2419,7 @@ var init_registry = __esm({
 // src/index.ts
 init_update_check();
 import { Command } from "commander";
-var VERSION = true ? "0.1.24" : "0.0.0-dev";
+var VERSION = true ? "0.1.26" : "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").option("-r, --runtime <runtime>", "runtime to use (bun, node, deno)").option("-f, --framework <framework>", "HTTP framework (hono, hono-openapi, elysia)").option("-b, --base <path>", "base directory for components (default: src/ai)").option("-y, --yes", "accept all defaults without prompting").action(async (opts) => {