@hexabot-ai/cli 3.2.2-alpha.12 → 3.2.2-alpha.14

package/AGENTS.md

@@ -26,7 +26,7 @@ This file is the authoritative cheat-sheet for the Hexabot CLI. It summarizes th
 | Command | Responsibilities | Options & IO | Implementation Notes |
 | --- | --- | --- | --- |
 | `check [--docker-only] [--no-docker]` | Run diagnostics for local Node version, Hexabot project detection, env files, and optionally Docker. | Flags narrow which checks run; outputs PASS/FAIL rows and sets exit code 1 if any check fails. | `src/commands/check.ts` calls `checkNodeVersion()`, `isHexabotProject()`, `loadProjectConfig()`, `listEnvStatus()`, and `checkDocker()` in sequence and prints results with chalk. |
-| `create <projectName>` | Scaffold a project from a GitHub template, configure package manager, bootstrap env files, install deps, and optionally start dev mode. | `--template`, `--pm`, `--no-install`, `--dev`, `--docker`, `--force`. Writes `hexabot.config.json` and new env files, installs deps (unless skipped), and can immediately run `hexabot dev`. | `src/commands/create.ts` validates the slug, downloads the latest release zip of `hexastack/hexabot-template-*` via `downloadAndExtractTemplate()`, ensures config/env files exist, installs dependencies via `installDependencies()`, and optionally calls `runDev()` for the new project. |
+| `create <projectName>` | Scaffold a project from a GitHub template, configure package manager, bootstrap env files, install deps, and optionally start dev mode. | `--template`, `--pm`, `--no-install`, `--dev`, `--docker`, `--force`. Writes `hexabot.config.json`, bootstraps local and Docker env files, persists initial admin seed credentials, installs deps (unless skipped), and can immediately run `hexabot dev`. | `src/commands/create.ts` validates the slug, downloads the latest release zip of `hexastack/hexabot-template-*` via `downloadAndExtractTemplate()`, ensures config/env files exist, installs dependencies via `installDependencies()`, and optionally calls `runDev()` for the new project. |
 | `config show` | Print the effective `hexabot.config.json` after merging defaults. | No flags; emits pretty-printed JSON. | `src/commands/config.ts` resolves the project root, asserts the workspace, and calls `loadProjectConfig()`. |
 | `config set <key> <value>` | Update nested config values via dot notation with type-aware parsing. | Supports booleans, numbers, JSON literals, comma lists (for `*Services` keys), and package-manager normalization. | Uses `parseValue()` + `buildOverride()` to construct overrides, writes via `updateProjectConfig()`, and echoes the new config. |
 | `dev [--docker] [--services] [-d] [--env] [--no-env-bootstrap] [--pm]` | Run the project in development mode using either the package script or Docker compose stack. | When not using Docker it runs the configured dev script (`dev` default) after optional env bootstrapping. Docker mode bootstraps the docker env file, resolves compose overlays, and runs `docker compose ... up --build [-d]`. | `src/commands/dev.ts` auto-detects the package manager, persists it into the config, handles env bootstrapping (local or docker), then either calls `runPackageScript()` or `runDockerDev()` (which uses `generateComposeFiles()` with mode `dev`). |
@@ -46,7 +46,7 @@ This file is the authoritative cheat-sheet for the Hexabot CLI. It summarizes th
 
 ## Typical Workflow
 
-1. `hexabot create my-bot --docker` — scaffold a workspace, persist the preferred package manager into `hexabot.config.json`, bootstrap both local and docker env files, and install dependencies.
+1. `hexabot create my-bot` — scaffold a workspace, persist the preferred package manager into `hexabot.config.json`, bootstrap both local and Docker env files, capture initial admin credentials, and install dependencies.
 2. `cd my-bot`
 3. `hexabot check` — confirm Node/Docker availability, project structure, and env files before running heavier commands.
 4. `hexabot env init` — re-run if you need to refresh `.env` files (use `--docker` to target docker envs).

package/README.md

@@ -41,10 +41,10 @@ Common options:
 - `--pm <npm|pnpm|yarn|bun>` – force a package manager (auto-detected otherwise).
 - `--no-install` – skip running the package manager after scaffolding.
 - `--dev` – immediately run `hexabot dev` once creation is complete.
-- `--docker` – bootstrap the Docker env file and hint about Docker-first commands.
+- `--docker` – show Docker-first next steps and use Docker mode when combined with `--dev`.
 - `--force` – allow scaffolding into a non-empty directory.
 
-The command downloads the latest template release, installs dependencies (unless `--no-install`), and bootstraps `.env` (and `.env.docker` when `--docker` is passed).
+The command downloads the latest template release, installs dependencies (unless `--no-install`), and bootstraps `.env` plus `.env.docker` when their example files are present.
 
 #### `dev`
 

package/dist/commands/__tests__/create.test.js

@@ -86,6 +86,7 @@ beforeEach(() => {
     setTTY(true);
     validateProjectName.mockReturnValue(true);
     detectPackageManager.mockReturnValue('pnpm');
+    bootstrapEnvFile.mockReturnValue(true);
     normalizePackageManager.mockImplementation((value) => {
         return typeof value === 'string' ? value.toLowerCase() : undefined;
     });
@@ -113,7 +114,7 @@ afterEach(() => {
     jest.restoreAllMocks();
 });
 describe('registerCreateCommand', () => {
-    it('prompts admin credentials and persists them to local env values', async () => {
+    it('prompts admin credentials and persists them to local and Docker env values', async () => {
         input
             .mockResolvedValueOnce('Anis')
             .mockResolvedValueOnce('Bot')
@@ -136,15 +137,46 @@ describe('registerCreateCommand', () => {
         expect(templateUrl).toBe('https://github.com/marrouchi/hexabot-v3-template/archive/refs/tags/v1.0.0.zip');
         expect(projectPath.endsWith(`${path.sep}anisbot`)).toBe(true);
         expect(bootstrapEnvFile).toHaveBeenCalledWith(projectPath, '.env.example', '.env', { quiet: true });
+        expect(bootstrapEnvFile).toHaveBeenCalledWith(projectPath, '.env.docker.example', '.env.docker', { quiet: true });
         expect(upsertEnvVariables).toHaveBeenCalledWith(projectPath, '.env', {
             SEED_ADMIN_FIRST_NAME: 'Anis',
             SEED_ADMIN_LAST_NAME: 'Bot',
             SEED_ADMIN_EMAIL: 'anis@example.com',
             SEED_ADMIN_PASSWORD: 'Admin#123',
         });
+        expect(upsertEnvVariables).toHaveBeenCalledWith(projectPath, '.env.docker', {
+            SEED_ADMIN_FIRST_NAME: 'Anis',
+            SEED_ADMIN_LAST_NAME: 'Bot',
+            SEED_ADMIN_EMAIL: 'anis@example.com',
+            SEED_ADMIN_PASSWORD: 'Admin#123',
+        });
         expect(exitSpy).not.toHaveBeenCalled();
         expect(input).toHaveBeenCalledTimes(3);
         expect(password).toHaveBeenCalledTimes(2);
+        expect(bootstrapEnvFile).toHaveBeenCalledTimes(2);
+        expect(upsertEnvVariables).toHaveBeenCalledTimes(2);
+    });
+    it('skips Docker admin credentials when the Docker env file is unavailable', async () => {
+        bootstrapEnvFile.mockImplementation((_projectRoot, _exampleFile, targetFile) => targetFile === '.env');
+        input
+            .mockResolvedValueOnce('Anis')
+            .mockResolvedValueOnce('Bot')
+            .mockResolvedValueOnce('anis@example.com');
+        password
+            .mockResolvedValueOnce('Admin#123')
+            .mockResolvedValueOnce('Admin#123');
+        const program = new Command();
+        registerCreateCommand(program);
+        await program.parseAsync(['node', 'test', 'create', 'anisbot']);
+        const [, projectPath] = downloadAndExtractTemplate.mock.calls[0];
+        expect(bootstrapEnvFile).toHaveBeenCalledWith(projectPath, '.env.docker.example', '.env.docker', { quiet: true });
+        expect(upsertEnvVariables).toHaveBeenCalledTimes(1);
+        expect(upsertEnvVariables).toHaveBeenCalledWith(projectPath, '.env', {
+            SEED_ADMIN_FIRST_NAME: 'Anis',
+            SEED_ADMIN_LAST_NAME: 'Bot',
+            SEED_ADMIN_EMAIL: 'anis@example.com',
+            SEED_ADMIN_PASSWORD: 'Admin#123',
+        });
     });
     it('fails cleanly when create runs in a non-interactive terminal', async () => {
         setTTY(false);

package/dist/commands/create.js

@@ -22,7 +22,7 @@ export const registerCreateCommand = (program) => {
         .option('--pm <npm|pnpm|yarn|bun>', 'Preferred package manager')
         .option('--no-install', 'Skip installing dependencies')
         .option('--dev', 'Run hexabot dev after creation')
-        .option('--docker', 'Bootstrap Docker env files during creation')
+        .option('--docker', 'Use Docker-oriented next steps and --dev startup')
         .option('--force', 'Allow scaffolding into a non-empty directory')
         .action(async (projectName, options) => {
         await createProject(projectName, options);
@@ -49,19 +49,9 @@ const createProject = async (projectName, options) => {
         };
         ensureProjectConfig(projectPath, configOverrides);
         const config = loadProjectConfig(projectPath);
-        bootstrapEnvFile(projectPath, config.env.localExample, config.env.local, {
-            quiet: true,
-        });
-        if (options.docker) {
-            bootstrapEnvFile(projectPath, config.env.dockerExample, config.env.docker, { quiet: true });
-        }
+        const dockerEnvBootstrapped = bootstrapCreateEnvFiles(projectPath, config);
         const adminCredentials = await promptSeedAdminCredentials();
-        upsertEnvVariables(projectPath, config.env.local, {
-            SEED_ADMIN_FIRST_NAME: adminCredentials.firstName,
-            SEED_ADMIN_LAST_NAME: adminCredentials.lastName,
-            SEED_ADMIN_EMAIL: adminCredentials.email,
-            SEED_ADMIN_PASSWORD: adminCredentials.password,
-        });
+        persistAdminSeedCredentials(projectPath, config, adminCredentials, dockerEnvBootstrapped);
         if (options.noInstall) {
             console.log(chalk.yellow('Skipping dependency installation (--no-install).'));
         }
@@ -117,6 +107,28 @@ const fetchLatestReleaseTag = async (templateRepo) => {
     }
     return data.tag_name;
 };
+const bootstrapCreateEnvFiles = (projectPath, config) => {
+    bootstrapEnvFile(projectPath, config.env.localExample, config.env.local, {
+        quiet: true,
+    });
+    return bootstrapEnvFile(projectPath, config.env.dockerExample, config.env.docker, { quiet: true });
+};
+const buildAdminSeedVariables = (credentials) => {
+    return {
+        SEED_ADMIN_FIRST_NAME: credentials.firstName,
+        SEED_ADMIN_LAST_NAME: credentials.lastName,
+        SEED_ADMIN_EMAIL: credentials.email,
+        SEED_ADMIN_PASSWORD: credentials.password,
+    };
+};
+const persistAdminSeedCredentials = (projectPath, config, credentials, dockerEnvBootstrapped) => {
+    const seedVariables = buildAdminSeedVariables(credentials);
+    upsertEnvVariables(projectPath, config.env.local, seedVariables);
+    if (dockerEnvBootstrapped ||
+        fs.existsSync(path.join(projectPath, config.env.docker))) {
+        upsertEnvVariables(projectPath, config.env.docker, seedVariables);
+    }
+};
 const requireValue = (label) => {
     return (value) => {
         if (!value.trim()) {
@@ -209,7 +221,7 @@ const logSuccessMessage = (projectName, options) => {
     }
     console.log(chalk.gray(`3. Explore docker helpers if needed:`));
     console.log(chalk.yellow(`   hexabot docker up --services postgres`));
-    console.log(chalk.gray(`Need env files? Run hexabot env init --docker`));
+    console.log(chalk.gray(`Env bootstrap completed.`));
     console.log('\n');
     console.log(chalk.blue('Optional: Install Hexabot skills'));
     console.log(chalk.gray('You can add official skills to accelerate your workflow:'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexabot-ai/cli",
-  "version": "3.2.2-alpha.12",
+  "version": "3.2.2-alpha.14",
   "description": "Official Hexabot CLI for creating and managing AI chatbot/agent projects built with Hexabot.",
   "main": "dist/index.js",
   "type": "module",

package/src/commands/__tests__/create.test.ts

@@ -104,6 +104,7 @@ beforeEach(() => {
 
   validateProjectName.mockReturnValue(true);
   detectPackageManager.mockReturnValue('pnpm');
+  bootstrapEnvFile.mockReturnValue(true);
   (normalizePackageManager as any).mockImplementation((value: unknown) => {
     return typeof value === 'string' ? value.toLowerCase() : undefined;
   });
@@ -133,7 +134,7 @@ afterEach(() => {
 });
 
 describe('registerCreateCommand', () => {
-  it('prompts admin credentials and persists them to local env values', async () => {
+  it('prompts admin credentials and persists them to local and Docker env values', async () => {
     (input as any)
       .mockResolvedValueOnce('Anis')
       .mockResolvedValueOnce('Bot')
@@ -166,15 +167,67 @@ describe('registerCreateCommand', () => {
       '.env',
       { quiet: true },
     );
+    expect(bootstrapEnvFile).toHaveBeenCalledWith(
+      projectPath,
+      '.env.docker.example',
+      '.env.docker',
+      { quiet: true },
+    );
     expect(upsertEnvVariables).toHaveBeenCalledWith(projectPath, '.env', {
       SEED_ADMIN_FIRST_NAME: 'Anis',
       SEED_ADMIN_LAST_NAME: 'Bot',
       SEED_ADMIN_EMAIL: 'anis@example.com',
       SEED_ADMIN_PASSWORD: 'Admin#123',
     });
+    expect(upsertEnvVariables).toHaveBeenCalledWith(
+      projectPath,
+      '.env.docker',
+      {
+        SEED_ADMIN_FIRST_NAME: 'Anis',
+        SEED_ADMIN_LAST_NAME: 'Bot',
+        SEED_ADMIN_EMAIL: 'anis@example.com',
+        SEED_ADMIN_PASSWORD: 'Admin#123',
+      },
+    );
     expect(exitSpy).not.toHaveBeenCalled();
     expect(input).toHaveBeenCalledTimes(3);
     expect(password).toHaveBeenCalledTimes(2);
+    expect(bootstrapEnvFile).toHaveBeenCalledTimes(2);
+    expect(upsertEnvVariables).toHaveBeenCalledTimes(2);
+  });
+
+  it('skips Docker admin credentials when the Docker env file is unavailable', async () => {
+    (bootstrapEnvFile as any).mockImplementation(
+      (_projectRoot: string, _exampleFile: string, targetFile: string) =>
+        targetFile === '.env',
+    );
+    (input as any)
+      .mockResolvedValueOnce('Anis')
+      .mockResolvedValueOnce('Bot')
+      .mockResolvedValueOnce('anis@example.com');
+    (password as any)
+      .mockResolvedValueOnce('Admin#123')
+      .mockResolvedValueOnce('Admin#123');
+
+    const program = new Command();
+    registerCreateCommand(program);
+
+    await program.parseAsync(['node', 'test', 'create', 'anisbot']);
+
+    const [, projectPath] = (downloadAndExtractTemplate as any).mock.calls[0];
+    expect(bootstrapEnvFile).toHaveBeenCalledWith(
+      projectPath,
+      '.env.docker.example',
+      '.env.docker',
+      { quiet: true },
+    );
+    expect(upsertEnvVariables).toHaveBeenCalledTimes(1);
+    expect(upsertEnvVariables).toHaveBeenCalledWith(projectPath, '.env', {
+      SEED_ADMIN_FIRST_NAME: 'Anis',
+      SEED_ADMIN_LAST_NAME: 'Bot',
+      SEED_ADMIN_EMAIL: 'anis@example.com',
+      SEED_ADMIN_PASSWORD: 'Admin#123',
+    });
   });
 
   it('fails cleanly when create runs in a non-interactive terminal', async () => {

package/src/commands/create.ts

@@ -52,7 +52,7 @@ export const registerCreateCommand = (program: Command) => {
     .option('--pm <npm|pnpm|yarn|bun>', 'Preferred package manager')
     .option('--no-install', 'Skip installing dependencies')
     .option('--dev', 'Run hexabot dev after creation')
-    .option('--docker', 'Bootstrap Docker env files during creation')
+    .option('--docker', 'Use Docker-oriented next steps and --dev startup')
     .option('--force', 'Allow scaffolding into a non-empty directory')
     .action(async (projectName: string, options: CreateCommandOptions) => {
       await createProject(projectName, options);
@@ -92,26 +92,14 @@ const createProject = async (
 
     ensureProjectConfig(projectPath, configOverrides);
     const config = loadProjectConfig(projectPath);
-
-    bootstrapEnvFile(projectPath, config.env.localExample, config.env.local, {
-      quiet: true,
-    });
-    if (options.docker) {
-      bootstrapEnvFile(
-        projectPath,
-        config.env.dockerExample,
-        config.env.docker,
-        { quiet: true },
-      );
-    }
-
+    const dockerEnvBootstrapped = bootstrapCreateEnvFiles(projectPath, config);
     const adminCredentials = await promptSeedAdminCredentials();
-    upsertEnvVariables(projectPath, config.env.local, {
-      SEED_ADMIN_FIRST_NAME: adminCredentials.firstName,
-      SEED_ADMIN_LAST_NAME: adminCredentials.lastName,
-      SEED_ADMIN_EMAIL: adminCredentials.email,
-      SEED_ADMIN_PASSWORD: adminCredentials.password,
-    });
+    persistAdminSeedCredentials(
+      projectPath,
+      config,
+      adminCredentials,
+      dockerEnvBootstrapped,
+    );
 
     if (options.noInstall) {
       console.log(
@@ -185,6 +173,45 @@ const fetchLatestReleaseTag = async (templateRepo: string) => {
 
   return data.tag_name;
 };
+const bootstrapCreateEnvFiles = (
+  projectPath: string,
+  config: ReturnType<typeof loadProjectConfig>,
+) => {
+  bootstrapEnvFile(projectPath, config.env.localExample, config.env.local, {
+    quiet: true,
+  });
+
+  return bootstrapEnvFile(
+    projectPath,
+    config.env.dockerExample,
+    config.env.docker,
+    { quiet: true },
+  );
+};
+const buildAdminSeedVariables = (credentials: AdminSeedCredentials) => {
+  return {
+    SEED_ADMIN_FIRST_NAME: credentials.firstName,
+    SEED_ADMIN_LAST_NAME: credentials.lastName,
+    SEED_ADMIN_EMAIL: credentials.email,
+    SEED_ADMIN_PASSWORD: credentials.password,
+  };
+};
+const persistAdminSeedCredentials = (
+  projectPath: string,
+  config: ReturnType<typeof loadProjectConfig>,
+  credentials: AdminSeedCredentials,
+  dockerEnvBootstrapped: boolean,
+) => {
+  const seedVariables = buildAdminSeedVariables(credentials);
+  upsertEnvVariables(projectPath, config.env.local, seedVariables);
+
+  if (
+    dockerEnvBootstrapped ||
+    fs.existsSync(path.join(projectPath, config.env.docker))
+  ) {
+    upsertEnvVariables(projectPath, config.env.docker, seedVariables);
+  }
+};
 const requireValue = (label: string) => {
   return (value: string) => {
     if (!value.trim()) {
@@ -304,7 +331,7 @@ const logSuccessMessage = (
   }
   console.log(chalk.gray(`3. Explore docker helpers if needed:`));
   console.log(chalk.yellow(`   hexabot docker up --services postgres`));
-  console.log(chalk.gray(`Need env files? Run hexabot env init --docker`));
+  console.log(chalk.gray(`Env bootstrap completed.`));
   console.log('\n');
   console.log(chalk.blue('Optional: Install Hexabot skills'));
   console.log(