@agents-at-scale/ark 0.1.33 → 0.1.35-rc.1

package/dist/lib/types.d.ts

@@ -13,13 +13,16 @@ export interface KubernetesConfig {
     namespace?: string;
     inCluster: boolean;
 }
-export interface ServiceStatus {
+export type DeploymentStatus = 'available' | 'progressing' | 'replicafailure' | 'failed' | 'not found' | 'unknown';
+export type ServiceStatus = {
     name: string;
-    status: 'healthy' | 'unhealthy' | 'not installed';
+    status: 'healthy' | 'warning' | 'unhealthy' | 'not installed' | 'not ready';
+    deploymentStatus?: DeploymentStatus;
     url?: string;
     version?: string;
+    revision?: string;
     details?: string;
-}
+};
 export interface DependencyStatus {
     name: string;
     installed: boolean;
@@ -29,6 +32,8 @@ export interface DependencyStatus {
 export interface StatusData {
     services: ServiceStatus[];
     dependencies: DependencyStatus[];
+    arkReady?: boolean;
+    defaultModelExists?: boolean;
 }
 export interface CommandVersionConfig {
     command: string;

package/dist/types/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Represents a Helm chart configuration for ARK components
+ */
+export interface ArkChart {
+    /** Name of the chart (used as release name) */
+    name: string;
+    /** Full chart path (OCI registry or local path) */
+    chartPath: string;
+    /** Kubernetes namespace to install into */
+    namespace: string;
+    /** Additional arguments to pass to helm (e.g., --create-namespace, --wait, --timeout 300s, --set key=value) */
+    args?: string[];
+    /** Description of what this chart provides */
+    description?: string;
+}
+/**
+ * Collection of ARK charts
+ */
+export interface ChartCollection {
+    [key: string]: ArkChart;
+}
+/**
+ * Represents a dependency that needs to be installed
+ */
+export interface Dependency {
+    /** Name of the dependency */
+    name: string;
+    /** Command to execute (helm, kubectl, etc.) */
+    command: string;
+    /** Arguments to pass to the command */
+    args: string[];
+    /** Description of what this dependency provides */
+    description?: string;
+}
+/**
+ * Collection of dependencies
+ */
+export interface DependencyCollection {
+    [key: string]: Dependency;
+}

package/dist/types/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui/MainMenu.js

@@ -1,70 +1,169 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Text, Box, useInput } from 'ink';
-import SelectInput from 'ink-select-input';
+import { Text, Box, render, useInput } from 'ink';
 import * as React from 'react';
-import DashboardCLI from '../components/DashboardCLI.js';
-import GeneratorUI from '../components/GeneratorUI.js';
-import { StatusChecker } from '../components/statusChecker.js';
-import { ConfigManager } from '../config.js';
-import { ArkClient } from '../lib/arkClient.js';
-const EXIT_TIMEOUT_MS = 1000;
+//  Helper function to unmount the main ink app - used when we move from a
+//  React TUI app to basic input/output.
+async function unmountInkApp() {
+    const app = globalThis.inkApp;
+    if (app) {
+        app.unmount();
+        // Remove all existing signal listeners that might interfere with inquirer
+        process.removeAllListeners('SIGINT');
+        process.removeAllListeners('SIGTERM');
+        process.removeAllListeners('SIGQUIT');
+        process.removeAllListeners('exit');
+        // Reset stdin completely
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            process.stdin.removeAllListeners();
+            process.stdin.resume();
+        }
+        // Reset stdout/stderr
+        process.stdout.removeAllListeners();
+        process.stderr.removeAllListeners();
+        console.clear();
+        // Give terminal more time to fully reset
+        await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+}
 const MainMenu = () => {
-    const [selectedChoice, setSelectedChoice] = React.useState(null);
-    const [statusData, setStatusData] = React.useState(null);
-    const [isLoading, setIsLoading] = React.useState(false);
-    const [error, setError] = React.useState(null);
+    const [selectedIndex, setSelectedIndex] = React.useState(0);
     const choices = [
-        { label: '🏷️  Dashboard', value: 'dashboard' },
-        { label: '🔍 Status Check', value: 'status' },
-        { label: '🎯 Generate', value: 'generate' },
-        { label: '👋 Exit', value: 'exit' },
+        {
+            label: 'Chat',
+            description: 'Interactive chat with ARK agents',
+            value: 'chat',
+            command: 'ark chat',
+        },
+        {
+            label: 'Install',
+            description: 'Install Ark',
+            value: 'install',
+            command: 'ark install',
+        },
+        {
+            label: 'Dashboard',
+            description: 'Open ARK dashboard in browser',
+            value: 'dashboard',
+            command: 'ark dashboard',
+        },
+        {
+            label: 'Status Check',
+            description: 'Check ARK services status',
+            value: 'status',
+            command: 'ark status',
+        },
+        {
+            label: 'Generate',
+            description: 'Generate new ARK components',
+            value: 'generate',
+            command: 'ark generate',
+        },
+        { label: 'Exit', description: 'Exit ARK CLI', value: 'exit' },
     ];
-    React.useEffect(() => {
-        if (selectedChoice === 'exit') {
-            const timer = setTimeout(() => {
-                process.exit(0);
-            }, EXIT_TIMEOUT_MS);
-            return () => clearTimeout(timer);
-        }
-    }, [selectedChoice]);
-    React.useEffect(() => {
-        if (selectedChoice === 'status' && !statusData && !isLoading) {
-            checkStatus();
+    useInput((input, key) => {
+        if (key.upArrow || input === 'k') {
+            setSelectedIndex((prev) => (prev > 0 ? prev - 1 : choices.length - 1));
         }
-    }, [selectedChoice, statusData, isLoading]);
-    const checkStatus = async () => {
-        setIsLoading(true);
-        setError(null);
-        try {
-            const configManager = new ConfigManager();
-            const apiBaseUrl = await configManager.getApiBaseUrl();
-            const serviceUrls = await configManager.getServiceUrls();
-            const arkClient = new ArkClient(apiBaseUrl);
-            const statusChecker = new StatusChecker(arkClient);
-            const status = await statusChecker.checkAll(serviceUrls, apiBaseUrl);
-            setStatusData(status);
+        else if (key.downArrow || input === 'j') {
+            setSelectedIndex((prev) => (prev < choices.length - 1 ? prev + 1 : 0));
         }
-        catch (err) {
-            setError(err instanceof Error ? err.message : 'Unknown error occurred');
+        else if (key.return) {
+            handleSelect(choices[selectedIndex]);
         }
-        finally {
-            setIsLoading(false);
+        else {
+            // Handle number keys for quick selection
+            const num = parseInt(input, 10);
+            if (!isNaN(num) && num >= 1 && num <= choices.length) {
+                handleSelect(choices[num - 1]);
+            }
         }
-    };
-    useInput((input, key) => {
-        if (selectedChoice && selectedChoice !== 'exit') {
-            if (key.escape || input === 'q' || key.return) {
-                // For generate, only reset on specific key combinations to avoid conflicts
-                if (selectedChoice === 'generate' && !(key.escape || input === 'q')) {
-                    return;
+    });
+    const handleSelect = async (item) => {
+        switch (item.value) {
+            case 'exit':
+                process.exit(0);
+                break;
+            case 'chat': {
+                // Unmount fullscreen app and clear screen.
+                await unmountInkApp();
+                // Import and start ChatUI in the same process
+                const { render } = await import('ink');
+                const { ArkApiProxy } = await import('../lib/arkApiProxy.js');
+                const ChatUI = (await import('../components/ChatUI.js')).default;
+                try {
+                    const proxy = new ArkApiProxy();
+                    const arkApiClient = await proxy.start();
+                    // Render ChatUI as a new Ink app
+                    render(_jsx(ChatUI, { arkApiClient: arkApiClient, arkApiProxy: proxy }));
                 }
-                setSelectedChoice(null);
-                setStatusData(null);
-                setError(null);
+                catch (error) {
+                    const output = (await import('../lib/output.js')).default;
+                    output.error(error instanceof Error
+                        ? error.message
+                        : 'Failed to connect to ARK API');
+                    process.exit(1);
+                }
+                break;
+            }
+            case 'install': {
+                //  Unmount fullscreen app and clear screen.
+                await unmountInkApp();
+                // NOTE: We spawn the install command as a separate process to avoid
+                // signal handling conflicts between Ink's useInput and inquirer's prompts.
+                // The signal-exit library used by inquirer conflicts with Ink's signal handlers,
+                // causing ExitPromptError even after proper cleanup. Spawning ensures
+                // a clean process environment for inquirer to work correctly.
+                const { spawn } = await import('child_process');
+                const child = spawn(process.execPath, [process.argv[1], 'install'], {
+                    stdio: 'inherit',
+                });
+                await new Promise((resolve, reject) => {
+                    child.on('close', (code) => {
+                        if (code === 0) {
+                            resolve();
+                        }
+                        else if (code === 130) {
+                            // 130 is the exit code for SIGINT (Ctrl+C)
+                            process.exit(130);
+                        }
+                        else {
+                            reject(new Error(`Install command failed with code ${code}`));
+                        }
+                    });
+                    child.on('error', reject);
+                    // Forward SIGINT to child and exit
+                    process.on('SIGINT', () => {
+                        child.kill('SIGINT');
+                        process.exit(130);
+                    });
+                });
+                break;
+            }
+            case 'dashboard': {
+                //  Unmount fullscreen app and clear screen.
+                await unmountInkApp();
+                const { openDashboard } = await import('../commands/dashboard/index.js');
+                await openDashboard();
+                break;
+            }
+            case 'status': {
+                //  Unmount fullscreen app and clear screen.
+                await unmountInkApp();
+                const { checkStatus } = await import('../commands/status/index.js');
+                await checkStatus();
+                break;
+            }
+            case 'generate': {
+                const GeneratorUI = (await import('../components/GeneratorUI.js'))
+                    .default;
+                render(_jsx(GeneratorUI, {}));
+                break;
             }
         }
-    });
-    const renderBanner = () => (_jsxs(Box, { flexDirection: "column", alignItems: "center", marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: `
+    };
+    return (_jsxs(_Fragment, { children: [_jsxs(Box, { flexDirection: "column", alignItems: "center", marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: `
     ╔═══════════════════════════════════════╗
     ║                                       ║
     ║         █████╗ ██████╗ ██╗  ██╗       ║
@@ -77,40 +176,9 @@ const MainMenu = () => {
     ║        Agents at Scale Platform       ║
     ║                                       ║
     ╚═══════════════════════════════════════╝
-        ` }), _jsx(Text, { color: "green", bold: true, children: "Welcome to ARK! \uD83D\uDE80" }), _jsx(Text, { color: "gray", children: "Interactive terminal interface for ARK agents" })] }));
-    const renderServiceStatus = (service) => {
-        const statusColor = service.status === 'healthy'
-            ? 'green'
-            : service.status === 'unhealthy'
-                ? 'red'
-                : 'yellow';
-        const statusIcon = service.status === 'healthy'
-            ? '✓'
-            : service.status === 'unhealthy'
-                ? '✗'
-                : '?';
-        return (_jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsxs(Text, { color: statusColor, children: [statusIcon, " "] }), _jsxs(Text, { bold: true, children: [service.name, ": "] }), _jsx(Text, { color: statusColor, children: service.status })] }), service.url && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "gray", children: ["URL: ", service.url] }) })), service.details && (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "gray", children: service.details }) }))] }, service.name));
-    };
-    const renderDependencyStatus = (dep) => {
-        const statusColor = dep.installed ? 'green' : 'red';
-        const statusIcon = dep.installed ? '✓' : '✗';
-        const statusText = dep.installed ? 'installed' : 'missing';
-        return (_jsxs(Box, { flexDirection: "column", marginLeft: 2, children: [_jsxs(Box, { children: [_jsxs(Text, { color: statusColor, children: [statusIcon, " "] }), _jsxs(Text, { bold: true, children: [dep.name, ": "] }), _jsx(Text, { color: statusColor, children: statusText })] }), dep.version && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: "gray", children: ["Version: ", dep.version] }) })), dep.details && (_jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: "gray", children: dep.details }) }))] }, dep.name));
-    };
-    const renderStatus = () => {
-        if (isLoading) {
-            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "yellow", children: "\uD83D\uDD0D Checking ARK system status..." }), _jsx(Text, { color: "gray", children: "Please wait while we verify services and dependencies." })] }));
-        }
-        if (error) {
-            return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "red", children: "\u274C Error checking status:" }), _jsx(Text, { color: "red", children: error }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Press ESC, 'q', or Enter to return to menu..." }) })] }));
-        }
-        if (!statusData) {
-            return null;
-        }
-        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "cyan", bold: true, children: "\uD83D\uDD0D ARK System Status" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "cyan", bold: true, children: "\uD83D\uDCE1 ARK Services:" }) }), statusData.services.map(renderServiceStatus), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "cyan", bold: true, children: "\uD83D\uDEE0\uFE0F System Dependencies:" }) }), statusData.dependencies.map(renderDependencyStatus), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Press ESC, 'q', or Enter to return to menu..." }) })] }));
-    };
-    return (_jsxs(_Fragment, { children: [renderBanner(), !selectedChoice && (_jsx(SelectInput, { items: choices, onSelect: (choice) => {
-                    setSelectedChoice(choice.value);
-                } })), selectedChoice === 'status' && renderStatus(), selectedChoice === 'dashboard' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", children: "\uD83C\uDFF7\uFE0F Dashboard feature selected" }), _jsx(DashboardCLI, {})] })), selectedChoice === 'generate' && _jsx(GeneratorUI, {}), selectedChoice === 'exit' && _jsx(Text, { color: "yellow", children: "\uD83D\uDC4B Goodbye!" })] }));
+        ` }), _jsx(Text, { color: "green", bold: true, children: "Welcome to ARK! \uD83D\uDE80" }), _jsx(Text, { color: "gray", children: "Interactive terminal interface for ARK agents" })] }), _jsx(Box, { flexDirection: "column", paddingX: 4, marginTop: 1, children: choices.map((choice, index) => {
+                    const isSelected = index === selectedIndex;
+                    return (_jsxs(Box, { flexDirection: "row", paddingY: 0, children: [_jsx(Text, { color: "gray", dimColor: true, children: isSelected ? '❯ ' : '  ' }), _jsxs(Text, { color: "gray", dimColor: true, children: [index + 1, "."] }), _jsx(Box, { marginLeft: 1, width: 20, children: _jsx(Text, { color: isSelected ? 'green' : 'white', bold: isSelected, children: choice.label }) }), _jsx(Text, { color: "gray", children: choice.description })] }, choice.value));
+                }) })] }));
 };
 export default MainMenu;

package/dist/ui/statusFormatter.d.ts

@@ -3,7 +3,10 @@ export declare class StatusFormatter {
     /**
      * Print status check results to console
      */
-    static printStatus(statusData: StatusData): void;
+    static printStatus(statusData: StatusData & {
+        clusterAccess?: boolean;
+        clusterInfo?: any;
+    }): void;
     private static printService;
     private static printDependency;
 }

package/dist/ui/statusFormatter.js

@@ -4,18 +4,78 @@ export class StatusFormatter {
      * Print status check results to console
      */
     static printStatus(statusData) {
-        console.log(chalk.cyan.bold('\n🔍 ARK System Status Check'));
-        console.log(chalk.gray('Checking ARK services and dependencies...\n'));
-        // Print services status
-        console.log(chalk.cyan.bold('📡 ARK Services:'));
-        for (const service of statusData.services) {
-            StatusFormatter.printService(service);
-        }
-        // Print dependencies status
-        console.log(chalk.cyan.bold('\n🛠️  System Dependencies:'));
+        console.log();
+        // Print dependencies status first
+        console.log(chalk.cyan.bold('system dependencies:'));
         for (const dep of statusData.dependencies) {
             StatusFormatter.printDependency(dep);
         }
+        // Print cluster status
+        console.log(chalk.cyan.bold('\ncluster access:'));
+        if (statusData.clusterAccess && statusData.clusterInfo) {
+            const clusterName = statusData.clusterInfo.context || 'kubernetes cluster';
+            const clusterDetails = [];
+            if (statusData.clusterInfo.type &&
+                statusData.clusterInfo.type !== 'unknown') {
+                clusterDetails.push(statusData.clusterInfo.type);
+            }
+            if (statusData.clusterInfo.ip) {
+                clusterDetails.push(statusData.clusterInfo.ip);
+            }
+            console.log(`  ${chalk.green('✓ accessible')} ${chalk.bold.white(clusterName)}${clusterDetails.length > 0 ? chalk.gray(' ' + clusterDetails.join(', ')) : ''}`);
+        }
+        else if (statusData.clusterAccess) {
+            console.log(`  ${chalk.green('✓ accessible')} ${chalk.bold('kubernetes cluster')}`);
+        }
+        else {
+            console.log(`  ${chalk.red('✗ unreachable')} ${chalk.bold('kubernetes cluster')}`);
+            console.log(`    ${chalk.gray('Install minikube: https://minikube.sigs.k8s.io/docs/start')}`);
+        }
+        // Only show ARK services if we have cluster access
+        if (statusData.clusterAccess) {
+            console.log(chalk.cyan.bold('\nark services:'));
+            // Show all services except ark-controller (already shown in ark status)
+            for (const service of statusData.services) {
+                if (service.name !== 'ark-controller') {
+                    StatusFormatter.printService(service);
+                }
+            }
+        }
+        else {
+            console.log(chalk.cyan.bold('\nark services:'));
+            console.log(`  ${chalk.gray('Cannot check ARK services - cluster not accessible')}`);
+        }
+        // Print ARK status section
+        console.log(chalk.cyan.bold('\nark status:'));
+        if (!statusData.clusterAccess) {
+            console.log(`  ${chalk.red('✗ no cluster access')}`);
+        }
+        else {
+            // Show ark-controller status
+            const controllerStatus = statusData.services?.find(s => s.name === 'ark-controller');
+            if (controllerStatus) {
+                // Show the actual status but replace "not installed" with "not ready" for display
+                if (controllerStatus.status === 'not installed') {
+                    console.log(`  ${chalk.yellow('○ not ready')} ${chalk.bold('ark-controller')} ${chalk.gray(controllerStatus.details || '')}`);
+                }
+                else if (controllerStatus.status === 'healthy') {
+                    // Controller is healthy - show ready status with model info
+                    if (!statusData.defaultModelExists) {
+                        console.log(`  ${chalk.green('✓ ready')} ${chalk.bold('ark-controller')} ${chalk.gray(controllerStatus.details || '')}`);
+                        console.log(`  ${chalk.gray('  (no default model configured)')}`);
+                    }
+                    else {
+                        console.log(`  ${chalk.green('✓ ready')} ${chalk.bold('ark-controller')} ${chalk.gray(controllerStatus.details || '')}`);
+                    }
+                }
+                else {
+                    StatusFormatter.printService(controllerStatus);
+                }
+            }
+            else {
+                console.log(`  ${chalk.yellow('○ not ready')} ${chalk.bold('ark-controller')}`);
+            }
+        }
         console.log();
     }
     static printService(service) {
@@ -23,24 +83,36 @@ export class StatusFormatter {
             ? chalk.green('✓ healthy')
             : service.status === 'unhealthy'
                 ? chalk.red('✗ unhealthy')
-                : chalk.yellow('? not installed');
-        console.log(`  • ${chalk.bold(service.name)}: ${statusColor}`);
-        if (service.url) {
-            console.log(`    ${chalk.gray(`URL: ${service.url}`)}`);
+                : service.status === 'warning'
+                    ? chalk.yellow('⚠ warning')
+                    : service.status === 'not ready'
+                        ? chalk.yellow('○ not ready')
+                        : chalk.yellow('? not installed');
+        // Show version and revision in grey after the name for healthy services
+        let versionInfo = '';
+        if (service.status === 'healthy' && (service.version || service.revision)) {
+            const parts = [];
+            if (service.version)
+                parts.push(`v${service.version}`);
+            if (service.revision)
+                parts.push(`revision ${service.revision}`);
+            versionInfo = chalk.gray(` ${parts.join(', ')}`);
         }
+        // Show details inline in grey for all statuses
+        let inlineDetails = '';
         if (service.details) {
-            console.log(`    ${chalk.gray(service.details)}`);
+            inlineDetails = chalk.gray(` ${service.details}`);
         }
+        console.log(`  ${statusColor} ${chalk.bold(service.name)}${versionInfo}${inlineDetails}`);
     }
     static printDependency(dep) {
         const statusColor = dep.installed
             ? chalk.green('✓ installed')
             : chalk.red('✗ missing');
-        console.log(`  • ${chalk.bold(dep.name)}: ${statusColor}`);
-        if (dep.version) {
-            console.log(`    ${chalk.gray(`Version: ${dep.version}`)}`);
-        }
-        if (dep.details) {
+        const versionText = dep.version ? chalk.gray(` ${dep.version}`) : '';
+        console.log(`  ${statusColor} ${chalk.bold(dep.name)}${versionText}`);
+        if (dep.details && !dep.installed) {
+            // Only show details if there's an issue
             console.log(`    ${chalk.gray(dep.details)}`);
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-at-scale/ark",
-  "version": "0.1.33",
+  "version": "0.1.35-rc.1",
   "description": "ARK CLI - Interactive terminal interface for ARK agents",
   "main": "dist/index.js",
   "type": "module",
@@ -12,11 +12,13 @@
   ],
   "scripts": {
     "build": "tsc && chmod +x dist/index.js",
-    "dev": "node --loader ts-node/esm src/index.tsx",
-    "start": "node dist/index.js",
+    "postbuild": "mkdir -p dist/lib/dev/tools && cp src/lib/dev/tools/*.py dist/lib/dev/tools/ 2>/dev/null || true",
+    "dev": "tsc --watch",
+    "start": "NODE_NO_WARNINGS=1 node dist/index.js",
     "clean": "rm -rf dist",
     "lint": "eslint src/ --fix && prettier --write src/",
     "lint:check": "eslint src/ && prettier --check src/",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage --coverageDirectory=./artifacts/coverage",
     "postinstall": "echo \"ARK CLI installed! Run 'ark' to try it out.\""
   },
   "keywords": [
@@ -39,7 +41,7 @@
   },
   "dependencies": {
     "@kubernetes/client-node": "^1.3.0",
-    "@types/react": "^19.1.8",
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "axios": "^1.7.7",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
@@ -47,9 +49,14 @@
     "execa": "^9.6.0",
     "ink": "^6.0.1",
     "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "inquirer": "^12.1.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
     "open": "^10.2.0",
+    "openai": "^5.19.1",
+    "ora": "^8.2.0",
     "react": "^19.1.0",
     "simple-git": "^3.28.0",
     "yaml": "^2.6.1"
@@ -58,12 +65,17 @@
     "@eslint/js": "^9.17.0",
     "@types/debug": "^4.1.12",
     "@types/inquirer": "^9.0.7",
+    "@types/jest": "^30.0.0",
     "@types/node": "^22.10.2",
+    "@types/react": "^19.1.13",
     "@typescript-eslint/eslint-plugin": "^8.20.0",
     "@typescript-eslint/parser": "^8.20.0",
     "eslint": "^9.17.0",
+    "jest": "^30.1.3",
     "prettier": "^3.6.2",
+    "ts-jest": "^29.4.1",
     "ts-node": "^10.9.2",
+    "tsx": "^4.20.5",
     "typescript": "^5.7.2"
   },
   "engines": {