create-thally-docs 0.10.78 → 0.10.79

package/dist/chunk-L2YCVQBR.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+// src/terminal.ts
+import { intro, outro, spinner } from "@clack/prompts";
+import { stripVTControlCharacters } from "util";
+var PRODUCT_TAGLINE = "Product knowledge, kept in step with your code.";
+var OLIVE = { rgb: "38;2;174;187;106", palette: "38;5;143" };
+var OLIVE_EDGE = { rgb: "38;2;115;121;56", palette: "38;5;101" };
+function oliveCode(env, edge = false) {
+  const color = edge ? OLIVE_EDGE : OLIVE;
+  return env.COLORTERM === "truecolor" || env.COLORTERM === "24bit" || ["iTerm.app", "vscode", "WezTerm"].includes(env.TERM_PROGRAM ?? "") ? color.rgb : color.palette;
+}
+var accentUsers = 0;
+var restoreAccent;
+function acquireTerminalAccent() {
+  if (!terminal.isRich) return () => {
+  };
+  if (accentUsers === 0) {
+    const output = process.stdout;
+    const previous = output.write;
+    const writeOriginal = previous.bind(output);
+    const opening = `\x1B[${oliveCode(process.env)}m`;
+    const themed = function(chunk, encodingOrCallback, callback) {
+      const text = typeof chunk === "string" ? chunk.replace(/\x1b\[(?:32|35|36)m/g, opening) : chunk;
+      return typeof encodingOrCallback === "string" ? writeOriginal(text, encodingOrCallback, callback) : writeOriginal(text, encodingOrCallback);
+    };
+    output.write = themed;
+    restoreAccent = () => {
+      if (output.write === themed) output.write = previous;
+    };
+  }
+  accentUsers += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    accentUsers -= 1;
+    if (accentUsers === 0) {
+      restoreAccent?.();
+      restoreAccent = void 0;
+    }
+  };
+}
+var WORDMARK = [
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2557     \u2588\u2588\u2557   \u2588\u2588\u2557",
+  "\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2551     \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551      \u255A\u2588\u2588\u2588\u2588\u2554\u255D ",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551       \u255A\u2588\u2588\u2554\u255D  ",
+  "   \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551   ",
+  "   \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D   "
+];
+var SMALL_WORDMARK = [
+  "\u2580\u2588\u2580 \u2588 \u2588 \u2584\u2580\u2588 \u2588   \u2588   \u2588 \u2588",
+  " \u2588  \u2588\u2580\u2588 \u2588\u2580\u2588 \u2588   \u2588    \u2588 ",
+  " \u2580  \u2580 \u2580 \u2580 \u2580 \u2580\u2580\u2580 \u2580\u2580\u2580  \u2580 "
+];
+function terminalText(value) {
+  return stripVTControlCharacters(value).replace(/[\u0000-\u0009\u000b-\u001f\u007f-\u009f]/g, "");
+}
+function createTerminal(options = {}) {
+  const output = options.stdout ?? process.stdout;
+  const errors = options.stderr ?? process.stderr;
+  const environment = () => options.env ?? process.env;
+  const arguments_ = () => options.argv ?? process.argv.slice(2);
+  const isRich = () => Boolean(output.isTTY) && !environment().CI && environment().TERM !== "dumb" && environment().NO_COLOR === void 0;
+  const canAnimate = () => isRich() && Boolean(process.stdin.isTTY) && output === process.stdout && errors === process.stderr && !arguments_().includes("--verbose");
+  const paint = (text, code, rich = isRich()) => rich ? `\x1B[${code}m${text}\x1B[0m` : text;
+  const accent = (text, edge = false) => paint(text, oliveCode(environment(), edge));
+  const write = (text) => output.write(`${text}
+`);
+  const wordmark = () => {
+    const columns = output.columns ?? 80;
+    const lines = columns >= Math.max(...WORDMARK.map((line) => line.length)) + 2 ? WORDMARK : SMALL_WORDMARK;
+    if (!isRich() || columns < Math.max(...lines.map((line) => line.length)) + 2) {
+      write(`  ${accent("THALLY")}`);
+      return;
+    }
+    const lettering = lines.map((line) => line.split(/(█+)/).map((part) => accent(part, !part.includes("\u2588"))).join(""));
+    for (const line of lettering) write(`  ${line}`);
+  };
+  const diagnostic = (message, isError) => {
+    const rich = isRich() && Boolean(errors.isTTY);
+    const symbol = isError ? rich ? "\u25A0" : "[error]" : rich ? "\u25B2" : "[warn]";
+    const line = `  ${paint(symbol, isError ? 31 : 33, rich)} ${terminalText(message)}`;
+    if (errors === process.stderr) console.warn(line);
+    else errors.write(`${line}
+`);
+  };
+  const render = {
+    /** Whether interactive decoration is supported by the current output. */
+    get isRich() {
+      return isRich();
+    },
+    /** Whether the caller requested detailed subprocess output. */
+    get isVerbose() {
+      return arguments_().includes("--verbose");
+    },
+    /** Introduce a command with the responsive wordmark and its immediate task. */
+    intro(command, version, subtitle = PRODUCT_TAGLINE) {
+      const heading = `${terminalText(command)}${version ? ` ${isRich() ? "\xB7" : "-"} v${terminalText(version)}` : ""}`;
+      write("");
+      wordmark();
+      write("");
+      write(`  ${PRODUCT_TAGLINE}`);
+      if (subtitle !== PRODUCT_TAGLINE) write(`  ${paint(terminalText(subtitle), 2)}`);
+      write("");
+      if (isRich() && output === process.stdout) intro(accent(heading));
+      else write(`  ${accent(heading)}`);
+      write("");
+    },
+    /** Display a source, destination, or result with a consistent label. */
+    detail(label, value) {
+      write(`  ${paint(terminalText(label).padEnd(10), 2)} ${terminalText(value)}`);
+    },
+    /** Display a neutral fact without implying success. */
+    info(message) {
+      write(`  ${paint(isRich() ? "\u2502" : "-", 2)} ${terminalText(message)}`);
+    },
+    /** Record a completed operation in the retained transcript. */
+    success(message) {
+      write(`  ${accent(isRich() ? "\u2713" : "[ok]")} ${terminalText(message)}`);
+    },
+    /** Keep warnings visible on stderr even when successful task logs are quiet. */
+    warn(message) {
+      diagnostic(message, false);
+    },
+    /** Keep errors visible on stderr and separate from machine-readable stdout. */
+    error(message) {
+      diagnostic(message, true);
+    },
+    /** Group next steps or results without a fixed-width box. */
+    section(title, lines) {
+      write("");
+      write(`  ${paint(terminalText(title), 1)}`);
+      for (const line of lines) write(`    ${terminalText(line)}`);
+      write("");
+    },
+    /** Make the next action prominent while retaining one intact shell command. */
+    nextAction(title, command) {
+      const cleanTitle = terminalText(title);
+      const cleanCommand = terminalText(command);
+      write("");
+      if (!isRich()) {
+        write(`  Next action: ${cleanTitle}`);
+        write("  Copy and run this command:");
+        write(`    ${cleanCommand}`);
+        write("");
+        return;
+      }
+      const label = `NEXT \u2192 ${cleanTitle}`;
+      write(`  ${paint(paint(paint(` ${label} `, 1), 30), oliveCode(environment()).replace(/^38;/, "48;"))}`);
+      write("");
+      write("  Copy and run to open your local preview:");
+      const canFrame = !cleanCommand.includes("\n") && cleanCommand.length + 8 <= (output.columns ?? 80);
+      if (canFrame) {
+        const width = cleanCommand.length + 4;
+        write(`  ${accent(`\u256D${"\u2500".repeat(width)}\u256E`)}`);
+        write(`  ${accent("\u2502")}${" ".repeat(width)}${accent("\u2502")}`);
+        write(`  ${accent("\u2502")}  ${accent(paint(cleanCommand, 1))}  ${accent("\u2502")}`);
+        write(`  ${accent("\u2502")}${" ".repeat(width)}${accent("\u2502")}`);
+        write(`  ${accent(`\u2570${"\u2500".repeat(width)}\u256F`)}`);
+      } else write(`    ${accent(paint(cleanCommand, 1))}`);
+      write("");
+    },
+    /** Finish a command without masking warnings or incomplete validation. */
+    outro(message) {
+      if (isRich() && output === process.stdout) outro(terminalText(message));
+      else {
+        write("");
+        write(`  ${terminalText(message)}`);
+        write("");
+      }
+    },
+    /** Render progress, retain the outcome, and always release Clack's cursor hooks. */
+    async step(label, action, completedLabel = label) {
+      const progress = canAnimate() ? spinner({ indicator: "timer" }) : void 0;
+      const releaseAccent = progress ? acquireTerminalAccent() : void 0;
+      const cleanLabel = terminalText(label).replace(/\n/g, " ");
+      const limit = Math.max(8, (output.columns ?? 80) - 16);
+      const fit = (message) => Array.from(terminalText(message).replace(/\n/g, " ")).slice(0, limit).join("");
+      let activity = cleanLabel;
+      const began = Date.now();
+      const update = (message) => {
+        const next = terminalText(message).replace(/\n/g, " ");
+        if (next === activity) return;
+        activity = next;
+        if (progress) progress.message(fit(next));
+        else render.info(next);
+      };
+      const heartbeat = !progress ? setInterval(() => {
+        render.info(`${activity} (${Math.floor((Date.now() - began) / 1e3)}s elapsed)`);
+      }, 15e3) : void 0;
+      const cancel = () => {
+        progress?.stop("Cancelled", 1);
+        releaseAccent?.();
+        process.exit(130);
+      };
+      const terminate = () => {
+        progress?.stop("Cancelled", 1);
+        releaseAccent?.();
+        process.exit(143);
+      };
+      if (progress) {
+        process.once("SIGINT", cancel);
+        process.once("SIGTERM", terminate);
+      }
+      try {
+        if (progress) progress.start(fit(cleanLabel));
+        else render.info(cleanLabel);
+        const result = await action(update);
+        if (progress) progress.stop(terminalText(completedLabel));
+        else render.success(completedLabel);
+        return result;
+      } catch (error) {
+        if (progress) progress.stop(`${cleanLabel}: failed`, 2);
+        else render.error(`${cleanLabel}: failed`);
+        throw error;
+      } finally {
+        releaseAccent?.();
+        if (heartbeat) clearInterval(heartbeat);
+        if (progress) {
+          process.removeListener("SIGINT", cancel);
+          process.removeListener("SIGTERM", terminate);
+        }
+      }
+    }
+  };
+  return render;
+}
+var terminal = createTerminal();
+function formatHelp(text) {
+  if (!terminal.isRich) return text;
+  const accent = `\x1B[${oliveCode(process.env)}m`;
+  return text.split("\n").map((line) => {
+    const heading = line.trimStart();
+    if (heading.length < 2 || !heading.endsWith(":")) return line;
+    const indentation = line.slice(0, line.length - heading.length);
+    return `${indentation}${accent}${heading}\x1B[0m`;
+  }).join("\n");
+}
+
+export {
+  PRODUCT_TAGLINE,
+  acquireTerminalAccent,
+  terminalText,
+  createTerminal,
+  terminal,
+  formatHelp
+};

package/dist/{chunk-W5WQ2V7P.js → chunk-WWIATVAD.js}

@@ -5,12 +5,14 @@ import {
 import {
   STABLE_SCAFFOLD_RELEASE
 } from "./chunk-BP2REWTO.js";
+import {
+  terminal
+} from "./chunk-L2YCVQBR.js";
 
 // src/download.ts
 import { Readable, Transform, pipeline } from "stream";
 import { promisify } from "util";
 import {
-  cpSync,
   lstatSync,
   mkdtempSync,
   readdirSync,
@@ -20,6 +22,7 @@ import {
 } from "fs";
 import { tmpdir } from "os";
 import { dirname, join } from "path";
+import { cp } from "fs/promises";
 import { extract } from "tar";
 var pipelineAsync = promisify(pipeline);
 var STARTER_FETCH_TIMEOUT_MS = 15e3;
@@ -86,9 +89,16 @@ function compressedArchiveLimit() {
 }
 async function downloadStarter(targetDir, siteName, release = STABLE_SCAFFOLD_RELEASE, options = {}) {
   if (options.announce !== false) {
-    console.log("");
-    console.log(`  \u23F3 Creating ${siteName?.trim() || "your docs site"}...`);
+    await terminal.step(
+      `Downloading starter for ${siteName?.trim() || "your docs site"}`,
+      () => extractStarter(targetDir, release),
+      "Starter downloaded"
+    );
+    return;
   }
+  await extractStarter(targetDir, release);
+}
+async function extractStarter(targetDir, release) {
   const targetEntry = lstatSync(targetDir);
   if (!targetEntry.isDirectory() || targetEntry.isSymbolicLink()) {
     throw new Error("The Thally starter target must be a regular directory.");
@@ -137,7 +147,7 @@ async function downloadStarter(targetDir, siteName, release = STABLE_SCAFFOLD_RE
     );
     try {
       for (const entry of readdirSync(stagingDir)) {
-        cpSync(join(stagingDir, entry), join(deliveryDir, entry), {
+        await cp(join(stagingDir, entry), join(deliveryDir, entry), {
           recursive: true,
           errorOnExist: true
         });

package/dist/index.js

@@ -1,27 +1,88 @@
 #!/usr/bin/env node
 import {
-  migrateDocs,
+  migrateDocs
+} from "./chunk-IZQHRVPV.js";
+import {
   parseFrontmatter,
   runCheck
-} from "./chunk-VGGE6JIL.js";
+} from "./chunk-DIX4EUI4.js";
+import "./chunk-KDLP27DS.js";
 import {
   logo,
+  previewCommand,
   scaffold,
   slugify,
   success
-} from "./chunk-QLMRRNLL.js";
+} from "./chunk-KGKSB3PU.js";
 import "./chunk-4VKRBJV2.js";
-import "./chunk-W5WQ2V7P.js";
+import "./chunk-J7255UQA.js";
+import "./chunk-WWIATVAD.js";
 import "./chunk-RI56XMBI.js";
 import "./chunk-BP2REWTO.js";
+import {
+  acquireTerminalAccent,
+  formatHelp,
+  terminal
+} from "./chunk-L2YCVQBR.js";
 
 // src/index.ts
 import { existsSync as existsSync2, readdirSync } from "fs";
 import { createRequire } from "module";
 import { resolve as resolve2 } from "path";
 
+// src/interactive-prompts.ts
+import * as clack from "@clack/prompts";
+import * as inquirer from "@inquirer/prompts";
+async function withAccent(prompt) {
+  const release = acquireTerminalAccent();
+  try {
+    return await prompt();
+  } finally {
+    release();
+  }
+}
+function answerOrCancel(answer) {
+  if (clack.isCancel(answer)) {
+    throw Object.assign(new Error("Cancelled."), { exitCode: 130 });
+  }
+  return answer;
+}
+async function input2(options) {
+  if (!terminal.isRich) return inquirer.input(options);
+  return answerOrCancel(await withAccent(() => clack.text({
+    message: options.message.trim(),
+    initialValue: options.default,
+    // Clack otherwise finalizes an empty answer as undefined. Optional fields
+    // such as the repository URL must keep Inquirer's empty-string contract.
+    defaultValue: "",
+    validate: options.validate ? (value) => {
+      const result = options.validate(value);
+      return result === true ? void 0 : result;
+    } : void 0
+  })));
+}
+async function select3(options) {
+  if (!terminal.isRich) return inquirer.select(options);
+  return answerOrCancel(await withAccent(() => clack.select({
+    message: options.message.trim(),
+    initialValue: options.default,
+    // Every existing choice has a label, including nonprimitive values such as
+    // undefined; Clack's conditional Option type cannot infer this for a generic.
+    options: options.choices.map((choice) => ({
+      label: choice.name,
+      value: choice.value
+    }))
+  })));
+}
+async function confirm3(options) {
+  if (!terminal.isRich) return inquirer.confirm(options);
+  return answerOrCancel(await withAccent(() => clack.confirm({
+    message: options.message.trim(),
+    initialValue: options.default ?? true
+  })));
+}
+
 // src/prompts.ts
-import { confirm, input, select } from "@inquirer/prompts";
 import { basename, resolve } from "path";
 import {
   parseGitHubRepositoryUrl
@@ -43,7 +104,7 @@ async function gatherMigrationPlatform(value, useDefaults) {
     );
     return void 0;
   }
-  return select({
+  return select3({
     message: "  Which platform currently hosts these docs?",
     choices: [
       { name: "Mintlify", value: "mintlify" },
@@ -69,7 +130,7 @@ async function resolveAutoDetectedMigrationSource(sourceUrl, shouldPrompt) {
   console.warn(`
   \u26A0 ${LIVE_URL_MIGRATION_WARNING}`);
   if (!shouldPrompt) return sourceUrl;
-  const sourcePreference = await select({
+  const sourcePreference = await select3({
     message: "  Which source should Thally migrate?",
     choices: [
       {
@@ -84,14 +145,14 @@ async function resolveAutoDetectedMigrationSource(sourceUrl, shouldPrompt) {
     default: "github"
   });
   if (sourcePreference === "github") {
-    const repositoryUrl = await input({
+    const repositoryUrl = await input2({
       message: "  GitHub repository URL:",
       validate: validateGitHubRepositorySource
     });
     parseGitHubRepositoryUrl(repositoryUrl);
     return repositoryUrl;
   }
-  const hasAcceptedAlignment = await confirm({
+  const hasAcceptedAlignment = await confirm3({
     message: "  Continue knowing the migration may need manual alignment, using the Thally MCP afterward if needed?",
     default: false
   });
@@ -119,23 +180,23 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   } else if (useDefaults) {
     projectDir = resolve("my-docs");
   } else {
-    const dirName = await input({
+    const dirName = await input2({
       message: "  Project directory:",
       default: "my-docs"
     });
     projectDir = resolve(dirName);
   }
   const defaultName = basename(projectDir).replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-  const projectName = useDefaults ? defaultName : await input({
+  const projectName = useDefaults ? defaultName : await input2({
     message: "  Project name:",
     default: defaultName
   });
   const defaultDesc = `Documentation for ${projectName}.`;
-  const description = useDefaults ? defaultDesc : await input({
+  const description = useDefaults ? defaultDesc : await input2({
     message: "  Description:",
     default: defaultDesc
   });
-  const brandPreset = useDefaults ? "primary" : await select({
+  const brandPreset = useDefaults ? "primary" : await select3({
     message: "  Brand preset:",
     choices: [
       { name: "primary", value: "primary" },
@@ -143,18 +204,18 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
     ],
     default: "primary"
   });
-  const repoUrl = useDefaults ? "" : await input({
+  const repoUrl = useDefaults ? "" : await input2({
     message: "  GitHub repo URL (optional):",
     default: ""
   });
   let trackRepos;
   if (!useDefaults) {
-    const enableTrack = await input({
+    const enableTrack = await input2({
       message: "  Keep your docs in sync automatically with Thally Track? When a PR merges in a repo you list,\n  the docs agent drafts the doc updates as a PR for you to review. (y/N):",
       default: "N"
     });
     if (enableTrack.trim().toLowerCase() === "y") {
-      const reposInput = await input({
+      const reposInput = await input2({
         message: "  Which repo(s) should Thally watch? (comma-separated owner/repo or GitHub URLs, e.g. acme/api,acme/web):",
         default: ""
       });
@@ -165,7 +226,7 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   }
   let doInstall = installPreference ?? false;
   if (!useDefaults && installPreference === void 0) {
-    const shouldInstall = await input({
+    const shouldInstall = await input2({
       message: "  Install dependencies now? (y/N):",
       default: "N"
     });
@@ -173,12 +234,12 @@ async function gatherAnswers(dirArg, useDefaults, installPreference) {
   }
   let i18nLocales;
   if (!useDefaults) {
-    const enableI18n = await input({
+    const enableI18n = await input2({
       message: "  Add another documentation language? (y/N):",
       default: "N"
     });
     if (enableI18n.toLowerCase() === "y") {
-      const localesInput = await input({
+      const localesInput = await input2({
         message: "  Which additional locales? (comma-separated codes, e.g. fr,de,ja):",
         default: "fr"
       });
@@ -212,7 +273,7 @@ import { parseGitHubRepositoryUrl as parseGitHubRepositoryUrl2 } from "@thallyla
 // src/translate.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { join, dirname } from "path";
-import { input as input2 } from "@inquirer/prompts";
+import { input as input3 } from "@inquirer/prompts";
 import Anthropic from "@anthropic-ai/sdk";
 import pLimit from "p-limit";
 
@@ -480,7 +541,7 @@ ${examples.maskedSource}`
       }
     ]
   });
-  const text = message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
+  const text2 = message.content.filter((block) => block.type === "text").map((block) => block.text).join("");
   const values = [];
   for (let start = 0; start < examples.segments.length; start += 32) {
     const sourceSegments = examples.segments.slice(start, start + 32);
@@ -498,7 +559,7 @@ ${examples.maskedSource}`
     }
     values.push(...translated);
   }
-  return examples.restore(text.trim(), values);
+  return examples.restore(text2.trim(), values);
 }
 async function runTranslateCommand(locale, pages, force, apiKey, model, yes, projectDir) {
   const config = readDocsJson(projectDir);
@@ -569,11 +630,11 @@ async function runTranslateCommand(locale, pages, force, apiKey, model, yes, pro
   }
   console.log("");
   if (!yes) {
-    const confirm2 = await input2({
+    const confirm4 = await input3({
       message: "  Proceed? (Y/n):",
       default: "Y"
     });
-    if (confirm2.toLowerCase() === "n") {
+    if (confirm4.toLowerCase() === "n") {
       console.log("\n  Aborted.");
       return;
     }
@@ -632,7 +693,7 @@ var valueFlags = /* @__PURE__ */ new Set([
   "--platform"
 ]);
 var commandFlags = {
-  scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install"]),
+  scaffold: /* @__PURE__ */ new Set(["--help", "-h", "--yes", "-y", "--install", "--no-install", "--verbose"]),
   migrate: /* @__PURE__ */ new Set([
     "--help",
     "-h",
@@ -643,6 +704,7 @@ var commandFlags = {
     "--max-pages",
     "--platform",
     "--skip-validation",
+    "--verbose",
     "--yes",
     "-y"
   ]),
@@ -673,6 +735,7 @@ Scaffold options:
   -y, --yes       Accept defaults and skip interactive prompts
   --install       Install project dependencies after scaffolding
   --no-install    Skip dependency installation without prompting
+  --verbose       Show detailed installation and Git output
   -h, --help      Show this help
   -v, -V, --version  Show the installed version
 
@@ -690,6 +753,7 @@ Options:
   --max-pages <count>  Limit a public URL crawl to 1-1000 pages
   --platform <name>    Use mintlify, docusaurus, fern, or auto
   --skip-validation   Import only; explicitly skip content and build verification
+  --verbose           Show detailed installation, build, and Git output
   --api-key <key>      Anthropic API key for non-Markdown conversion
   -y, --yes            Skip interactive prompts
   -h, --help           Show this help
@@ -743,7 +807,7 @@ function resolveCommand(subcommand) {
   return "scaffold";
 }
 function printHelp(command) {
-  console.log(command === "scaffold" ? mainHelp : commandHelp[command]);
+  console.log(formatHelp(command === "scaffold" ? mainHelp : commandHelp[command]));
 }
 function validateFlags(command) {
   const unknownFlag = flags.find((flag) => !commandFlags[command].has(flag));
@@ -772,10 +836,11 @@ async function runMigrateCommand() {
   const branch = getFlagValue("--branch");
   const docsDir = getFlagValue("--docs-dir");
   const yes = flags.includes("--yes") || flags.includes("-y");
+  terminal.intro("migrate", packageMetadata.version, "Bring your docs to Thally. Built for people and AI tools.");
   const platformFlag = getFlagValue("--platform");
   const platform = await gatherMigrationPlatform(platformFlag, yes);
   if (platform === void 0) {
-    const shouldPromptForSource = platformFlag === void 0 && !yes;
+    const shouldPromptForSource = platformFlag === void 0 && !yes && Boolean(process.stdin.isTTY);
     sourceUrl = await resolveAutoDetectedMigrationSource(sourceUrl, shouldPromptForSource);
     source = new URL(sourceUrl);
   }
@@ -797,15 +862,11 @@ async function runMigrateCommand() {
     console.error("\n  \u274C --max-pages must be an integer between 1 and 1000.");
     process.exit(1);
   }
-  logo();
-  console.log("  \u{1F680} Thally Migrate");
-  console.log("");
-  console.log(`  Source:  ${sourceUrl}`);
-  console.log(`  Target:  ${projectDir}`);
-  if (branch) console.log(`  Branch:  ${branch}`);
-  if (docsDir) console.log(`  Docs dir: ${docsDir}`);
-  console.log(`  Platform: ${platform ?? "auto-detect"}`);
-  console.log("");
+  terminal.detail("Source", `${source.origin}${source.pathname}`);
+  terminal.detail("Output", projectDir);
+  if (branch) terminal.detail("Branch", branch);
+  if (docsDir) terminal.detail("Docs dir", docsDir);
+  terminal.detail("Platform", platform ?? "auto-detect");
   const result = await migrateDocs({
     sourceUrl,
     projectDir,
@@ -818,14 +879,20 @@ async function runMigrateCommand() {
     yes,
     skipValidation: flags.includes("--skip-validation")
   });
-  console.log("");
-  console.log(`  Migrated docs: ${result.projectDir}`);
-  const quotedDir = process.platform === "win32" ? `"${result.projectDir.replace(/"/g, '""')}"` : `'${result.projectDir.replace(/'/g, "'\\''")}'`;
-  console.log(`  To preview: cd ${quotedDir} && npm run dev`);
+  terminal.section("Migration summary", [
+    `${result.pagesWritten} pages \xB7 ${result.assetsWritten} assets \xB7 ${result.platform}`,
+    `Content: ${result.validation.content} \xB7 Build: ${result.validation.build}`,
+    `${result.warnings.length} migration warning(s)`
+  ]);
+  terminal.detail("Output", result.projectDir);
+  terminal.detail("Report", result.reportPath);
+  const isVerified = result.validation.content === "passed" && result.validation.build === "passed";
+  terminal.outro(isVerified ? "Migration verified. Review any warnings before publishing." : "Import saved. Validation is incomplete; review the migration report.");
+  terminal.nextAction("Preview locally", previewCommand(result.projectDir, !existsSync2(resolve2(result.projectDir, "node_modules"))));
   if (result.validation.content === "failed" || result.validation.build === "failed") process.exitCode = 1;
 }
 async function runScaffoldCommand() {
-  const useDefaults = flags.includes("--yes") || flags.includes("-y");
+  const useDefaults = flags.includes("--yes") || flags.includes("-y") || !process.stdin.isTTY;
   const installPreference = flags.includes("--install") ? true : flags.includes("--no-install") ? false : void 0;
   const dirArg = positional[0];
   if (dirArg) {
@@ -873,9 +940,7 @@ async function runTranslateSubcommand() {
   const model = getFlagValue("--model") ?? "claude-sonnet-4-6";
   const yes = flags.includes("--yes") || flags.includes("-y");
   const projectDir = resolve2(positional[1] ?? ".");
-  logo();
-  console.log("  \u{1F310} Thally Translate");
-  console.log("");
+  terminal.intro("translate", packageMetadata.version, "Make your docs available in another language.");
   await runTranslateCommand(locale, pages, force, apiKey, model, yes, projectDir);
 }
 async function main() {
@@ -897,11 +962,11 @@ async function main() {
   } else if (subcommand === "translate") {
     await runTranslateSubcommand();
   } else {
-    logo();
+    logo(packageMetadata.version);
     await runScaffoldCommand();
   }
 }
 main().catch((err) => {
-  console.error("\n  \u274C Error:", err.message);
-  process.exit(1);
+  terminal.error(err.message);
+  process.exit(err.exitCode ?? 1);
 });