@alimaandev/ripple 0.1.0 → 0.2.0

package/dist/bin.js

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
+import { DEFAULT_CONFIG, rippleConfigSchema, formatSchemaIssues } from './chunk-OOERV74D.js';
 import { CommanderError, Command } from 'commander';
 import { createJiti } from 'jiti';
 import path8 from 'path';
 import fs from 'fs/promises';
 import fs2 from 'fs';
 import { Project, ts, SyntaxKind } from 'ts-morph';
-import { z } from 'zod';
-import ora from 'ora';
-import treeify from 'treeify';
 import chalk from 'chalk';
+import figures from 'figures';
+import treeify from 'treeify';
+import boxen from 'boxen';
 import fg from 'fast-glob';
+import ora from 'ora';
 
 // src/output/writer.ts
 var TerminalWriter = class {
@@ -183,66 +185,6 @@ function substituteAlias(specifier, aliases) {
   return void 0;
 }
 
-// src/config/defaults.ts
-var DEFAULT_CONFIG = {
-  include: ["**/*.{ts,tsx,js,jsx}"],
-  ignore: ["node_modules", "dist", "build", "coverage", ".next", "out", ".git"],
-  aliases: {},
-  tsconfigPath: "tsconfig.json",
-  risk: {
-    weights: {
-      affectedFiles: 0.3,
-      entryPoint: 0.15,
-      sharedUtility: 0.15,
-      publicExports: 0.1,
-      tests: 0.1,
-      routes: 0.1,
-      cycleMembership: 0.1
-    },
-    thresholds: {
-      medium: 30,
-      high: 55,
-      critical: 80
-    }
-  }
-};
-
-// src/config/schema.ts
-var fraction = z.number().min(0).max(1);
-var score = z.number().min(0).max(100);
-var riskWeightsSchema = z.object({
-  affectedFiles: fraction.default(DEFAULT_CONFIG.risk.weights.affectedFiles),
-  entryPoint: fraction.default(DEFAULT_CONFIG.risk.weights.entryPoint),
-  sharedUtility: fraction.default(DEFAULT_CONFIG.risk.weights.sharedUtility),
-  publicExports: fraction.default(DEFAULT_CONFIG.risk.weights.publicExports),
-  tests: fraction.default(DEFAULT_CONFIG.risk.weights.tests),
-  routes: fraction.default(DEFAULT_CONFIG.risk.weights.routes),
-  cycleMembership: fraction.default(DEFAULT_CONFIG.risk.weights.cycleMembership)
-}).strict();
-var riskThresholdsSchema = z.object({
-  medium: score.default(DEFAULT_CONFIG.risk.thresholds.medium),
-  high: score.default(DEFAULT_CONFIG.risk.thresholds.high),
-  critical: score.default(DEFAULT_CONFIG.risk.thresholds.critical)
-}).strict();
-var riskConfigSchema = z.object({
-  weights: riskWeightsSchema.default(DEFAULT_CONFIG.risk.weights),
-  thresholds: riskThresholdsSchema.default(DEFAULT_CONFIG.risk.thresholds)
-}).strict();
-var rippleConfigSchema = z.object({
-  include: z.array(z.string().min(1)).min(1).default(DEFAULT_CONFIG.include),
-  ignore: z.array(z.string()).default(DEFAULT_CONFIG.ignore),
-  aliases: z.record(z.string(), z.string()).default(DEFAULT_CONFIG.aliases),
-  tsconfigPath: z.string().min(1).default(DEFAULT_CONFIG.tsconfigPath),
-  risk: riskConfigSchema.default(DEFAULT_CONFIG.risk)
-}).strict();
-function formatSchemaIssues(error) {
-  return error.issues.map((issue) => {
-    const path12 = issue.path.join(".");
-    const location = path12 === "" ? "config" : `config.${path12}`;
-    return `${location}: ${issue.message}`;
-  });
-}
-
 // src/config/loader.ts
 var CONFIG_CANDIDATES = [
   "ripple.config.ts",
@@ -600,10 +542,10 @@ function reverseTraverse(graph, targetKey, options) {
 }
 
 // src/risk/levels.ts
-function scoreToLevel(score2, thresholds) {
-  if (score2 >= thresholds.critical) return "CRITICAL";
-  if (score2 >= thresholds.high) return "HIGH";
-  if (score2 >= thresholds.medium) return "MEDIUM";
+function scoreToLevel(score, thresholds) {
+  if (score >= thresholds.critical) return "CRITICAL";
+  if (score >= thresholds.high) return "HIGH";
+  if (score >= thresholds.medium) return "MEDIUM";
   return "LOW";
 }
 function clamp(value, min, max) {
@@ -684,14 +626,14 @@ function scoreRisk(input) {
       contribution: Math.round(weight * value * 100 * 100) / 100
     };
   });
-  const score2 = clamp(
+  const score = clamp(
     Math.round(factors.reduce((sum, factor) => sum + factor.contribution, 0) * 100) / 100,
     0,
     100
   );
   return {
-    score: score2,
-    level: scoreToLevel(score2, input.riskConfig.thresholds),
+    score,
+    level: scoreToLevel(score, input.riskConfig.thresholds),
     factors
   };
 }
@@ -733,24 +675,79 @@ function analyzeFile(input) {
     maxDepth: reachedDepth
   };
 }
-function createSpinner(enabled) {
-  if (!enabled || !process.stdout.isTTY) {
-    return { start: () => {
-    }, stop: () => {
-    } };
+function dim(text, style) {
+  return style.color ? chalk.dim(text) : text;
+}
+function strong(text, style) {
+  return style.color ? chalk.bold(text) : text;
+}
+var RISK_COLORS = {
+  LOW: (text) => chalk.green(text),
+  MEDIUM: (text) => chalk.yellow(text),
+  HIGH: (text) => chalk.magenta(text),
+  CRITICAL: (text) => chalk.red.bold(text)
+};
+function riskColor(level) {
+  return RISK_COLORS[level];
+}
+function riskBadge(level, style) {
+  return style.color ? RISK_COLORS[level](level) : level;
+}
+function confidenceText(percent, style) {
+  const text = `${percent}%`;
+  if (!style.color) return text;
+  if (percent >= 90) return chalk.green(text);
+  if (percent >= 70) return chalk.yellow(text);
+  return chalk.red(text);
+}
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  return `${(ms / 1e3).toFixed(2)}s`;
+}
+function pluralize(count, noun, plural = `${noun}s`) {
+  return `${count} ${count === 1 ? noun : plural}`;
+}
+function icon(name) {
+  return figures[name];
+}
+
+// src/ui/progress.ts
+var noop = {
+  next: () => {
+  },
+  done: () => {
   }
-  let instance;
+};
+function createStageTracker(enabled) {
+  if (!enabled || !process.stdout.isTTY) return noop;
+  let current;
+  let from = 0;
+  const stamp = (label, ms) => {
+    process.stdout.write(
+      `${chalk.green(icon("tick"))} ${label} ${chalk.dim(formatDuration(ms))}
+`
+    );
+  };
   return {
-    start(text) {
-      instance = ora(text).start();
+    next(label) {
+      if (current) stamp(current, Date.now() - from);
+      current = label;
+      from = Date.now();
     },
-    stop() {
-      instance?.stop();
-      instance = void 0;
+    done() {
+      if (current) stamp(current, Date.now() - from);
+      current = void 0;
     }
   };
 }
 
+// src/ui/color.ts
+function resolveColor(requested) {
+  if (requested === false) return false;
+  const noColor = process.env.NO_COLOR;
+  return noColor === void 0 || noColor === "";
+}
+
 // src/formatter/table.ts
 function renderTable(columns, rows) {
   const widths = columns.map((column, index) => {
@@ -788,50 +785,53 @@ function renderTree(nodes) {
   }
   return treeify.asTree(root, false, false).trimEnd();
 }
-function banner(text, style) {
-  return style.color ? chalk.cyanBright.bold(text) : text;
-}
-function sectionTitle(text, style) {
-  return style.color ? chalk.bold.underline(text) : text;
-}
-function dim(text, style) {
-  return style.color ? chalk.dim(text) : text;
-}
-function strong(text, style) {
-  return style.color ? chalk.bold(text) : text;
-}
-var RISK_COLORS = {
-  LOW: (text) => chalk.green(text),
-  MEDIUM: (text) => chalk.yellow(text),
-  HIGH: (text) => chalk.magenta(text),
-  CRITICAL: (text) => chalk.red.bold(text)
-};
-function riskBadge(level, style) {
-  return style.color ? RISK_COLORS[level](level) : level;
-}
-function confidenceText(percent, style) {
-  const text = `${percent}%`;
-  if (!style.color) return text;
-  if (percent >= 90) return chalk.green(text);
-  if (percent >= 70) return chalk.yellow(text);
-  return chalk.red(text);
+var DIVIDER_WIDTH = 38;
+function brandHeader(options) {
+  const { label, version, style } = options;
+  if (!style.color) {
+    return `ripple \u2014 ${label}${version ? ` \xB7 v${version}` : ""}`;
+  }
+  const tagline = `${icon("pointer")} ${label}${version ? ` \xB7 v${version}` : ""}`;
+  return boxen(` ${tagline}`, {
+    padding: { left: 1, right: 1 },
+    title: "ripple",
+    borderStyle: "round",
+    borderColor: "cyan"
+  });
 }
-function formatDuration(ms) {
-  if (ms < 1e3) return `${ms}ms`;
-  return `${(ms / 1e3).toFixed(2)}s`;
+function sectionHeader(title, style) {
+  if (!style.color) return title;
+  return `${chalk.dim("\u2500".repeat(DIVIDER_WIDTH))}
+${chalk.bold(title)}`;
 }
-function pluralize(count, noun, plural = `${noun}s`) {
-  return `${count} ${count === 1 ? noun : plural}`;
+
+// src/ui/gauge.ts
+var CELLS = 10;
+var FILL = "\u2588";
+var EMPTY = "\u2591";
+function riskGauge(score, level, style) {
+  if (!style.color) return "";
+  const filled = Math.max(0, Math.min(CELLS, Math.round(score / 100 * CELLS)));
+  return riskColor(level)(FILL.repeat(filled) + EMPTY.repeat(CELLS - filled));
 }
 
 // src/output/report.ts
 var DEFAULT_LIST_LIMIT = 20;
 var textStyle = (options) => ({ color: options.color });
 function fileLabel(filePath, depth, inCycle, style) {
-  const relative = dim(filePath, style);
-  const depthSuffix = dim(`(depth ${depth})`, style);
-  const cycleSuffix = dim("(cycle)", style);
-  return `${relative} ${depthSuffix}${inCycle ? ` ${cycleSuffix}` : ""}`;
+  const parts = [dim(filePath, style)];
+  if (depth >= 0) parts.push(dim(`\xB7 depth ${depth}`, style));
+  if (inCycle) parts.push(dim("\xB7 cycle", style));
+  return parts.join(" ");
+}
+function impactLine(result, style) {
+  const { summary } = result;
+  const parts = [];
+  if (summary.routes > 0) parts.push(pluralize(summary.routes, "route"));
+  if (summary.components > 0) parts.push(pluralize(summary.components, "component"));
+  if (summary.tests > 0) parts.push(pluralize(summary.tests, "test"));
+  if (summary.utilities > 0) parts.push(pluralize(summary.utilities, "utility"));
+  return parts.length > 0 ? parts.join(" \xB7 ") : dim("none", style);
 }
 function buildAffectedTree(result, cwd, style) {
   const { affected, graph } = result;
@@ -871,29 +871,32 @@ function renderAnalyzeReport(result, options, writer) {
   const style = textStyle(options);
   const { summary, risk } = result;
   const file = displayPath(result.targetPath, options.cwd);
-  writer.writeLine(banner("\u{1F30A} Ripple Analysis", style));
+  writer.writeLine(brandHeader({ label: "impact analysis", version: options.version, style }));
   writer.writeLine();
-  writer.writeLine(
-    renderKeyValue([
-      ["File", file],
-      ["Risk", riskBadge(risk.level, style)],
-      ["Affected Files", pluralize(summary.affectedFiles, "file")],
-      ["Components", String(summary.components)],
-      ["API Routes", String(summary.routes)],
-      ["Tests", String(summary.tests)],
-      ["Utilities", String(summary.utilities)],
-      ["Max Depth", String(summary.maxDepth)],
-      ["Confidence", confidenceText(summary.confidence, style)],
-      ["Duration", dim(formatDuration(result.durationMs), style)]
-    ])
-  );
+  const score = risk.score.toFixed(1);
+  const gauge = riskGauge(risk.score, risk.level, style);
+  const rows = [
+    ["File", file],
+    ["Risk", `${riskBadge(risk.level, style)} \xB7 ${score}/100${gauge ? ` ${gauge}` : ""}`],
+    ["Impact", impactLine(result, style)],
+    ["Affected", pluralize(summary.affectedFiles, "file")],
+    ["Max depth", String(summary.maxDepth)],
+    ["Confidence", confidenceText(summary.confidence, style)],
+    ["Duration", dim(formatDuration(result.durationMs), style)]
+  ];
+  const width = Math.max(...rows.map(([key]) => key.length));
+  for (const [key, value] of rows) {
+    writer.writeLine(`${key.padEnd(width)}  ${value}`);
+  }
   writer.writeLine();
-  writer.writeLine(sectionTitle("Top Impact", style));
+  writer.writeLine(sectionHeader("Top impact", style));
   for (const area of summary.topImpact) {
-    writer.writeLine(`\u2022 ${strong(area.label, style)} ${dim(`(${area.count})`, style)}`);
+    writer.writeLine(
+      `${icon("bullet")} ${strong(area.label, style)} ${dim(`(${area.count})`, style)}`
+    );
   }
   writer.writeLine();
-  writer.writeLine(sectionTitle("Circular Dependencies", style));
+  writer.writeLine(sectionHeader("Circular dependencies", style));
   if (result.graph.cycles.length === 0) {
     writer.writeLine(dim("none", style));
   } else {
@@ -901,13 +904,13 @@ function renderAnalyzeReport(result, options, writer) {
       const chain = cycle.path.map((key) => {
         const node = result.graph.nodes.get(key);
         return displayPath(node?.path ?? key, options.cwd);
-      }).join(" \u2192 ");
-      writer.writeLine(`\u2B55 ${chain}`);
+      }).join(` ${icon("arrowRight")} `);
+      writer.writeLine(`${icon("circle")} ${chain}`);
     }
   }
   writer.writeLine();
   if (summary.affectedFiles > 0) {
-    writer.writeLine(sectionTitle(`Affected Files (${summary.affectedFiles})`, style));
+    writer.writeLine(sectionHeader(`Affected files (${summary.affectedFiles})`, style));
     const tree = buildAffectedTree(result, options.cwd, style);
     writer.writeLine(renderTree(tree));
     const limit = options.listLimit ?? DEFAULT_LIST_LIMIT;
@@ -919,22 +922,27 @@ function renderAnalyzeReport(result, options, writer) {
     writer.writeLine();
   }
   if (options.verbose) {
-    writer.writeLine(sectionTitle("Risk Factors", style));
+    writer.writeLine(sectionHeader("Risk factors", style));
     const columns = [
       { header: "Factor" },
       { header: "Weight" },
       { header: "Signal" },
       { header: "Points" }
     ];
-    const rows = risk.factors.map((factor) => [
+    const rowsVerbose = risk.factors.map((factor) => [
       factor.label,
       factor.weight.toFixed(2),
       factor.value.toFixed(2),
       factor.contribution.toFixed(2)
     ]);
-    writer.writeLine(renderTable(columns, rows));
+    writer.writeLine(renderTable(columns, rowsVerbose));
     writer.writeLine();
   }
+  if (style.color) {
+    writer.writeLine(
+      dim(`${icon("info")} Tip: run "ripple doctor" to check project health`, style)
+    );
+  }
 }
 function buildAnalyzeJsonReport(result, version, cwd) {
   const realPath = (key) => result.graph.nodes.get(key)?.path ?? key;
@@ -958,7 +966,7 @@ function buildAnalyzeJsonReport(result, version, cwd) {
 function renderGraphReport(input, options, writer) {
   const style = textStyle(options);
   const { stats } = input;
-  writer.writeLine(banner("\u{1F30A} Dependency Graph", style));
+  writer.writeLine(brandHeader({ label: "dependency graph", version: options.version, style }));
   writer.writeLine();
   writer.writeLine(
     renderKeyValue([
@@ -971,26 +979,26 @@ function renderGraphReport(input, options, writer) {
   );
   writer.writeLine();
   if (input.forward) {
-    writer.writeLine(sectionTitle("Dependants (forward)", style));
+    writer.writeLine(sectionHeader("Dependants (forward)", style));
     writer.writeLine(renderTree(input.forward.map((path12) => ({ label: path12 }))));
     writer.writeLine();
   }
   if (input.reverse) {
-    writer.writeLine(sectionTitle("Dependents (reverse)", style));
+    writer.writeLine(sectionHeader("Dependents (reverse)", style));
     writer.writeLine(renderTree(input.reverse.map((path12) => ({ label: path12 }))));
     writer.writeLine();
   }
-  if (input.cycles.length > 0) {
-    writer.writeLine(sectionTitle("Circular Dependencies", style));
+  writer.writeLine(sectionHeader("Circular dependencies", style));
+  if (input.cycles.length === 0) {
+    writer.writeLine(dim("none", style));
+  } else {
     for (const cycle of input.cycles) {
       const chain = cycle.path.map((key) => {
         const node = input.nodes.get(key);
         return displayPath(node?.path ?? key, input.cwd);
-      }).join(" \u2192 ");
-      writer.writeLine(`\u2B55 ${chain}`);
+      }).join(` ${icon("arrowRight")} `);
+      writer.writeLine(`${icon("circle")} ${chain}`);
     }
-  } else {
-    writer.writeLine(dim("No circular dependencies found.", style));
   }
 }
 function buildGraphJsonReport(input, version) {
@@ -1473,11 +1481,13 @@ async function analyzeCommand(fileArg, options, ctx2) {
   if (!await pathExists(targetPath)) {
     throw new RippleError(`File not found: ${fileArg}`, ExitCode.NotFound);
   }
-  const spinner = createSpinner(!options.json);
-  spinner.start("Analyzing project\u2026");
+  const tracker = createStageTracker(!options.json);
+  tracker.next("Loading config");
   const started = Date.now();
   const context = await loadProjectContext(ctx2.cwd, options.config);
+  tracker.next("Building dependency graph");
   const { graph, entryPoints, durationMs: pipelineMs } = await runPipeline(context);
+  tracker.next("Analyzing impact");
   const completed = Date.now();
   const result = analyzeFile({
     graph,
@@ -1488,7 +1498,7 @@ async function analyzeCommand(fileArg, options, ctx2) {
     durationMs: pipelineMs + (completed - started),
     ...options.depth !== void 0 ? { maxDepth: options.depth } : {}
   });
-  spinner.stop();
+  tracker.done();
   if (options.json) {
     const report = buildAnalyzeJsonReport(result, ctx2.version, ctx2.cwd);
     ctx2.writer.write(serializeJson(report));
@@ -1498,8 +1508,9 @@ async function analyzeCommand(fileArg, options, ctx2) {
     result,
     {
       cwd: ctx2.cwd,
-      color: options.color !== false,
-      verbose: options.verbose
+      color: resolveColor(options.color),
+      verbose: options.verbose,
+      version: ctx2.version
     },
     ctx2.writer
   );
@@ -1528,11 +1539,12 @@ function walk(graph, startKey, edges, maxDepth, cwd) {
   return entries.sort((a, b) => a.depth - b.depth || a.path.localeCompare(b.path)).map((entry) => entry.path);
 }
 async function graphCommand(fileArg, options, ctx2) {
-  const spinner = createSpinner(!options.json);
-  spinner.start(fileArg ? "Building dependency tree\u2026" : "Building graph\u2026");
+  const tracker = createStageTracker(!options.json);
+  tracker.next("Loading config");
   const cwd = ctx2.cwd;
   try {
     const context = await loadProjectContext(cwd, options.config);
+    tracker.next("Building graph");
     const { graph } = await runPipeline(context);
     const input = {
       stats: graph.stats,
@@ -1541,13 +1553,19 @@ async function graphCommand(fileArg, options, ctx2) {
       cwd
     };
     if (!fileArg) {
+      tracker.done();
       if (options.json) {
         const report = buildGraphJsonReport(input, ctx2.version);
         ctx2.writer.write(serializeJson(report));
       } else {
         renderGraphReport(
           input,
-          { cwd, color: options.color !== false, verbose: options.verbose },
+          {
+            cwd,
+            color: resolveColor(options.color),
+            verbose: options.verbose,
+            version: ctx2.version
+          },
           ctx2.writer
         );
       }
@@ -1557,6 +1575,7 @@ async function graphCommand(fileArg, options, ctx2) {
     const { key } = requireNode(graph, targetPath, context.rootDir);
     const dependants = walk(graph, key, graph.forward, options.depth, cwd);
     const dependents = walk(graph, key, graph.reverse, options.depth, cwd);
+    tracker.done();
     if (options.json) {
       const report = buildGraphJsonReport(
         {
@@ -1573,17 +1592,38 @@ async function graphCommand(fileArg, options, ctx2) {
           forward: options.reverse ? void 0 : dependants,
           reverse: options.reverse ? dependents : void 0
         },
-        { cwd, color: options.color !== false, verbose: options.verbose },
+        { cwd, color: resolveColor(options.color), verbose: options.verbose, version: ctx2.version },
         ctx2.writer
       );
     }
     return ExitCode.Success;
   } finally {
-    spinner.stop();
+    tracker.done();
+  }
+}
+function createSpinner(enabled) {
+  if (!enabled || !process.stdout.isTTY) {
+    return { start: () => {
+    }, stop: () => {
+    } };
   }
+  let instance;
+  return {
+    start(text) {
+      instance = ora(text).start();
+    },
+    stop() {
+      instance?.stop();
+      instance = void 0;
+    }
+  };
 }
+
+// src/commands/doctor.ts
 async function doctorCommand(options, ctx2) {
-  const spinner = createSpinner(options.color !== false);
+  const color = resolveColor(options.color);
+  const style = { color };
+  const spinner = createSpinner(color);
   spinner.start("Running diagnostics\u2026");
   const results = [];
   const check = (label, state, detail) => {
@@ -1608,7 +1648,7 @@ async function doctorCommand(options, ctx2) {
       context = await loadProjectContext(ctx2.cwd, options.config);
     } catch (error) {
       check("ripple config", "fail", error instanceof Error ? error.message : String(error));
-      renderResults(results, ctx2);
+      renderResults(results, ctx2, color);
       return ExitCode.InvalidConfig;
     }
     if (context.tsconfig) {
@@ -1657,29 +1697,39 @@ async function doctorCommand(options, ctx2) {
   } finally {
     spinner.stop();
   }
-  renderResults(results, ctx2);
+  renderResults(results, ctx2, color);
   const failed = results.some((check2) => check2.state === "fail");
   const warned = results.some((check2) => check2.state === "warn");
-  ctx2.writer.writeLine(
-    failed ? "\u2716 Diagnoses found problems." : warned ? "\u26A0 Diagnoses passed with warnings." : "\u2713 All checks passed."
-  );
+  const verdict = failed ? { icon: icon("cross"), text: "Diagnoses found problems.", color: chalk.red } : warned ? { icon: icon("warning"), text: "Diagnoses passed with warnings.", color: chalk.yellow } : { icon: icon("tick"), text: "All checks passed.", color: chalk.green };
+  const verdictIcon = style.color ? verdict.color(verdict.icon) : verdict.icon;
+  ctx2.writer.writeLine(`${verdictIcon} ${verdict.text}`);
   return failed ? ExitCode.Failure : ExitCode.Success;
 }
-function renderResults(results, ctx2) {
+function renderResults(results, ctx2, color) {
+  const style = { color };
+  ctx2.writer.writeLine(brandHeader({ label: "project health check", version: ctx2.version, style }));
+  ctx2.writer.writeLine();
+  const width = Math.max(...results.map((check) => check.label.length));
   for (const check of results) {
-    const icon = check.state === "ok" ? "\u2713" : check.state === "warn" ? "\u26A0" : "\u2716";
-    const suffix = check.detail ? ` ${check.detail}` : "";
-    ctx2.writer.writeLine(`${icon} ${check.label}${suffix}`);
+    const stateIcon = check.state === "ok" ? icon("tick") : check.state === "warn" ? icon("warning") : icon("cross");
+    const colored = check.state === "ok" ? chalk.green : check.state === "warn" ? chalk.yellow : chalk.red;
+    const mark = style.color ? colored(stateIcon) : stateIcon;
+    const detail = check.detail ? ` ${dim(check.detail, style)}` : "";
+    ctx2.writer.writeLine(`${mark} ${check.label.padEnd(width)}${detail}`);
   }
   ctx2.writer.writeLine();
 }
 var INIT_FILENAME = "ripple.config.json";
 async function initCommand(options, ctx2) {
+  const style = { color: resolveColor(options.color) };
   const target = path8.join(ctx2.cwd, INIT_FILENAME);
   try {
     await fs.access(target);
     if (!options.force) {
-      ctx2.writer.writeLine(`\u2716 ${INIT_FILENAME} already exists. Pass --force to overwrite it.`);
+      const mark = style.color ? chalk.red(icon("cross")) : icon("cross");
+      ctx2.writer.writeLine(
+        `${mark} ${INIT_FILENAME} already exists. Pass --force to overwrite it.`
+      );
       return ExitCode.Failure;
     }
   } catch {
@@ -1690,12 +1740,16 @@ async function initCommand(options, ctx2) {
   try {
     await fs.writeFile(target, `${JSON.stringify(payload, null, 2)}
 `, "utf8");
-    ctx2.writer.writeLine(`\u2713 Wrote ${INIT_FILENAME}`);
-    ctx2.writer.writeLine(`  Edit it to tune include globs, aliases and risk weights.`);
+    const mark = style.color ? chalk.green(icon("tick")) : icon("tick");
+    ctx2.writer.writeLine(`${mark} Wrote ${INIT_FILENAME}`);
+    ctx2.writer.writeLine(
+      `  ${dim("Edit it to tune include globs, aliases and risk weights.", style)}`
+    );
     return ExitCode.Success;
   } catch (error) {
+    const mark = style.color ? chalk.red(icon("cross")) : icon("cross");
     ctx2.writer.writeLine(
-      `\u2716 Could not write ${INIT_FILENAME}: ${error instanceof Error ? error.message : String(error)}`
+      `${mark} Could not write ${INIT_FILENAME}: ${error instanceof Error ? error.message : String(error)}`
     );
     return ExitCode.Failure;
   }
@@ -1751,8 +1805,11 @@ function createProgram(ctx2) {
       throw new ExitError(exitCode2);
     }
   });
-  program.command("init").description("Create a ripple.config.json with the default settings").option("-f, --force", "overwrite an existing config file").action(async (options) => {
-    const exitCode2 = await initCommand({ force: Boolean(options.force) }, ctx2);
+  program.command("init").description("Create a ripple.config.json with the default settings").option("-f, --force", "overwrite an existing config file").option("--no-color", "disable ANSI colors").action(async (options) => {
+    const exitCode2 = await initCommand(
+      { force: Boolean(options.force), color: options.color },
+      ctx2
+    );
     if (exitCode2 !== ExitCode.Success) {
       throw new ExitError(exitCode2);
     }
@@ -1760,6 +1817,11 @@ function createProgram(ctx2) {
   program.command("version").description("Print the Ripple version").action(() => {
     ctx2.writer.writeLine(ctx2.version);
   });
+  program.addHelpText(
+    "beforeAll",
+    `ripple \u2014 dependency impact analysis for TypeScript and JavaScript
+`
+  );
   return program;
 }
 var ExitError = class extends Error {
@@ -1814,7 +1876,7 @@ async function run({ argv, ctx: ctx2 }) {
 
 // package.json
 var package_default = {
-  version: "0.1.0"};
+  version: "0.2.0"};
 
 // src/cli/bin.ts
 var ctx = {