icoa-cli 1.4.3 → 1.5.0

package/dist/index.js

@@ -14,6 +14,7 @@ import { registerSetupCommand } from './commands/setup.js';
 import { getConfig, saveConfig } from './lib/config.js';
 import { startRepl } from './repl.js';
 import { checkTerminal } from './lib/terminal.js';
+import { setTerminalTheme } from './lib/theme.js';
 // Banner: each line between ║ ║ = exactly 58 visible chars
 const B = chalk.cyan('║');
 const BANNER = `
@@ -36,7 +37,7 @@ ${B}                                                          ${B}
 ${B}   ${chalk.white('Sydney, Australia')}  ${chalk.gray('Jun 27 - Jul 2, 2026')}                ${B}
 ${B}   ${chalk.cyan.underline('https://icoa2026.au')}                                    ${B}
 ${B}                                                          ${B}
-${B}   ${chalk.gray('CLI-Native Competition Terminal  v1.4.3')}                ${B}
+${B}   ${chalk.gray('CLI-Native Competition Terminal  v1.5.0')}                ${B}
 ${B}                                                          ${B}
 ${chalk.cyan('╚══════════════════════════════════════════════════════════╝')}
 `;
@@ -61,8 +62,8 @@ program
     .description('ICOA CLI — CLI-Native CTF Competition Terminal')
     .option('--resume', 'Resume previous session')
     .action((opts) => {
-    // Force black background, green text (hacker style) across all platforms
-    process.stdout.write('\x1b[0m\x1b[40m\x1b[38;2;0;255;65m\x1b[2J\x1b[H');
+    // Force hacker theme: black background + green text
+    setTerminalTheme();
     console.log(BANNER);
     checkTerminal();
     // If running interactively (no extra args or --resume), start REPL

package/dist/lib/sandbox.d.ts

@@ -0,0 +1,7 @@
+export declare function isDockerAvailable(): boolean;
+export declare function isSandboxRunning(): boolean;
+export declare function ensureSandbox(): Promise<boolean>;
+export declare function runInSandbox(command: string, rl: {
+    pause: () => void;
+    resume: () => void;
+}): Promise<void>;

package/dist/lib/sandbox.js

@@ -0,0 +1,93 @@
+import { execSync, spawn } from 'node:child_process';
+import chalk from 'chalk';
+const IMAGE = 'icoa/sandbox:2026';
+const CONTAINER = 'icoa-sandbox';
+export function isDockerAvailable() {
+    try {
+        execSync('docker info', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isSandboxRunning() {
+    try {
+        const out = execSync(`docker inspect -f '{{.State.Running}}' ${CONTAINER} 2>/dev/null`, {
+            encoding: 'utf-8',
+        });
+        return out.trim() === 'true';
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensureSandbox() {
+    if (!isDockerAvailable()) {
+        console.log(chalk.yellow('  Docker not found. Install Docker Desktop to use sandbox tools.'));
+        console.log(chalk.gray('  https://www.docker.com/products/docker-desktop'));
+        return false;
+    }
+    if (isSandboxRunning())
+        return true;
+    // Check if container exists but stopped
+    try {
+        execSync(`docker start ${CONTAINER}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        // Container doesn't exist, create it
+    }
+    // Check if image exists
+    try {
+        execSync(`docker image inspect ${IMAGE}`, { stdio: 'ignore' });
+    }
+    catch {
+        console.log(chalk.gray('  Pulling sandbox image (first time only)...'));
+        try {
+            execSync(`docker pull ${IMAGE}`, { stdio: 'inherit' });
+        }
+        catch {
+            // Image not on registry yet, try building locally
+            console.log(chalk.gray('  Building sandbox from local Dockerfile...'));
+            try {
+                const dockerDir = new URL('../../docker', import.meta.url).pathname;
+                execSync(`docker build -t ${IMAGE} ${dockerDir}`, { stdio: 'inherit' });
+            }
+            catch {
+                console.log(chalk.red('  Failed to set up sandbox.'));
+                return false;
+            }
+        }
+    }
+    // Create and start container
+    try {
+        execSync(`docker run -d --name ${CONTAINER} ` +
+            `-v icoa-challenges:/home/competitor/challenges ` +
+            `--network host ` +
+            `${IMAGE} sleep infinity`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        console.log(chalk.red('  Failed to start sandbox container.'));
+        return false;
+    }
+}
+export function runInSandbox(command, rl) {
+    return new Promise((resolve) => {
+        rl.pause();
+        const opts = {
+            stdio: 'inherit',
+            shell: true,
+        };
+        const child = spawn('docker', ['exec', '-it', CONTAINER, 'bash', '-c', command], opts);
+        child.on('close', () => {
+            rl.resume();
+            resolve();
+        });
+        child.on('error', () => {
+            rl.resume();
+            resolve();
+        });
+    });
+}

package/dist/lib/theme.d.ts

@@ -0,0 +1,2 @@
+export declare function setTerminalTheme(): void;
+export declare function resetTerminalTheme(): void;

package/dist/lib/theme.js

@@ -0,0 +1,52 @@
+import { execSync } from 'node:child_process';
+import { platform } from 'node:os';
+export function setTerminalTheme() {
+    const os = platform();
+    if (os === 'darwin') {
+        // macOS Terminal.app: use AppleScript to change colors
+        try {
+            execSync(`osascript -e '
+        tell application "Terminal"
+          set bg to {0, 0, 0}
+          set fg to {0, 65535, 16896}
+          set background color of selected tab of front window to bg
+          set normal text color of selected tab of front window to fg
+          set cursor color of selected tab of front window to fg
+        end tell
+      '`, { stdio: 'ignore' });
+        }
+        catch {
+            // Fallback to ANSI if AppleScript fails (e.g. not Terminal.app)
+            process.stdout.write('\x1b[0m\x1b[40m\x1b[38;2;0;255;65m\x1b[2J\x1b[H');
+        }
+    }
+    else {
+        // Linux / Windows: ANSI escape codes
+        process.stdout.write('\x1b[0m\x1b[40m\x1b[38;2;0;255;65m\x1b[2J\x1b[H');
+    }
+    // Clear screen
+    process.stdout.write('\x1b[2J\x1b[H');
+}
+export function resetTerminalTheme() {
+    const os = platform();
+    if (os === 'darwin') {
+        try {
+            // Reset to macOS Terminal.app default profile colors
+            execSync(`osascript -e '
+        tell application "Terminal"
+          set bg to {65535, 65535, 65535}
+          set fg to {0, 0, 0}
+          set background color of selected tab of front window to bg
+          set normal text color of selected tab of front window to fg
+          set cursor color of selected tab of front window to fg
+        end tell
+      '`, { stdio: 'ignore' });
+        }
+        catch {
+            process.stdout.write('\x1b[0m\x1b[2J\x1b[H');
+        }
+    }
+    else {
+        process.stdout.write('\x1b[0m\x1b[2J\x1b[H');
+    }
+}

package/dist/repl.js

@@ -3,6 +3,8 @@ import { spawn } from 'node:child_process';
 import chalk from 'chalk';
 import { isConnected, getConfig } from './lib/config.js';
 import { isActivated, activateToken, isFreeCommand, isDeviceMatch, recordExit, recordResume } from './lib/access.js';
+import { resetTerminalTheme } from './lib/theme.js';
+import { ensureSandbox, runInSandbox, isDockerAvailable } from './lib/sandbox.js';
 const INTERCEPT = '__REPL_NO_EXIT__';
 export function startRepl(program, resumeMode) {
     const config = getConfig();
@@ -68,7 +70,7 @@ export function startRepl(program, resumeMode) {
         if (input === 'exit' || input === 'quit' || input === 'q') {
             recordExit();
             console.log(chalk.gray('  Session saved. Use ') + chalk.white('icoa --resume') + chalk.gray(' to continue.'));
-            process.stdout.write('\x1b[0m\x1b[2J\x1b[H'); // Reset colors, clear screen
+            resetTerminalTheme();
             realExit(0);
             return;
         }
@@ -126,10 +128,21 @@ export function startRepl(program, resumeMode) {
             'lang', 'setup', 'model', 'ctf',
         ];
         if (!knownCommands.includes(cmd)) {
-            // Pass through to system shell
+            // Route to Docker sandbox if available, otherwise system shell
             processing = true;
             try {
-                await runSystemCommand(input, rl);
+                if (isDockerAvailable()) {
+                    const ready = await ensureSandbox();
+                    if (ready) {
+                        await runInSandbox(input, rl);
+                    }
+                    else {
+                        await runSystemCommand(input, rl);
+                    }
+                }
+                else {
+                    await runSystemCommand(input, rl);
+                }
             }
             catch {
                 console.log(chalk.yellow(`  Command failed: ${cmd}`));
@@ -168,7 +181,7 @@ export function startRepl(program, resumeMode) {
     });
     rl.on('close', () => {
         recordExit();
-        process.stdout.write('\x1b[0m\x1b[2J\x1b[H');
+        resetTerminalTheme();
         realExit(0);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icoa-cli",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "ICOA CLI — The world's first CLI-native CTF competition terminal",
   "type": "module",
   "bin": {