@ilanalimanjs/open_pack 2.2.4 → 2.4.3

package/bin/index.js

@@ -1,93 +1,714 @@
 #!/usr/bin/env node
+import os from 'node:os';
+import net from 'node:net';
 import path from 'node:path';
 import process from 'node:process';
+import { createRequire } from 'node:module';
+import { parseArgs } from 'node:util';
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { setTimeout as sleep } from 'node:timers/promises';
 import { downloadTemplate } from 'giget';
+import * as prompts from '@clack/prompts';
+import fse from 'fs-extra';
 import chalk from 'chalk';
 import ora from 'ora';
 
+const { version: CLI_VERSION } = createRequire(import.meta.url)('../package.json');
+
 const TEMPLATE_SOURCE = 'github:DevIlannn/open_pack/Source';
+const REGISTRY_URL = 'https://registry.npmjs.org/@ilanalimanjs%2Fopen_pack/latest';
 const PACKAGE_COMMAND = 'npx @ilanalimanjs/open_pack@latest';
 const NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const DATABASE_URL_PATTERN = /^postgres(ql)?:\/\/.+/;
+const ANSI_PATTERN = /\u001B\[[0-9;]*m/g;
+const ENV_EXAMPLE_FILE = '.env.examples';
+const ENV_FILE = '.env';
+const DEFAULT_PORT = 3000;
+const DEFAULT_DATABASE_PORT = 5432;
+const MAX_PORT = 65535;
+const PORT_SEARCH_RANGE = 50;
+const MIN_NODE_VERSION = { major: 20, minor: 11 };
+const BANNER_DELAY_MS = 70;
+const STEP_MIN_DURATION_MS = 450;
+const DETECT_TIMEOUT_MS = 4000;
+const DATABASE_TIMEOUT_MS = 2500;
+const UPDATE_TIMEOUT_MS = 2500;
+const EXIT_INTERRUPTED = 130;
+const GRADIENT = ['#22d3ee', '#38bdf8', '#60a5fa', '#818cf8', '#a78bfa'];
+
+const GLYPHS = [
+  [String.raw`  ___  `, String.raw` / _ \ `, String.raw`| | | |`, String.raw`| |_| |`, String.raw` \___/ `],
+  [String.raw` ____  `, String.raw`|  _ \ `, String.raw`| |_) |`, String.raw`|  __/ `, String.raw`|_|    `],
+  [String.raw` _____ `, String.raw`| ____|`, String.raw`|  _|  `, String.raw`| |___ `, String.raw`|_____|`],
+  [String.raw` _   _ `, String.raw`| \ | |`, String.raw`|  \| |`, String.raw`| |\  |`, String.raw`|_| \_|`],
+  [String.raw` ____  `, String.raw`|  _ \ `, String.raw`| |_) |`, String.raw`|  __/ `, String.raw`|_|    `],
+  [String.raw`    _     `, String.raw`   / \    `, String.raw`  / _ \   `, String.raw` / ___ \  `, String.raw`/_/   \_\ `],
+  [String.raw`  ____ `, String.raw` / ___|`, String.raw`| |    `, String.raw`| |___ `, String.raw` \____|`],
+  [String.raw` _  __ `, String.raw`| |/ / `, String.raw`| ' /  `, String.raw`| . \  `, String.raw`|_|\_\ `]
+];
+
+const BANNER_LINES = GLYPHS[0].map((_, row) => GLYPHS.map((glyph) => glyph[row]).join(''));
+
+const PACKAGE_MANAGERS = {
+  npm: { label: 'npm', install: ['install'], dev: ['run', 'dev'] },
+  pnpm: { label: 'pnpm', install: ['install'], dev: ['run', 'dev'] },
+  yarn: { label: 'yarn', install: ['install'], dev: ['run', 'dev'] },
+  bun: { label: 'bun', install: ['install'], dev: ['run', 'dev'] }
+};
+
+const PLATFORM_LABELS = {
+  darwin: 'macOS',
+  win32: 'Windows',
+  linux: 'Linux'
+};
+
+const MODES = {
+  run: 'run',
+  install: 'install',
+  none: 'none'
+};
 
-const [projectName] = process.argv.slice(2);
+const CLI_OPTIONS = {
+  yes: { type: 'boolean', short: 'y' },
+  pm: { type: 'string' },
+  'database-url': { type: 'string' },
+  port: { type: 'string' },
+  'no-install': { type: 'boolean' },
+  'no-run': { type: 'boolean' },
+  'no-db-check': { type: 'boolean' },
+  'no-update-check': { type: 'boolean' },
+  help: { type: 'boolean', short: 'h' },
+  version: { type: 'boolean', short: 'v' }
+};
+
+const HELP_OPTIONS = [
+  ['-y, --yes', 'Skip prompts and use defaults'],
+  ['--pm <name>', 'Package manager: npm, pnpm, yarn, bun'],
+  ['--database-url <url>', 'PostgreSQL connection string'],
+  ['--port <number>', `Development server port (default ${DEFAULT_PORT})`],
+  ['--no-install', 'Create the project without installing dependencies'],
+  ['--no-run', 'Install dependencies without starting the server'],
+  ['--no-db-check', 'Skip the database reachability check'],
+  ['--no-update-check', 'Skip the CLI update check'],
+  ['-h, --help', 'Show this help'],
+  ['-v, --version', 'Show the CLI version']
+];
 
-const accent = chalk.cyan;
+const accent = chalk.hex('#38bdf8');
 const muted = chalk.gray;
+const isWindows = process.platform === 'win32';
+const isTTY = Boolean(process.stdout.isTTY && process.stdin.isTTY);
+
+const STATE_ICONS = {
+  done: chalk.green('✔'),
+  warning: chalk.yellow('!'),
+  failed: chalk.red('✖'),
+  pending: muted('○')
+};
+
+class UsageError extends Error {}
+
+const pause = (ms) => (isTTY ? sleep(ms) : Promise.resolve());
+
+const visibleLength = (value) => value.replace(ANSI_PATTERN, '').length;
+
+const renderCard = (title, rows) => {
+  const labelWidth = Math.max(...rows.map((row) => visibleLength(row.label)));
+  const lines = rows.map((row) => `${row.label}${' '.repeat(labelWidth - visibleLength(row.label))}  ${row.value}`);
+  const width = Math.max(visibleLength(title) + 1, ...lines.map(visibleLength));
+  const inner = width + 2;
+  const border = chalk.hex('#475569');
+  const top = border('╭─ ') + chalk.bold(title) + border(` ${'─'.repeat(inner - visibleLength(title) - 3)}╮`);
+  const body = lines.map((line) => `${border('│')} ${line}${' '.repeat(width - visibleLength(line))} ${border('│')}`);
+  const bottom = border(`╰${'─'.repeat(inner)}╯`);
+  return [top, ...body, bottom].map((line) => `  ${line}`).join('\n');
+};
+
+const compareVersions = (left, right) => {
+  const leftParts = left.split('.').map(Number);
+  const rightParts = right.split('.').map(Number);
+  for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+    const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  return 0;
+};
+
+const validateProjectName = (value) => {
+  if (!value) return 'Project name is required';
+  if (!NAME_PATTERN.test(value)) return 'Use letters, numbers, dot, dash, or underscore';
+  return undefined;
+};
+
+const validateDatabaseUrl = (value) =>
+  DATABASE_URL_PATTERN.test(value ?? '') ? undefined : 'Use the format postgresql://user:password@host:port/db';
+
+const validatePort = (value) => {
+  const port = Number(value);
+  return /^\d+$/.test(String(value ?? '')) && port >= 1 && port <= MAX_PORT
+    ? undefined
+    : `Use a port between 1 and ${MAX_PORT}`;
+};
+
+const validateFlags = ({ values, positionals }) => {
+  const checks = [
+    positionals[0] === undefined ? undefined : validateProjectName(positionals[0]),
+    values.pm === undefined || PACKAGE_MANAGERS[values.pm] ? undefined : '--pm must be one of npm, pnpm, yarn, bun',
+    values.port === undefined ? undefined : validatePort(values.port),
+    values['database-url'] === undefined ? undefined : validateDatabaseUrl(values['database-url'])
+  ];
+  return checks.find(Boolean);
+};
+
+const resolveFixedMode = (values) => {
+  if (values['no-install']) return MODES.none;
+  if (values['no-run']) return MODES.install;
+  return undefined;
+};
+
+const readFixedOptions = ({ values, positionals }) => ({
+  name: positionals[0],
+  packageManager: values.pm,
+  databaseUrl: values['database-url'],
+  port: values.port === undefined ? undefined : Number(values.port),
+  mode: resolveFixedMode(values)
+});
+
+const captureCommand = (command, args) =>
+  new Promise((resolve) => {
+    const child = spawn(command, args, {
+      shell: isWindows,
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: DETECT_TIMEOUT_MS
+    });
+    let output = '';
+    child.stdout.on('data', (chunk) => {
+      output += chunk.toString();
+    });
+    child.on('error', () => resolve(null));
+    child.on('close', (code) => resolve(code === 0 ? (output.trim().split('\n')[0] ?? null) : null));
+  });
+
+const isPortFree = (port) =>
+  new Promise((resolve) => {
+    const server = net.createServer();
+    server.once('error', () => resolve(false));
+    server.once('listening', () => server.close(() => resolve(true)));
+    server.listen(port);
+  });
+
+const findFreePort = async (start) => {
+  for (let offset = 0; offset < PORT_SEARCH_RANGE && start + offset <= MAX_PORT; offset += 1) {
+    if (await isPortFree(start + offset)) return start + offset;
+  }
+  throw new Error(`No free port found from ${start}`);
+};
+
+const isTcpReachable = (host, port) =>
+  new Promise((resolve) => {
+    const socket = net.connect({ host, port, timeout: DATABASE_TIMEOUT_MS });
+    socket.once('connect', () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.once('timeout', () => {
+      socket.destroy();
+      resolve(false);
+    });
+    socket.once('error', () => resolve(false));
+  });
+
+const fetchLatestVersion = async () => {
+  try {
+    const response = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(UPDATE_TIMEOUT_MS) });
+    if (!response.ok) return null;
+    const { version } = await response.json();
+    return typeof version === 'string' ? version : null;
+  } catch {
+    return null;
+  }
+};
+
+const parseLauncher = () => {
+  const [agent] = (process.env.npm_config_user_agent ?? '').split(' ');
+  const [name, version] = agent.split('/');
+  return PACKAGE_MANAGERS[name] ? { name, version } : null;
+};
+
+const isNodeSupported = () => {
+  const [major, minor] = process.versions.node.split('.').map(Number);
+  return major > MIN_NODE_VERSION.major || (major === MIN_NODE_VERSION.major && minor >= MIN_NODE_VERSION.minor);
+};
 
-const printHeader = () => {
+const detectEnvironment = async ({ port, checkUpdate }) => {
+  const managerNames = Object.keys(PACKAGE_MANAGERS);
+  const [gitOutput, portFree, latestVersion, ...managerVersions] = await Promise.all([
+    captureCommand('git', ['--version']),
+    isPortFree(port),
+    checkUpdate ? fetchLatestVersion() : Promise.resolve(null),
+    ...managerNames.map((name) => captureCommand(name, ['--version']))
+  ]);
+  const managers = Object.fromEntries(
+    managerNames.map((name, index) => [name, managerVersions[index]]).filter(([, version]) => version)
+  );
+  const cpus = os.cpus();
+
+  return {
+    system: `${PLATFORM_LABELS[process.platform] ?? process.platform} ${os.release()} (${os.arch()})`,
+    device: `${(cpus[0]?.model ?? 'Unknown CPU').replace(/\s+/g, ' ').trim()} (${cpus.length} cores, ${Math.round(os.totalmem() / 1024 ** 3)} GB RAM)`,
+    node: process.versions.node,
+    nodeSupported: isNodeSupported(),
+    launcher: parseLauncher(),
+    managers,
+    git: gitOutput ? gitOutput.replace(/^git version\s*/, '') : null,
+    port,
+    portFree,
+    latestVersion
+  };
+};
+
+const printEnvironmentCard = (environment) => {
+  const managerList = Object.entries(environment.managers).map(([name, version]) => `${name} ${version}`);
+  const nodeStatus = environment.nodeSupported
+    ? chalk.green('✔')
+    : chalk.red(`✖ requires >=${MIN_NODE_VERSION.major}.${MIN_NODE_VERSION.minor}`);
+  const hasUpdate = environment.latestVersion && compareVersions(environment.latestVersion, CLI_VERSION) > 0;
+  const rows = [
+    { label: muted('System'), value: environment.system },
+    { label: muted('Device'), value: environment.device },
+    { label: muted('Node.js'), value: `v${environment.node} ${nodeStatus}` },
+    {
+      label: muted('Launched with'),
+      value: environment.launcher ? `${environment.launcher.name} ${environment.launcher.version}` : 'node (direct)'
+    },
+    {
+      label: muted('Package managers'),
+      value: managerList.length ? managerList.join(', ') : chalk.yellow('none detected')
+    },
+    {
+      label: muted('Git'),
+      value: environment.git ? `${environment.git} ${chalk.green('✔')}` : muted('not found')
+    },
+    {
+      label: muted('Port'),
+      value: `${environment.port} ${environment.portFree ? `${chalk.green('✔')} free` : chalk.yellow('in use')}`
+    },
+    {
+      label: muted('Openpack'),
+      value: hasUpdate
+        ? `v${CLI_VERSION} ${chalk.yellow(`update available: ${environment.latestVersion}`)}`
+        : `v${CLI_VERSION} ${chalk.green('✔')}`
+    }
+  ];
+  console.log(renderCard('Environment', rows));
   console.log();
-  console.log(`  ${chalk.bold('Open Pack')}  ${muted('Fast starter for Node.js, Express, and PostgreSQL')}`);
+};
+
+const printStatusCard = (results) => {
+  const rows = results.map((result) => ({
+    label: `${STATE_ICONS[result.state]} ${result.label}`,
+    value: result.duration === null ? muted('pending') : muted(`${(result.duration / 1000).toFixed(1)}s`)
+  }));
   console.log();
+  console.log(renderCard('Build status', rows));
 };
 
-const printFailure = (title, detail) => {
-  console.log(`  ${chalk.red('✖')} ${chalk.bold(title)}`);
-  if (detail) console.log(`    ${muted(detail)}`);
+const printBanner = async () => {
+  console.log();
+  for (const [index, line] of BANNER_LINES.entries()) {
+    console.log(`  ${chalk.hex(GRADIENT[index % GRADIENT.length])(line)}`);
+    await pause(BANNER_DELAY_MS);
+  }
+  console.log();
+  console.log(`  ${chalk.bold('Openpack')} ${muted('Fast starter for Node.js, Express, and PostgreSQL')}`);
   console.log();
-  process.exitCode = 1;
 };
 
-const printUsage = () => {
+const printHelp = () => {
+  const width = Math.max(...HELP_OPTIONS.map(([flag]) => flag.length));
+  console.log();
+  console.log(`  ${chalk.bold('Openpack')} ${muted(`v${CLI_VERSION}`)}`);
+  console.log();
   console.log(`  ${muted('Usage')}`);
-  console.log(`  ${PACKAGE_COMMAND} ${accent('<project-name>')}`);
+  console.log(`  ${PACKAGE_COMMAND} ${accent('[project-name] [options]')}`);
+  console.log();
+  console.log(`  ${muted('Options')}`);
+  HELP_OPTIONS.forEach(([flag, description]) => {
+    console.log(`  ${accent(flag.padEnd(width))}  ${description}`);
+  });
   console.log();
   console.log(`  ${muted('Example')}`);
-  console.log(`  ${PACKAGE_COMMAND} ${accent('my-project')}`);
+  console.log(`  ${PACKAGE_COMMAND} ${accent('my-project --yes --pm pnpm --database-url postgresql://user:pass@localhost:5432/db --no-run')}`);
   console.log();
 };
 
-const printNextSteps = (name, startedAt) => {
-  const duration = ((performance.now() - startedAt) / 1000).toFixed(1);
+const printFailure = (title, detail) => {
+  console.log();
+  console.log(`  ${chalk.red('✖')} ${chalk.bold(title)}`);
+  if (detail) console.log(`    ${muted(detail)}`);
+  console.log();
+  process.exitCode = 1;
+};
+
+const runCommand = (command, args, cwd) =>
+  new Promise((resolve, reject) => {
+    const child = spawn(command, args, { cwd, shell: isWindows, stdio: ['ignore', 'ignore', 'pipe'] });
+    const errors = [];
+    child.stderr.on('data', (chunk) => errors.push(chunk.toString()));
+    child.on('error', reject);
+    child.on('close', (code) => {
+      if (code === 0) return resolve();
+      const tail = errors.join('').trim().split('\n').slice(-5).join('\n');
+      reject(new Error(tail || `${command} exited with code ${code}`));
+    });
+  });
+
+const runInteractive = (command, args, cwd) =>
+  new Promise((resolve, reject) => {
+    const child = spawn(command, args, { cwd, shell: isWindows, stdio: 'inherit' });
+    child.on('error', reject);
+    child.on('close', () => resolve());
+  });
+
+const setEnvValue = (content, key, value) => {
+  const pattern = new RegExp(`^${key}=.*$`, 'm');
+  if (pattern.test(content)) return content.replace(pattern, () => `${key}=${value}`);
+  const separator = content.endsWith('\n') || content.length === 0 ? '' : '\n';
+  return `${content}${separator}${key}=${value}\n`;
+};
+
+const createRollback = (targetDirectory, originalCwd, enabled) => {
+  let armed = enabled;
+  return {
+    disarm: () => {
+      armed = false;
+    },
+    run: async () => {
+      if (!armed) return false;
+      armed = false;
+      process.chdir(originalCwd);
+      try {
+        await fse.remove(targetDirectory);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  };
+};
+
+const resolveManagerChoices = (environment) => {
+  const detected = Object.keys(environment.managers);
+  const names = detected.length ? detected : ['npm'];
+  const launcherName = environment.launcher?.name;
+  return { names, initial: names.includes(launcherName) ? launcherName : names[0] };
+};
+
+const needsPortChoice = async (port, mode) => mode === MODES.run && !(await isPortFree(port));
+
+const askOptions = async (cli, environment) => {
+  const fixed = readFixedOptions(cli);
+  const managers = resolveManagerChoices(environment);
+
+  const answers = await prompts.group(
+    {
+      name: () =>
+        fixed.name !== undefined
+          ? Promise.resolve(fixed.name)
+          : prompts.text({
+              message: 'What is your project name?',
+              placeholder: 'my-project',
+              validate: validateProjectName
+            }),
+      packageManager: () =>
+        fixed.packageManager !== undefined
+          ? Promise.resolve(fixed.packageManager)
+          : prompts.select({
+              message: 'Choose a package manager',
+              initialValue: managers.initial,
+              options: managers.names.map((value) => ({
+                value,
+                label: PACKAGE_MANAGERS[value].label,
+                hint: environment.managers[value] ? `v${environment.managers[value]}` : undefined
+              }))
+            }),
+      databaseUrl: () =>
+        fixed.databaseUrl !== undefined
+          ? Promise.resolve(fixed.databaseUrl)
+          : prompts.text({
+              message: 'PostgreSQL DATABASE_URL',
+              placeholder: 'postgresql://user:password@localhost:5432/mydb',
+              validate: validateDatabaseUrl
+            }),
+      mode: () =>
+        fixed.mode !== undefined
+          ? Promise.resolve(fixed.mode)
+          : prompts.select({
+              message: 'Once the template is ready',
+              initialValue: MODES.run,
+              options: [
+                { value: MODES.run, label: 'Install dependencies and start the server', hint: 'recommended' },
+                { value: MODES.install, label: 'Install dependencies only' },
+                { value: MODES.none, label: 'Create the project only' }
+              ]
+            }),
+      port: async ({ results }) => {
+        const desired = fixed.port ?? DEFAULT_PORT;
+        if (!(await needsPortChoice(desired, results.mode))) return desired;
+        return prompts.text({
+          message: `Port ${desired} is in use. Choose another port`,
+          initialValue: String(await findFreePort(desired + 1)),
+          validate: validatePort
+        });
+      }
+    },
+    {
+      onCancel: () => {
+        prompts.cancel('Cancelled');
+        process.exit(0);
+      }
+    }
+  );
+
+  return { ...answers, port: Number(answers.port) };
+};
+
+const resolveDefaultOptions = async (cli, environment) => {
+  const fixed = readFixedOptions(cli);
+  if (fixed.name === undefined) throw new UsageError('Project name is required in non-interactive mode');
+  if (fixed.databaseUrl === undefined) throw new UsageError('--database-url is required in non-interactive mode');
+
+  const mode = fixed.mode ?? (process.stdout.isTTY ? MODES.run : MODES.install);
+  const desired = fixed.port ?? DEFAULT_PORT;
+  let port = desired;
+
+  if (await needsPortChoice(desired, mode)) {
+    if (fixed.port !== undefined) throw new UsageError(`Port ${desired} is already in use`);
+    port = await findFreePort(desired + 1);
+  }
+
+  return {
+    name: fixed.name,
+    packageManager: fixed.packageManager ?? resolveManagerChoices(environment).initial,
+    databaseUrl: fixed.databaseUrl,
+    mode,
+    port
+  };
+};
+
+const checkDatabase = async (databaseUrl) => {
+  const url = new URL(databaseUrl);
+  const host = url.hostname.replace(/^\[|\]$/g, '');
+  const port = Number(url.port) || DEFAULT_DATABASE_PORT;
+  const target = `${host}:${port}`;
+  return (await isTcpReachable(host, port))
+    ? { label: `Database reachable at ${target}` }
+    : { state: 'warning', label: `Database unreachable at ${target}` };
+};
+
+const buildSteps = ({ name, packageManager, databaseUrl, mode, port }, { dbCheck }) => {
+  const targetDirectory = path.resolve(process.cwd(), name);
+  const manager = PACKAGE_MANAGERS[packageManager];
+  const customPort = port !== DEFAULT_PORT;
   const steps = [
-    `cd ${name}`,
-    'npm install',
-    'cp .env.examples .env',
-    'npm run dev',
+    {
+      active: 'Fetching template',
+      done: 'Template fetched',
+      task: () => downloadTemplate(TEMPLATE_SOURCE, { dir: targetDirectory })
+    },
+    {
+      active: 'Preparing environment',
+      done: `${ENV_FILE} is ready`,
+      task: async () => {
+        const source = path.join(targetDirectory, ENV_EXAMPLE_FILE);
+        if (!(await fse.pathExists(source))) throw new Error(`${ENV_EXAMPLE_FILE} not found in the template`);
+        await fse.copy(source, path.join(targetDirectory, ENV_FILE));
+      }
+    },
+    {
+      active: 'Injecting template configuration',
+      done: customPort ? 'DATABASE_URL, SESSION_SECRET, and PORT injected' : 'DATABASE_URL and SESSION_SECRET injected',
+      task: async () => {
+        const envPath = path.join(targetDirectory, ENV_FILE);
+        const current = await fse.readFile(envPath, 'utf8');
+        const withDatabase = setEnvValue(current, 'DATABASE_URL', databaseUrl);
+        const withSecret = setEnvValue(withDatabase, 'SESSION_SECRET', randomBytes(32).toString('hex'));
+        await fse.writeFile(envPath, customPort ? setEnvValue(withSecret, 'PORT', String(port)) : withSecret);
+      }
+    }
   ];
 
+  if (dbCheck) {
+    steps.push({
+      active: 'Checking database connection',
+      done: 'Database reachable',
+      task: () => checkDatabase(databaseUrl)
+    });
+  }
+
+  steps.push({
+    active: 'Entering project directory',
+    done: `Entered ${name}`,
+    task: async () => process.chdir(targetDirectory)
+  });
+
+  if (mode !== MODES.none) {
+    steps.push({
+      active: `Installing dependencies with ${manager.label}`,
+      done: 'Dependencies installed',
+      task: () => runCommand(packageManager, manager.install, targetDirectory),
+      minDuration: 0
+    });
+  }
+
+  if (mode === MODES.run) {
+    steps.push({
+      active: 'Starting template',
+      done: 'Template ready to run',
+      task: async () => undefined
+    });
+  }
+
+  return { steps, targetDirectory, manager };
+};
+
+const runSteps = async (steps, results) => {
+  const total = steps.length;
+  for (const [index, step] of steps.entries()) {
+    const prefix = muted(`[${index + 1}/${total}]`);
+    const spinner = ora({ text: `${prefix} ${step.active}`, indent: 2, spinner: 'dots12', color: 'cyan' }).start();
+    const startedAt = Date.now();
+    try {
+      const outcome = (await step.task()) ?? {};
+      const remaining = (step.minDuration ?? STEP_MIN_DURATION_MS) - (Date.now() - startedAt);
+      if (remaining > 0) await pause(remaining);
+      const state = outcome.state ?? 'done';
+      const label = outcome.label ?? step.done;
+      results[index] = { label, state, duration: Date.now() - startedAt };
+      spinner.stopAndPersist({ symbol: STATE_ICONS[state], text: `${prefix} ${label}` });
+    } catch (error) {
+      results[index] = { label: step.active, state: 'failed', duration: Date.now() - startedAt };
+      spinner.stopAndPersist({ symbol: STATE_ICONS.failed, text: `${prefix} ${step.active}` });
+      throw error;
+    }
+  }
+};
+
+const printSummary = ({ name, packageManager, mode, port, startedAt }) => {
+  const duration = ((performance.now() - startedAt) / 1000).toFixed(1);
+  const devUrl = `http://localhost:${port}`;
+  const devCommand = [packageManager, ...PACKAGE_MANAGERS[packageManager].dev].join(' ');
+  const pending = [`cd ${name}`];
+  if (mode === MODES.none) pending.push(`${packageManager} install`);
+  if (mode !== MODES.run) pending.push(devCommand);
+
   console.log();
   console.log(`  ${chalk.green('✔')} ${chalk.bold(name)} is ready ${muted(`in ${duration}s`)}`);
   console.log();
+  if (mode === MODES.run) {
+    console.log(`  ${muted('Server')}        ${accent(devUrl)}`);
+    console.log(`  ${muted('Health check')}  ${accent(`${devUrl}/api/health`)}`);
+    console.log(`  ${muted('Press Ctrl+C to stop')}`);
+    console.log();
+    return;
+  }
   console.log(`  ${muted('Next steps')}`);
-  steps.forEach((step, index) => {
-    console.log(`  ${muted(`${index + 1}`)}  ${accent(step)}`);
-  });
+  pending.forEach((step, index) => console.log(`  ${muted(String(index + 1))}  ${accent(step)}`));
   console.log();
-  console.log(`  ${muted('Fill in')} DATABASE_URL ${muted('and')} SESSION_SECRET ${muted('inside .env before running.')}`);
-  console.log(`  ${muted('Health check')} http://localhost:3000/api/health`);
+  console.log(`  ${muted('Health check')}  ${accent(`${devUrl}/api/health`)}`);
   console.log();
 };
 
+const parseCli = () => {
+  try {
+    return parseArgs({ args: process.argv.slice(2), options: CLI_OPTIONS, allowPositionals: true });
+  } catch (error) {
+    throw new UsageError(error.message);
+  }
+};
+
 async function main() {
-  printHeader();
+  const cli = parseCli();
 
-  if (!projectName) {
-    printFailure('Project name is required');
-    printUsage();
-    return;
+  if (cli.values.help) return printHelp();
+  if (cli.values.version) return console.log(CLI_VERSION);
+
+  await printBanner();
+
+  const flagError = validateFlags(cli);
+  if (flagError) throw new UsageError(flagError);
+
+  const inspector = ora({ text: 'Inspecting your environment', indent: 2, spinner: 'dots12', color: 'cyan' }).start();
+  const environment = await detectEnvironment({
+    port: cli.values.port === undefined ? DEFAULT_PORT : Number(cli.values.port),
+    checkUpdate: !cli.values['no-update-check']
+  });
+  await pause(STEP_MIN_DURATION_MS);
+  inspector.stop();
+  printEnvironmentCard(environment);
+
+  if (!environment.nodeSupported) {
+    throw new UsageError(
+      `Openpack requires Node.js >=${MIN_NODE_VERSION.major}.${MIN_NODE_VERSION.minor}, found v${environment.node}`
+    );
   }
 
-  if (!NAME_PATTERN.test(projectName)) {
-    printFailure('Invalid project name', 'Use letters, numbers, dot, dash, or underscore.');
-    return;
+  if (cli.values.pm && !environment.managers[cli.values.pm]) {
+    throw new UsageError(`${cli.values.pm} is not installed`);
   }
 
-  const targetDirectory = path.resolve(process.cwd(), projectName);
+  const interactive = isTTY && !cli.values.yes;
+  if (!interactive) console.log(`  ${muted('Non-interactive mode')}\n`);
+
+  const options = interactive ? await askOptions(cli, environment) : await resolveDefaultOptions(cli, environment);
+  const originalCwd = process.cwd();
+  const { steps, targetDirectory, manager } = buildSteps(options, { dbCheck: !cli.values['no-db-check'] });
+  const rollback = createRollback(targetDirectory, originalCwd, !(await fse.pathExists(targetDirectory)));
+  const results = steps.map((step) => ({ label: step.done, state: 'pending', duration: null }));
   const startedAt = performance.now();
-  const spinner = ora({ text: `Creating ${chalk.bold(projectName)} from the Open Pack template`, indent: 2 }).start();
+
+  const handleInterrupt = async () => {
+    const removed = await rollback.run();
+    console.log();
+    console.log(`  ${chalk.yellow('!')} Interrupted${removed ? ', partial project removed' : ''}`);
+    console.log();
+    process.exit(EXIT_INTERRUPTED);
+  };
+
+  console.log();
+  process.once('SIGINT', handleInterrupt);
 
   try {
-    await downloadTemplate(TEMPLATE_SOURCE, { dir: targetDirectory });
-    spinner.stop();
-    printNextSteps(projectName, startedAt);
+    await runSteps(steps, results);
+    rollback.disarm();
   } catch (error) {
-    spinner.stop();
+    const removed = await rollback.run();
+    printStatusCard(results);
+    if (removed) console.log(`\n  ${muted('Partial project removed')}`);
     const alreadyExists = /already exists/i.test(error.message);
     printFailure(
       alreadyExists ? 'Directory already exists' : 'Failed to create project',
       alreadyExists ? `Choose another name or remove ${targetDirectory}` : error.message
     );
+    return;
+  } finally {
+    process.removeListener('SIGINT', handleInterrupt);
+  }
+
+  printStatusCard(results);
+  printSummary({ ...options, startedAt });
+
+  if (options.mode === MODES.run) {
+    await runInteractive(options.packageManager, manager.dev, targetDirectory);
   }
 }
 
-main();
+main().catch((error) => {
+  if (error instanceof UsageError) {
+    printFailure('Invalid usage', error.message);
+    console.log(`  ${muted('Run with --help to see all options')}\n`);
+    return;
+  }
+  printFailure('Unexpected error', error.message);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ilanalimanjs/open_pack",
-  "version": "2.2.4",
+  "version": "2.4.3",
   "description": "Open Pack CLI: create a new project from the Open Pack source template",
   "type": "module",
   "bin": {
@@ -20,8 +20,10 @@
     "url": "git+https://github.com/DevIlannn/open_pack.git"
   },
   "dependencies": {
-    "giget": "^2.0.0",
+    "@clack/prompts": "^0.11.0",
     "chalk": "^5.4.1",
+    "fs-extra": "^11.3.0",
+    "giget": "^2.0.0",
     "ora": "^8.1.1"
   }
 }