auramaxx 0.0.1

package/server/cli/lib/prompt.ts

@@ -0,0 +1,294 @@
+/**
+ * Interactive prompts for CLI commands
+ */
+
+import * as readline from 'readline';
+import { paint, ANSI } from './theme';
+
+export interface PromptSelectOption {
+  value: string;
+  label: string;
+  aliases?: string[];
+}
+
+function resolveSelectedValue(answer: string, options: PromptSelectOption[], defaultValue?: string): string {
+  const normalized = answer.trim().toLowerCase();
+  if (!normalized && defaultValue) return defaultValue;
+
+  for (const opt of options) {
+    const candidates = [opt.value, opt.label, ...(opt.aliases || [])].map((v) => v.toLowerCase());
+    if (candidates.includes(normalized)) return opt.value;
+  }
+
+  return defaultValue || options[0].value;
+}
+
+function renderSelectLines(
+  message: string,
+  options: PromptSelectOption[],
+  selectedIndex: number,
+  defaultValue?: string,
+): string[] {
+  const lines = [
+    message,
+    paint('  Use up/down arrows and Enter to confirm.', ANSI.dim),
+  ];
+
+  for (let i = 0; i < options.length; i += 1) {
+    const option = options[i];
+    const isDefault = defaultValue && option.value === defaultValue;
+    const suffix = isDefault ? ' [default]' : '';
+    if (i === selectedIndex) {
+      lines.push(`  ${paint('//', ANSI.fgAccent, ANSI.bold)} ${paint(option.label + suffix, ANSI.bold)}`);
+    } else {
+      lines.push(`     ${paint(option.label + suffix, ANSI.dim)}`);
+    }
+  }
+
+  return lines;
+}
+
+async function promptSelectInteractive(
+  message: string,
+  options: PromptSelectOption[],
+  defaultValue?: string,
+): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const typedStdin = stdin as NodeJS.ReadStream & { isRaw?: boolean };
+
+    const defaultIndex = Math.max(
+      0,
+      options.findIndex((opt) => opt.value === defaultValue),
+    );
+    let selectedIndex = defaultIndex;
+    let renderedLines = 0;
+    let settled = false;
+    const wasRaw = typedStdin.isRaw ?? false;
+    const wasPaused = stdin.isPaused();
+
+    const cleanup = () => {
+      if (settled) return;
+      settled = true;
+      stdin.removeListener('data', onData);
+      stdin.removeListener('error', onError);
+      if (stdin.isTTY && typeof stdin.setRawMode === 'function') {
+        stdin.setRawMode(wasRaw);
+      }
+      if (wasPaused) {
+        stdin.pause();
+      }
+    };
+
+    const render = () => {
+      const lines = renderSelectLines(message, options, selectedIndex, defaultValue);
+      if (renderedLines > 0) {
+        stdout.write(`\u001b[${renderedLines}A`);
+      }
+      for (const line of lines) {
+        stdout.write('\u001b[2K');
+        stdout.write(`${line}\n`);
+      }
+      renderedLines = lines.length;
+    };
+
+    const moveSelection = (delta: number) => {
+      if (delta === 0) return;
+      selectedIndex = (selectedIndex + delta + options.length) % options.length;
+      render();
+    };
+
+    const onError = (error: Error) => {
+      cleanup();
+      reject(error);
+    };
+
+    const onData = (chunk: Buffer | string) => {
+      const input = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+      let delta = 0;
+
+      for (let i = 0; i < input.length; i += 1) {
+        const c = input[i];
+        if (c === '\u0003') {
+          cleanup();
+          stdout.write('\n');
+          process.exit(1);
+        }
+        if (c === '\r' || c === '\n') {
+          cleanup();
+          stdout.write('\n');
+          resolve(options[selectedIndex].value);
+          return;
+        }
+        if (input.startsWith('\u001b[A', i)) {
+          delta -= 1;
+          i += 2;
+          continue;
+        }
+        if (input.startsWith('\u001b[B', i)) {
+          delta += 1;
+          i += 2;
+          continue;
+        }
+      }
+
+      if (delta !== 0) {
+        moveSelection(delta);
+      }
+    };
+
+    try {
+      if (stdin.isTTY && typeof stdin.setRawMode === 'function') {
+        stdin.setRawMode(true);
+      }
+      stdin.resume();
+      stdin.on('data', onData);
+      stdin.on('error', onError);
+      render();
+    } catch (error) {
+      onError(error as Error);
+    }
+  });
+}
+
+/**
+ * Prompt for a password with hidden input
+ */
+export async function promptPassword(label: string = 'Password'): Promise<string> {
+  if (!process.stdin.isTTY) {
+    throw new Error('Interactive password prompt requires a TTY. Use --password-stdin for automation.');
+  }
+
+  return new Promise((resolve, reject) => {
+    const stdin = process.stdin;
+    const stdout = process.stdout;
+    const wasRaw = stdin.isRaw;
+    const wasPaused = stdin.isPaused();
+    let settled = false;
+    let password = '';
+
+    stdout.write(`${label}: `);
+
+    const cleanup = () => {
+      if (settled) return;
+      settled = true;
+      stdin.removeListener('data', onData);
+      stdin.removeListener('error', onError);
+      if (stdin.isTTY) {
+        stdin.setRawMode(wasRaw ?? false);
+      }
+      if (wasPaused) {
+        stdin.pause();
+      }
+    };
+
+    const finish = () => {
+      cleanup();
+      stdout.write('\n');
+      resolve(password);
+    };
+
+    const abort = () => {
+      cleanup();
+      stdout.write('\n');
+      process.exit(1);
+    };
+
+    const onError = (error: Error) => {
+      cleanup();
+      reject(error);
+    };
+
+    if (stdin.isTTY) {
+      stdin.setRawMode(true);
+    }
+
+    stdin.resume();
+
+    const onData = (chunk: Buffer | string) => {
+      const input = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+      for (const c of input) {
+        if (c === '\r' || c === '\n') {
+          finish();
+          return;
+        }
+        if (c === '\u0003') {
+          // Ctrl+C
+          abort();
+          return;
+        }
+        if (c === '\u007f' || c === '\b') {
+          if (password.length > 0) {
+            password = password.slice(0, -1);
+          }
+          continue;
+        }
+        password += c;
+      }
+    };
+
+    stdin.on('data', onData);
+    stdin.on('error', onError);
+  });
+}
+
+/**
+ * Prompt for visible text input
+ */
+export async function promptInput(label: string): Promise<string> {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    rl.question(`${label}: `, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Prompt user to select from explicit options
+ */
+export async function promptSelect(
+  message: string,
+  options: PromptSelectOption[],
+  defaultValue?: string,
+): Promise<string> {
+  if (options.length === 0) throw new Error('promptSelect requires at least one option');
+
+  if (process.stdin.isTTY && process.stdout.isTTY && typeof process.stdin.setRawMode === 'function') {
+    return promptSelectInteractive(message, options, defaultValue);
+  }
+
+  const optionLine = options
+    .map((opt) => (defaultValue && opt.value === defaultValue ? `${opt.label} [default]` : opt.label))
+    .join(' | ');
+
+  const answer = await promptInput(`${message} (${optionLine})`);
+  return resolveSelectedValue(answer, options, defaultValue);
+}
+
+/**
+ * Prompt for yes/no confirmation
+ */
+export async function promptConfirm(msg: string): Promise<boolean> {
+  const choice = await promptSelect(
+    msg,
+    [
+      { value: 'yes', label: 'yes', aliases: ['y'] },
+      { value: 'no', label: 'no', aliases: ['n'] },
+    ],
+    'yes',
+  );
+  return choice === 'yes';
+}
+
+/**
+ * Wait for the user to press Enter
+ */
+export async function waitForEnter(msg: string = 'Press Enter to continue...'): Promise<void> {
+  await promptInput(msg);
+}

package/server/cli/lib/theme.ts

@@ -0,0 +1,240 @@
+/**
+ * Aura CLI Theme — Medical / Industrial / Tyvek
+ *
+ * Shared visual primitives for all CLI commands.
+ * Inspired by the AuraMaxx SVG logo system: registration corner marks,
+ * three diagonal stripes at 45° (aura_logo.svg), dot micro-textures, monochrome fills.
+ *
+ * All output degrades safely in non-TTY / NO_COLOR / CI / TERM=dumb.
+ */
+
+// ── ANSI ─────────────────────────────────────────────────────
+
+const ANSI = {
+  reset:   '\x1b[0m',
+  bold:    '\x1b[1m',
+  dim:     '\x1b[2m',
+  italic:  '\x1b[3m',
+  fgAccent:'\x1b[38;5;154m',
+  fgGreen: '\x1b[32m',
+  fgRed:   '\x1b[31m',
+  fgYellow:'\x1b[33m',
+  fgGray:  '\x1b[90m',
+} as const;
+
+export function supportsColor(): boolean {
+  if (!process.stdout.isTTY) return false;
+  if (process.env.NO_COLOR) return false;
+  if (process.env.CI === 'true') return false;
+  return process.env.TERM !== 'dumb';
+}
+
+const USE_COLOR = supportsColor();
+
+export function paint(text: string, ...codes: string[]): string {
+  if (!USE_COLOR) return text;
+  return `${codes.join('')}${text}${ANSI.reset}`;
+}
+
+// ── Constants ────────────────────────────────────────────────
+
+const W = 62; // content width (fits 80-col with 2-char indent + padding)
+
+export const SEPARATOR = '  ' + '- '.repeat(Math.floor(W / 2));
+
+const CORNER_TL = paint('.-', ANSI.fgGray);
+const CORNER_TR = paint('-.', ANSI.fgGray);
+const CORNER_BL = paint("'-", ANSI.fgGray);
+const CORNER_BR = paint("-'", ANSI.fgGray);
+
+// ── Banner ───────────────────────────────────────────────────
+
+/**
+ * Print the Aura branded banner.
+ *
+ * Left side: three diagonal stripes at 45° inside a bordered square —
+ * matching the canonical Aura logo (website/public/aura_logo.svg:
+ * three rotated rects clipped to a square with corner marks).
+ * Right side: AURA wordmark + subtitle.
+ * Outer frame: crop-mark corners (from all SVG logos).
+ */
+export function printBanner(subtitle?: string): void {
+  const sub = subtitle ? subtitle.toUpperCase() : '';
+
+  const P = paint('|', ANSI.fgGray);    // outer pipe
+  const LP = paint('|', ANSI.fgGray);   // logo pipe
+  const S = (t: string) => paint(t, ANSI.bold);  // stripe chars
+
+  // Logo box borders (dashed, matching Tyvek style)
+  const LT = paint('.', ANSI.fgGray) + paint('----------', ANSI.dim) + paint('.', ANSI.fgGray);
+  const LB = paint("'", ANSI.fgGray) + paint('----------', ANSI.dim) + paint("'", ANSI.fgGray);
+
+  // Three diagonal stripes inside a 12×5 square (≈ square at 2:1 char ratio)
+  // All rows: |\\  \\  \\|
+  const r1 = `${LP}${S('\\\\')}  ${S('\\\\')}  ${S('\\\\')}${LP}`;
+  const r2 = `${LP}${S('\\\\')}  ${S('\\\\')}  ${S('\\\\')}${LP}`;
+  const r3 = `${LP}${S('\\\\')}  ${S('\\\\')}  ${S('\\\\')}${LP}`;
+
+  console.log('');
+  console.log(`  ${CORNER_TL}${paint(' '.repeat(W - 4), ANSI.dim)}${CORNER_TR}`);
+  console.log(`  ${P}   ${LT}${' '.repeat(W - 19)}${P}`);
+  console.log(`  ${P}   ${r1}    ${paint('A U R A', ANSI.bold)}${' '.repeat(W - 30)}${P}`);
+  console.log(`  ${P}   ${r2}    ${paint('M A X X . S H', ANSI.dim)}${' '.repeat(W - 36)}${P}`);
+  console.log(`  ${P}   ${r3}    ${sub ? paint(sub, ANSI.fgAccent) : ''}${' '.repeat(Math.max(0, W - 23 - sub.length))}${P}`);
+  console.log(`  ${P}   ${LB}${' '.repeat(W - 19)}${P}`);
+  console.log(`  ${CORNER_BL}${paint(' '.repeat(W - 4), ANSI.dim)}${CORNER_BR}`);
+  console.log('');
+}
+
+// ── Section ──────────────────────────────────────────────────
+
+/**
+ * Print a section header with Tyvek-style framing.
+ *
+ * Output:
+ *   - - - - - - - - - - - - - - - - - - -
+ *   [ SECTION TITLE ]
+ *   Optional subtitle
+ */
+export function printSection(title: string, subtitle?: string): void {
+  console.log('');
+  console.log(SEPARATOR);
+  console.log(`  ${paint(`[ ${title.toUpperCase()} ]`, ANSI.bold)}`);
+  if (subtitle) {
+    console.log(`  ${paint(subtitle, ANSI.dim)}`);
+  }
+  console.log('');
+}
+
+// ── Box ──────────────────────────────────────────────────────
+
+/**
+ * Print a framed box with crop-mark corners.
+ * Replaces the old ╔═══╗ double-line Unicode boxes.
+ *
+ * Output:
+ *   .- - - - - - - - - - - - - - - - -.
+ *   |  Line 1                          |
+ *   |  Line 2                          |
+ *   '- - - - - - - - - - - - - - - - -'
+ */
+export function printBox(lines: string[]): void {
+  const inner = W - 4; // account for "| " and " |"
+  const dashes = '- '.repeat(Math.floor((W - 2) / 2));
+
+  console.log(`  ${CORNER_TL}${paint(dashes.slice(0, W - 4), ANSI.dim)}${CORNER_TR}`);
+  for (const line of lines) {
+    // Strip ANSI to measure visible length for padding
+    const visible = line.replace(/\x1b\[[0-9;]*m/g, '');
+    const pad = Math.max(0, inner - visible.length);
+    console.log(`  ${paint('|', ANSI.fgGray)}  ${line}${' '.repeat(pad)}${paint('|', ANSI.fgGray)}`);
+  }
+  console.log(`  ${CORNER_BL}${paint(dashes.slice(0, W - 4), ANSI.dim)}${CORNER_BR}`);
+}
+
+// ── Status line ──────────────────────────────────────────────
+
+/**
+ * Print a key/value status line.
+ *
+ * Output:
+ *     Label:        value
+ *     Label:    [ok] value
+ */
+export function printStatus(label: string, value: string, ok?: boolean): void {
+  const paddedLabel = label.padEnd(16);
+  let indicator = '';
+  if (ok === true) indicator = paint('[ok]', ANSI.fgGreen) + ' ';
+  else if (ok === false) indicator = paint('[--]', ANSI.fgRed) + ' ';
+  console.log(`    ${paint(paddedLabel, ANSI.dim)}${indicator}${value}`);
+}
+
+// ── Check result (for doctor) ────────────────────────────────
+
+export type CheckBadge = 'pass' | 'warn' | 'fail';
+
+/**
+ * Format a diagnostic check badge in Tyvek style.
+ */
+export function checkBadge(status: CheckBadge): string {
+  switch (status) {
+    case 'pass': return paint('[PASS]', ANSI.fgGreen, ANSI.bold);
+    case 'warn': return paint('[WARN]', ANSI.fgYellow, ANSI.bold);
+    case 'fail': return paint('[FAIL]', ANSI.fgRed, ANSI.bold);
+  }
+}
+
+// ── Completion ───────────────────────────────────────────────
+
+/**
+ * Print a branded completion message.
+ */
+export function printComplete(message: string): void {
+  console.log('');
+  console.log(SEPARATOR);
+  console.log(`  ${paint('[ok]', ANSI.fgGreen)} ${paint(message, ANSI.bold)}`);
+  console.log('');
+}
+
+// ── Seed phrase box (security-critical) ──────────────────────
+
+/**
+ * Display a seed phrase in a clearly framed box.
+ * This is security-critical — readability is paramount.
+ */
+export function printSeedPhrase(mnemonic: string): void {
+  const words = mnemonic.split(' ');
+  const inner = 46;
+
+  console.log('');
+  console.log(`  ${CORNER_TL}${paint('-'.repeat(inner), ANSI.dim)}${CORNER_TR}`);
+  console.log(`  ${paint('|', ANSI.fgGray)}  ${paint('SEED PHRASE', ANSI.bold)}${' '.repeat(inner - 14)}${paint('|', ANSI.fgGray)}`);
+  console.log(`  ${paint('|', ANSI.fgGray)}  ${paint('Write this down. Store it safely.', ANSI.dim)}${' '.repeat(inner - 36)}${paint('|', ANSI.fgGray)}`);
+  console.log(`  ${paint('|', ANSI.fgGray)}${' '.repeat(inner + 2)}${paint('|', ANSI.fgGray)}`);
+  for (let i = 0; i < words.length; i += 4) {
+    const line = words.slice(i, i + 4)
+      .map((w, j) => `${String(i + j + 1).padStart(2)}. ${w.padEnd(10)}`)
+      .join('');
+    const pad = Math.max(0, inner - 2 - line.length);
+    console.log(`  ${paint('|', ANSI.fgGray)}  ${line}${' '.repeat(pad)}${paint('|', ANSI.fgGray)}`);
+  }
+  console.log(`  ${paint('|', ANSI.fgGray)}${' '.repeat(inner + 2)}${paint('|', ANSI.fgGray)}`);
+  console.log(`  ${paint('|', ANSI.fgGray)}  ${paint('It cannot be recovered.', ANSI.fgRed)}${' '.repeat(inner - 27)}${paint('|', ANSI.fgGray)}`);
+  console.log(`  ${CORNER_BL}${paint('-'.repeat(inner), ANSI.dim)}${CORNER_BR}`);
+  console.log('');
+}
+
+// ── Help formatter ───────────────────────────────────────────
+
+/**
+ * Print a branded help screen.
+ */
+export function printHelp(
+  title: string,
+  usage: string,
+  commands: Array<{ name: string; desc: string }>,
+  extras?: string[],
+): void {
+  printBanner(title);
+
+  console.log(`  ${paint('Usage:', ANSI.bold)} ${usage}`);
+  console.log('');
+
+  if (commands.length > 0) {
+    console.log(`  ${paint('Commands:', ANSI.bold)}`);
+    const maxName = Math.max(...commands.map(c => c.name.length));
+    for (const cmd of commands) {
+      console.log(`    ${paint(cmd.name.padEnd(maxName + 2), ANSI.fgAccent)}${cmd.desc}`);
+    }
+    console.log('');
+  }
+
+  if (extras) {
+    for (const line of extras) {
+      console.log(`  ${line}`);
+    }
+    console.log('');
+  }
+}
+
+export { ANSI, USE_COLOR, W };