Skip to content

Turbocharge Claude Code, Cursor, Codex, Gemini & every coding agent: faster, cheaper, with contextual understanding specific to your codebase.

3.6 KB
Raw Blame
/**
 * `init`'s closing epilogue: the ASCII wordmark (trail's or graft's, by the name it ran as) + numbered next steps,
 * printed to stderr after the per-file ✓/·/⚠ lines. Extracted out of cli.ts
 * so the exact text — spacing is hand-aligned, not incidental — can be
 * unit-tested without spawning the CLI.
 */
import { brand, cmd } from "./brand.js";

// The live node/edge stats go on the wordmark's bottom line of letters (index
// 4 in both), when a graph exists. graft's stays byte for byte: its output is
// read by scripts.
const WORDMARKS: Record<"trail" | "graft", string[]> = {
  trail: [
    "  _             _ _",
    " | |_ _ __ __ _(_) |",
    " | __| '__/ _` | | |",
    " | |_| | | (_| | | |",
    "  \\__|_|  \\__,_|_|_|",
  ],
  graft: [
    "                   __ _",
    "   __ _ _ __ __ _ / _| |_",
    "  / _` | '__/ _` | |_| __|",
    " | (_| | | | (_| |  _| |_",
    "  \\__, |_|  \\__,_|_|  \\__|",
    "  |___/",
  ],
};
const STATS_LINE_INDEX = 4;

// Nanonets indigo, and a muted grey for the secondary stats suffix — only
// applied when stderr is a real TTY (tests spawn/call this without one, so
// existing plain-text assertions keep passing).
const indigo = (s: string) => `\x1b[38;2;84;111;255m${s}\x1b[0m`;
const muted = (s: string) => `\x1b[38;5;244m${s}\x1b[0m`;

interface Step {
  label: string;
  command: string;
  /** Extra continuation lines under this step, left-padded to the same column. */
  extra?: string[];
}

export interface InitEpilogueOptions {
  /** Whether a graft graph exists on disk (built by this run, or a prior one). */
  graphBuilt: boolean;
  /** Node count from the built graph — only meaningful when `graphBuilt`. */
  nodes?: number;
  /** Edge count from the built graph — only meaningful when `graphBuilt`. */
  edges?: number;
}

/** Renders the `graft init` next-steps epilogue (no trailing newline — the
 * caller's `console.error` adds the one trailing newline). */
export function formatInitEpilogue(opts: InitEpilogueOptions): string {
  const { graphBuilt, nodes, edges } = opts;
  const tty = Boolean(process.stderr.isTTY);

  const wordmark = WORDMARKS[brand()].map((l) => (tty ? indigo(l) : l));
  if (graphBuilt && nodes !== undefined && edges !== undefined) {
    const stats = `  ${nodes.toLocaleString("en-US")} nodes · ${edges.toLocaleString("en-US")} edges`;
    wordmark[STATS_LINE_INDEX] += tty ? muted(stats) : stats;
  }

  const steps: Step[] = [
    ...(graphBuilt ? [] : [{ label: "build the graph", command: cmd("graft build") }]),
    { label: "restart your agent", command: `a new session picks up ${brand()} automatically` },
    {
      label: "code as usual",
      command: "ask your agent to fix a bug or explain a flow:",
      extra: ["it now answers from the graph"],
    },
    {
      label: "explore by hand",
      command: `${cmd("graft ask")} "where is auth handled?" · ${cmd("graft callers")} <fn> · ${cmd("graft viz")}`,
    },
  ];

  const indent = "  ";
  const gap = "  ";
  const labelWidth = Math.max(...steps.map((s, i) => `${i + 1}. ${s.label}`.length));
  const columnWidth = indent.length + labelWidth + gap.length;

  const stepLines: string[] = [];
  steps.forEach((s, i) => {
    const prefix = `${indent}${i + 1}. ${s.label}`;
    stepLines.push(prefix.padEnd(columnWidth) + s.command);
    for (const extra of s.extra ?? []) {
      stepLines.push(" ".repeat(columnWidth) + extra);
    }
  });

  const closing = `${indent}share it: git add .claude && git commit; teammates run \`${cmd("graft build")}\` for their own local graph`;

  return [...wordmark, "", ...stepLines, "", closing].join("\n");
}