ai-spec-dev 0.1.0 → 0.17.0

package/cli/welcome.ts

@@ -0,0 +1,151 @@
+import chalk from "chalk";
+import * as os from "os";
+import * as path from "path";
+import * as fs from "fs-extra";
+
+// ─── Layout constants ─────────────────────────────────────────────────────────
+
+const VERSION = "0.14.1";
+/** Total visible width of the title / bottom bar */
+const TOTAL_W = 76;
+/** Visible width of the left content column */
+const L_WIDTH = 44;
+/** Visible width of the right content column (TOTAL_W - L_WIDTH - 4 for " │ " + leading space) */
+const R_WIDTH = TOTAL_W - L_WIDTH - 4;
+
+// ─── ASCII robot ──────────────────────────────────────────────────────────────
+
+const ROBOT_COLOR = chalk.hex("#E8885A");
+
+const ROBOT: string[] = [
+  ROBOT_COLOR("      ┌───────────┐"),
+  ROBOT_COLOR("      │") + chalk.bold.white(" ◉  ") + ROBOT_COLOR("   ") + chalk.bold.white("◉ ") + ROBOT_COLOR("│"),
+  ROBOT_COLOR("      │") + chalk.dim("    ╰─╯    ") + ROBOT_COLOR("│"),
+  ROBOT_COLOR("      └─────┬─────┘"),
+  ROBOT_COLOR("            │"),
+  ROBOT_COLOR("        ────┴────"),
+];
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+/** Visible (non-ANSI) length of a string */
+function visLen(s: string): number {
+  // eslint-disable-next-line no-control-regex
+  return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+
+/** Pad a string on the right to reach `width` visible chars */
+function padR(s: string, width: number): string {
+  const vl = visLen(s);
+  return vl >= width ? s : s + " ".repeat(width - vl);
+}
+
+/** Render one full-width row: left column + separator + right column */
+function row(left: string, right: string): string {
+  return padR(left, L_WIDTH) + " " + chalk.gray("│") + " " + padR(right, R_WIDTH);
+}
+
+/** Center a string (with chalk codes) within `width` visible chars */
+function center(s: string, width: number): string {
+  const vl = visLen(s);
+  const pad = Math.max(0, Math.floor((width - vl) / 2));
+  return " ".repeat(pad) + s;
+}
+
+// ─── Recent specs ─────────────────────────────────────────────────────────────
+
+async function getRecentSpecs(dir: string): Promise<string[]> {
+  const specsDir = path.join(dir, "specs");
+  if (!(await fs.pathExists(specsDir))) return [];
+  try {
+    const files = await fs.readdir(specsDir);
+    const mdFiles = files.filter((f) => f.endsWith(".md"));
+    const withStats = await Promise.all(
+      mdFiles.map(async (f) => {
+        const stat = await fs.stat(path.join(specsDir, f));
+        return { name: f, mtime: stat.mtime.getTime() };
+      })
+    );
+    withStats.sort((a, b) => b.mtime - a.mtime);
+    return withStats.slice(0, 3).map(({ name, mtime }) => {
+      const ms = Date.now() - mtime;
+      const hours = Math.floor(ms / 3_600_000);
+      const days = Math.floor(hours / 24);
+      const age = days > 0 ? `${days}d ago` : hours > 0 ? `${hours}h ago` : "just now";
+      // trim to fit right column
+      const slug = name.replace(/\.md$/, "").slice(0, R_WIDTH - age.length - 2);
+      return chalk.white(slug) + chalk.dim("  " + age);
+    });
+  } catch {
+    return [];
+  }
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+export async function printWelcome(
+  currentDir: string,
+  config?: { provider?: string; model?: string }
+): Promise<void> {
+  const username = os.userInfo().username;
+  const homeDir = os.homedir();
+  const shortDir = currentDir.startsWith(homeDir)
+    ? "~" + currentDir.slice(homeDir.length)
+    : currentDir;
+
+  const recentSpecs = await getRecentSpecs(currentDir);
+
+  const providerBit = config?.provider
+    ? config.provider + (config.model ? " · " + config.model : "")
+    : "";
+  // Build bottom info and truncate to fit left column (leave 2-char indent)
+  const bottomRaw = [providerBit, shortDir].filter(Boolean).join(" · ");
+  const maxInfoLen = L_WIDTH - 2;
+  const bottomTruncated = bottomRaw.length > maxInfoLen
+    ? bottomRaw.slice(0, maxInfoLen - 1) + "…"
+    : bottomRaw;
+  const bottomLine = "  " + chalk.dim(bottomTruncated);
+
+  // ── Title bar ───────────────────────────────────────────────────────────────
+  const titleInner = `ai-spec v${VERSION} `;
+  const titleDashes = "─".repeat(Math.max(0, TOTAL_W - titleInner.length - 4));
+  console.log(
+    "\n" +
+    chalk.hex("#FF6B35")("─── " + titleInner + titleDashes)
+  );
+
+  // ── Build left-column lines ──────────────────────────────────────────────────
+  const welcomeText = "Welcome back, " + chalk.bold.white(username) + "!";
+  const leftLines: string[] = [
+    "",
+    center(welcomeText, L_WIDTH),
+    "",
+    ...ROBOT,
+    "",
+    bottomLine,
+    "",
+  ];
+
+  // ── Build right-column lines ─────────────────────────────────────────────────
+  const rightLines: string[] = [
+    chalk.hex("#FF8C00").bold("Tips for getting started"),
+    chalk.gray("─".repeat(R_WIDTH)),
+    chalk.white('ai-spec create "feature"'),
+    chalk.gray("ai-spec workspace run"),
+    chalk.gray("ai-spec update \"change\""),
+    "",
+    chalk.hex("#FF8C00").bold("Recent activity"),
+    chalk.gray("─".repeat(R_WIDTH)),
+    ...(recentSpecs.length > 0 ? recentSpecs : [chalk.dim("No recent activity")]),
+  ];
+
+  // ── Render rows ─────────────────────────────────────────────────────────────
+  const maxLines = Math.max(leftLines.length, rightLines.length);
+  for (let i = 0; i < maxLines; i++) {
+    console.log(row(leftLines[i] ?? "", rightLines[i] ?? ""));
+  }
+
+  // ── Bottom bar ──────────────────────────────────────────────────────────────
+  console.log(chalk.gray("─".repeat(TOTAL_W)));
+  console.log();
+}