@botonic/create-workspace 2.23.0

package/CHANGELOG.md

@@ -0,0 +1,213 @@
+## 2.23.0 (2026-03-20)
+
+### 🚀 Features
+
+- **create-workspace:** package renamed from `@botonic/create-botonic-workspace` to `@botonic/create-workspace`; default install uses public npm (no CodeArtifact or global npm config).
+
+### 🩹 Fixes
+
+- **create-workspace:** `--registry` remains supported for Verdaccio / custom registries.
+
+## 2.22.1 (2026-03-19)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.22.0 (2026-03-16)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.21.0 (2026-03-16)
+
+### 🚀 Features
+
+- **botonic-nx-plugin:** set prod as default serve config and improve first-run UX #BLT-2243 ([#735](https://github.com/metis-ai/hubtype-product/pull/735))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.20.0 (2026-03-13)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.19.0 (2026-03-12)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.18.0 (2026-03-04)
+
+### 🚀 Features
+
+- **publishing:** package fixes, lilara rename & token/reset unification #BLT-2205 #BLT-2221 #BLT-2206 ([#701](https://github.com/metis-ai/hubtype-product/pull/701))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.17.0 (2026-03-02)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.16.0 (2026-02-23)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.15.0 (2026-02-13)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.14.0 (2026-02-05)
+
+### 🚀 Features
+
+- **botonic:** add E2E publish flow testing with Verdaccio ([#577](https://github.com/metis-ai/hubtype-product/pull/577))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.4 (2026-02-02)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.13.3 (2026-01-30)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.13.2 (2026-01-30)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.13.1 (2026-01-30)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.13.0 (2026-01-29)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.12.0 (2026-01-28)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.5 (2026-01-28)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.4 (2026-01-28)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.3 (2026-01-28)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.2 (2026-01-21)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.1 (2026-01-21)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.11.0 (2026-01-21)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.10.1 (2026-01-19)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.10.0 (2026-01-18)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.9.1 (2026-01-17)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.9.0 (2026-01-17)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.8.1 (2026-01-16)
+
+### 🩹 Fixes
+
+- streamline CodeArtifact plugin installation process by configuring npm registry directly ([#523](https://github.com/metis-ai/hubtype-product/pull/523))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.8.0 (2026-01-16)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.7.1 (2026-01-16)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.7.0 (2026-01-15)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.6.0 (2025-12-09)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.5.0 (2025-12-09)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.4.1 (2025-12-08)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.4.0 (2025-12-05)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.3.3 (2025-12-04)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.3.2 (2025-12-04)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.3.1 (2025-12-04)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.3.0 (2025-12-04)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.2.1 (2025-12-04)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.
+
+## 2.2.0 (2025-12-04)
+
+### 🚀 Features
+
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.1.0 (2025-12-02)
+
+### 🚀 Features
+
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.0.1-alpha.0 (2025-11-27)
+
+This was a version bump only for @botonic/create-botonic-workspace to align it with other projects, there were no code changes.

package/README.md

@@ -0,0 +1,65 @@
+# @botonic/create-workspace
+
+A CLI tool to quickly create new workspaces for Botonic bot development.
+
+## Usage
+
+```bash
+npx @botonic/create-workspace my-botonic-workspace
+```
+
+## Options
+
+- `--packageManager, -pm` - Package manager to use (`npm`, `yarn`, `pnpm`)
+- `--interactive, -i` - Run in interactive mode (default: true)
+- `--registry, -r` - Custom npm registry (e.g. Verdaccio) for `@botonic/*` in the new workspace
+- `--help, -h` - Show help
+- `--version, -v` - Show version
+
+## Examples
+
+```bash
+# Create a workspace with default settings
+npx @botonic/create-workspace my-workspace
+
+# Create a workspace with yarn
+npx @botonic/create-workspace my-workspace --packageManager=yarn
+
+# Create a workspace non-interactively
+npx @botonic/create-workspace my-workspace --no-interactive
+```
+
+## What it creates
+
+This tool creates a new Nx workspace configured for Botonic development with:
+
+- Nx workspace configuration
+- Botonic dependencies pre-installed
+- Nx Botonic plugin configured
+- Development and build scripts
+- TypeScript configuration
+- ESLint and Prettier setup
+
+## After creation
+
+Once your workspace is created, you can:
+
+```bash
+cd my-workspace
+
+# Create a new bot
+nx g @botonic/nx-plugin:bot-app my-bot
+
+# Serve the bot for development
+nx serve my-bot
+
+# Build the bot
+nx build my-bot
+
+# Run tests
+nx test my-bot
+```
+
+## License
+
+MIT

package/bin/create-workspace.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process')
+const yargs = require('yargs/yargs')
+const { hideBin } = require('yargs/helpers')
+
+const argv = yargs(hideBin(process.argv))
+  .usage('Usage: $0 <workspace-name> [options]')
+  .command('$0 <name>', 'Create a new Botonic workspace', yargs => {
+    return yargs
+      .positional('name', {
+        describe: 'Name of the workspace',
+        type: 'string',
+      })
+      .option('interactive', {
+        alias: 'i',
+        describe: 'Run in interactive mode',
+        type: 'boolean',
+        default: true,
+      })
+      .option('registry', {
+        alias: 'r',
+        describe:
+          'Use a custom npm registry (e.g. Verdaccio); writes workspace .npmrc for @botonic scope',
+        type: 'string',
+      })
+  })
+  .help()
+  .alias('help', 'h')
+  .version()
+  .alias('version', 'v').argv
+
+const workspaceName = argv.name
+const interactive = argv.interactive
+const registry = argv.registry
+
+// Build exec options - use custom registry via env var if provided (session-only, no global config changes)
+// Also clear NX_* env vars to avoid interference from parent workspace
+const cleanEnv = { ...process.env }
+delete cleanEnv.NX_WORKSPACE_ROOT_PATH
+delete cleanEnv.NX_WORKSPACE_ROOT
+delete cleanEnv.NX_DAEMON
+
+const execOptions = {
+  stdio: 'inherit',
+  env: registry ? { ...cleanEnv, NPM_CONFIG_REGISTRY: registry } : cleanEnv,
+}
+
+console.log('🤖 Creating Botonic workspace...')
+console.log(`📁 Workspace name: ${workspaceName}`)
+if (registry) {
+  console.log(`📡 Registry: ${registry}`)
+}
+
+try {
+  // Step 1: Create the workspace using create-nx-workspace with TypeScript preset
+  const createCommand = [
+    'npx create-nx-workspace@latest',
+    workspaceName,
+    '--preset=ts',
+    '--packageManager=pnpm',
+    interactive ? '' : '--no-interactive',
+  ]
+    .filter(Boolean)
+    .join(' ')
+
+  console.log(
+    `\n🚀 Step 1: Creating TypeScript workspace with: ${createCommand}\n`
+  )
+
+  execSync(createCommand, {
+    ...execOptions,
+    cwd: process.cwd(),
+  })
+
+  console.log('\n✅ Base workspace created!')
+  console.log('🔧 Step 2: Installing Botonic plugin...')
+
+  const workspaceDir = `./${workspaceName}`
+
+  // Configure registry in the new workspace
+  if (registry) {
+    // Create .npmrc in new workspace for custom registry with fake auth token
+    // (local registries like Verdaccio with $all publish access accept any token)
+    // Also set @botonic:registry to override any user-level scoped registry config
+    const fs = require('fs')
+    const path = require('path')
+    const registryHost = registry.replace(/^https?:\/\//, '').replace(/\/$/, '')
+    const npmrcContent = [
+      `@botonic:registry=${registry}`,
+      `//${registryHost}/:_authToken=local-dev-token`,
+      '',
+    ].join('\n')
+    fs.writeFileSync(path.join(workspaceDir, '.npmrc'), npmrcContent)
+    console.log(`\n📝 Created .npmrc with custom registry: ${registry}`)
+  }
+
+  const installPluginCommand = `pnpm add -D @botonic/nx-plugin`
+
+  console.log(
+    `\n📦 Installing Botonic plugin from ${registry || 'public npm'}: ${installPluginCommand}`
+  )
+
+  execSync(installPluginCommand, {
+    ...execOptions,
+    cwd: workspaceDir,
+  })
+
+  console.log('🔧 Step 3: Configuring Botonic workspace...')
+
+  // Step 3: Now run the generator (plugin is installed)
+  const configureBotonicCommand = [
+    'npx nx g @botonic/nx-plugin:preset',
+    workspaceName,
+    '--packageManager=pnpm',
+    '--no-interactive',
+  ]
+    .filter(Boolean)
+    .join(' ')
+
+  console.log(`\n⚙️  Configuring Botonic with: ${configureBotonicCommand}`)
+
+  execSync(configureBotonicCommand, {
+    ...execOptions,
+    cwd: workspaceDir,
+  })
+
+  // Restore custom registry .npmrc (preset generator may have overwritten it)
+  if (registry) {
+    const fs = require('fs')
+    const path = require('path')
+    const registryHost = registry.replace(/^https?:\/\//, '').replace(/\/$/, '')
+    const npmrcContent = [
+      `@botonic:registry=${registry}`,
+      `//${registryHost}/:_authToken=local-dev-token`,
+      '',
+    ].join('\n')
+    fs.writeFileSync(path.join(workspaceDir, '.npmrc'), npmrcContent)
+    console.log(`\n📝 Restored .npmrc with custom registry: ${registry}`)
+  }
+
+  // Install dependencies added by preset (e.g. @nx/react) with --no-frozen-lockfile
+  // since the lockfile was created before these deps were added to package.json.
+  console.log('\n📦 Step 4: Installing preset dependencies...')
+  const installDepsCommand = `pnpm install --no-frozen-lockfile`
+  execSync(installDepsCommand, {
+    ...execOptions,
+    cwd: workspaceDir,
+  })
+  console.log('\n✅ All dependencies installed!')
+
+  console.log(`
+🎉 Botonic workspace configured successfully!
+
+📦 Dependencies installed:
+   • @nx/react - for React-based bot apps
+   • @botonic/nx-plugin - for Botonic generators
+
+📝 Next steps:
+
+   • Enter to the created project:
+        cd ${workspaceName}
+
+   • Create your first bot app with:
+        npx nx g @botonic/nx-plugin:bot-app my-bot
+
+🤖 Happy bot building!
+  `)
+} catch (error) {
+  console.error('❌ Failed to create Botonic workspace:', error.message)
+  process.exit(1)
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@botonic/create-workspace",
+  "version": "2.23.0",
+  "description": "Create a new workspace for Botonic bot development",
+  "main": "index.js",
+  "bin": {
+    "create-workspace": "./bin/create-workspace.js"
+  },
+  "keywords": [
+    "botonic",
+    "nx",
+    "workspace",
+    "create",
+    "generator",
+    "chatbot",
+    "hubtype"
+  ],
+  "author": "Hubtype",
+  "license": "MIT",
+  "dependencies": {
+    "create-nx-workspace": "^21.0.3",
+    "yargs": "^17.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/project.json

@@ -0,0 +1,27 @@
+{
+  "name": "@botonic/create-workspace",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/botonic/create-workspace",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "outputs": ["{workspaceRoot}/dist/libs/botonic/create-workspace"],
+      "options": {
+        "commands": [
+          "mkdir -p dist/libs/botonic/create-workspace",
+          "cp -r libs/botonic/create-workspace/* dist/libs/botonic/create-workspace/"
+        ],
+        "parallel": false
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": ["{options.outputFile}"],
+      "options": {
+        "lintFilePatterns": ["libs/botonic/create-workspace/**/*.js"]
+      }
+    }
+  },
+  "tags": ["scope:botonic", "type:cli"]
+}