@botonic/nx-plugin 2.23.0

package/src/lib/util/file-system.js

@@ -0,0 +1,65 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var file_system_exports = {};
+__export(file_system_exports, {
+  copy: () => copy,
+  createDir: () => createDir,
+  getHomeDirectory: () => getHomeDirectory,
+  pathExists: () => pathExists,
+  readJSON: () => readJSON,
+  removeRecursively: () => removeRecursively,
+  writeJSON: () => writeJSON
+});
+module.exports = __toCommonJS(file_system_exports);
+var import_fs = require("fs");
+var import_fs_extra = require("fs-extra");
+var import_os = require("os");
+function pathExists(path) {
+  return (0, import_fs.existsSync)(path);
+}
+function readJSON(path) {
+  const fileContent = (0, import_fs.readFileSync)(path, "utf8");
+  if (!fileContent) return void 0;
+  return JSON.parse(fileContent);
+}
+function writeJSON(path, object) {
+  (0, import_fs.writeFileSync)(path, JSON.stringify(object));
+}
+function createDir(path) {
+  return (0, import_fs.mkdirSync)(path);
+}
+function getHomeDirectory() {
+  return (0, import_os.homedir)();
+}
+function copy(from, to) {
+  (0, import_fs_extra.copySync)(from, to);
+}
+function removeRecursively(path) {
+  (0, import_fs.rmSync)(path, { recursive: true, force: true });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  copy,
+  createDir,
+  getHomeDirectory,
+  pathExists,
+  readJSON,
+  removeRecursively,
+  writeJSON
+});

package/src/lib/util/sam-container-cleanup.d.ts

@@ -0,0 +1,11 @@
+export type CleanupResult = 'removed' | 'none' | 'skipped';
+/**
+ * Remove any existing Lambda container(s) from a previous run by finding containers
+ * with the label sam.cli.function.name=<function name from template.yaml>.
+ *
+ * @param projectRoot - Root path of the bot project (containing src/server/lambda/template.yaml)
+ * @returns 'removed' if at least one container was found and removed (or removal attempted),
+ *   'none' if no container with that label existed (or docker failed),
+ *   'skipped' if the template could not be read (e.g. missing or invalid).
+ */
+export declare function cleanupPreviousSamContainersByLabel(projectRoot: string): CleanupResult;

package/src/lib/util/sam-container-cleanup.js

@@ -0,0 +1,55 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sam_container_cleanup_exports = {};
+__export(sam_container_cleanup_exports, {
+  cleanupPreviousSamContainersByLabel: () => cleanupPreviousSamContainersByLabel
+});
+module.exports = __toCommonJS(sam_container_cleanup_exports);
+var import_child_process = require("child_process");
+var import_sam_template = require("./sam-template");
+const SAM_CLI_FUNCTION_LABEL = "sam.cli.function.name";
+function cleanupPreviousSamContainersByLabel(projectRoot) {
+  let functionName;
+  try {
+    functionName = (0, import_sam_template.getLocalLambdaFunctionName)(projectRoot);
+  } catch {
+    return "skipped";
+  }
+  try {
+    const out = (0, import_child_process.execSync)(
+      `docker ps -a -q --filter "label=${SAM_CLI_FUNCTION_LABEL}=${functionName}"`,
+      { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }
+    );
+    const ids = out.trim().split("\n").filter(Boolean);
+    if (ids.length === 0) {
+      return "none";
+    }
+    try {
+      (0, import_child_process.execSync)(`docker rm -f ${ids.join(" ")}`, { stdio: "pipe" });
+    } catch {
+    }
+    return "removed";
+  } catch {
+    return "none";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cleanupPreviousSamContainersByLabel
+});

package/src/lib/util/sam-template.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reads the SAM template at projectRoot/src/server/lambda/template.yaml and returns
+ * the logical resource name of the first AWS::Serverless::Function (or the single
+ * resource key under Resources when there is only one).
+ * @param projectRoot - Root path of the bot project
+ * @returns The logical function name (e.g. "BotonicV2LocalLambda")
+ * @throws Error when the file is missing, unreadable, or has no Lambda resource
+ */
+export declare function getLocalLambdaFunctionName(projectRoot: string): string;

package/src/lib/util/sam-template.js

@@ -0,0 +1,71 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var sam_template_exports = {};
+__export(sam_template_exports, {
+  getLocalLambdaFunctionName: () => getLocalLambdaFunctionName
+});
+module.exports = __toCommonJS(sam_template_exports);
+var import_fs = require("fs");
+var import_path = require("path");
+var import_yaml = require("yaml");
+const TEMPLATE_RELATIVE_PATH = "src/server/lambda/template.yaml";
+function getLocalLambdaFunctionName(projectRoot) {
+  const templatePath = (0, import_path.join)(projectRoot, TEMPLATE_RELATIVE_PATH);
+  let content;
+  try {
+    content = (0, import_fs.readFileSync)(templatePath, "utf-8");
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `Could not read SAM template at ${templatePath}: ${message}. Ensure the file exists.`
+    );
+  }
+  let parsed;
+  try {
+    parsed = (0, import_yaml.parse)(content);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `Invalid YAML in SAM template at ${templatePath}: ${message}`
+    );
+  }
+  const resources = parsed?.Resources;
+  if (!resources || typeof resources !== "object") {
+    throw new Error(
+      `SAM template at ${templatePath} has no Resources section or it is not an object.`
+    );
+  }
+  const entries = Object.entries(resources);
+  const lambdaEntry = entries.find(
+    ([, def]) => def && def.Type === "AWS::Serverless::Function"
+  );
+  if (lambdaEntry) {
+    return lambdaEntry[0];
+  }
+  if (entries.length === 1) {
+    return entries[0][0];
+  }
+  throw new Error(
+    `SAM template at ${templatePath} has no AWS::Serverless::Function resource under Resources.`
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getLocalLambdaFunctionName
+});

package/src/lib/util/system.d.ts

@@ -0,0 +1 @@
+export declare function sleep(ms: number): Promise<void>;

package/src/lib/util/system.js

@@ -0,0 +1,30 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var system_exports = {};
+__export(system_exports, {
+  sleep: () => sleep
+});
+module.exports = __toCommonJS(system_exports);
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sleep
+});

package/src/migrations/add-botonic-update-bots-skill/add-botonic-update-bots-skill.migration.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from '@nx/devkit';
+export default function addBotonicUpdateBotsSkillMigration(tree: Tree): Promise<void>;

package/src/migrations/add-botonic-update-bots-skill/add-botonic-update-bots-skill.migration.js

@@ -0,0 +1,52 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var add_botonic_update_bots_skill_migration_exports = {};
+__export(add_botonic_update_bots_skill_migration_exports, {
+  default: () => addBotonicUpdateBotsSkillMigration
+});
+module.exports = __toCommonJS(add_botonic_update_bots_skill_migration_exports);
+var import_devkit = require("@nx/devkit");
+var path = __toESM(require("path"));
+const MODULE_DIR = __dirname;
+const UPDATE_BOTONIC_MD = ".cursor/commands/update-botonic.md";
+const UPDATE_BOT_MD = ".cursor/commands/update-bot.md";
+async function addBotonicUpdateBotsSkillMigration(tree) {
+  const botUpdateExists = tree.exists(UPDATE_BOT_MD);
+  const botonicUpdateExists = tree.exists(UPDATE_BOTONIC_MD);
+  if (botUpdateExists && botonicUpdateExists) {
+    import_devkit.logger.info(
+      "update-botonic and update-bot commands already present \u2013 skipping"
+    );
+    return;
+  }
+  (0, import_devkit.generateFiles)(tree, path.join(MODULE_DIR, "files"), ".", {});
+  if (!botonicUpdateExists) import_devkit.logger.info("Added /update-botonic Cursor command");
+  if (!botUpdateExists) import_devkit.logger.info("Added /update-bot Cursor command");
+  await (0, import_devkit.formatFiles)(tree);
+}

package/src/migrations/add-botonic-update-bots-skill/add-botonic-update-bots-skill.migration.md

@@ -0,0 +1,23 @@
+# Add /update-bot Cursor Command Migration
+
+## Summary
+
+This migration adds the `/update-bot` Cursor command to your workspace. The command helps you update Botonic bot apps to newer versions using Nx migrations, one bot at a time, with git branch management.
+
+## What the automated migration does
+
+- Creates `.cursor/commands/update-bot.md` — workflow and examples
+- Creates `.cursor/scripts/update-bot/discover-bots.sh` — finds bot apps via `nx show projects --projects "tag:botonic:bot-app"`
+- Creates `.cursor/scripts/update-bot/find-migration-guides.sh` — finds `<name>.migration.md` files between versions
+
+## How to use the command
+
+1. In Cursor, type `/update-bot` in the chat input and run it
+2. The command discovers your bots, lets you pick one, and runs `nx migrate` one version at a time
+3. For each version step, it reads any migration guide (`<name>.migration.md`) and guides you through verification
+
+## Verification checklist
+
+- [ ] `.cursor/commands/update-bot.md` exists
+- [ ] Run `bash .cursor/scripts/update-bot/discover-bots.sh` from workspace root — returns JSON list of bots (or `[]` if none)
+- [ ] Run `bash .cursor/scripts/update-bot/find-migration-guides.sh 0.0.0 999.0.0` — returns JSON array (may be empty)

package/src/migrations/add-botonic-update-bots-skill/files/.cursor/commands/update-bot.md

@@ -0,0 +1,5 @@
+# Update Botonic Bot
+
+Applies pending bot-app migrations from `.botonic/pending-bot-migrations.json` to a single bot.
+
+Follow the full workflow in: `node_modules/@botonic/nx-plugin/src/cursor-commands/update-bot.md`

package/src/migrations/add-botonic-update-bots-skill/files/.cursor/commands/update-botonic.md

@@ -0,0 +1,5 @@
+# Update Botonic Workspace
+
+Updates the Botonic plugin to the latest version and queues pending bot-app migrations.
+
+Follow the full workflow in: `node_modules/@botonic/nx-plugin/src/cursor-commands/update-botonic.md`

package/src/migrations/add-botonic-update-bots-skill/files/.cursor/scripts/update-bot/discover-bots.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# Discovers botonic bot apps and their current versions.
+# Uses nx show projects with tag:botonic:bot-app filter.
+# Run from workspace root. Output: JSON array of { name, path, version }.
+# Usage: bash .cursor/scripts/update-bot/discover-bots.sh
+
+set -euo pipefail
+
+# Ensure we're in workspace root (contains apps/ or nx.json)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+GIT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+REL_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+if [[ -n "$GIT_ROOT" ]] && [[ -f "$GIT_ROOT/nx.json" ]]; then
+  ROOT="$GIT_ROOT"
+elif [[ -d "$REL_ROOT/apps" ]] || [[ -f "$REL_ROOT/nx.json" ]]; then
+  ROOT="$REL_ROOT"
+else
+  ROOT="${GIT_ROOT:-.}"
+fi
+cd "$ROOT"
+
+# List bot apps via nx (tag:botonic:bot-app)
+# Nx may print plugin messages to stdout; use tail -1 to get JSON only
+names=$(npx nx show projects --projects "tag:botonic:bot-app" --json 2>/dev/null | tail -1 || echo "[]")
+if [[ "$names" == "[]" ]] || [[ -z "$names" ]]; then
+  echo "[]"
+  exit 0
+fi
+
+bots='[]'
+for name in $(echo "$names" | node -e "
+  try {
+    const arr = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
+    (Array.isArray(arr) ? arr : []).forEach(n => console.log(n));
+  } catch {}
+"); do
+  [[ -z "$name" ]] && continue
+
+  path="$name"
+  if root=$(npx nx show project "$name" --json 2>/dev/null | tail -1 | node -e "try { const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); process.stdout.write(d.root||''); } catch {}"); then
+    [[ -n "$root" ]] && path="$root"
+  else
+    path="apps/$name"
+  fi
+
+  version="unknown"
+  pkg="$ROOT/$path/package.json"
+  if [[ -f "$pkg" ]]; then
+    version=$(node -e "
+      try {
+        const p = require('$pkg');
+        const v = p.dependencies?.['@botonic/core']
+              || p.dependencies?.['@botonic/webchat-react']
+              || 'unknown';
+        console.log(String(v).replace(/^[\^~]/, ''));
+      } catch { console.log('unknown'); }
+    " 2>/dev/null || echo "unknown")
+  fi
+
+  bots=$(echo "$bots" | node -e "
+    const b = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
+    b.push({ name: process.argv[1], path: process.argv[2], version: process.argv[3] });
+    console.log(JSON.stringify(b, null, 2));
+  " "$name" "$path" "$version")
+done
+
+echo "$bots"

package/src/migrations/add-botonic-update-bots-skill/files/.cursor/scripts/update-bot/find-migration-guides.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Finds <name>.migration.md files for migrations between two versions.
+# Reads node_modules/@botonic/nx-plugin/migrations.json (published, real semver).
+# Usage: find-migration-guides.sh <from-version> <to-version>
+# Output: JSON array of { version, migrations: [{ name, migrationGuide }] } grouped by unique version
+
+set -euo pipefail
+
+FROM_VERSION="${1:?Usage: find-migration-guides.sh <from> <to>}"
+TO_VERSION="${2:?Usage: find-migration-guides.sh <from> <to>}"
+
+# Run from workspace root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+GIT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+REL_ROOT="$(cd "$SCRIPT_DIR/../../../" && pwd)"
+if [[ -n "$GIT_ROOT" ]] && [[ -f "$GIT_ROOT/nx.json" ]]; then
+  ROOT="$GIT_ROOT"
+elif [[ -f "$REL_ROOT/nx.json" ]] || [[ -f "$REL_ROOT/node_modules/@botonic/nx-plugin/migrations.json" ]]; then
+  ROOT="$REL_ROOT"
+else
+  ROOT="${GIT_ROOT:-$REL_ROOT}"
+fi
+cd "$ROOT"
+
+MIGRATIONS_JSON="node_modules/@botonic/nx-plugin/migrations.json"
+MIGRATIONS_DIR="node_modules/@botonic/nx-plugin/src/migrations"
+
+if [ ! -f "$MIGRATIONS_JSON" ]; then
+  echo '{"error": "migrations.json not found. Run pnpm install first."}' >&2
+  exit 1
+fi
+
+node -e "
+  const fs = require('fs');
+  const path = require('path');
+  let semver;
+  try { semver = require('semver'); } catch { semver = null; }
+
+  const mj = JSON.parse(fs.readFileSync('$MIGRATIONS_JSON', 'utf8'));
+  const generators = mj.generators || {};
+  const from = '$FROM_VERSION';
+  const to = '$TO_VERSION';
+  const migrationsDir = path.resolve('$MIGRATIONS_DIR');
+
+  const valid = (v) => semver ? semver.valid(v) : /^\\d+\\.\\d+\\.\\d+$/.test(v);
+  const gt = (a, b) => semver ? semver.gt(a, b) : a !== b;
+  const lte = (a, b) => semver ? semver.lte(a, b) : true;
+  const compare = (a, b) => semver ? semver.compare(a, b) : 0;
+
+  const entries = Object.entries(generators)
+    .filter(([, cfg]) => valid(cfg.version) && gt(cfg.version, from) && lte(cfg.version, to))
+    .sort(([, a], [, b]) => compare(a.version, b.version));
+
+  const byVersion = new Map();
+  for (const [name, cfg] of entries) {
+    const guideFile = path.join(migrationsDir, name, \`\${name}.migration.md\`);
+    const migrationGuide = fs.existsSync(guideFile) ? guideFile : null;
+    if (!byVersion.has(cfg.version)) {
+      byVersion.set(cfg.version, []);
+    }
+    byVersion.get(cfg.version).push({ name, migrationGuide });
+  }
+
+  const results = Array.from(byVersion.entries()).map(([version, migrations]) => ({
+    version,
+    migrations
+  }));
+
+  console.log(JSON.stringify(results, null, 2));
+"

package/src/migrations/add-botonic-update-bots-skill/schema.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "type": "object",
+  "properties": {}
+}

package/src/migrations/add-lilara-registry/add-lilara-registry.migration.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from '@nx/devkit';
+export default function addLilaraRegistry(tree: Tree): Promise<void>;

package/src/migrations/add-lilara-registry/add-lilara-registry.migration.js

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var add_lilara_registry_migration_exports = {};
+__export(add_lilara_registry_migration_exports, {
+  default: () => addLilaraRegistry
+});
+module.exports = __toCommonJS(add_lilara_registry_migration_exports);
+var import_devkit = require("@nx/devkit");
+const NPMRC = ".npmrc";
+const BOTONIC_REGISTRY_PREFIX = "@botonic:registry=";
+const LILARA_REGISTRY_LINE = "@lilara:registry=https://hubtype-489822642696.d.codeartifact.eu-west-1.amazonaws.com/npm/hubtype-internal/";
+async function addLilaraRegistry(tree) {
+  if (!tree.exists(NPMRC)) {
+    import_devkit.logger.info(`\u2139\uFE0F  ${NPMRC} not found \u2013 skipping`);
+    return;
+  }
+  const content = tree.read(NPMRC, "utf-8") ?? "";
+  if (content.includes("@lilara:registry=")) {
+    import_devkit.logger.info("\u2139\uFE0F  @lilara:registry already present \u2013 skipping");
+    return;
+  }
+  const lines = content.split("\n");
+  const botonicIdx = lines.findIndex((l) => l.startsWith(BOTONIC_REGISTRY_PREFIX));
+  let newContent;
+  if (botonicIdx !== -1) {
+    lines.splice(botonicIdx + 1, 0, LILARA_REGISTRY_LINE);
+    newContent = lines.join("\n");
+  } else {
+    newContent = content + (content.endsWith("\n") ? "" : "\n") + LILARA_REGISTRY_LINE + "\n";
+  }
+  tree.write(NPMRC, newContent);
+  import_devkit.logger.info(`\u2705 Added @lilara:registry to ${NPMRC}`);
+}

package/src/migrations/add-lilara-registry/schema.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "type": "object",
+  "properties": {}
+}

package/src/migrations/fix-css-code-split/fix-css-code-split.migration.md

@@ -0,0 +1,45 @@
+# Fix CSS Code Split Migration
+
+## Summary
+
+Vite generates multiple CSS chunks when code splitting is enabled. Only the main `webchat.botonic.css` (or `webviews.botonic.css`) is injected into `index.html`; secondary chunks like `webchat.botonic-[hash].css` are not referenced, causing styles to fail loading after build.
+
+This migration adds `cssCodeSplit: false` to the vite build config so all CSS is merged into a single file that Vite injects correctly.
+
+## What the automated migration does
+
+- Adds `cssCodeSplit: false` to `vite/webchat.config.ts` build options
+- Adds `cssCodeSplit: false` to `vite/webviews.config.ts` build options
+- Skips files that already have `cssCodeSplit` configured
+
+## What it cannot handle
+
+- Bots with non-standard vite config layout (e.g. config in a different path)
+- Custom build setups that override rollup CSS output
+- Bots that intentionally use multiple CSS entry points
+
+## Manual migration steps
+
+If your bot has customized the vite config or the migration skips your project:
+
+1. Open `vite/webchat.config.ts` and `vite/webviews.config.ts`
+2. In the `build` section, add `cssCodeSplit: false,` after `reportCompressedSize: true,`
+3. Example:
+
+```ts
+build: {
+  outDir: resolve(projectRoot, output.dir),
+  emptyOutDir: true,
+  reportCompressedSize: true,
+  cssCodeSplit: false,  // add this line
+  commonjsOptions: { ... },
+  ...
+}
+```
+
+## Verification checklist
+
+- [ ] Run `nx build <your-bot>` for webchat and webviews
+- [ ] Inspect `dist/webchat/` and `dist/webviews/` — expect single `webchat.botonic.css` and `webviews.botonic.css`
+- [ ] Run `nx serve-bot <your-bot>` and verify styles render correctly
+- [ ] Deploy to staging and confirm no missing CSS in production

package/src/migrations/remove-codeartifact-registry/remove-codeartifact-registry.migration.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from '@nx/devkit';
+export default function removeCodeartifactRegistry(tree: Tree): Promise<void>;

package/src/migrations/remove-codeartifact-registry/remove-codeartifact-registry.migration.js

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var remove_codeartifact_registry_migration_exports = {};
+__export(remove_codeartifact_registry_migration_exports, {
+  default: () => removeCodeartifactRegistry
+});
+module.exports = __toCommonJS(remove_codeartifact_registry_migration_exports);
+var import_devkit = require("@nx/devkit");
+const NPMRC = ".npmrc";
+function isCodeArtifactScopedRegistryLine(line) {
+  const t = line.trim();
+  if (!t.startsWith("@botonic:registry=") && !t.startsWith("@hubtype-lilara:registry=")) {
+    return false;
+  }
+  return t.toLowerCase().includes("codeartifact");
+}
+function isCodeArtifactAuthLine(line) {
+  const t = line.trim();
+  if (!t.toLowerCase().includes("codeartifact")) return false;
+  return t.includes(":always-auth=") || t.includes(":_authToken=");
+}
+async function removeCodeartifactRegistry(tree) {
+  if (!tree.exists(NPMRC)) {
+    import_devkit.logger.info(`\u2139\uFE0F  ${NPMRC} not found \u2013 skipping`);
+    return;
+  }
+  const content = tree.read(NPMRC, "utf-8") ?? "";
+  const lines = content.split("\n");
+  const kept = lines.filter(
+    (l) => !isCodeArtifactScopedRegistryLine(l) && !isCodeArtifactAuthLine(l)
+  );
+  if (kept.length === lines.length) {
+    import_devkit.logger.info("\u2139\uFE0F  No CodeArtifact entries in .npmrc \u2013 skipping");
+    return;
+  }
+  let newContent = kept.join("\n");
+  while (newContent.includes("\n\n\n")) {
+    newContent = newContent.replace(/\n\n\n/g, "\n\n");
+  }
+  if (!newContent.endsWith("\n")) newContent += "\n";
+  tree.write(NPMRC, newContent);
+  import_devkit.logger.info(`\u2705 Removed CodeArtifact registry lines from ${NPMRC}`);
+}