create-kai 0.1.0 → 0.1.1

package/README.md

@@ -240,7 +240,7 @@ not evidence.
 | `scripts/build.mjs` devDep check | a devDependency range disagreeing with `packages/ui`. `.npmrc` sets `node-linker=hoisted`, so one version wins workspace-wide — an `@types/node: ^22` here downgraded the KIT from 26 and broke its emitted-code suite |
 | `test/kit-contract.test.ts` | a template importing something the kit does not export |
 | `scripts/build.mjs` bundle-graph check | the CLI bundle reaching a module it must not. Three symbols imported out of the MCP's `tools/scaffold.ts` took `dist/index.js` from 203 kB to 904 kB, 505 kB of it zod, and **every other check stayed green** — emitted output was byte-identical, `verify:scaffold` was 616/616. It grades the esbuild metafile's real module graph, so it bans the CAUSE (anything under `agent-tooling/mcp/`) and not only the symptom |
-| `scripts/verify-pack.mjs` | npm stripping `.gitignore` out of the tarball, and templates missing from `files` |
+| `scripts/verify-pack.mjs` | what only the PACKED tarball can show. npm drops a fixed set of names from every package whatever `files` says, so a template carrying one loses it at publish time and nowhere else: the working tree has it, the build copies it, every test that reads `dist/templates` sees it. `.gitignore` was handled from the start; `.npmrc` was not, and 0.1.0 shipped `nextjs` and `tanstack-start` with none while the bundled CLI still patched one — `ENOENT: ... open '.../myapp/.npmrc'` on the first command a user runs, two of eight frameworks, with this script printing `tarball OK`. It now checks the whole `STRIPPED_DOTFILES` list rather than one name, and asserts every file the patch tables OPEN is in the listing — derived from `PATCHES`/`GATEWAY_PATCHES`, because a hand-written list would have had exactly the hole that produced this. Also: templates missing from `files`, and a template that packs to nothing |
 | `scripts/smoke.mjs` | an emitted project that installs but does not build. `--framework all` covers every ready framework; without a flag it only ever built React, which meant it answered "does React still build" no matter which framework you had just turned on |
 
 ## Publish gate

package/dist/index.js

@@ -3457,7 +3457,7 @@ function validateProjectName(name) {
 }
 
 // src/generate.ts
-import { cp, mkdir, readFile, readdir, rename, stat, writeFile } from "node:fs/promises";
+import { cp, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -3936,8 +3936,15 @@ function patchesFor(templateDir) {
   return PATCHES[templateDir] ?? [];
 }
 
+// src/template-dotfiles.ts
+var GITIGNORE_SOURCE_NAME = ".gitignore";
+var STRIPPED_DOTFILES = [GITIGNORE_SOURCE_NAME, ".npmrc"];
+function travellingName(dotfile) {
+  return `_${dotfile.slice(1)}`;
+}
+
 // src/generate.ts
-var GITIGNORE_TEMPLATE_NAME = "_gitignore";
+var GITIGNORE_TEMPLATE_NAME = travellingName(GITIGNORE_SOURCE_NAME);
 function defaultTemplateRoot() {
   return path.join(path.dirname(fileURLToPath(import.meta.url)), "templates");
 }
@@ -3960,25 +3967,68 @@ async function generate(plan, options = {}) {
       `create-kai: no template for '${framework.id}' at ${templateDir}. Run the package build (it copies examples/starters/* into dist/templates).`
     );
   }
-  await mkdir(plan.dir, { recursive: true });
-  await cp(templateDir, plan.dir, { recursive: true });
-  const underscored = path.join(plan.dir, GITIGNORE_TEMPLATE_NAME);
-  if (existsSync(underscored)) {
-    await rename(underscored, path.join(plan.dir, ".gitignore"));
+  const parent = path.dirname(plan.dir);
+  await mkdir(parent, { recursive: true });
+  const out = await mkdtemp(path.join(parent, ".create-kai-"));
+  let previousKitSpec;
+  try {
+    await cp(templateDir, out, { recursive: true });
+    for (const dotfile of STRIPPED_DOTFILES) {
+      const travelling = path.join(out, travellingName(dotfile));
+      if (existsSync(travelling)) await rename(travelling, path.join(out, dotfile));
+    }
+    for (const patch of patchesFor(framework.templateDir)) {
+      const file = path.join(out, patch.file);
+      await writeFile(file, applyPatch(patch, await readFile(file, "utf8"), plan.name), "utf8");
+    }
+    const pkgPath = path.join(out, "package.json");
+    const rewritten = rewritePackageJson(await readFile(pkgPath, "utf8"), {
+      name: plan.name,
+      kit: plan.kit,
+      gatewayDeps: integration.deps.npm
+    });
+    previousKitSpec = rewritten.previousKitSpec;
+    await writeFile(pkgPath, stringifyPackageJson(rewritten.json), "utf8");
+    const appSource = await readFile(path.join(out, framework.paths.app), "utf8");
+    const thread = goLiveThread(appSource, framework);
+    const routeFiles = await writeGateway(plan, framework, integration, out, thread);
+    await writeFile(
+      path.join(out, "kai.json"),
+      stringifyKaiJson(buildKaiJson(plan, framework)),
+      "utf8"
+    );
+    await writeFile(
+      path.join(out, "README.md"),
+      plan.gatewayId === "mock" ? renderMockReadme(plan, framework, thread, integration.docsSlug) : renderGatewayReadme(plan, framework, integration, routeFiles[0].path),
+      "utf8"
+    );
+  } catch (error) {
+    await rm(out, { recursive: true, force: true });
+    throw error;
   }
-  for (const patch of patchesFor(framework.templateDir)) {
-    const file = path.join(plan.dir, patch.file);
-    await writeFile(file, applyPatch(patch, await readFile(file, "utf8"), plan.name), "utf8");
+  await commit(out, plan.dir);
+  return {
+    dir: plan.dir,
+    files: await listFiles(plan.dir),
+    previousKitSpec,
+    runNote: integration.runNote,
+    docsSlug: integration.docsSlug
+  };
+}
+async function commit(from, to) {
+  try {
+    await rename(from, to);
+    return;
+  } catch (error) {
+    const code = error.code;
+    if (code !== "EEXIST" && code !== "ENOTEMPTY" && code !== "EPERM" && code !== "EXDEV") {
+      throw error;
+    }
   }
-  const pkgPath = path.join(plan.dir, "package.json");
-  const { json, previousKitSpec } = rewritePackageJson(await readFile(pkgPath, "utf8"), {
-    name: plan.name,
-    kit: plan.kit,
-    gatewayDeps: integration.deps.npm
-  });
-  await writeFile(pkgPath, stringifyPackageJson(json), "utf8");
-  const appSource = await readFile(path.join(plan.dir, framework.paths.app), "utf8");
-  const thread = goLiveThread(appSource, framework);
+  await cp(from, to, { recursive: true });
+  await rm(from, { recursive: true, force: true });
+}
+async function writeGateway(plan, framework, integration, out, thread) {
   const routeFiles = plan.gatewayId === "mock" ? [] : emitRoute(integration, framework);
   if (plan.gatewayId !== "mock") {
     if (routeFiles.length === 0) {
@@ -3987,12 +4037,12 @@ async function generate(plan, options = {}) {
       );
     }
     for (const file of routeFiles) {
-      const abs = path.join(plan.dir, file.path);
+      const abs = path.join(out, file.path);
       await mkdir(path.dirname(abs), { recursive: true });
       await writeFile(abs, file.contents, "utf8");
     }
     for (const patch of gatewayPatchesFor(framework.templateDir)) {
-      const file = path.join(plan.dir, patch.file);
+      const file = path.join(out, patch.file);
       await writeFile(
         file,
         applyGatewayPatch(patch, await readFile(file, "utf8"), {
@@ -4006,29 +4056,13 @@ async function generate(plan, options = {}) {
     }
     if (integration.envVars.length > 0) {
       await writeFile(
-        path.join(plan.dir, framework.paths.env),
+        path.join(out, framework.paths.env),
         renderEnvFile(integration.envVars, integration.runNote),
         "utf8"
       );
     }
   }
-  await writeFile(
-    path.join(plan.dir, "kai.json"),
-    stringifyKaiJson(buildKaiJson(plan, framework)),
-    "utf8"
-  );
-  await writeFile(
-    path.join(plan.dir, "README.md"),
-    plan.gatewayId === "mock" ? renderMockReadme(plan, framework, thread, integration.docsSlug) : renderGatewayReadme(plan, framework, integration, routeFiles[0].path),
-    "utf8"
-  );
-  return {
-    dir: plan.dir,
-    files: await listFiles(plan.dir),
-    previousKitSpec,
-    runNote: integration.runNote,
-    docsSlug: integration.docsSlug
-  };
+  return routeFiles;
 }
 function renderEnvFile(envVars, runNote) {
   return [
@@ -4187,7 +4221,7 @@ function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
 }
 
 // src/index.ts
-var DEFAULT_KIT_RANGE = `^${"0.23.0"}`;
+var DEFAULT_KIT_RANGE = `^${"0.24.0"}`;
 var HELP = `
 ${import_picocolors3.default.bold("create-kai")} \u2014 scaffold a runnable @kitn.ai/ui chat app
 
@@ -4218,7 +4252,7 @@ async function main() {
     return 0;
   }
   if (args.version) {
-    console.log("0.1.0");
+    console.log("0.1.1");
     return 0;
   }
   if (args.list) {
@@ -4374,7 +4408,7 @@ function run(command, cwd) {
 }
 function printMatrix(asJson) {
   const matrix = {
-    cli: "0.1.0",
+    cli: "0.1.1",
     kit: DEFAULT_KIT_RANGE,
     frameworks: FRAMEWORKS.map((f) => ({
       id: f.id,

package/dist/templates/nextjs/_npmrc

@@ -0,0 +1,5 @@
+# Pack the local `@kitn.ai/ui` (file:../../../packages/ui) into a real node_modules copy instead
+# of symlinking it. Next.js/webpack follows symlinks to their realpath, which puts
+# the kit's prebuilt dist/ outside node_modules — Next then transpiles it and trips
+# on the minified Shiki chunk. A packed copy is also what a real npm install yields.
+install-links=true

package/dist/templates/tanstack-start/_npmrc

@@ -0,0 +1,4 @@
+# Pack the local `@kitn.ai/ui` (file:../../../packages/ui) into a real node_modules copy instead
+# of symlinking it, so the example reproduces a real npm install layout (the kit's
+# prebuilt dist/ lives under node_modules, not a live link to repo source).
+install-links=true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kai",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "Scaffold a runnable @kitn.ai/ui chat app. `npm create kai@latest`",
   "license": "MIT",
@@ -26,10 +26,15 @@
     "name": "create-kai",
     "targets": {
       "test": {
-        "dependsOn": ["build", "^build"]
+        "dependsOn": [
+          "build",
+          "^build"
+        ]
       },
       "typecheck": {
-        "dependsOn": ["^build"]
+        "dependsOn": [
+          "^build"
+        ]
       }
     }
   },