espcli 0.0.1 → 0.0.2

package/src/tui/commands/clean.ts

@@ -1,36 +0,0 @@
-import { clean } from '@/core/operations/clean';
-import { findProjectRoot } from '@/core/services/idf';
-import { createOperationId } from '@/core/emitter';
-import { logger } from '@/tui/logger';
-
-interface CleanOptions {
-  full?: boolean;
-}
-
-export async function cleanCommand(options: CleanOptions): Promise<void> {
-  const projectDir = await findProjectRoot(process.cwd());
-
-  if (!projectDir) {
-    logger.error('Not in an ESP-IDF project directory');
-    process.exit(1);
-  }
-
-  const opId = createOperationId();
-
-  logger.step(options.full ? 'Running fullclean...' : 'Cleaning build...');
-
-  const result = await clean(
-    {
-      projectDir,
-      full: options.full,
-    },
-    opId
-  );
-
-  if (!result.ok) {
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  logger.success('Clean complete');
-}

package/src/tui/commands/devices.ts

@@ -1,18 +0,0 @@
-import { listDevices } from '@/core/operations/devices';
-import { deviceTable } from '@/tui/display';
-import { logger } from '@/tui/logger';
-
-export async function devicesCommand(): Promise<void> {
-  logger.info('Scanning for devices...');
-
-  const result = await listDevices();
-
-  if (!result.ok) {
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  logger.newline();
-  deviceTable(result.data);
-  logger.newline();
-}

package/src/tui/commands/doctor.ts

@@ -1,70 +0,0 @@
-import pc from 'picocolors';
-import { getHealth, type HealthStatus } from '@/core/services/health';
-import { listPorts } from '@/core/services/ports';
-import { logger } from '@/tui/logger';
-
-export async function doctorCommand(): Promise<void> {
-  logger.info('Checking system health...');
-  logger.newline();
-
-  const health = await getHealth();
-
-  // Display each check
-  displayStatus(health.python);
-  displayStatus(health.git);
-  displayStatus(health.idf);
-  displayStatus(health.pyserial);
-  displayStatus(health.esptool);
-
-  // Check for connected devices
-  logger.newline();
-  await checkDevices();
-
-  // Summary
-  logger.newline();
-  const allOk = health.python.ok && health.git.ok && health.idf.ok && health.pyserial.ok && health.esptool.ok;
-
-  if (allOk) {
-    console.log(pc.green('✓ All checks passed! Ready for ESP32 development.'));
-  } else {
-    console.log(pc.yellow('⚠ Some checks failed. See hints above to fix issues.'));
-  }
-
-  logger.newline();
-}
-
-function displayStatus(status: HealthStatus): void {
-  const icon = status.ok ? pc.green('✓') : pc.red('✗');
-  const name = status.name.padEnd(10);
-  const version = status.version ? pc.dim(`v${status.version}`) : '';
-  const path = status.path ? pc.dim(` (${status.path})`) : '';
-
-  if (status.ok) {
-    console.log(`  ${icon} ${pc.bold(name)} ${version}${path}`);
-  } else {
-    console.log(`  ${icon} ${pc.bold(name)} ${pc.red(status.error || 'Not found')}`);
-    if (status.hint) {
-      console.log(`    ${pc.dim('→')} ${pc.yellow(status.hint)}`);
-    }
-  }
-}
-
-async function checkDevices(): Promise<void> {
-  console.log(pc.bold('  Devices:'));
-
-  try {
-    const devices = await listPorts();
-
-    if (devices.length === 0) {
-      console.log(`    ${pc.dim('No ESP devices connected')}`);
-    } else {
-      for (const device of devices) {
-        const chip = device.espChip || device.chip || 'Unknown';
-        const type = device.connectionType === 'native-usb' ? 'USB' : 'UART';
-        console.log(`    ${pc.green('•')} ${device.port} ${pc.dim(`(${chip} via ${type})`)}`);
-      }
-    }
-  } catch {
-    console.log(`    ${pc.dim('Could not check devices')}`);
-  }
-}

package/src/tui/commands/flash.ts

@@ -1,61 +0,0 @@
-import { flash } from '@/core/operations/flash';
-import { listDevices } from '@/core/operations/devices';
-import { findProjectRoot } from '@/core/services/idf';
-import { emitter, createOperationId } from '@/core/emitter';
-import * as prompts from '@/tui/prompts';
-import { logger } from '@/tui/logger';
-
-interface FlashOptions {
-  port?: string;
-  baud?: number;
-}
-
-export async function flashCommand(options: FlashOptions): Promise<void> {
-  const projectDir = await findProjectRoot(process.cwd());
-
-  if (!projectDir) {
-    logger.error('Not in an ESP-IDF project directory');
-    process.exit(1);
-  }
-
-  let port = options.port;
-
-  if (!port) {
-    const devicesResult = await listDevices();
-
-    if (!devicesResult.ok) {
-      logger.error(devicesResult.error);
-      process.exit(1);
-    }
-
-    port = await prompts.selectDevice(devicesResult.data);
-  }
-
-  const opId = createOperationId();
-
-  emitter.subscribe(opId, (event) => {
-    if (event.data.type === 'stdout' || event.data.type === 'stderr') {
-      logger.output(event.data.text);
-    }
-  });
-
-  logger.step(`Flashing to ${port}...`);
-
-  const result = await flash(
-    {
-      projectDir,
-      port,
-      baud: options.baud,
-    },
-    opId
-  );
-
-  if (!result.ok) {
-    logger.newline();
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  logger.newline();
-  logger.success('Flash complete');
-}

package/src/tui/commands/init.ts

@@ -1,59 +0,0 @@
-import { init } from '@/core/operations/init';
-import { createOperationId } from '@/core/emitter';
-import * as prompts from '@/tui/prompts';
-import { logger } from '@/tui/logger';
-import { resolve } from 'path';
-
-interface InitOptions {
-  lang?: 'c' | 'cpp';
-  target?: string;
-}
-
-export async function initCommand(name: string | undefined, options: InitOptions): Promise<void> {
-  prompts.intro('Create ESP-IDF Project');
-
-  const projectName = name || (await prompts.text('Project name', 'my-esp-project'));
-
-  const language = options.lang || (await prompts.selectLanguage());
-  const target = options.target || (await prompts.selectTarget());
-
-  const config = {
-    name: projectName,
-    directory: resolve(process.cwd()),
-    language,
-    target,
-  };
-
-  prompts.note(
-    `Name: ${config.name}\nLanguage: ${language.toUpperCase()}\nTarget: ${target}\nPath: ${config.directory}/${config.name}`,
-    'Project Configuration'
-  );
-
-  const proceed = await prompts.confirm('Create project?');
-  if (!proceed) {
-    prompts.cancel('Cancelled');
-    return;
-  }
-
-  const spin = prompts.spinner();
-  spin.start('Creating project...');
-
-  const opId = createOperationId();
-  const result = await init(config, opId);
-
-  spin.stop();
-
-  if (!result.ok) {
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  logger.success(`Created project at ${result.data.projectPath}`);
-  logger.newline();
-  logger.dim('Files created:');
-  result.data.files.forEach((f) => logger.dim(`  ${f}`));
-  logger.newline();
-  logger.info(`cd ${projectName} && espcli build`);
-
-  prompts.outro('Project ready');
-}

package/src/tui/commands/install.ts

@@ -1,89 +0,0 @@
-import { install } from '@/core/operations/install';
-import { getIdfStatus } from '@/core/services/idf';
-import { getShellInfo } from '@/core/services/shell';
-import { emitter, createOperationId } from '@/core/emitter';
-import { DEFAULT_ESP_PATH } from '@/core/constants';
-import * as prompts from '@/tui/prompts';
-import { logger } from '@/tui/logger';
-
-interface InstallOptions {
-  path?: string;
-  target?: string;
-  yes?: boolean;
-}
-
-export async function installCommand(options: InstallOptions): Promise<void> {
-  prompts.intro('ESP-IDF Installation');
-
-  const status = await getIdfStatus();
-
-  if (status.installed) {
-    logger.info(`ESP-IDF already installed at ${status.path}`);
-    if (status.version) {
-      logger.info(`Version: ${status.version}`);
-    }
-
-    const reinstall = await prompts.confirm('Reinstall ESP-IDF?', false);
-    if (!reinstall) {
-      prompts.outro('Installation skipped');
-      return;
-    }
-  }
-
-  const path = options.path || DEFAULT_ESP_PATH;
-  const target = options.target || 'all';
-  const shellInfo = getShellInfo();
-
-  if (!options.yes) {
-    prompts.note(
-      `Install path: ${path}\nTarget: ${target}\nShell: ${shellInfo.type}\nConfig: ${shellInfo.configPath}`,
-      'Installation Plan'
-    );
-
-    const proceed = await prompts.confirm('Proceed with installation?');
-    if (!proceed) {
-      prompts.cancel('Installation cancelled');
-      return;
-    }
-  }
-
-  const opId = createOperationId();
-  const spin = prompts.spinner();
-
-  emitter.subscribe(opId, (event) => {
-    if (event.data.type === 'progress') {
-      spin.message(event.data.message);
-    } else if (event.data.type === 'stdout' || event.data.type === 'stderr') {
-      spin.stop();
-      logger.output(event.data.text);
-      spin.start();
-    }
-  });
-
-  spin.start('Installing ESP-IDF...');
-
-  const result = await install(
-    {
-      path,
-      target,
-      addToShell: true,
-    },
-    opId
-  );
-
-  spin.stop();
-
-  if (!result.ok) {
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  logger.success(`ESP-IDF installed at ${result.data.idfPath}`);
-
-  if (result.data.addedToShell) {
-    logger.info(`Added to ${shellInfo.configPath}`);
-    logger.dim('Restart your shell or run: source ' + shellInfo.configPath);
-  }
-
-  prompts.outro('Installation complete');
-}

package/src/tui/commands/monitor.ts

@@ -1,63 +0,0 @@
-import { startMonitor } from '@/core/operations/monitor';
-import { listDevices } from '@/core/operations/devices';
-import { findProjectRoot } from '@/core/services/idf';
-import { emitter, createOperationId } from '@/core/emitter';
-import * as prompts from '@/tui/prompts';
-import { logger } from '@/tui/logger';
-
-interface MonitorOptions {
-  port?: string;
-  baud?: number;
-}
-
-export async function monitorCommand(options: MonitorOptions): Promise<void> {
-  const projectDir = await findProjectRoot(process.cwd());
-
-  let port = options.port;
-
-  if (!port) {
-    const devicesResult = await listDevices();
-
-    if (!devicesResult.ok) {
-      logger.error(devicesResult.error);
-      process.exit(1);
-    }
-
-    port = await prompts.selectDevice(devicesResult.data);
-  }
-
-  const opId = createOperationId();
-
-  emitter.subscribe(opId, (event) => {
-    if (event.data.type === 'stdout' || event.data.type === 'stderr') {
-      logger.output(event.data.text);
-    }
-  });
-
-  logger.step(`Connecting to ${port}...`);
-  logger.dim('Press Ctrl+C to exit');
-  logger.newline();
-
-  const result = startMonitor(
-    {
-      port,
-      baud: options.baud,
-      projectDir: projectDir || undefined,
-    },
-    opId
-  );
-
-  if (!result.ok) {
-    logger.error(result.error);
-    process.exit(1);
-  }
-
-  process.on('SIGINT', () => {
-    result.data.stop();
-    logger.newline();
-    logger.info('Monitor stopped');
-    process.exit(0);
-  });
-
-  await new Promise(() => {});
-}

package/src/tui/commands/run.ts

@@ -1,99 +0,0 @@
-import { build } from '@/core/operations/build';
-import { flash } from '@/core/operations/flash';
-import { startMonitor } from '@/core/operations/monitor';
-import { listDevices } from '@/core/operations/devices';
-import { findProjectRoot } from '@/core/services/idf';
-import { emitter, createOperationId } from '@/core/emitter';
-import * as prompts from '@/tui/prompts';
-import { logger } from '@/tui/logger';
-
-interface RunOptions {
-  port?: string;
-  baud?: number;
-  skipBuild?: boolean;
-}
-
-export async function runCommand(options: RunOptions): Promise<void> {
-  const projectDir = await findProjectRoot(process.cwd());
-
-  if (!projectDir) {
-    logger.error('Not in an ESP-IDF project directory');
-    process.exit(1);
-  }
-
-  let port = options.port;
-
-  if (!port) {
-    const devicesResult = await listDevices();
-
-    if (!devicesResult.ok) {
-      logger.error(devicesResult.error);
-      process.exit(1);
-    }
-
-    port = await prompts.selectDevice(devicesResult.data);
-  }
-
-  const streamHandler = (event: { data: { type: string; text?: string } }) => {
-    if (event.data.type === 'stdout' || event.data.type === 'stderr') {
-      logger.output((event.data as { text: string }).text);
-    }
-  };
-
-  if (!options.skipBuild) {
-    const buildOpId = createOperationId();
-    emitter.subscribe(buildOpId, streamHandler);
-
-    logger.step('Building...');
-
-    const buildResult = await build({ projectDir }, buildOpId);
-
-    if (!buildResult.ok) {
-      logger.newline();
-      logger.error(buildResult.error);
-      process.exit(1);
-    }
-
-    logger.newline();
-    logger.success('Build complete');
-  }
-
-  const flashOpId = createOperationId();
-  emitter.subscribe(flashOpId, streamHandler);
-
-  logger.step(`Flashing to ${port}...`);
-
-  const flashResult = await flash({ projectDir, port, baud: options.baud }, flashOpId);
-
-  if (!flashResult.ok) {
-    logger.newline();
-    logger.error(flashResult.error);
-    process.exit(1);
-  }
-
-  logger.newline();
-  logger.success('Flash complete');
-
-  const monitorOpId = createOperationId();
-  emitter.subscribe(monitorOpId, streamHandler);
-
-  logger.step('Starting monitor...');
-  logger.dim('Press Ctrl+C to exit');
-  logger.newline();
-
-  const monitorResult = startMonitor({ port, baud: options.baud, projectDir }, monitorOpId);
-
-  if (!monitorResult.ok) {
-    logger.error(monitorResult.error);
-    process.exit(1);
-  }
-
-  process.on('SIGINT', () => {
-    monitorResult.data.stop();
-    logger.newline();
-    logger.info('Monitor stopped');
-    process.exit(0);
-  });
-
-  await new Promise(() => {});
-}

package/src/tui/display.ts

@@ -1,96 +0,0 @@
-import pc from 'picocolors';
-import type { SerialDevice, EspTarget } from '@/core/types';
-
-function stripAnsi(str: string): string {
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
-}
-
-function visibleLength(str: string): number {
-  return stripAnsi(str).length;
-}
-
-export function table(headers: string[], rows: string[][]): void {
-  const colWidths = headers.map((h, i) => {
-    const maxRow = Math.max(...rows.map((r) => visibleLength(r[i] || '')));
-    return Math.max(h.length, maxRow);
-  });
-
-  const separator = '─';
-  const topBorder = '┌' + colWidths.map((w) => separator.repeat(w + 2)).join('┬') + '┐';
-  const midBorder = '├' + colWidths.map((w) => separator.repeat(w + 2)).join('┼') + '┤';
-  const botBorder = '└' + colWidths.map((w) => separator.repeat(w + 2)).join('┴') + '┘';
-
-  const padCell = (cell: string, width: number) => {
-    const visible = visibleLength(cell);
-    const padding = width - visible;
-    return cell + ' '.repeat(Math.max(0, padding));
-  };
-
-  const formatRow = (cells: string[]) =>
-    '│' + cells.map((c, i) => ` ${padCell(c || '', colWidths[i])} `).join('│') + '│';
-
-  console.log(pc.dim(topBorder));
-  console.log(pc.bold(formatRow(headers)));
-  console.log(pc.dim(midBorder));
-  rows.forEach((row) => console.log(formatRow(row)));
-  console.log(pc.dim(botBorder));
-}
-
-export function deviceTable(devices: SerialDevice[]): void {
-  if (devices.length === 0) {
-    console.log(pc.dim('No devices found'));
-    return;
-  }
-
-  const headers = ['Port', 'Type', 'Chip', 'ESP'];
-  const rows = devices.map((d) => {
-    const typeLabel = getConnectionTypeLabel(d.connectionType);
-    const espLabel = d.espChip || (d.connectionType === 'native-usb' ? '?' : '-');
-    return [d.port, typeLabel, d.chip || '-', espLabel];
-  });
-
-  table(headers, rows);
-
-  // Show helpful hints
-  const hasNativeUsb = devices.some((d) => d.connectionType === 'native-usb');
-  const hasUartBridge = devices.some((d) => d.connectionType === 'uart-bridge');
-
-  if (hasNativeUsb && hasUartBridge) {
-    console.log('');
-    console.log(pc.dim('  Hint: Multiple ports from same board'));
-    console.log(pc.dim('  • ') + pc.cyan('UART') + pc.dim(' - Reliable flashing & monitoring'));
-    console.log(pc.dim('  • ') + pc.magenta('USB') + pc.dim('  - JTAG debugging'));
-  }
-}
-
-function getConnectionTypeLabel(type: SerialDevice['connectionType']): string {
-  switch (type) {
-    case 'native-usb':
-      return pc.magenta('USB');
-    case 'uart-bridge':
-      return pc.cyan('UART');
-    default:
-      return pc.dim('?');
-  }
-}
-
-export function targetList(targets: EspTarget[]): void {
-  targets.forEach((t) => {
-    const status = t.stable ? pc.green('stable') : pc.yellow('preview');
-    console.log(`  ${pc.bold(t.id.padEnd(10))} ${pc.dim(t.description)} [${status}]`);
-  });
-}
-
-export function box(title: string, content: string): void {
-  const lines = content.split('\n');
-  const maxLen = Math.max(title.length, ...lines.map((l) => l.length));
-  const width = maxLen + 4;
-
-  console.log(pc.dim('╭' + '─'.repeat(width) + '╮'));
-  console.log(pc.dim('│') + ' ' + pc.bold(title.padEnd(maxLen + 2)) + ' ' + pc.dim('│'));
-  console.log(pc.dim('├' + '─'.repeat(width) + '┤'));
-  lines.forEach((line) => {
-    console.log(pc.dim('│') + '  ' + line.padEnd(maxLen + 1) + ' ' + pc.dim('│'));
-  });
-  console.log(pc.dim('╰' + '─'.repeat(width) + '╯'));
-}

package/src/tui/index.ts

@@ -1,96 +0,0 @@
-import { Command } from 'commander';
-import { VERSION } from '@/core/constants';
-import { installCommand } from '@/tui/commands/install';
-import { initCommand } from '@/tui/commands/init';
-import { devicesCommand } from '@/tui/commands/devices';
-import { buildCommand } from '@/tui/commands/build';
-import { flashCommand } from '@/tui/commands/flash';
-import { monitorCommand } from '@/tui/commands/monitor';
-import { cleanCommand } from '@/tui/commands/clean';
-import { runCommand } from '@/tui/commands/run';
-import { doctorCommand } from '@/tui/commands/doctor';
-// import { createServer } from '@/server';
-
-export function createCli(): Command {
-  const program = new Command();
-
-  program
-    .name('espcli')
-    .description('CLI tool for ESP-IDF development')
-    .version(VERSION);
-
-  program
-    .command('install')
-    .description('Install ESP-IDF framework')
-    .option('-p, --path <path>', 'Installation path')
-    .option('-t, --target <target>', 'Target chip (default: all)')
-    .option('-y, --yes', 'Skip confirmation prompts')
-    .action(installCommand);
-
-  program
-    .command('init [name]')
-    .description('Create a new ESP-IDF project')
-    .option('-l, --lang <lang>', 'Language: c or cpp')
-    .option('-t, --target <target>', 'Target chip')
-    .action(initCommand);
-
-  program
-    .command('devices')
-    .alias('ports')
-    .description('List connected ESP devices')
-    .action(devicesCommand);
-
-  program
-    .command('build')
-    .description('Build the current project')
-    .option('-t, --target <target>', 'Set target before build')
-    .option('-c, --clean', 'Clean before build')
-    .action(buildCommand);
-
-  program
-    .command('flash')
-    .description('Flash firmware to device')
-    .option('-p, --port <port>', 'Serial port')
-    .option('-b, --baud <baud>', 'Flash baud rate', parseInt)
-    .action(flashCommand);
-
-  program
-    .command('monitor')
-    .description('Open serial monitor')
-    .option('-p, --port <port>', 'Serial port')
-    .option('-b, --baud <baud>', 'Monitor baud rate', parseInt)
-    .action(monitorCommand);
-
-  program
-    .command('run')
-    .description('Build, flash, and monitor')
-    .option('-p, --port <port>', 'Serial port')
-    .option('-b, --baud <baud>', 'Baud rate', parseInt)
-    .option('--skip-build', 'Skip build step')
-    .action(runCommand);
-
-  program
-    .command('clean')
-    .description('Clean build artifacts')
-    .option('-f, --full', 'Full clean (includes sdkconfig)')
-    .action(cleanCommand);
-
-  // program
-  //   .command('serve')
-  //   .description('Start HTTP/WebSocket server for GUI')
-  //   .option('-p, --port <port>', 'Server port', '3000')
-  //   .action((options: { port: string }) => {
-  //     const port = parseInt(options.port, 10);
-  //     const server = createServer(port);
-  //     console.log(`ESP CLI server running on http://localhost:${server.port}`);
-  //     console.log(`WebSocket available at ws://localhost:${server.port}/ws`);
-  //   });
-
-  program
-    .command('doctor')
-    .alias('check')
-    .description('Check system health and dependencies')
-    .action(doctorCommand);
-
-  return program;
-}