cnippet-stack 0.1.0 → 0.2.1

package/dist/index.js

@@ -557,7 +557,7 @@ var require_logger = __commonJS({
         return level;
       },
       // Can be overridden in the host environment
-      log: function log2(level) {
+      log: function log3(level) {
         level = logger.lookupLevel(level);
         if (typeof console !== "undefined" && logger.lookupLevel(logger.level) <= level) {
           var method = logger.methodMap[level];
@@ -738,8 +738,8 @@ var require_base = __commonJS({
         _internalProtoAccess.resetLoggedProperties();
       }
     };
-    var log2 = _logger2["default"].log;
-    exports.log = log2;
+    var log3 = _logger2["default"].log;
+    exports.log = log3;
     exports.createFrame = _utils.createFrame;
     exports.logger = _logger2["default"];
   }
@@ -5927,12 +5927,20 @@ var require_lib = __commonJS({
 });
 
 // src/program.ts
+import * as clack3 from "@clack/prompts";
 import { Command } from "commander";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
+
+// src/commands/doctor.ts
+function runDoctor(recipe) {
+  console.log(
+    `\`cnippet-stack doctor ${recipe}\` isn't implemented yet \u2014 post-install verification lands in Phase 7.`
+  );
+}
 
 // src/commands/init.ts
 import * as clack2 from "@clack/prompts";
-import pc2 from "picocolors";
+import pc3 from "picocolors";
 
 // src/compat.ts
 var CompatibilityError = class extends Error {
@@ -5972,10 +5980,12 @@ function checkCompatibility(detection, supports) {
     );
   }
 }
+function isRequireSatisfied(required, detection) {
+  return required === "prisma" && detection.orm === "prisma";
+}
 function checkRequires(recipeName, requires, detection) {
   for (const required of requires) {
-    const satisfied = required === "prisma" && detection.orm === "prisma";
-    if (!satisfied) {
+    if (!isRequireSatisfied(required, detection)) {
       throw new CompatibilityError(
         `"${recipeName}" requires "${required}" to be installed first. Run \`cnippet-stack init ${required}\` first, then re-run this command.`
       );
@@ -6215,6 +6225,7 @@ function toTemplateContext(detection) {
 import fs9 from "fs";
 import { spawnSync } from "child_process";
 import path9 from "path";
+import { parseDocument, Document } from "yaml";
 function parseDependencySpec(spec) {
   const atIndex = spec.lastIndexOf("@");
   if (atIndex <= 0) return { name: spec, range: "latest" };
@@ -6256,6 +6267,68 @@ function mergePackageJsonDeps(cwd, dependencies, devDependencies) {
   }
   return changed;
 }
+function findPnpmWorkspaceFile(cwd) {
+  let dir = path9.resolve(cwd);
+  for (; ; ) {
+    const candidate = path9.join(dir, "pnpm-workspace.yaml");
+    if (fs9.existsSync(candidate)) return candidate;
+    const parent = path9.dirname(dir);
+    if (parent === dir) return path9.join(path9.resolve(cwd), "pnpm-workspace.yaml");
+    dir = parent;
+  }
+}
+function mergeTrustedBuildScripts(cwd, packageManager, trusted) {
+  if (trusted.length === 0) return false;
+  if (packageManager === "pnpm") {
+    const file = findPnpmWorkspaceFile(cwd);
+    const doc = fs9.existsSync(file) ? parseDocument(fs9.readFileSync(file, "utf8")) : new Document({});
+    const contents = doc.toJS() ?? {};
+    const list = new Set(contents.onlyBuiltDependencies ?? []);
+    const allow = { ...contents.allowBuilds };
+    let changed = !fs9.existsSync(file);
+    for (const name of trusted) {
+      if (!list.has(name)) {
+        list.add(name);
+        changed = true;
+      }
+      if (typeof allow[name] !== "boolean") {
+        allow[name] = true;
+        changed = true;
+      }
+    }
+    if (!changed) return false;
+    doc.set("onlyBuiltDependencies", [...list]);
+    doc.set("allowBuilds", allow);
+    fs9.writeFileSync(file, doc.toString(), "utf8");
+    return true;
+  }
+  if (packageManager === "bun") {
+    const file = path9.join(cwd, "package.json");
+    const pkg = JSON.parse(fs9.readFileSync(file, "utf8"));
+    pkg.trustedDependencies ??= [];
+    let changed = false;
+    for (const name of trusted) {
+      if (!pkg.trustedDependencies.includes(name)) {
+        pkg.trustedDependencies.push(name);
+        changed = true;
+      }
+    }
+    if (changed) {
+      fs9.writeFileSync(file, `${JSON.stringify(pkg, null, 2)}
+`, "utf8");
+    }
+    return changed;
+  }
+  return false;
+}
+function parseIgnoredBuilds(output) {
+  const match = /Ignored build scripts: ([^\n]+)/.exec(output);
+  if (!match?.[1]) return [];
+  return match[1].split(",").map((entry) => entry.trim()).filter(Boolean).map((entry) => {
+    const atIndex = entry.lastIndexOf("@");
+    return atIndex > 0 ? entry.slice(0, atIndex) : entry;
+  });
+}
 function envWithLocalBin(cwd) {
   const pathKey = Object.keys(process.env).find((key) => key.toLowerCase() === "path") ?? "PATH";
   const existing = process.env[pathKey] ?? "";
@@ -6266,13 +6339,14 @@ function envWithLocalBin(cwd) {
   };
 }
 var defaultCommandRunner = (command, args, cwd) => {
-  const result = spawnSync(command, args, {
+  const result = spawnSync([command, ...args].join(" "), {
     cwd,
+    encoding: "utf8",
     env: envWithLocalBin(cwd),
-    shell: true,
-    stdio: "inherit"
+    shell: true
   });
-  return { status: result.status };
+  const output = `${result.stdout ?? ""}${result.stderr ?? ""}`;
+  return { output, status: result.status };
 };
 function runInstallCommand(cwd, packageManager, runner = defaultCommandRunner) {
   const { command, args } = installCommandFor(packageManager);
@@ -6540,6 +6614,7 @@ function applyCreate(cwd, file, options) {
 // src/installer/index.ts
 function applyInstall(plan, options) {
   const runner = options.runner ?? defaultCommandRunner;
+  const progress = options.progress ?? {};
   const files = [];
   for (const file of plan.renderedFiles) {
     if (file.strategy === "create") {
@@ -6572,25 +6647,58 @@ function applyInstall(plan, options) {
     plan.manifest.dependencies,
     plan.manifest.devDependencies
   );
-  let depsInstallFailed = false;
+  let depsInstall = {
+    ignoredBuilds: [],
+    status: "not-needed"
+  };
   if (depsChanged) {
+    mergeTrustedBuildScripts(
+      options.cwd,
+      options.detection.packageManager,
+      plan.manifest.trustedBuildScripts ?? []
+    );
+    progress.onDepsStart?.(options.detection.packageManager);
     const depsResult = runInstallCommand(
       options.cwd,
       options.detection.packageManager,
       runner
     );
-    depsInstallFailed = depsResult.status !== 0;
+    const output = depsResult.output;
+    const ignoredBuilds = output ? parseIgnoredBuilds(output) : [];
+    if (depsResult.status === 0) {
+      depsInstall = { ignoredBuilds, output, status: "ok" };
+    } else if (ignoredBuilds.length > 0) {
+      depsInstall = { ignoredBuilds, output, status: "ignored-builds" };
+    } else {
+      depsInstall = { ignoredBuilds: [], output, status: "failed" };
+    }
+    progress.onDepsDone?.(depsInstall);
   }
+  const depsUsable = depsInstall.status !== "failed";
   const postInstall = plan.postInstall.map((step) => {
-    if (depsInstallFailed) {
-      return { ...step, status: "skipped" };
+    if (!depsUsable) {
+      const skipped = { ...step, status: "skipped" };
+      progress.onStepDone?.(skipped);
+      return skipped;
     }
     const [command, ...args] = step.command.split(" ");
-    if (!command) return { ...step, status: "skipped" };
+    if (!command) {
+      const skipped = { ...step, status: "skipped" };
+      progress.onStepDone?.(skipped);
+      return skipped;
+    }
+    progress.onStepStart?.(step);
     const result = runner(command, args, options.cwd);
-    return { ...step, status: result.status === 0 ? "ok" : "failed" };
+    const done = {
+      ...step,
+      output: result.output,
+      status: result.status === 0 ? "ok" : "failed"
+    };
+    progress.onStepDone?.(done);
+    return done;
   });
   return {
+    depsInstall,
     envVarsWritten,
     files,
     manualSteps: plan.manualSteps.map((s) => ({
@@ -6598,6 +6706,7 @@ function applyInstall(plan, options) {
       description: s.description,
       title: s.title
     })),
+    packageManager: options.detection.packageManager,
     postInstall,
     recipe: options.recipe
   };
@@ -10791,6 +10900,13 @@ var RecipeManifest = external_exports.object({
     router: external_exports.array(external_exports.enum(["app"]))
   }),
   tier: external_exports.enum(["free", "pro"]),
+  // Packages whose install-time build scripts this recipe vouches for.
+  // pnpm 10+ and bun block postinstall scripts by default; the CLI merges
+  // these into `pnpm.onlyBuiltDependencies` / `trustedDependencies` in the
+  // target package.json so e.g. `prisma generate` works out of the box.
+  // Optional (not defaulted) so manifests published before this field parse
+  // unchanged over the wire.
+  trustedBuildScripts: external_exports.array(external_exports.string()).optional(),
   title: external_exports.string(),
   version: external_exports.string()
 });
@@ -11489,11 +11605,189 @@ var HttpRegistrySource = class {
   }
 };
 
+// src/ui.ts
+import pc2 from "picocolors";
+var FILE_STATUS_LABEL = {
+  appended: "appended",
+  created: "created",
+  injected: "injected",
+  overwritten: "overwritten",
+  skipped: "skipped"
+};
+var FILE_STATUS_COLOR = {
+  appended: pc2.yellow,
+  created: pc2.green,
+  injected: pc2.yellow,
+  overwritten: pc2.yellow,
+  skipped: pc2.dim
+};
+function renderAppliedFiles(result) {
+  const lines = [];
+  for (const file of result.files) {
+    const color = FILE_STATUS_COLOR[file.status];
+    lines.push(
+      `${color(FILE_STATUS_LABEL[file.status].padEnd(16))} ${file.target}`
+    );
+  }
+  if (result.envVarsWritten.length > 0) {
+    lines.push(
+      `${pc2.cyan("env vars".padEnd(16))} ${result.envVarsWritten.join(", ")}`
+    );
+  }
+  return lines.join("\n");
+}
+function tailOf(output, maxLines) {
+  const lines = output.trimEnd().split(/\r?\n/);
+  return lines.slice(-maxLines).join("\n");
+}
+function execPrefix(packageManager) {
+  const table = {
+    bun: "bunx",
+    npm: "npx",
+    pnpm: "pnpm exec",
+    yarn: "yarn"
+  };
+  return table[packageManager];
+}
+function buildNextSteps(results) {
+  const steps = [];
+  const ignoredBuilds = [
+    ...new Set(results.flatMap((r) => r.depsInstall.ignoredBuilds))
+  ];
+  const pm = results[0]?.packageManager ?? "npm";
+  if (ignoredBuilds.length > 0 && pm === "pnpm") {
+    steps.push({
+      detail: `pnpm blocked install scripts for ${ignoredBuilds.join(", ")}. Approve the ones you trust, then re-run \`pnpm install\`.`,
+      required: false,
+      title: `Run ${pc2.bold("pnpm approve-builds")} to allow blocked build scripts`
+    });
+  }
+  for (const result of results) {
+    for (const step of result.postInstall) {
+      if (step.status === "ok") continue;
+      const command = `${execPrefix(result.packageManager)} ${step.command}`;
+      steps.push({
+        detail: step.status === "failed" ? `The command failed during install \u2014 fix the error above and re-run it.` : `Skipped because dependency install failed. Install dependencies, then run it.`,
+        required: true,
+        title: `Run ${pc2.bold(command)} \u2014 ${step.description}`
+      });
+    }
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const manual = results.flatMap((r) => r.manualSteps).filter((s) => seen.has(s.title) ? false : (seen.add(s.title), true));
+  for (const step of manual.filter((s) => s.blocking)) {
+    steps.push({ detail: step.description, required: true, title: step.title });
+  }
+  for (const step of manual.filter((s) => !s.blocking)) {
+    steps.push({
+      detail: step.description,
+      required: false,
+      title: step.title
+    });
+  }
+  return steps;
+}
+function renderNextSteps(steps) {
+  const lines = [];
+  steps.forEach((step, index) => {
+    const number = `${index + 1}.`.padEnd(3);
+    const badge = step.required ? pc2.red("required") : pc2.dim("optional");
+    lines.push(`${pc2.bold(number)}${step.title} ${badge}`);
+    if (step.detail) {
+      lines.push(pc2.dim(`   ${step.detail}`));
+    }
+  });
+  return lines.join("\n");
+}
+
 // src/commands/init.ts
+function clackProgress() {
+  const spin = clack2.spinner();
+  let depsPm = "";
+  return {
+    onDepsStart: (packageManager) => {
+      depsPm = packageManager;
+      spin.start(`Installing dependencies with ${packageManager}`);
+    },
+    onDepsDone: (outcome) => {
+      if (outcome.status === "ok") {
+        spin.stop(`Dependencies installed with ${depsPm}`);
+        return;
+      }
+      if (outcome.status === "ignored-builds") {
+        spin.stop(
+          `Dependencies installed \u2014 build scripts blocked for ${pc3.bold(
+            outcome.ignoredBuilds.join(", ")
+          )} (see next steps)`
+        );
+        return;
+      }
+      spin.stop(pc3.red("Dependency install failed"), 2);
+      if (outcome.output) {
+        clack2.log.error(pc3.dim(tailOf(outcome.output, 20)));
+      }
+    },
+    onStepStart: (step) => {
+      spin.start(step.description);
+    },
+    onStepDone: (step) => {
+      if (step.status === "ok") {
+        spin.stop(`${step.description} ${pc3.dim(`(${step.command})`)}`);
+      } else if (step.status === "failed") {
+        spin.stop(
+          pc3.red(`${step.description} failed ${pc3.dim(`(${step.command})`)}`),
+          2
+        );
+      } else {
+        clack2.log.warn(
+          `Skipped: ${step.description} ${pc3.dim(`(${step.command})`)}`
+        );
+      }
+    }
+  };
+}
 async function runInit(options) {
   const source = options.registrySource ?? new LocalRegistrySource();
-  const detection = detectProject(options.cwd);
+  let detection = detectProject(options.cwd);
   const manifest = await source.getManifest(options.recipe);
+  const interactive = !options.yes && !options.json && !options.dryRun;
+  const chained = [];
+  const missing = manifest.requires.filter(
+    (required) => !isRequireSatisfied(required, detection)
+  );
+  if (missing.length > 0 && interactive) {
+    for (const required of missing) {
+      if (options.chain?.includes(required)) {
+        throw new CompatibilityError(
+          `Recipe dependency cycle detected: ${[...options.chain, options.recipe, required].join(" -> ")}.`
+        );
+      }
+    }
+    clack2.log.warn(
+      `${pc3.bold(options.recipe)} requires ${pc3.bold(missing.join(", "))}, which isn't set up in this project yet.`
+    );
+    const install = await clack2.confirm({
+      message: `Set up ${missing.join(", ")} now, then continue with ${options.recipe}?`
+    });
+    if (clack2.isCancel(install) || !install) {
+      throw new CompatibilityError(
+        `"${options.recipe}" requires "${missing.join('", "')}" to be installed first. Run \`cnippet-stack init ${missing[0]}\` first, then re-run this command.`
+      );
+    }
+    for (const required of missing) {
+      const sub = await runInit({
+        ...options,
+        answers: void 0,
+        chain: [...options.chain ?? [], options.recipe],
+        recipe: required
+      });
+      chained.push(sub);
+    }
+    detection = detectProject(options.cwd);
+    clack2.log.success(
+      `${pc3.bold(missing.join(", "))} installed \u2014 continuing with ${pc3.bold(options.recipe)}.`
+    );
+  }
   checkCompatibility(detection, manifest.supports);
   checkRequires(options.recipe, manifest.requires, detection);
   const suppliedAnswers = options.answers !== void 0 ? JSON.parse(options.answers) : void 0;
@@ -11511,15 +11805,21 @@ async function runInit(options) {
   if (options.dryRun) {
     if (!options.json) {
       clack2.log.info(
-        `Install plan for ${pc2.bold(options.recipe)} (dry run \u2014 nothing written):`
+        `Install plan for ${pc3.bold(options.recipe)} (dry run \u2014 nothing written):`
       );
-      console.log(renderPreview(preview));
+      clack2.log.message(renderPreview(preview));
     }
-    return { applied: false, preview, recipeVersion: plan.manifest.version };
+    return {
+      applied: false,
+      chained,
+      preview,
+      recipe: options.recipe,
+      recipeVersion: plan.manifest.version
+    };
   }
   if (!options.yes && !options.json) {
-    clack2.log.info(`Install plan for ${pc2.bold(options.recipe)}:`);
-    console.log(renderPreview(preview));
+    clack2.log.step(`Install plan for ${pc3.bold(options.recipe)}`);
+    clack2.log.message(renderPreview(preview));
     const confirmed = await clack2.confirm({ message: "Apply these changes?" });
     if (clack2.isCancel(confirmed) || !confirmed) {
       throw new PromptCancelledError();
@@ -11529,22 +11829,28 @@ async function runInit(options) {
     cwd: options.cwd,
     detection,
     overwrite: options.overwrite ?? false,
+    progress: options.json ? void 0 : clackProgress(),
     recipe: options.recipe,
     runner: options.runner,
     timestamp: (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")
   });
-  return { applied: true, preview, recipeVersion: plan.manifest.version, result };
-}
-
-// src/commands/doctor.ts
-function runDoctor(recipe) {
-  console.log(
-    `\`cnippet-stack doctor ${recipe}\` isn't implemented yet \u2014 post-install verification lands in Phase 7.`
-  );
+  if (!options.json) {
+    clack2.log.success(`${pc3.bold(options.recipe)} applied`);
+    const fileLines = renderAppliedFiles(result);
+    if (fileLines) clack2.log.message(fileLines);
+  }
+  return {
+    applied: true,
+    chained,
+    preview,
+    recipe: options.recipe,
+    recipeVersion: plan.manifest.version,
+    result
+  };
 }
 
 // src/commands/list.ts
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 async function runList(options = {}) {
   const source = options.registrySource ?? new LocalRegistrySource();
   const recipes = await source.list();
@@ -11557,15 +11863,15 @@ async function runList(options = {}) {
     return;
   }
   for (const recipe of recipes) {
-    const tier = recipe.tier === "pro" ? pc3.magenta("[pro]") : pc3.green("[free]");
-    console.log(`${pc3.bold(recipe.name)} ${tier} \u2014 ${recipe.title}`);
-    console.log(`  ${pc3.dim(recipe.description)}`);
+    const tier = recipe.tier === "pro" ? pc4.magenta("[pro]") : pc4.green("[free]");
+    console.log(`${pc4.bold(recipe.name)} ${tier} \u2014 ${recipe.title}`);
+    console.log(`  ${pc4.dim(recipe.description)}`);
   }
 }
 
 // src/commands/login.ts
 import { spawn } from "child_process";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 function resolveBaseUrl(options) {
   return options.registry ?? process.env.CNIPPET_REGISTRY_URL ?? DEFAULT_REGISTRY_URL;
 }
@@ -11598,11 +11904,11 @@ async function runLogin(options = {}) {
   }
   const start = await startRes.json();
   console.log(`
-Go to: ${pc4.bold(pc4.cyan(start.verificationUrl))}`);
-  console.log(`Confirm this code: ${pc4.bold(start.code)}
+Go to: ${pc5.bold(pc5.cyan(start.verificationUrl))}`);
+  console.log(`Confirm this code: ${pc5.bold(start.code)}
 `);
   openBrowser(start.verificationUrl);
-  console.log(pc4.dim("Waiting for approval..."));
+  console.log(pc5.dim("Waiting for approval..."));
   const deadline = Date.now() + start.expiresIn * 1e3;
   while (Date.now() < deadline) {
     await sleep(2e3);
@@ -11618,7 +11924,7 @@ Go to: ${pc4.bold(pc4.cyan(start.verificationUrl))}`);
     const poll = await pollRes.json();
     if (poll.status === "approved" && poll.token) {
       saveCliConfig({ baseUrl, token: poll.token });
-      console.log(pc4.green("\u2714 Logged in."));
+      console.log(pc5.green("\u2714 Logged in."));
       return;
     }
   }
@@ -11626,7 +11932,7 @@ Go to: ${pc4.bold(pc4.cyan(start.verificationUrl))}`);
 }
 
 // src/commands/logout.ts
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 async function runLogout() {
   const config = loadCliConfig();
   if (!config) {
@@ -11641,11 +11947,11 @@ async function runLogout() {
   } catch {
   }
   clearCliConfig();
-  console.log(pc5.green("\u2714 Logged out."));
+  console.log(pc6.green("\u2714 Logged out."));
 }
 
 // src/commands/whoami.ts
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 async function runWhoami() {
   const config = loadCliConfig();
   if (!config) {
@@ -11657,23 +11963,24 @@ async function runWhoami() {
   });
   if (!res.ok) {
     console.log(
-      pc6.red("\u2716 Session is no longer valid."),
+      pc7.red("\u2716 Session is no longer valid."),
       "Run `cnippet-stack login` again."
     );
     return;
   }
   const whoami = await res.json();
-  console.log(`${pc6.bold(whoami.name)} <${whoami.email}>`);
+  console.log(`${pc7.bold(whoami.name)} <${whoami.email}>`);
   console.log(
-    whoami.hasActiveLicense ? pc6.green("License: active") : pc6.dim("License: none \u2014 pro recipes require a license.")
+    whoami.hasActiveLicense ? pc7.green("License: active") : pc7.dim("License: none \u2014 pro recipes require a license.")
   );
 }
 
 // src/program.ts
 function resolveRegistrySource(opts) {
   if (opts.localRegistry) return new LocalRegistrySource();
-  const url = opts.registry ?? process.env.CNIPPET_REGISTRY_URL;
-  return url ? new HttpRegistrySource(url) : void 0;
+  return new HttpRegistrySource(
+    opts.registry ?? process.env.CNIPPET_REGISTRY_URL ?? DEFAULT_REGISTRY_URL
+  );
 }
 function sendTelemetry(registrySource, event) {
   if (process.env.CNIPPET_TELEMETRY === "0") return;
@@ -11686,46 +11993,31 @@ function sendTelemetry(registrySource, event) {
   }).catch(() => {
   });
 }
+function collectResults(outcome) {
+  return [
+    ...outcome.chained.flatMap(collectResults),
+    ...outcome.applied && outcome.result ? [outcome.result] : []
+  ];
+}
 function reportOutcome(outcome, json) {
   if (json) {
     console.log(JSON.stringify(outcome, null, 2));
     return;
   }
-  if (!outcome.applied || !outcome.result) return;
-  console.log(`
-${pc7.green("Done.")}`);
-  for (const file of outcome.result.files) {
-    console.log(`  ${pc7.dim(file.status)} ${file.target}`);
-  }
-  if (outcome.result.envVarsWritten.length > 0) {
-    console.log(
-      `  env vars written: ${outcome.result.envVarsWritten.join(", ")}`
-    );
-  }
-  if (outcome.result.postInstall.length > 0) {
-    console.log(`
-${pc7.bold("Post-install:")}`);
-    for (const step of outcome.result.postInstall) {
-      if (step.status === "ok") {
-        console.log(`  ${pc7.green("\u2713")} ${step.description} (${step.command})`);
-      } else {
-        const reason = step.status === "skipped" ? "skipped \u2014 dependency install failed" : "failed";
-        console.log(
-          `  ${pc7.red("\u2716")} ${step.description} \u2014 ${reason}. Run \`${step.command}\` yourself once dependencies are installed.`
-        );
-      }
-    }
+  if (!outcome.applied || !outcome.result) {
+    clack3.outro(pc8.dim("Dry run \u2014 nothing was written."));
+    return;
   }
-  if (outcome.result.manualSteps.length > 0) {
-    console.log(`
-${pc7.bold("Manual steps:")}`);
-    for (const step of outcome.result.manualSteps) {
-      console.log(
-        `  ${step.blocking ? pc7.red("[required]") : pc7.dim("[optional]")} ${step.title}`
-      );
-      console.log(`    ${step.description}`);
-    }
+  const steps = buildNextSteps(collectResults(outcome));
+  if (steps.length > 0) {
+    clack3.log.step(pc8.bold("Next steps"));
+    clack3.log.message(renderNextSteps(steps));
   }
+  const installed = [
+    ...outcome.chained.map((sub) => sub.recipe),
+    outcome.recipe
+  ];
+  clack3.outro(pc8.green(`${installed.join(" + ")} installed \u2714`));
 }
 function createProgram() {
   const program = new Command();
@@ -11752,12 +12044,17 @@ function createProgram() {
   ).action(async (recipe, opts) => {
     const registrySource = resolveRegistrySource(opts);
     const startedAt = Date.now();
-    if (!opts.json && !opts.dryRun) {
-      console.log(
-        pc7.dim(
-          "Anonymous usage data is sent to help improve cnippet \u2014 set CNIPPET_TELEMETRY=0 to opt out."
-        )
+    if (!opts.json) {
+      clack3.intro(
+        `${pc8.bgCyan(pc8.black(" cnippet-stack "))} ${pc8.dim(`v${cliVersion()}`)}`
       );
+      if (!opts.dryRun) {
+        clack3.log.message(
+          pc8.dim(
+            "Anonymous usage data is sent to help improve cnippet \u2014 set CNIPPET_TELEMETRY=0 to opt out."
+          )
+        );
+      }
     }
     try {
       const outcome = await runInit({
@@ -11788,17 +12085,20 @@ function createProgram() {
         });
       }
       if (error instanceof CompatibilityError) {
-        console.error(pc7.red(`\u2716 ${error.message}`));
+        if (opts.json) console.error(pc8.red(`\u2716 ${error.message}`));
+        else clack3.cancel(error.message);
         process.exitCode = 1;
         return;
       }
       if (error instanceof PromptCancelledError) {
-        console.log(pc7.dim("Aborted \u2014 nothing was changed."));
+        if (opts.json) console.log(pc8.dim("Aborted \u2014 nothing was changed."));
+        else clack3.cancel("Aborted \u2014 nothing was changed.");
         process.exitCode = 1;
         return;
       }
       if (error instanceof RegistryHttpError) {
-        console.error(pc7.red(`\u2716 ${error.message}`));
+        if (opts.json) console.error(pc8.red(`\u2716 ${error.message}`));
+        else clack3.cancel(error.message);
         process.exitCode = 1;
         return;
       }
@@ -11814,10 +12114,13 @@ function createProgram() {
     false
   ).action(async (opts) => {
     try {
-      await runList({ json: opts.json, registrySource: resolveRegistrySource(opts) });
+      await runList({
+        json: opts.json,
+        registrySource: resolveRegistrySource(opts)
+      });
     } catch (error) {
       if (error instanceof RegistryHttpError) {
-        console.error(pc7.red(`\u2716 ${error.message}`));
+        console.error(pc8.red(`\u2716 ${error.message}`));
         process.exitCode = 1;
         return;
       }
@@ -11835,7 +12138,7 @@ function createProgram() {
       await runLogin({ registry: opts.registry });
     } catch (error) {
       if (error instanceof LoginError) {
-        console.error(pc7.red(`\u2716 ${error.message}`));
+        console.error(pc8.red(`\u2716 ${error.message}`));
         process.exitCode = 1;
         return;
       }

package/package.json

@@ -4,13 +4,14 @@
     "cnippet-stack": "./dist/index.js"
   },
   "bugs": "https://github.com/cnippet-dev/cnippet-stack/issues",
-  "description": "CLI that installs full integrations (auth, payments, email, storage) into your existing Next.js app — detection, prompts, safe file injection, env setup.",
   "dependencies": {
     "@clack/prompts": "^0.10.0",
     "commander": "^13.1.0",
     "picocolors": "^1.1.1",
-    "ts-morph": "^25.0.1"
+    "ts-morph": "^25.0.1",
+    "yaml": "^2.9.0"
   },
+  "description": "CLI that installs full integrations (auth, payments, email, storage) into your existing Next.js app — detection, prompts, safe file injection, env setup.",
   "devDependencies": {
     "@cnippet/registry": "workspace:*",
     "@cnippet/validators": "workspace:*",
@@ -49,9 +50,9 @@
     "access": "public"
   },
   "repository": {
+    "directory": "packages/cli",
     "type": "git",
-    "url": "git+https://github.com/cnippet-dev/cnippet-stack.git",
-    "directory": "packages/cli"
+    "url": "git+https://github.com/cnippet-dev/cnippet-stack.git"
   },
   "scripts": {
     "build": "tsup",
@@ -62,5 +63,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.1.0"
+  "version": "0.2.1"
 }