libretto 0.6.12 → 0.6.13

package/src/cli/commands/setup.ts

@@ -1,383 +1,15 @@
-import { createInterface } from "node:readline";
 import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { writeSnapshotModel } from "../core/config.js";
 import {
   ensureLibrettoSetup,
   LIBRETTO_CONFIG_PATH,
   REPO_ROOT,
 } from "../core/context.js";
-import {
-  type AiSetupStatus,
-  DEFAULT_SNAPSHOT_MODELS,
-  resolveAiSetupStatus,
-} from "../core/ai-model.js";
-import {
-  detectProjectPackageManager,
-  installCommand,
-  librettoCommand,
-} from "../../shared/package-manager.js";
-import type { Provider } from "../core/resolve-model.js";
+import { librettoCommand } from "../../shared/package-manager.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 
-const PROVIDER_SDK_PACKAGES: Record<Provider, string> = {
-  openai: "@ai-sdk/openai",
-  anthropic: "@ai-sdk/anthropic",
-  google: "@ai-sdk/google",
-  vertex: "@ai-sdk/google-vertex",
-  openrouter: "@ai-sdk/openai",
-};
-
-function isSdkInstalled(sdkPackage: string): boolean {
-  try {
-    const result = spawnSync("node", ["-e", `require.resolve("${sdkPackage}")`], {
-      cwd: REPO_ROOT,
-      stdio: "pipe",
-    });
-    return result.status === 0;
-  } catch {
-    return false;
-  }
-}
-
-function installSdkIfNeeded(provider: Provider): void {
-  const sdkPackage = PROVIDER_SDK_PACKAGES[provider];
-  if (isSdkInstalled(sdkPackage)) return;
-
-  const pkgManager = detectProjectPackageManager();
-  const cmd = installCommand(pkgManager);
-  console.log(`\nInstalling ${sdkPackage}...`);
-  const result = spawnSync(cmd, [sdkPackage], {
-    cwd: REPO_ROOT,
-    stdio: "inherit",
-    shell: true,
-  });
-  if (result.status === 0) {
-    console.log(`✓ Installed ${sdkPackage}`);
-  } else {
-    console.error(
-      `✗ Failed to install ${sdkPackage}. Install it manually: ${cmd} ${sdkPackage}`,
-    );
-  }
-}
-
-export type ProviderChoice = {
-  key: string;
-  label: string;
-  provider: Provider;
-  envVar: string;
-  envHint: string;
-};
-
-export const PROVIDER_CHOICES: ProviderChoice[] = [
-  {
-    key: "1",
-    label: "OpenAI",
-    provider: "openai",
-    envVar: "OPENAI_API_KEY",
-    envHint: "Get your key at https://platform.openai.com/api-keys",
-  },
-  {
-    key: "2",
-    label: "Anthropic",
-    provider: "anthropic",
-    envVar: "ANTHROPIC_API_KEY",
-    envHint: "Get your key at https://console.anthropic.com/settings/keys",
-  },
-  {
-    key: "3",
-    label: "Google Gemini",
-    provider: "google",
-    envVar: "GEMINI_API_KEY",
-    envHint: "Get your key at https://aistudio.google.com/apikey",
-  },
-  {
-    key: "4",
-    label: "Google Vertex AI",
-    provider: "vertex",
-    envVar: "GOOGLE_CLOUD_PROJECT",
-    envHint:
-      "Requires `gcloud auth application-default login` and a GCP project ID",
-  },
-  {
-    key: "5",
-    label: "OpenRouter",
-    provider: "openrouter",
-    envVar: "OPENROUTER_API_KEY",
-    envHint: "Get your key at https://openrouter.ai/settings/keys",
-  },
-];
-
-function promptUser(
-  rl: ReturnType<typeof createInterface>,
-  question: string,
-): Promise<string> {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      resolve(answer.trim());
-    });
-  });
-}
-
-/** Map provider to a human-readable label for status messages. */
-function providerLabel(provider: Provider): string {
-  const choice = PROVIDER_CHOICES.find((c) => c.provider === provider);
-  return choice?.label ?? provider;
-}
-
-/** Extract the env var name from source like "env:GOOGLE_CLOUD_PROJECT". */
-function sourceEnvVar(source: string): string | null {
-  if (source.startsWith("env:")) return source.slice(4);
-  return null;
-}
-
-/**
- * If the workspace has usable credentials but no pinned model in config,
- * write the resolved default model to `.libretto/config.json`.
- */
-function ensurePinnedDefaultModel(
-  status: AiSetupStatus & { kind: "ready" },
-): AiSetupStatus & { kind: "ready" } {
-  if (status.source !== "config") {
-    writeSnapshotModel(status.model);
-    return { ...status, source: "config" as const };
-  }
-  return status;
-}
-
-function printHealthySummary(status: AiSetupStatus & { kind: "ready" }): void {
-  const envVar = sourceEnvVar(status.source);
-  if (envVar) {
-    console.log(
-      `✓ Detected ${envVar}. Using ${providerLabel(status.provider)}.`,
-    );
-  } else {
-    console.log(`✓ Using ${providerLabel(status.provider)} (${status.model}).`);
-  }
-  console.log(
-    `To change: ${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}`,
-  );
-}
-
-function printInvalidAiConfigWarning(status: AiSetupStatus): void {
-  if (status.kind !== "invalid-config") return;
-  console.log("! Existing AI config is invalid:");
-  for (const line of status.message.split("\n")) {
-    console.log(`  ${line}`);
-  }
-}
-
-// ── Repair plan helpers (exported for testing) ──────────────────────────────
-
-export type RepairChoice = "switch-provider" | "skip";
-
-export type RepairPlan =
-  | {
-      kind: "repair-missing-credentials";
-      provider: Provider;
-      model: string;
-      envVar: string;
-      choices: RepairChoice[];
-    }
-  | { kind: "repair-invalid-config"; message: string }
-  | { kind: "no-repair-needed" };
-
-/**
- * Determine what repair action setup should take for the current AI status.
- * Pure function — no I/O, no prompts.
- */
-export function buildRepairPlan(status: AiSetupStatus): RepairPlan {
-  if (status.kind === "configured-missing-credentials") {
-    const choice = PROVIDER_CHOICES.find((c) => c.provider === status.provider);
-    return {
-      kind: "repair-missing-credentials",
-      provider: status.provider,
-      model: status.model,
-      envVar: choice?.envVar ?? `${status.provider.toUpperCase()}_API_KEY`,
-      choices: ["switch-provider", "skip"],
-    };
-  }
-  if (status.kind === "invalid-config") {
-    return { kind: "repair-invalid-config", message: status.message };
-  }
-  return { kind: "no-repair-needed" };
-}
-
-/**
- * Format a provider-specific explanation for missing credentials.
- */
-export function formatMissingCredentialsMessage(
-  plan: RepairPlan & { kind: "repair-missing-credentials" },
-): string {
-  return `✗ ${plan.provider} is configured (model: ${plan.model}), but ${plan.envVar} is not set.`;
-}
-
-function printSnapshotApiStatus(): boolean {
-  const status = resolveAiSetupStatus();
-
-  console.log(
-    "\nLibretto uses a sub-agent to analyze DOM snapshots. The model is determined by environment variables.",
-  );
-
-  if (status.kind === "ready") {
-    console.log();
-    printHealthySummary(status);
-    ensurePinnedDefaultModel(status);
-    return true;
-  }
-
-  // Provider-specific missing-credentials message
-  const plan = buildRepairPlan(status);
-  if (plan.kind === "repair-missing-credentials") {
-    console.log();
-    console.log(formatMissingCredentialsMessage(plan));
-    console.log(
-      `  To fix: add ${plan.envVar} to .env, or run \`${librettoCommand("setup")}\` interactively to repair.`,
-    );
-    return false;
-  }
-
-  if (plan.kind === "repair-invalid-config") {
-    printInvalidAiConfigWarning(status);
-    console.log(
-      `  Run \`${librettoCommand("setup")}\` interactively to reconfigure.`,
-    );
-    return false;
-  }
-
-  console.log();
-  console.log("✗ No snapshot API credentials detected.");
-  console.log("  Add one provider to .env:");
-  console.log("    OPENAI_API_KEY=...");
-  console.log("    ANTHROPIC_API_KEY=...");
-  console.log("    GEMINI_API_KEY=...  # or GOOGLE_GENERATIVE_AI_API_KEY");
-  console.log(
-    "    GOOGLE_CLOUD_PROJECT=...  # plus application default credentials for Vertex",
-  );
-  console.log(
-    `  Or run \`${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}\` to set a specific model.`,
-  );
-  console.log(
-    `  Run \`${librettoCommand("setup")}\` interactively to set up credentials.`,
-  );
-  return false;
-}
-
-/**
- * Run the full provider selection menu.
- * Pins the selected provider's default model to config and prints
- * instructions for the user to add the credential to .env themselves.
- * Returns true if a provider was successfully configured.
- */
-async function promptProviderSelection(
-  rl: ReturnType<typeof createInterface>,
-): Promise<boolean> {
-  console.log(
-    "Which model provider would you like to use for snapshot analysis?\n",
-  );
-  for (const choice of PROVIDER_CHOICES) {
-    console.log(`  ${choice.key}) ${choice.label}`);
-  }
-  console.log("  s) Skip for now\n");
-
-  const answer = await promptUser(rl, "Choice: ");
-
-  if (answer.toLowerCase() === "s" || !answer) {
-    printSkipMessage();
-    return false;
-  }
-
-  const selected = PROVIDER_CHOICES.find((choice) => choice.key === answer);
-  if (!selected) {
-    console.log(`\nUnknown choice "${answer}". Skipping API setup.`);
-    return false;
-  }
-
-  const model = DEFAULT_SNAPSHOT_MODELS[selected.provider];
-  writeSnapshotModel(model);
-  console.log(`\n✓ ${selected.label} selected (model: ${model}).`);
-  console.log(`\nAdd ${selected.envVar} to your .env file:`);
-  console.log(`  ${selected.envHint}`);
-  installSdkIfNeeded(selected.provider);
-  return true;
-}
-
-function printSkipMessage(): void {
-  console.log(
-    `\nSkipped. You can set up API credentials later by rerunning \`${librettoCommand("setup")}\`.`,
-  );
-  console.log("Or add credentials directly to your .env file:");
-  console.log("  OPENAI_API_KEY=...");
-  console.log("  ANTHROPIC_API_KEY=...");
-  console.log("  GEMINI_API_KEY=...");
-  console.log(
-    `  Or run \`${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}\` to set a specific model.`,
-  );
-}
-
-async function runInteractiveApiSetup(): Promise<void> {
-  const status = resolveAiSetupStatus();
-
-  console.log(
-    "\nLibretto uses a sub-agent to analyze DOM snapshots. The model is determined by environment variables.",
-  );
-
-  if (status.kind === "ready") {
-    console.log();
-    printHealthySummary(status);
-    ensurePinnedDefaultModel(status);
-    return;
-  }
-
-  const plan = buildRepairPlan(status);
-
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  try {
-    // ── Repair: configured provider with missing credentials ──
-    if (plan.kind === "repair-missing-credentials") {
-      console.log(formatMissingCredentialsMessage(plan));
-      console.log(`\nAdd ${plan.envVar} to your .env file to fix this.`);
-      console.log("");
-      console.log("Or switch to a different provider:\n");
-      console.log("  1) Switch to a different provider");
-      console.log("  s) Skip for now\n");
-
-      const answer = await promptUser(rl, "Choice: ");
-
-      if (answer === "1") {
-        await promptProviderSelection(rl);
-        return;
-      }
-
-      // skip or empty
-      printSkipMessage();
-      return;
-    }
-
-    // ── Repair: invalid config → let user pick a provider ──
-    if (plan.kind === "repair-invalid-config") {
-      printInvalidAiConfigWarning(status);
-      console.log(
-        "\nWould you like to reconfigure with a fresh provider selection?\n",
-      );
-      await promptProviderSelection(rl);
-      return;
-    }
-
-    // ── Unconfigured: standard first-run flow ──
-    console.log("✗ No snapshot API credentials detected.\n");
-    await promptProviderSelection(rl);
-  } finally {
-    rl.close();
-  }
-}
-
 function installBrowsers(): void {
   console.log("Installing Playwright Chromium...");
   const result = spawnSync("npx", ["playwright", "install", "chromium"], {
@@ -486,17 +118,6 @@ export const setupCommand = SimpleCLI.command({
 
     copySkills();
 
-    if (process.stdin.isTTY) {
-      await runInteractiveApiSetup();
-    } else {
-      const ready = printSnapshotApiStatus();
-      if (!ready) {
-        console.log(
-          `\nIf you're an agent, request the user to run \`${librettoCommand("setup")}\`.`,
-        );
-      }
-    }
-
     console.log(`\nConfig set up at ${LIBRETTO_CONFIG_PATH}`);
     console.log("\n✓ libretto setup complete");
   });

package/src/cli/commands/snapshot.ts

@@ -1,22 +1,12 @@
-import { readFileSync, writeFileSync } from "node:fs";
 import { z } from "zod";
 import type { LoggerApi } from "../../shared/logger/index.js";
-import { condenseDom } from "../../shared/condense-dom/condense-dom.js";
 import { readSessionState } from "../core/session.js";
-import {
-  type InterpretArgs,
-  type ScreenshotPair,
-} from "../core/snapshot-analyzer.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 import {
   pageOption,
   sessionOption,
-  withExperiments,
   withRequiredSession,
 } from "./shared.js";
-import { runApiInterpret } from "../core/api-snapshot-analyzer.js";
-import { readSnapshotModel } from "../core/config.js";
-import { resolveSnapshotApiModelOrThrow } from "../core/ai-model.js";
 import { DaemonClient } from "../core/daemon/ipc.js";
 import { librettoCommand } from "../../shared/package-manager.js";
 import { renderSnapshot } from "../../shared/snapshot/render-snapshot.js";
@@ -116,101 +106,6 @@ export async function forceSnapshotViewport(
   });
 }
 
-async function captureSnapshot(
-  session: string,
-  logger: LoggerApi,
-  daemonSocketPath: string,
-  pageId?: string,
-): Promise<ScreenshotPair> {
-  logger.info("snapshot-via-daemon", { session, pageId });
-  const client = await DaemonClient.connect(daemonSocketPath);
-  let snapshotResult: Awaited<ReturnType<DaemonClient["snapshot"]>>;
-  try {
-    snapshotResult = await client.snapshot({ pageId });
-  } finally {
-    client.destroy();
-  }
-  if (!("htmlPath" in snapshotResult)) {
-    throw new Error("Daemon returned a compact snapshot for a legacy request.");
-  }
-  const { pngPath, htmlPath, snapshotRunId, pageUrl, title } = snapshotResult;
-
-  // condenseDom runs in the CLI process, not the daemon.
-  const htmlContent = readFileSync(htmlPath, "utf8");
-  const condenseResult = condenseDom(htmlContent);
-  const condensedHtmlPath = htmlPath.replace(/\.html$/, ".condensed.html");
-  writeFileSync(condensedHtmlPath, condenseResult.html);
-
-  logger.info("snapshot-daemon-success", {
-    session,
-    pageUrl,
-    title,
-    pngPath,
-    htmlPath,
-    condensedHtmlPath,
-    snapshotRunId,
-    domCondenseStats: {
-      originalLength: condenseResult.originalLength,
-      condensedLength: condenseResult.condensedLength,
-      reductions: condenseResult.reductions,
-    },
-  });
-
-  return { pngPath, htmlPath, condensedHtmlPath, baseName: snapshotRunId };
-}
-
-async function runSnapshot(
-  session: string,
-  logger: LoggerApi,
-  pageId: string | undefined,
-  objective: string | undefined,
-  context: string | undefined,
-): Promise<void> {
-  if (objective === undefined) {
-    throw new Error("Missing required option --objective.");
-  }
-  if (context === undefined) {
-    throw new Error("Missing required option --context.");
-  }
-
-  const normalizedObjective = objective.trim();
-  const normalizedContext = context.trim();
-
-  const snapshotModel = readSnapshotModel();
-  resolveSnapshotApiModelOrThrow(snapshotModel);
-
-  const state = readSessionState(session, logger);
-  if (!state?.daemonSocketPath) {
-    throw new Error(
-      `Session "${session}" has no daemon socket. The browser daemon may have crashed. ` +
-        `Close and reopen the session: ${librettoCommand(`close --session ${session}`)}`,
-    );
-  }
-
-  const { pngPath, htmlPath, condensedHtmlPath } =
-    await captureSnapshot(session, logger, state.daemonSocketPath, pageId);
-
-  console.log("Screenshot saved:");
-  console.log(`  PNG:             ${pngPath}`);
-  console.log(`  HTML:            ${htmlPath}`);
-  console.log(`  Condensed HTML:  ${condensedHtmlPath}`);
-
-  const interpretArgs: InterpretArgs = {
-    objective: normalizedObjective,
-    session,
-    context: normalizedContext,
-    pngPath,
-    htmlPath,
-    condensedHtmlPath,
-  };
-
-  // Analysis uses direct API calls via the Vercel AI SDK (see api-snapshot-analyzer.ts).
-  // The legacy CLI-agent path (spawning codex/claude/gemini as a subprocess) is preserved
-  // in snapshot-analyzer.ts — to switch back, replace this call with:
-  //   await runInterpret(interpretArgs, logger);
-  await runApiInterpret(interpretArgs, logger, snapshotModel);
-}
-
 async function runCompactSnapshot(
   args: {
     session: string;
@@ -237,17 +132,12 @@ async function runCompactSnapshot(
   let result: Awaited<ReturnType<DaemonClient["snapshot"]>>;
   try {
     result = await client.snapshot({
-      mode: "compact",
       pageId: args.pageId,
       useCachedSnapshot: args.ref !== undefined,
     });
   } finally {
     client.destroy();
   }
-  if (!("mode" in result) || result.mode !== "compact") {
-    throw new Error("Daemon returned a legacy snapshot for a compact request.");
-  }
-
   console.log(`Screenshot at ${result.pngPath}`);
   console.log(renderSnapshot(result.snapshot, args.ref));
   console.log(
@@ -270,34 +160,16 @@ export const snapshotInput = SimpleCLI.input({
 });
 
 export const snapshotCommand = SimpleCLI.command({
-  description: "Capture PNG + HTML and analyze with --objective and --context",
+  description: "Capture a screenshot and compact accessibility snapshot",
 })
   .input(snapshotInput)
   .use(withRequiredSession())
-  .use(withExperiments())
   .handle(async ({ input, ctx }) => {
-    if (ctx.experiments["compact-snapshot-format"]) {
-      await runCompactSnapshot({
-        session: ctx.session,
-        daemonSocketPath: ctx.sessionState.daemonSocketPath,
-        logger: ctx.logger,
-        pageId: input.page,
-        ref: input.ref,
-      });
-      return;
-    }
-
-    if (input.ref) {
-      throw new Error(
-        `Snapshot refs require the compact-snapshot-format experiment. Enable it with ${librettoCommand("experiments enable compact-snapshot-format")}.`,
-      );
-    }
-
-    await runSnapshot(
-      ctx.session,
-      ctx.logger,
-      input.page,
-      input.objective,
-      input.context,
-    );
+    await runCompactSnapshot({
+      session: ctx.session,
+      daemonSocketPath: ctx.sessionState.daemonSocketPath,
+      logger: ctx.logger,
+      pageId: input.page,
+      ref: input.ref,
+    });
   });

package/src/cli/commands/status.ts

@@ -1,51 +1,6 @@
-import { LIBRETTO_CONFIG_PATH } from "../core/context.js";
-import { type AiSetupStatus, resolveAiSetupStatus } from "../core/ai-model.js";
-import { librettoCommand } from "../../shared/package-manager.js";
 import { listRunningSessions, type SessionState } from "../core/session.js";
 import { SimpleCLI } from "../framework/simple-cli.js";
 
-// ── AI status printing ──────────────────────────────────────────────────────
-
-function printAiStatus(status: AiSetupStatus): void {
-  console.log("AI configuration:");
-
-  switch (status.kind) {
-    case "ready":
-      console.log(`  ✓ Snapshot model: ${status.model}`);
-      if (status.source === "config") {
-        console.log(`  Config: ${LIBRETTO_CONFIG_PATH}`);
-      } else {
-        console.log(`  Source: ${status.source}`);
-      }
-      console.log(
-        `  To change: ${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}`,
-      );
-      break;
-
-    case "configured-missing-credentials":
-      console.log(
-        `  ✗ ${status.provider} is configured (model: ${status.model}), but credentials are missing.`,
-      );
-      console.log(`  Run \`${librettoCommand("setup")}\` to repair.`);
-      break;
-
-    case "invalid-config":
-      console.log("  ✗ Config is invalid:");
-      for (const line of status.message.split("\n")) {
-        console.log(`    ${line}`);
-      }
-      console.log(`  Run \`${librettoCommand("setup")}\` to reconfigure.`);
-      break;
-
-    case "unconfigured":
-      console.log("  ✗ No AI model configured.");
-      console.log(
-        `  Run \`${librettoCommand("setup")}\` or \`${librettoCommand("ai configure")}\` to set up.`,
-      );
-      break;
-  }
-}
-
 // ── Session status printing ─────────────────────────────────────────────────
 
 function printOpenSessions(sessions: SessionState[]): void {
@@ -68,13 +23,10 @@ function printOpenSessions(sessions: SessionState[]): void {
 // ── Command ─────────────────────────────────────────────────────────────────
 
 export const statusCommand = SimpleCLI.command({
-  description: "Show workspace status: AI configuration and open sessions",
+  description: "Show workspace status and open sessions",
 })
   .input(SimpleCLI.input({ positionals: [], named: {} }))
   .handle(async () => {
-    const aiStatus = resolveAiSetupStatus();
-    printAiStatus(aiStatus);
-
     const sessions = listRunningSessions();
     printOpenSessions(sessions);
   });

package/src/cli/core/browser.ts

@@ -6,6 +6,7 @@ import {
   type Page,
 } from "playwright";
 import { existsSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { createServer } from "node:net";
 import type { LoggerApi } from "../../shared/logger/index.js";
@@ -657,9 +658,8 @@ export async function runSave(
     }
 
     const state = { cookies, origins };
-    const fs = await import("node:fs/promises");
-    await fs.mkdir(dirname(profilePath), { recursive: true });
-    await fs.writeFile(profilePath, JSON.stringify(state, null, 2));
+    await mkdir(dirname(profilePath), { recursive: true });
+    await writeFile(profilePath, JSON.stringify(state, null, 2));
 
     logger.info("save-success", {
       domain,

package/src/cli/core/config.ts

@@ -3,7 +3,6 @@ import { dirname } from "node:path";
 import { z } from "zod";
 import { SessionAccessModeSchema } from "../../shared/state/index.js";
 import { LIBRETTO_CONFIG_PATH } from "./context.js";
-import { librettoCommand } from "../../shared/package-manager.js";
 
 export const CURRENT_CONFIG_VERSION = 1;
 
@@ -42,7 +41,6 @@ function formatExpectedConfigExample(): string {
   return JSON.stringify(
     {
       version: CURRENT_CONFIG_VERSION,
-      snapshotModel: "openai/gpt-5.4",
       viewport: {
         width: 1280,
         height: 800,
@@ -66,10 +64,9 @@ function invalidConfigError(configPath: string, detail?: string): Error {
       "Expected config example:",
       formatExpectedConfigExample(),
       "Notes:",
-      '  - "snapshotModel", "viewport", "windowPosition", and "sessionMode" are optional.',
-      '  - "snapshotModel" must be a provider/model string like "openai/gpt-5.4" or "anthropic/claude-sonnet-4-6".',
-      "Fix the file to match this shape, or delete it and rerun:",
-      `  ${librettoCommand("ai configure openai | anthropic | gemini | vertex | openrouter")}`,
+      '  - "viewport", "windowPosition", and "sessionMode" are optional.',
+      '  - "snapshotModel" is deprecated and ignored by snapshot.',
+      "Fix the file to match this shape, or delete it and rerun setup.",
     ]
       .filter(Boolean)
       .join("\n"),