@bhooai/nexus-cli 2.0.2 → 2.0.4

package/src/wizard.ts

@@ -0,0 +1,691 @@
+/**
+ * Full-screen init wizard (TUI) — the single `nexus init` experience.
+ *
+ * Steps: project name → starter (empty vs examples) → include admin? →
+ * feature checkboxes → port check/auto-assign → infra (mongo/redis/AI/venv)
+ * → review & create.
+ *
+ * Boxed-card layout: a title bar with a step indicator, then a bordered card
+ * around the active step's content. All columns align on VISIBLE width and
+ * long lines are clipped so the frame never wraps.
+ *
+ * Returns a WizardResult consumed by `nexus init`, or null when the user
+ * cancels / there's no TTY.
+ */
+import { stdout as output } from 'node:process';
+import { ANSI, Tui, isTty, type KeyInfo } from './tui.js';
+import { padVisible, clipVisible, fitCell, boxAround, visibleWidth } from './layout.js';
+import { FEATURES } from './features.js';
+import { ensureExamples, listExamplesFrom, resolveExamplesDir } from './examples.js';
+import { nextFreePort, isPortFree, slugify } from './util.js';
+
+export interface PortAssignment {
+  key: 'backend' | 'frontend' | 'admin' | 'ai';
+  label: string;
+  default: number;
+  port: number;
+}
+
+export interface WizardResult {
+  name: string;
+  nameSlug: string;
+  example: string;
+  /** Resolved examples directory (bundled or on-demand cache). */
+  examplesDir: string;
+  /** Selected feature ids from the catalog (incl. frontend/admin/ai-server). */
+  features: string[];
+  /** Include the admin app. */
+  includeAdmin: boolean;
+  /** Port assignments keyed by backend/frontend/admin/ai. */
+  ports: Record<'backend' | 'frontend' | 'admin' | 'ai', number>;
+  mongoUri: string;
+  redisUrl: string;
+  aiProviders: string[];
+  useVenv: boolean;
+  /** Whether to launch the dev console after scaffolding. */
+  launchDev: boolean;
+}
+
+type Page = 'name' | 'starter' | 'examples' | 'admin' | 'features' | 'ports' | 'infra' | 'confirm';
+
+interface InfraField {
+  key: 'mongo' | 'redis' | 'ai' | 'venv';
+  label: string;
+  value: string;
+  kind: 'text' | 'bool';
+}
+
+const STEPS: Array<{ id: Page; label: string }> = [
+  { id: 'name',     label: 'Project name' },
+  { id: 'starter',  label: 'Starter' },
+  { id: 'admin',    label: 'Admin panel' },
+  { id: 'features', label: 'Features' },
+  { id: 'ports',    label: 'Ports' },
+  { id: 'infra',    label: 'Infrastructure' },
+  { id: 'confirm',  label: 'Review' },
+];
+
+function stepIndex(page: Page): number {
+  // `examples` is a drill-down sub-page of `starter` — share its step index.
+  const p: Page = page === 'examples' ? 'starter' : page;
+  return Math.max(0, STEPS.findIndex((s) => s.id === p));
+}
+
+const PORT_DEFAULTS: Array<Pick<PortAssignment, 'key' | 'label' | 'default'>> = [
+  { key: 'backend',  label: 'Backend API',  default: 4000 },
+  { key: 'frontend', label: 'Frontend',     default: 3000 },
+  { key: 'admin',    label: 'Admin panel',  default: 3300 },
+  { key: 'ai',       label: 'AI server',    default: 8000 },
+];
+
+interface WizardState {
+  page: Page;
+  name: string;
+  examples: string[];
+  examplesDir: string;
+  examplesLoading: boolean;
+  examplesError: string;
+  examplesIndex: number;
+  starterIndex: number;
+  example: string;
+  features: Set<string>;
+  featureIndex: number;
+  ports: PortAssignment[];
+  portIndex: number;
+  portEditing: boolean;
+  portBuffer: string;
+  fields: InfraField[];
+  fieldIndex: number;
+  fieldEditing: boolean;
+  fieldBuffer: string;
+  result: WizardResult | null;
+  cancelled: boolean;
+  error: string;
+}
+
+export async function runWizard(prefillName = ''): Promise<WizardResult | null> {
+  if (!isTty()) return null;
+
+  // Probe the canonical ports first (auto-specify free alternatives).
+  const ports: PortAssignment[] = [];
+  for (const d of PORT_DEFAULTS) {
+    ports.push({ key: d.key, label: d.label, default: d.default, port: await nextFreePort(d.default) });
+  }
+
+  // Pre-fill the examples list only if the bundled dir is already available
+  // (no install). The Examples drill-down will resolve/install on demand.
+  const bundledDir = resolveExamplesDir();
+  const preloaded = bundledDir ? await listExamplesFrom(bundledDir) : [];
+
+  const initialName = prefillName ? slugify(prefillName) : '';
+  const state: WizardState = {
+    page: 'name',
+    name: initialName,
+    examples: preloaded,
+    examplesDir: bundledDir ?? '',
+    examplesLoading: false,
+    examplesError: '',
+    examplesIndex: 0,
+    starterIndex: 0,
+    example: 'empty',
+    features: new Set(['admin', 'frontend', 'ai-server']),
+    featureIndex: 0,
+    ports,
+    portIndex: 0,
+    portEditing: false,
+    portBuffer: '',
+    fields: [
+      { key: 'mongo', label: 'MongoDB URI',        value: initialName ? `mongodb://localhost:27017/${initialName}` : '', kind: 'text' },
+      { key: 'redis', label: 'Redis URL',           value: 'redis://localhost:6379', kind: 'text' },
+      { key: 'ai',    label: 'AI providers (comma-separated, empty = none)', value: '', kind: 'text' },
+      { key: 'venv',  label: 'Create Python virtualenv', value: 'yes', kind: 'bool' },
+    ],
+    fieldIndex: 0,
+    fieldEditing: false,
+    fieldBuffer: '',
+    result: null,
+    cancelled: false,
+    error: '',
+  };
+
+  const tui = new Tui((str, key) => handleKey(state, str, key, tui));
+  tui.enter();
+  render(state, tui);
+  await tui.wait();
+  tui.exit();
+
+  if (state.cancelled) return null;
+  return state.result;
+}
+
+// ---------------------------------------------------------------------------
+// Key handling (unchanged behavior)
+// ---------------------------------------------------------------------------
+
+function handleKey(state: WizardState, str: string, key: KeyInfo, tui: Tui): void {
+  if (key.name === 'c' && key.ctrl) {
+    state.cancelled = true;
+    tui.quit = true;
+    return;
+  }
+  if (key.name === 'escape') {
+    if (state.portEditing || state.fieldEditing) {
+      state.portEditing = false;
+      state.fieldEditing = false;
+    } else if (state.page === 'examples') {
+      state.examplesLoading = false;
+      state.page = 'starter';
+    } else {
+      const idx = stepIndex(state.page);
+      if (idx > 0) state.page = STEPS[idx - 1]!.id;
+    }
+    render(state, tui);
+    return;
+  }
+  if (key.name === 'q') {
+    state.cancelled = true;
+    tui.quit = true;
+    return;
+  }
+
+  if (state.portEditing) {
+    handlePortEditing(state, str, key);
+    render(state, tui);
+    return;
+  }
+  if (state.fieldEditing) {
+    handleFieldEditing(state, str, key);
+    render(state, tui);
+    return;
+  }
+
+  switch (state.page) {
+    case 'name': pageName(state, str, key); break;
+    case 'starter': pageStarter(state, key, tui); break;
+    case 'examples': pageExamples(state, key, tui); break;
+    case 'admin': pageAdmin(state, str, key); break;
+    case 'features': pageFeatures(state, key); break;
+    case 'ports': pagePorts(state, key, tui); break;
+    case 'infra': pageInfra(state, key); break;
+    case 'confirm': pageConfirm(state, key, tui); break;
+  }
+  render(state, tui);
+}
+
+function pageName(state: WizardState, str: string, key: KeyInfo): void {
+  if (key.name === 'return' || key.name === 'enter') {
+    const slug = slugify(state.name);
+    if (!slug) {
+      state.error = 'Project name cannot be empty.';
+      return;
+    }
+    state.name = slug;
+    const mongo = state.fields.find((f) => f.key === 'mongo');
+    if (mongo) mongo.value = `mongodb://localhost:27017/${slug}`;
+    state.page = 'starter';
+    state.error = '';
+    return;
+  }
+  if (key.name === 'backspace') {
+    state.name = state.name.slice(0, -1);
+    state.error = '';
+  } else if (str && !key.ctrl && !key.meta) {
+    state.name += str;
+    state.error = '';
+  }
+}
+
+function pageStarter(state: WizardState, key: KeyInfo, tui: Tui): void {
+  if (key.name === 'up') {
+    state.starterIndex = 0;
+  } else if (key.name === 'down') {
+    state.starterIndex = 1;
+  } else if (key.name === 'return' || key.name === 'enter') {
+    if (state.starterIndex === 0) {
+      state.example = 'empty';
+      state.page = 'admin';
+    } else {
+      // Drill into the examples list; resolve/install on demand.
+      state.examplesError = '';
+      if (state.examples.length > 0) {
+        state.examplesIndex = 0;
+        state.page = 'examples';
+      } else {
+        state.examplesLoading = true;
+        state.page = 'examples';
+        void loadExamples(state, tui);
+      }
+    }
+  }
+}
+
+async function loadExamples(state: WizardState, tui: Tui): Promise<void> {
+  const res = await ensureExamples();
+  state.examplesLoading = false;
+  if ('error' in res) {
+    state.examplesError = res.error;
+  } else {
+    state.examples = res.list;
+    state.examplesDir = res.dir;
+    state.examplesIndex = 0;
+  }
+  render(state, tui);
+}
+
+function pageExamples(state: WizardState, key: KeyInfo, tui: Tui): void {
+  if (state.examplesLoading) return; // ignore keys while installing
+  if (state.examplesError) {
+    if (key.name === 'escape' || key.name === 'return' || key.name === 'enter') {
+      state.page = 'starter';
+    }
+    return;
+  }
+  if (key.name === 'escape') {
+    state.page = 'starter';
+    return;
+  }
+  const list = state.examples;
+  if (key.name === 'up') {
+    state.examplesIndex = Math.max(0, state.examplesIndex - 1);
+  } else if (key.name === 'down') {
+    state.examplesIndex = Math.min(list.length - 1, state.examplesIndex + 1);
+  } else if (key.name === 'return' || key.name === 'enter') {
+    const chosen = list[state.examplesIndex];
+    if (chosen) {
+      state.example = chosen;
+      state.page = 'admin';
+    }
+  }
+  void tui;
+}
+
+function pageAdmin(state: WizardState, str: string, key: KeyInfo): void {
+  const isYes = state.features.has('admin');
+  if (key.name === 'left' || key.name === 'right' || key.name === 'up' || key.name === 'down') {
+    state.features.add('admin');
+    if (isYes) state.features.delete('admin');
+  } else if (key.name === 'return' || key.name === 'enter') {
+    state.page = 'features';
+  } else if (str && /y/i.test(str)) {
+    state.features.add('admin');
+  } else if (str && /n/i.test(str)) {
+    state.features.delete('admin');
+  }
+}
+
+function pageFeatures(state: WizardState, key: KeyInfo): void {
+  if (key.name === 'up') {
+    state.featureIndex = Math.max(0, state.featureIndex - 1);
+  } else if (key.name === 'down') {
+    state.featureIndex = Math.min(FEATURES.length - 1, state.featureIndex + 1);
+  } else if (key.name === ' ') {
+    const id = FEATURES[state.featureIndex]?.id;
+    if (id) {
+      if (state.features.has(id)) state.features.delete(id);
+      else state.features.add(id);
+    }
+  } else if (key.name === 'return' || key.name === 'enter' || key.name === 'tab') {
+    state.page = 'ports';
+  }
+}
+
+function pagePorts(state: WizardState, key: KeyInfo, tui: Tui): void {
+  if (key.name === 'up') {
+    state.portIndex = Math.max(0, state.portIndex - 1);
+  } else if (key.name === 'down') {
+    state.portIndex = Math.min(state.ports.length - 1, state.portIndex + 1);
+  } else if (key.name === 'e') {
+    state.portEditing = true;
+    state.portBuffer = String(state.ports[state.portIndex]?.port ?? '');
+  } else if (key.name === 'r') {
+    state.error = '';
+    void reprobePorts(state, tui);
+  } else if (key.name === 'return' || key.name === 'enter') {
+    state.page = 'infra';
+  }
+}
+
+function handlePortEditing(state: WizardState, str: string, key: KeyInfo): void {
+  if (key.name === 'return' || key.name === 'enter') {
+    const n = parseInt(state.portBuffer, 10);
+    const row = state.ports[state.portIndex];
+    if (row && Number.isFinite(n) && n > 0 && n < 65536) {
+      row.port = n;
+      state.error = '';
+    } else {
+      state.error = 'Port must be a number between 1 and 65535.';
+    }
+    state.portEditing = false;
+    state.portBuffer = '';
+  } else if (key.name === 'backspace') {
+    state.portBuffer = state.portBuffer.slice(0, -1);
+  } else if (str && /\d/.test(str)) {
+    state.portBuffer += str;
+  }
+}
+
+async function reprobePorts(state: WizardState, tui: Tui): Promise<void> {
+  const used = new Set<number>();
+  for (const row of state.ports) {
+    let candidate = row.default;
+    while (used.has(candidate) || !(await isPortFree(candidate))) candidate++;
+    row.port = candidate;
+    used.add(candidate);
+  }
+  render(state, tui);
+}
+
+function pageInfra(state: WizardState, key: KeyInfo): void {
+  if (key.name === 'up') {
+    state.fieldIndex = Math.max(0, state.fieldIndex - 1);
+  } else if (key.name === 'down') {
+    state.fieldIndex = Math.min(state.fields.length, state.fieldIndex + 1);
+  } else if (key.name === 'return' || key.name === 'enter') {
+    const field = state.fields[state.fieldIndex];
+    if (!field) {
+      state.page = 'confirm';
+      return;
+    }
+    if (field.key === 'venv') {
+      field.value = field.value === 'yes' ? 'no' : 'yes';
+    } else {
+      state.fieldEditing = true;
+      state.fieldBuffer = field.value;
+    }
+  } else if (key.name === 'tab') {
+    state.page = 'confirm';
+  }
+}
+
+function handleFieldEditing(state: WizardState, str: string, key: KeyInfo): void {
+  if (key.name === 'return' || key.name === 'enter') {
+    const field = state.fields[state.fieldIndex];
+    if (field) field.value = state.fieldBuffer;
+    state.fieldEditing = false;
+    state.fieldBuffer = '';
+  } else if (key.name === 'backspace') {
+    state.fieldBuffer = state.fieldBuffer.slice(0, -1);
+  } else if (str && !key.ctrl && !key.meta) {
+    state.fieldBuffer += str;
+  }
+}
+
+function pageConfirm(state: WizardState, key: KeyInfo, tui: Tui): void {
+  if (key.name === 'return' || key.name === 'enter') {
+    commitResult(state, tui);
+  }
+}
+
+function commitResult(state: WizardState, tui: Tui): void {
+  const mongo = state.fields.find((f) => f.key === 'mongo');
+  const redis = state.fields.find((f) => f.key === 'redis');
+  const ai = state.fields.find((f) => f.key === 'ai');
+  const venv = state.fields.find((f) => f.key === 'venv');
+
+  const ports = {
+    backend: state.ports.find((p) => p.key === 'backend')?.port ?? 4000,
+    frontend: state.ports.find((p) => p.key === 'frontend')?.port ?? 3000,
+    admin: state.ports.find((p) => p.key === 'admin')?.port ?? 3300,
+    ai: state.ports.find((p) => p.key === 'ai')?.port ?? 8000,
+  };
+
+  state.result = {
+    name: state.name,
+    nameSlug: state.name,
+    example: state.example,
+    examplesDir: state.examplesDir,
+    features: [...state.features],
+    includeAdmin: state.features.has('admin'),
+    ports,
+    mongoUri: mongo?.value ?? `mongodb://localhost:27017/${state.name}`,
+    redisUrl: redis?.value ?? 'redis://localhost:6379',
+    aiProviders: (ai?.value ?? '').split(',').map((s) => s.trim()).filter(Boolean),
+    useVenv: (venv?.value ?? 'yes') === 'yes',
+    launchDev: false,
+  };
+  tui.quit = true;
+}
+
+// ---------------------------------------------------------------------------
+// Rendering — boxed cards
+// ---------------------------------------------------------------------------
+
+const EXAMPLE_DESC: Record<string, string> = {
+  empty: 'Bare scaffold — no demo code',
+  chat: 'Realtime rooms, presence, typing',
+  'video-call': 'WebRTC signaling, 1:1 calls',
+  checkout: 'Payments + mailables + webhooks',
+  livestream: 'Broadcaster/viewer streaming',
+  'ai-chat': 'Streaming LLM via SSE',
+  'saas-starter': 'Auth + teams + projects + policies',
+  'blog-crud': 'ODM models, GraphQL subgraph',
+  dashboard: 'Admin metrics demo',
+  'file-storage': 'Uploads, signed URLs, S3',
+  'multi-app': 'Two backends, two frontends',
+};
+
+function render(state: WizardState, tui: Tui): void {
+  const W = output.columns || 80;
+  const innerW = Math.min(Math.max(W - 6, 40), 72);
+
+  const inner: string[] = [];
+  inner.push(progressDots(state));
+  inner.push('');
+  inner.push(`${ANSI.bold}${ANSI.cyan}${stepTitle(state)}${ANSI.reset}`);
+  inner.push('');
+
+  switch (state.page) {
+    case 'name': inner.push(...renderName(state, innerW)); break;
+    case 'starter': inner.push(...renderStarter(state, innerW)); break;
+    case 'examples': inner.push(...renderExamplesList(state, innerW)); break;
+    case 'admin': inner.push(...renderAdmin(state, innerW)); break;
+    case 'features': inner.push(...renderFeatures(state, innerW)); break;
+    case 'ports': inner.push(...renderPorts(state, innerW)); break;
+    case 'infra': inner.push(...renderInfra(state, innerW)); break;
+    case 'confirm': inner.push(...renderConfirm(state, innerW)); break;
+  }
+
+  if (state.error) {
+    inner.push('');
+    inner.push(`${ANSI.red}${state.error}${ANSI.reset}`);
+  }
+
+  const rows: string[] = [titleBar(state, W), ''];
+  rows.push(...boxAround(inner, innerW));
+
+  tui.draw(rows, `${ANSI.dim}${footerFor(state)}${ANSI.reset}`);
+}
+
+function titleBar(state: WizardState, W: number): string {
+  const left = `${ANSI.bold}${ANSI.cyan}BhooAI Nexus${ANSI.reset}  ${ANSI.dim}project setup${ANSI.reset}`;
+  const n = stepIndex(state.page) + 1;
+  const right = `${ANSI.dim}Step ${n} of ${STEPS.length}${ANSI.reset}`;
+  const gap = Math.max(1, W - visibleWidth(left) - visibleWidth(right));
+  return `${left}${' '.repeat(gap)}${right}`;
+}
+
+function progressDots(state: WizardState): string {
+  const idx = stepIndex(state.page);
+  return STEPS.map((s, i) => {
+    if (i < idx) return `${ANSI.green}●${ANSI.reset}`;
+    if (i === idx) return `${ANSI.cyan}◐${ANSI.reset}`;
+    return `${ANSI.dimGray}○${ANSI.reset}`;
+  }).join(' ');
+}
+
+function stepTitle(state: WizardState): string {
+  const idx = stepIndex(state.page);
+  return `${idx + 1}. ${STEPS[idx]!.label}`;
+}
+
+function renderName(state: WizardState, innerW: number): string[] {
+  void innerW;
+  return [
+    `  ${ANSI.cyan}${state.name}█${ANSI.reset}`,
+    '',
+    `${ANSI.dim}  Type a project name. It will be scaffolded into ./${state.name || '<name>'}${ANSI.reset}`,
+    `${ANSI.dim}  (letters, numbers and dashes).${ANSI.reset}`,
+  ];
+}
+
+function renderStarter(state: WizardState, innerW: number): string[] {
+  const nameW = 16;
+  const descW = Math.max(innerW - nameW - 5, 10);
+  const out: string[] = [];
+  const choices: Array<{ label: string; desc: string }> = [
+    { label: 'Empty', desc: 'Bare scaffold — no demo code' },
+    { label: 'Examples', desc: 'Start from a working example (10 demos)' },
+  ];
+  choices.forEach((c, i) => {
+    const sel = i === state.starterIndex;
+    const marker = sel ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const label = sel ? `${ANSI.bold}${c.label}${ANSI.reset}` : c.label;
+    out.push(` ${marker} ${fitCell(label, nameW)} ${clipVisible(`${ANSI.dim}${c.desc}${ANSI.reset}`, descW)}`);
+  });
+  return out;
+}
+
+function renderExamplesList(state: WizardState, innerW: number): string[] {
+  const nameW = 16;
+  const descW = Math.max(innerW - nameW - 5, 10);
+  const out: string[] = [];
+
+  if (state.examplesLoading) {
+    out.push(`  ${ANSI.dim}Installing @bhooai/nexus-examples…${ANSI.reset}`);
+    out.push('');
+    out.push(`  ${ANSI.dim}(this only happens once, when examples aren't bundled)${ANSI.reset}`);
+    return out;
+  }
+
+  if (state.examplesError) {
+    out.push(`  ${ANSI.red}${state.examplesError}${ANSI.reset}`);
+    out.push('');
+    out.push(`  ${ANSI.dim}Press Esc to go back and choose Empty.${ANSI.reset}`);
+    return out;
+  }
+
+  if (state.examples.length === 0) {
+    out.push(`  ${ANSI.dim}No examples available.${ANSI.reset}`);
+    out.push('');
+    out.push(`  ${ANSI.dim}Press Esc to go back.${ANSI.reset}`);
+    return out;
+  }
+
+  state.examples.forEach((ex, i) => {
+    const sel = i === state.examplesIndex;
+    const marker = sel ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const label = sel ? `${ANSI.bold}${ex}${ANSI.reset}` : ex;
+    out.push(` ${marker} ${fitCell(label, nameW)} ${clipVisible(`${ANSI.dim}${EXAMPLE_DESC[ex] ?? ''}${ANSI.reset}`, descW)}`);
+  });
+  out.push('');
+  out.push(`${ANSI.dim}  ↑/↓ pick · Enter choose · Esc back${ANSI.reset}`);
+  return out;
+}
+
+function renderAdmin(state: WizardState, innerW: number): string[] {
+  void innerW;
+  const yes = state.features.has('admin');
+  const row = (on: boolean, label: string, desc: string) => {
+    const marker = on ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const text = on ? `${ANSI.bold}${label}${ANSI.reset}` : label;
+    return ` ${marker} ${text}  ${ANSI.dim}${desc}${ANSI.reset}`;
+  };
+  return [
+    row(yes, 'Yes', 'apps/admin — users, logs, registry, config'),
+    row(!yes, 'No', 'skip the admin app and its port'),
+  ];
+}
+
+function renderFeatures(state: WizardState, innerW: number): string[] {
+  const nameW = 18;
+  const descW = Math.max(innerW - nameW - 6, 10);
+  const out: string[] = [];
+  FEATURES.forEach((f, i) => {
+    const on = state.features.has(f.id);
+    const sel = i === state.featureIndex;
+    const marker = sel ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const box = on ? `${ANSI.green}■${ANSI.reset}` : `${ANSI.dimGray}□${ANSI.reset}`;
+    const label = sel ? `${ANSI.bold}${f.name}${ANSI.reset}` : f.name;
+    const desc = clipVisible(`${ANSI.dim}${f.desc}${ANSI.reset}`, descW);
+    out.push(` ${marker} ${box} ${fitCell(label, nameW)} ${desc}`);
+  });
+  return out;
+}
+
+function renderPorts(state: WizardState, innerW: number): string[] {
+  const labelW = 16;
+  const out: string[] = [];
+  state.ports.forEach((p, i) => {
+    const sel = i === state.portIndex;
+    const marker = sel ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const label = sel ? `${ANSI.bold}${p.label}${ANSI.reset}` : p.label;
+    const value = state.portEditing && sel ? `${ANSI.cyan}${state.portBuffer}█${ANSI.reset}` : String(p.port);
+    const tail = `${ANSI.dim}  (default ${p.default})${ANSI.reset}`;
+    out.push(` ${marker} ${fitCell(label, labelW)} :${fitCell(value, 6)}${tail}`);
+  });
+  out.push('');
+  out.push(`${ANSI.dim}  e edit selected · r re-probe free ports${ANSI.reset}`);
+  void innerW;
+  return out;
+}
+
+function renderInfra(state: WizardState, innerW: number): string[] {
+  const labelW = Math.min(40, Math.max(20, innerW - 18));
+  const out: string[] = [];
+  state.fields.forEach((f, i) => {
+    const sel = i === state.fieldIndex;
+    const marker = sel ? `${ANSI.cyan}▶${ANSI.reset}` : ' ';
+    const label = sel ? `${ANSI.bold}${f.label}${ANSI.reset}` : f.label;
+    let value: string;
+    if (f.kind === 'bool') {
+      value = f.value === 'yes' ? `${ANSI.green}yes${ANSI.reset}` : `${ANSI.red}no${ANSI.reset}`;
+    } else {
+      value = state.fieldEditing && sel ? `${ANSI.cyan}${state.fieldBuffer}█${ANSI.reset}` : (f.value || `${ANSI.dim}—${ANSI.reset}`);
+    }
+    out.push(` ${marker} ${fitCell(label, labelW)} ${clipVisible(value, innerW - labelW - 3)}`);
+  });
+  out.push('');
+  const onContinue = state.fieldIndex === state.fields.length;
+  out.push(` ${onContinue ? `${ANSI.cyan}▶${ANSI.reset}` : ' '} ${ANSI.bold}→ Review & create${ANSI.reset}`);
+  return out;
+}
+
+function renderConfirm(state: WizardState, innerW: number): string[] {
+  const ports = {
+    backend: state.ports.find((p) => p.key === 'backend')?.port ?? 4000,
+    frontend: state.ports.find((p) => p.key === 'frontend')?.port ?? 3000,
+    admin: state.ports.find((p) => p.key === 'admin')?.port ?? 3300,
+    ai: state.ports.find((p) => p.key === 'ai')?.port ?? 8000,
+  };
+  const mongo = state.fields.find((f) => f.key === 'mongo');
+  const redis = state.fields.find((f) => f.key === 'redis');
+  const features = [...state.features];
+  const labelW = 12;
+  const row = (k: string, v: string) => `  ${fitCell(k, labelW)} ${clipVisible(v, innerW - labelW - 3)}`;
+  return [
+    row('Project', state.name),
+    row('Starter', state.example),
+    row('Features', features.join(', ') || '(none)'),
+    row('Ports', `backend :${ports.backend} · frontend :${ports.frontend} · admin :${ports.admin} · ai :${ports.ai}`),
+    row('MongoDB', mongo?.value ?? ''),
+    row('Redis', redis?.value ?? ''),
+    '',
+    `${ANSI.dim}  Enter to scaffold the project (deps install automatically).${ANSI.reset}`,
+  ];
+}
+
+function footerFor(state: WizardState): string {
+  switch (state.page) {
+    case 'name': return 'Type a project name · Enter continue';
+    case 'starter': return '↑/↓ choose · Enter continue';
+    case 'admin': return '←/→ or y/n toggle · Enter continue';
+    case 'features': return '↑/↓ move · Space toggle · Enter continue';
+    case 'ports': return '↑/↓ select · e edit · r re-probe · Enter continue';
+    case 'infra': return '↑/↓ select · Enter edit · Enter on Review to continue';
+    case 'confirm': return 'Enter create project · Esc back';
+    default: return '';
+  }
+}
+
+// `padVisible` re-exported for callers that want the aligned helpers.
+export { padVisible };

package/templates/base/Dockerfile.ejs

@@ -15,6 +15,7 @@ COPY apps/backend/package.json apps/backend/package.json
 RUN npm install --omit=dev --workspace=apps/backend --include-workspace-root=false
 COPY apps/backend apps/backend
 COPY tsconfig.json ./
+COPY nexus.config.ts ./
 
 EXPOSE <%= backendPort %>
 ENV NODE_ENV=production