@hexabot-ai/cli 3.0.0-alpha.3

package/src/ui/banner.ts

@@ -0,0 +1,18 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import chalk from 'chalk';
+import figlet from 'figlet';
+
+import { getCliVersion } from '../utils/version.js';
+
+export const printBanner = () => {
+  const bannerText = chalk.blue(figlet.textSync('Hexabot'));
+  const versionText = chalk.gray(`CLI v${getCliVersion()}`);
+
+  console.log(bannerText);
+  console.log(versionText);
+};

package/src/utils/__tests__/services.test.ts

@@ -0,0 +1,21 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { parseServices } from '../services.js';
+
+describe('parseServices', () => {
+  it('splits and trims comma separated values', () => {
+    expect(parseServices('api, postgres,worker')).toEqual([
+      'api',
+      'postgres',
+      'worker',
+    ]);
+  });
+
+  it('filters out empty service values', () => {
+    expect(parseServices(' , , ')).toEqual([]);
+  });
+});

package/src/utils/__tests__/validation.test.ts

@@ -0,0 +1,21 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { validateProjectName } from '../validation.js';
+
+describe('validateProjectName', () => {
+  it('accepts lowercase alphanumeric names with dashes', () => {
+    expect(validateProjectName('hexabot-bot01')).toBe(true);
+  });
+
+  it('rejects names that do not start with a letter', () => {
+    expect(validateProjectName('1hexabot')).toBe(false);
+  });
+
+  it('rejects names containing uppercase characters or spaces', () => {
+    expect(validateProjectName('Hexabot Agent')).toBe(false);
+  });
+});

package/src/utils/__tests__/version.test.ts

@@ -0,0 +1,35 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import fs from 'fs';
+import * as path from 'path';
+
+import { jest } from '@jest/globals';
+
+import { getCliVersion } from '../version.js';
+
+describe('getCliVersion', () => {
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it('returns the version from the package.json file', () => {
+    const packageJsonPath = path.resolve(process.cwd(), 'package.json');
+    const { version } = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+
+    expect(getCliVersion()).toBe(version);
+  });
+
+  it('falls back to the default version when package.json cannot be read', () => {
+    const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
+    const failingReader: typeof fs.readFileSync = () => {
+      throw new Error('file error');
+    };
+
+    expect(getCliVersion(failingReader)).toBe('3.0.0');
+    expect(errorSpy).toHaveBeenCalled();
+  });
+});

package/src/utils/services.ts

@@ -0,0 +1,12 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+export const parseServices = (serviceString: string): string[] => {
+  return serviceString
+    .split(',')
+    .map((service) => service.trim())
+    .filter((s) => s);
+};

package/src/utils/validation.ts

@@ -0,0 +1,11 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+export const validateProjectName = (projectName: string) => {
+  const regex = /^[a-z][a-z0-9\-]+$/;
+
+  return regex.test(projectName);
+};

package/src/utils/version.ts

@@ -0,0 +1,28 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const INITIAL_CLI_VERSION = '3.0.0';
+
+export const getCliVersion = (
+  readFile: typeof fs.readFileSync = fs.readFileSync,
+) => {
+  try {
+    const filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(filename);
+    const packageJsonPath = path.join(__dirname, '../../package.json');
+    const packageJson = JSON.parse(readFile(packageJsonPath, 'utf-8'));
+
+    return packageJson.version;
+  } catch (error) {
+    console.error('Error reading package.json:', error);
+
+    return INITIAL_CLI_VERSION;
+  }
+};

package/test/__mocks__/chalk.ts

@@ -0,0 +1,13 @@
+const passthrough = (value: string) => value;
+
+const chalkMock = {
+  blue: passthrough,
+  yellow: passthrough,
+  cyan: passthrough,
+  red: passthrough,
+  green: passthrough,
+  bgYellow: passthrough,
+  gray: passthrough,
+};
+
+export default chalkMock;

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020", // Change to ES2020 or ESNext
+    "moduleResolution": "node", // Ensure module resolution is node
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}