thinkwell 0.5.5 → 0.5.7

package/dist/cli/check.js

@@ -1,12 +1,3 @@
-/**
- * Check command for type-checking with @JSONSchema transformation.
- *
- * This module provides the `thinkwell check` command that runs TypeScript's
- * type checker without producing output files. It uses the same custom
- * CompilerHost as `thinkwell build`, but with `--noEmit` to skip emit.
- *
- * Supports single-package projects and workspace mode (pnpm/npm workspaces).
- */
 import ts from "typescript";
 import { existsSync } from "node:fs";
 import { resolve, join } from "node:path";
@@ -15,224 +6,144 @@ import { cyan, cyanBold, greenBold, whiteBold, dim } from "./fmt.js";
 import { detectWorkspace, resolvePackageName } from "./workspace.js";
 import { checkDependencies, hasPackageJson } from "./dependency-check.js";
 import { formatMissingDependencyError, hasMissingDependencies } from "./dependency-errors.js";
-// ============================================================================
-// Diagnostics Formatting
-// ============================================================================
 function createDiagnosticsHost(pretty) {
-    return {
-        getCanonicalFileName: (fileName) => fileName,
-        getCurrentDirectory: ts.sys.getCurrentDirectory,
-        getNewLine: () => ts.sys.newLine,
-    };
+  return {
+    getCanonicalFileName: (fileName) => fileName,
+    getCurrentDirectory: ts.sys.getCurrentDirectory,
+    getNewLine: () => ts.sys.newLine
+  };
 }
 function formatDiagnostics(diagnostics, pretty) {
-    if (diagnostics.length === 0)
-        return "";
-    const host = createDiagnosticsHost(pretty);
-    return pretty
-        ? ts.formatDiagnosticsWithColorAndContext(diagnostics, host)
-        : ts.formatDiagnostics(diagnostics, host);
+  if (diagnostics.length === 0)
+    return "";
+  const host = createDiagnosticsHost(pretty);
+  return pretty ? ts.formatDiagnosticsWithColorAndContext(diagnostics, host) : ts.formatDiagnostics(diagnostics, host);
 }
-// ============================================================================
-// Single-Package Check
-// ============================================================================
-/**
- * Type-check a single package directory. Returns the number of errors found.
- */
 function checkPackage(dir, pretty, projectDir) {
-    const configPath = resolve(dir, "tsconfig.json");
-    const { program, configErrors } = projectDir
-        ? createThinkwellProgram({ configPath, projectDir })
-        : createThinkwellProgram(configPath);
-    // Report config-level diagnostics
-    if (configErrors.length > 0) {
-        process.stderr.write(formatDiagnostics(configErrors, pretty));
-        const hasFatal = configErrors.some((d) => d.category === ts.DiagnosticCategory.Error);
-        if (hasFatal) {
-            return configErrors.filter((d) => d.category === ts.DiagnosticCategory.Error).length;
-        }
-    }
-    const diagnostics = ts.getPreEmitDiagnostics(program);
-    const errors = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Error);
-    if (diagnostics.length > 0) {
-        process.stderr.write("\n");
-        process.stderr.write(formatDiagnostics(diagnostics, pretty));
-    }
-    return errors.length;
+  const configPath = resolve(dir, "tsconfig.json"), { program, configErrors } = projectDir ? createThinkwellProgram({ configPath, projectDir }) : createThinkwellProgram(configPath);
+  if (configErrors.length > 0 && (process.stderr.write(formatDiagnostics(configErrors, pretty)), configErrors.some((d) => d.category === ts.DiagnosticCategory.Error)))
+    return configErrors.filter((d) => d.category === ts.DiagnosticCategory.Error).length;
+  const diagnostics = ts.getPreEmitDiagnostics(program), errors = diagnostics.filter((d) => d.category === ts.DiagnosticCategory.Error);
+  return diagnostics.length > 0 && (process.stderr.write(`
+`), process.stderr.write(formatDiagnostics(diagnostics, pretty))), errors.length;
 }
-// ============================================================================
-// Check Command
-// ============================================================================
 export async function runCheck(options) {
-    const cwd = process.cwd();
-    const pretty = options.pretty ?? process.stdout.isTTY ?? false;
-    const workspace = detectWorkspace(cwd);
-    // --package requires a workspace
-    if (options.packages && options.packages.length > 0 && !workspace) {
-        process.stderr.write('Error: --package can only be used in a workspace.\n' +
-            'No pnpm-workspace.yaml or package.json "workspaces" found in current directory.\n');
-        process.exit(2);
-    }
-    // Single-package mode (no workspace detected)
-    if (!workspace) {
-        // Check for required dependencies when a package.json exists
-        if (hasPackageJson(cwd)) {
-            const depCheck = await checkDependencies(cwd);
-            if (hasMissingDependencies(depCheck)) {
-                process.stderr.write(formatMissingDependencyError(depCheck) + "\n");
-                process.exit(2);
-            }
-        }
-        const configPath = resolve(cwd, "tsconfig.json");
-        if (!existsSync(configPath)) {
-            process.stderr.write("Error: Cannot find tsconfig.json\n");
-            process.stderr.write("\n");
-            process.stderr.write("  Run this command from a directory with a tsconfig.json.\n");
-            process.exit(2);
-        }
-        // Read package name for display, fall back to directory name
-        let pkgName = cwd.split("/").pop() ?? "project";
-        try {
-            const pkgPath = join(cwd, "package.json");
-            if (existsSync(pkgPath)) {
-                const pkg = JSON.parse((await import("node:fs")).readFileSync(pkgPath, "utf-8"));
-                if (pkg.name)
-                    pkgName = pkg.name;
-            }
-        }
-        catch {
-            // Use directory name
-        }
-        process.stderr.write(`  Checking ${pkgName}...\n`);
-        const projectDir = hasPackageJson(cwd) ? cwd : undefined;
-        const errorCount = checkPackage(cwd, pretty, projectDir);
-        if (errorCount > 0) {
-            process.exit(1);
-        }
-        process.stderr.write("  No type errors found.\n");
-        return;
-    }
-    // Workspace mode: check dependencies at workspace root
-    if (hasPackageJson(workspace.rootDir)) {
-        const depCheck = await checkDependencies(workspace.rootDir);
-        if (hasMissingDependencies(depCheck)) {
-            process.stderr.write(formatMissingDependencyError(depCheck) + "\n");
-            process.exit(2);
-        }
-    }
-    // Workspace mode: determine which packages to check
-    let packagesToCheck;
-    if (options.packages && options.packages.length > 0) {
-        // Resolve named packages
-        packagesToCheck = [];
-        for (const name of options.packages) {
-            const result = resolvePackageName(name, workspace.members);
-            switch (result.kind) {
-                case "found":
-                    if (!result.member.hasTsConfig) {
-                        process.stderr.write(`Error: Package "${result.member.name}" has no tsconfig.json.\n`);
-                        process.exit(2);
-                    }
-                    packagesToCheck.push(result.member);
-                    break;
-                case "ambiguous":
-                    process.stderr.write(`Error: Ambiguous package name "${result.name}". Matches:\n`);
-                    for (const m of result.matches) {
-                        process.stderr.write(`  - ${m.name}\n`);
-                    }
-                    process.stderr.write("\nUse the full package name to disambiguate.\n");
-                    process.exit(2);
-                    break; // unreachable but satisfies control flow
-                case "not-found":
-                    process.stderr.write(`Error: Package "${result.name}" not found in workspace.\n`);
-                    process.stderr.write("\nAvailable packages:\n");
-                    for (const available of result.available) {
-                        process.stderr.write(`  - ${available}\n`);
-                    }
-                    process.exit(2);
-                    break; // unreachable but satisfies control flow
-            }
-        }
+  const cwd = process.cwd(), pretty = options.pretty ?? process.stdout.isTTY ?? !1, workspace = detectWorkspace(cwd);
+  if (options.packages && options.packages.length > 0 && !workspace && (process.stderr.write(`Error: --package can only be used in a workspace.
+No pnpm-workspace.yaml or package.json "workspaces" found in current directory.
+`), process.exit(2)), !workspace) {
+    if (hasPackageJson(cwd)) {
+      const depCheck = await checkDependencies(cwd);
+      hasMissingDependencies(depCheck) && (process.stderr.write(formatMissingDependencyError(depCheck) + `
+`), process.exit(2));
     }
-    else {
-        // Check all packages that have tsconfig.json
-        packagesToCheck = workspace.members.filter((m) => m.hasTsConfig);
+    const configPath = resolve(cwd, "tsconfig.json");
+    existsSync(configPath) || (process.stderr.write(`Error: Cannot find tsconfig.json
+`), process.stderr.write(`
+`), process.stderr.write(`  Run this command from a directory with a tsconfig.json.
+`), process.exit(2));
+    let pkgName = cwd.split("/").pop() ?? "project";
+    try {
+      const pkgPath = join(cwd, "package.json");
+      if (existsSync(pkgPath)) {
+        const pkg = JSON.parse((await import("node:fs")).readFileSync(pkgPath, "utf-8"));
+        pkg.name && (pkgName = pkg.name);
+      }
+    } catch {
     }
-    if (packagesToCheck.length === 0) {
-        process.stderr.write("No TypeScript packages found in workspace.\n");
-        process.exit(2);
+    process.stderr.write(`  Checking ${pkgName}...
+`);
+    const projectDir = hasPackageJson(cwd) ? cwd : void 0;
+    checkPackage(cwd, pretty, projectDir) > 0 && process.exit(1), process.stderr.write(`  No type errors found.
+`);
+    return;
+  }
+  if (hasPackageJson(workspace.rootDir)) {
+    const depCheck = await checkDependencies(workspace.rootDir);
+    hasMissingDependencies(depCheck) && (process.stderr.write(formatMissingDependencyError(depCheck) + `
+`), process.exit(2));
+  }
+  let packagesToCheck;
+  if (options.packages && options.packages.length > 0) {
+    packagesToCheck = [];
+    for (const name of options.packages) {
+      const result = resolvePackageName(name, workspace.members);
+      switch (result.kind) {
+        case "found":
+          result.member.hasTsConfig || (process.stderr.write(`Error: Package "${result.member.name}" has no tsconfig.json.
+`), process.exit(2)), packagesToCheck.push(result.member);
+          break;
+        case "ambiguous":
+          process.stderr.write(`Error: Ambiguous package name "${result.name}". Matches:
+`);
+          for (const m of result.matches)
+            process.stderr.write(`  - ${m.name}
+`);
+          process.stderr.write(`
+Use the full package name to disambiguate.
+`), process.exit(2);
+          break;
+        // unreachable but satisfies control flow
+        case "not-found":
+          process.stderr.write(`Error: Package "${result.name}" not found in workspace.
+`), process.stderr.write(`
+Available packages:
+`);
+          for (const available of result.available)
+            process.stderr.write(`  - ${available}
+`);
+          process.exit(2);
+          break;
+      }
     }
-    // Check each package
-    let totalErrors = 0;
-    let packagesWithErrors = 0;
-    const total = packagesToCheck.length;
-    for (const member of packagesToCheck) {
-        process.stderr.write(`  Checking ${member.name}...`);
-        const originalCwd = process.cwd();
-        process.chdir(member.dir);
-        try {
-            const errorCount = checkPackage(member.dir, pretty, member.dir);
-            if (errorCount > 0) {
-                totalErrors += errorCount;
-                packagesWithErrors++;
-            }
-            else {
-                process.stderr.write(" ok\n");
-            }
-        }
-        finally {
-            process.chdir(originalCwd);
-        }
+  } else
+    packagesToCheck = workspace.members.filter((m) => m.hasTsConfig);
+  packagesToCheck.length === 0 && (process.stderr.write(`No TypeScript packages found in workspace.
+`), process.exit(2));
+  let totalErrors = 0, packagesWithErrors = 0;
+  const total = packagesToCheck.length;
+  for (const member of packagesToCheck) {
+    process.stderr.write(`  Checking ${member.name}...`);
+    const originalCwd = process.cwd();
+    process.chdir(member.dir);
+    try {
+      const errorCount = checkPackage(member.dir, pretty, member.dir);
+      errorCount > 0 ? (totalErrors += errorCount, packagesWithErrors++) : process.stderr.write(` ok
+`);
+    } finally {
+      process.chdir(originalCwd);
     }
-    // Summary
-    process.stderr.write("\n");
-    if (packagesWithErrors > 0) {
-        process.stderr.write(`  ${packagesWithErrors} of ${total} package${total === 1 ? "" : "s"} had errors.\n`);
-        process.exit(1);
-    }
-    process.stderr.write(`  All ${total} package${total === 1 ? "" : "s"} passed.\n`);
+  }
+  process.stderr.write(`
+`), packagesWithErrors > 0 && (process.stderr.write(`  ${packagesWithErrors} of ${total} package${total === 1 ? "" : "s"} had errors.
+`), process.exit(1)), process.stderr.write(`  All ${total} package${total === 1 ? "" : "s"} passed.
+`);
 }
-// ============================================================================
-// Argument Parsing
-// ============================================================================
 export function parseCheckArgs(args) {
-    const options = {};
-    let i = 0;
-    while (i < args.length) {
-        const arg = args[i];
-        if (arg === "-p" || arg === "--package") {
-            i++;
-            if (i >= args.length) {
-                throw new Error("Missing value for --package");
-            }
-            if (!options.packages)
-                options.packages = [];
-            options.packages.push(args[i]);
-        }
-        else if (arg === "--pretty") {
-            options.pretty = true;
-        }
-        else if (arg === "--no-pretty") {
-            options.pretty = false;
-        }
-        else if (arg.startsWith("-")) {
-            throw new Error(`Unknown option: ${arg}`);
-        }
-        else {
-            throw new Error(`Unexpected argument: ${arg}\n\n` +
-                `  "thinkwell check" type-checks the project without producing output.\n` +
-                `  It does not take positional arguments.\n\n` +
-                `  To check a specific workspace package, use: thinkwell check -p ${arg}`);
-        }
-        i++;
-    }
-    return options;
+  const options = {};
+  let i = 0;
+  for (; i < args.length; ) {
+    const arg = args[i];
+    if (arg === "-p" || arg === "--package") {
+      if (i++, i >= args.length)
+        throw new Error("Missing value for --package");
+      options.packages || (options.packages = []), options.packages.push(args[i]);
+    } else if (arg === "--pretty")
+      options.pretty = !0;
+    else if (arg === "--no-pretty")
+      options.pretty = !1;
+    else throw arg.startsWith("-") ? new Error(`Unknown option: ${arg}`) : new Error(`Unexpected argument: ${arg}
+
+  "thinkwell check" type-checks the project without producing output.
+  It does not take positional arguments.
+
+  To check a specific workspace package, use: thinkwell check -p ${arg}`);
+    i++;
+  }
+  return options;
 }
-// ============================================================================
-// Help
-// ============================================================================
 export function showCheckHelp() {
-    console.log(`
+  console.log(`
 ${cyanBold("thinkwell check")} - ${whiteBold("Type-check TypeScript with @JSONSchema support")}
 
 ${greenBold("Usage:")}
@@ -264,6 +175,6 @@ ${greenBold("Examples:")}
   ${cyanBold("thinkwell check")} ${cyan("-p acp")}              Check a specific workspace package
   ${cyanBold("thinkwell check")} ${cyan("-p acp -p protocol")}  Check multiple packages
   ${cyanBold("thinkwell check")} ${cyan("--no-pretty")}         Disable colorized output ${dim("(for CI)")}
-`.trim() + "\n");
+`.trim() + `
+`);
 }
-//# sourceMappingURL=check.js.map

package/dist/cli/commands.js

@@ -1,67 +1,31 @@
-/**
- * Shared CLI commands and help text.
- *
- * This module is the single source of truth for help screens and
- * utility functions shared between the two CLI entry points:
- *   - src/cli/main.cjs (compiled binary, CommonJS)
- *   - bin/thinkwell (npm distribution, ESM)
- *
- * IMPORTANT: This module must remain self-contained (no local imports)
- * because main.cjs loads it via require() inside the pkg snapshot,
- * where ESM import resolution for sibling modules fails.
- */
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
 import { styleText } from "node:util";
-const cyan = (t) => styleText("cyan", t);
-const cyanBold = (t) => styleText(["cyan", "bold"], t);
-const greenBold = (t) => styleText(["green", "bold"], t);
-const whiteBold = (t) => styleText(["white", "bold"], t);
-const redBold = (t) => styleText(["red", "bold"], t);
-const dim = (t) => styleText("dim", t);
+const cyan = (t) => styleText("cyan", t), cyanBold = (t) => styleText(["cyan", "bold"], t), greenBold = (t) => styleText(["green", "bold"], t), whiteBold = (t) => styleText(["white", "bold"], t), redBold = (t) => styleText(["red", "bold"], t), dim = (t) => styleText("dim", t);
 function getWelcomeMarkerPath() {
-    const cacheDir = process.env.THINKWELL_CACHE_DIR || join(homedir(), ".cache", "thinkwell");
-    return join(cacheDir, "welcome-version");
+  const cacheDir = process.env.THINKWELL_CACHE_DIR || join(homedir(), ".cache", "thinkwell");
+  return join(cacheDir, "welcome-version");
 }
 function shouldAnimate(version, forceWelcome) {
-    if (forceWelcome)
-        return true;
-    try {
-        const stored = readFileSync(getWelcomeMarkerPath(), "utf-8").trim();
-        return stored !== version;
-    }
-    catch {
-        return true;
-    }
+  if (forceWelcome)
+    return !0;
+  try {
+    return readFileSync(getWelcomeMarkerPath(), "utf-8").trim() !== version;
+  } catch {
+    return !0;
+  }
 }
 function recordWelcomeVersion(version) {
-    try {
-        const markerPath = getWelcomeMarkerPath();
-        mkdirSync(dirname(markerPath), { recursive: true });
-        writeFileSync(markerPath, version + "\n", "utf-8");
-    }
-    catch {
-        // Best-effort — if we can't write, the animation plays again next time.
-    }
+  try {
+    const markerPath = getWelcomeMarkerPath();
+    mkdirSync(dirname(markerPath), { recursive: !0 }), writeFileSync(markerPath, version + `
+`, "utf-8");
+  } catch {
+  }
 }
-/**
- * Print the main help screen to stdout, with an optional typewriter
- * animation on the tagline when stdout is an interactive TTY.
- *
- * The animation is gated to run once per installed version. Pass
- * `forceWelcome: true` (via the undocumented `--welcome` flag) to
- * bypass version gating.
- */
 export async function showMainHelp(options) {
-    const anchor = cyanBold("thinkwell");
-    const revealedText = " - agent scripting made easy";
-    const pen = " ✍️  ";
-    const penWithSparkle = " ✨✍️  ";
-    const { version, forceWelcome = false } = options;
-    const ttyOk = process.stdout.isTTY && !process.env.CI;
-    const animate = ttyOk && shouldAnimate(version, forceWelcome);
-    const middleHelp = `
+  const anchor = cyanBold("thinkwell"), revealedText = " - agent scripting made easy", pen = " \u270D\uFE0F  ", penWithSparkle = " \u2728\u270D\uFE0F  ", { version, forceWelcome = !1 } = options, animate = process.stdout.isTTY && !process.env.CI && shouldAnimate(version, forceWelcome), middleHelp = `
 
 ${greenBold("Usage:")}
   ${cyanBold("thinkwell")} ${dim("<script.ts> [args...]")}     Run a TypeScript script
@@ -76,136 +40,58 @@ ${greenBold("Usage:")}
 
 ${greenBold("Example:")}
   ${cyanBold("thinkwell")} ${cyan("my-agent.ts")}
-`;
-    const infoLineText = "For more information, visit: ";
-    const infoLineUrl = "https://thinkwell.sh";
-    const infoLine = `${infoLineText}${cyanBold(infoLineUrl)}`;
-    if (!animate) {
-        console.log(anchor + whiteBold(revealedText + penWithSparkle) + middleHelp + "\n" + infoLine);
-        return;
-    }
-    // Helper: typewriter with ✍️ trailing cursor
-    const typewrite = (chars, duration, styleFn) => new Promise((resolve) => {
-        const interval = duration / chars.length;
-        let i = 0;
-        const timer = setInterval(() => {
-            i++;
-            const revealed = chars.slice(0, i).join("");
-            process.stdout.write(`\r\x1b[K${styleFn(revealed)}${pen}`);
-            if (i >= chars.length) {
-                clearInterval(timer);
-                resolve();
-            }
-        }, interval);
-    });
-    // Hide cursor during animation
-    process.stdout.write("\x1b[?25l");
-    // Stage 1: Typewriter the tagline over 1s
-    process.stdout.write(pen);
-    const fullText = "thinkwell" + revealedText;
-    const fullChars = [...fullText];
-    await typewrite(fullChars, 1000, (revealed) => revealed.length <= 9
-        ? cyanBold(revealed)
-        : cyanBold("thinkwell") + whiteBold(revealed.slice(9)));
-    // Print the middle help text statically (remove ✍️ from tagline first)
-    process.stdout.write(`\r\x1b[K${anchor}${whiteBold(revealedText)}`);
-    process.stdout.write(middleHelp + "\n");
-    // Stage 2: Typewriter the "For more information" line with 📖 prefix over 1s
-    const infoChars = [...(infoLineText + infoLineUrl)];
-    await new Promise((resolve) => {
-        const interval = 1000 / infoChars.length;
-        let i = 0;
-        const timer = setInterval(() => {
-            i++;
-            const revealed = infoChars.slice(0, i).join("");
-            const styled = revealed.length <= infoLineText.length
-                ? revealed
-                : infoLineText + cyanBold(revealed.slice(infoLineText.length));
-            process.stdout.write(`\r\x1b[K📖 ${styled}${pen}`);
-            if (i >= infoChars.length) {
-                clearInterval(timer);
-                resolve();
-            }
-        }, interval);
-    });
-    // Remove pen, keep 📖
-    process.stdout.write(`\r\x1b[K📖 ${infoLine}`);
-    // Stage 3: Pen travels up vertically in the same column to the tagline
-    //
-    // The pen sits just after "📖 For more information, visit: https://thinkwell.sh"
-    // "📖 " = 3 visible cols, + infoLineText (29) + infoLineUrl (20) = 52 cols.
-    // The pen emoji occupies col 53+. On each intermediate line, we save the
-    // plain character at col 53 (all description text at that column is unstyled
-    // ASCII), write the pen over it, then restore it before moving up.
-    const penCol = 53;
-    const goCol = `\x1b[${penCol}G`;
-    // Strip ANSI escape codes to get visible text
-    const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
-    // Build array of plain chars at penCol for each line (bottom to top)
-    const helpLines = (middleHelp + "\n").split("\n");
-    // helpLines[0] corresponds to the line just below the tagline (bottom of array = closest to info line)
-    const charAtCol = helpLines.map((line) => {
-        const plain = stripAnsi(line);
-        // penCol is 1-based, string index is 0-based
-        return plain[penCol - 1] ?? " ";
-    });
-    // Number of \n characters between tagline and info line
-    const linesFromInfoToTagline = helpLines.length - 1;
-    const stepDelay = 40; // ms per line
-    // Animate pen traveling upward — save/restore single char at fixed col
-    for (let linesUp = 1; linesUp < linesFromInfoToTagline; linesUp++) {
-        // Draw pen at fixed column on this line
-        process.stdout.write(`\x1b[${linesUp}A${goCol}✍️\x1b[${linesUp}B\r`);
-        await new Promise((r) => setTimeout(r, stepDelay));
-        // Restore original character at that column
-        const originalChar = charAtCol[helpLines.length - 1 - linesUp];
-        process.stdout.write(`\x1b[${linesUp}A${goCol}${originalChar}\x1b[${linesUp}B\r`);
-    }
-    // Pen arrives at tagline — slide left from col 53 to final position
-    // The tagline "thinkwell - agent scripting made easy" is 38 visible chars.
-    // The sparkle goes at col 39, pen (✍️) at col 41 (after "✨").
-    // But first the pen slides from col 53 to col 40 (one past the sparkle slot).
-    const taglineRow = linesFromInfoToTagline;
-    const sparkleCol = 39;
-    for (let col = penCol; col > sparkleCol; col--) {
-        process.stdout.write(`\x1b[${taglineRow}A\x1b[${col}G✍️\x1b[${taglineRow}B\r`);
-        await new Promise((r) => setTimeout(r, stepDelay));
-        // Erase pen (it's over spaces on the tagline)
-        process.stdout.write(`\x1b[${taglineRow}A\x1b[${col}G \x1b[${taglineRow}B\r`);
-    }
-    // Write sparkle + pen at final position
-    process.stdout.write(`\x1b[${taglineRow}A\r\x1b[K${anchor}${whiteBold(revealedText + penWithSparkle)}\x1b[${taglineRow}B\r`);
-    // Record that this version's welcome animation has been shown
-    recordWelcomeVersion(version);
-    // Show cursor
-    process.stdout.write("\x1b[?25h\n");
+`, infoLineText = "For more information, visit: ", infoLineUrl = "https://thinkwell.sh", infoLine = `${infoLineText}${cyanBold(infoLineUrl)}`;
+  if (!animate) {
+    console.log(anchor + whiteBold(revealedText + penWithSparkle) + middleHelp + `
+` + infoLine);
+    return;
+  }
+  const typewrite = (chars, duration, styleFn) => new Promise((resolve) => {
+    const interval = duration / chars.length;
+    let i = 0;
+    const timer = setInterval(() => {
+      i++;
+      const revealed = chars.slice(0, i).join("");
+      process.stdout.write(`\r\x1B[K${styleFn(revealed)}${pen}`), i >= chars.length && (clearInterval(timer), resolve());
+    }, interval);
+  });
+  process.stdout.write("\x1B[?25l"), process.stdout.write(pen);
+  const fullChars = [..."thinkwell" + revealedText];
+  await typewrite(fullChars, 1e3, (revealed) => revealed.length <= 9 ? cyanBold(revealed) : cyanBold("thinkwell") + whiteBold(revealed.slice(9))), process.stdout.write(`\r\x1B[K${anchor}${whiteBold(revealedText)}`), process.stdout.write(middleHelp + `
+`);
+  const infoChars = [...infoLineText + infoLineUrl];
+  await new Promise((resolve) => {
+    const interval = 1e3 / infoChars.length;
+    let i = 0;
+    const timer = setInterval(() => {
+      i++;
+      const revealed = infoChars.slice(0, i).join(""), styled = revealed.length <= infoLineText.length ? revealed : infoLineText + cyanBold(revealed.slice(infoLineText.length));
+      process.stdout.write(`\r\x1B[K\u{1F4D6} ${styled}${pen}`), i >= infoChars.length && (clearInterval(timer), resolve());
+    }, interval);
+  }), process.stdout.write(`\r\x1B[K\u{1F4D6} ${infoLine}`);
+  const penCol = 53, goCol = `\x1B[${penCol}G`, stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, ""), helpLines = (middleHelp + `
+`).split(`
+`), charAtCol = helpLines.map((line) => stripAnsi(line)[penCol - 1] ?? " "), linesFromInfoToTagline = helpLines.length - 1, stepDelay = 40;
+  for (let linesUp = 1; linesUp < linesFromInfoToTagline; linesUp++) {
+    process.stdout.write(`\x1B[${linesUp}A${goCol}\u270D\uFE0F\x1B[${linesUp}B\r`), await new Promise((r) => setTimeout(r, stepDelay));
+    const originalChar = charAtCol[helpLines.length - 1 - linesUp];
+    process.stdout.write(`\x1B[${linesUp}A${goCol}${originalChar}\x1B[${linesUp}B\r`);
+  }
+  const taglineRow = linesFromInfoToTagline, sparkleCol = 39;
+  for (let col = penCol; col > sparkleCol; col--)
+    process.stdout.write(`\x1B[${taglineRow}A\x1B[${col}G\u270D\uFE0F\x1B[${taglineRow}B\r`), await new Promise((r) => setTimeout(r, stepDelay)), process.stdout.write(`\x1B[${taglineRow}A\x1B[${col}G \x1B[${taglineRow}B\r`);
+  process.stdout.write(`\x1B[${taglineRow}A\r\x1B[K${anchor}${whiteBold(revealedText + penWithSparkle)}\x1B[${taglineRow}B\r`), recordWelcomeVersion(version), process.stdout.write(`\x1B[?25h
+`);
 }
-/**
- * Print the "no script provided" error and exit.
- */
 export function showNoScriptError() {
-    console.error(`${redBold("Error:")} No script provided.`);
-    console.error("");
-    console.error("Usage: thinkwell <script.ts> [args...]");
-    process.exit(1);
+  console.error(`${redBold("Error:")} No script provided.`), console.error(""), console.error("Usage: thinkwell <script.ts> [args...]"), process.exit(1);
 }
-/**
- * Check if args contain a help flag (--help or -h).
- */
 export function hasHelpFlag(args) {
-    return args.includes("--help") || args.includes("-h");
+  return args.includes("--help") || args.includes("-h");
 }
-/**
- * Check if args contain the undocumented --welcome flag.
- */
 export function hasWelcomeFlag(args) {
-    return args.includes("--welcome");
+  return args.includes("--welcome");
 }
-/**
- * Format an error message with a red bold "Error:" prefix.
- * Use with console.error(): `console.error(fmtError("something went wrong"))`
- */
 export function fmtError(message) {
-    return `${redBold("Error:")} ${message}`;
+  return `${redBold("Error:")} ${message}`;
 }
-//# sourceMappingURL=commands.js.map