libretto 0.5.0 → 0.5.1

package/src/cli/core/snapshot-api-config.ts

@@ -1,191 +1,188 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import {
-	type AiConfig,
-	readAiConfig,
-} from "./ai-config.js";
+import { type AiConfig, readAiConfig } from "./ai-config.js";
 import { LIBRETTO_CONFIG_PATH, REPO_ROOT } from "./context.js";
 import {
-	hasProviderCredentials,
-	parseModel,
-	type Provider,
+  hasProviderCredentials,
+  parseModel,
+  type Provider,
 } from "../../shared/llm/client.js";
 
 const DEFAULT_SNAPSHOT_MODELS = {
-	openai: "openai/gpt-5.4",
-	anthropic: "anthropic/claude-sonnet-4-6",
-	google: "google/gemini-3-flash-preview",
-	vertex: "vertex/gemini-2.5-pro",
+  openai: "openai/gpt-5.4",
+  anthropic: "anthropic/claude-sonnet-4-6",
+  google: "google/gemini-3-flash-preview",
+  vertex: "vertex/gemini-2.5-pro",
 } as const satisfies Record<Provider, string>;
 
 export type SnapshotApiModelSelection = {
-	model: string;
-	provider: Provider;
-	source:
-		| "config"
-		| "env:auto-openai"
-		| "env:auto-anthropic"
-		| "env:auto-google"
-		| "env:auto-vertex";
+  model: string;
+  provider: Provider;
+  source:
+    | "config"
+    | "env:auto-openai"
+    | "env:auto-anthropic"
+    | "env:auto-google"
+    | "env:auto-vertex";
 };
 
 export class SnapshotApiUnavailableError extends Error {
-	constructor(message: string) {
-		super(message);
-		this.name = "SnapshotApiUnavailableError";
-	}
+  constructor(message: string) {
+    super(message);
+    this.name = "SnapshotApiUnavailableError";
+  }
 }
 
 function providerSetupSentence(provider: Provider): string {
-	switch (provider) {
-		case "openai":
-			return "Add OPENAI_API_KEY to .env or as a shell environment variable.";
-		case "anthropic":
-			return "Add ANTHROPIC_API_KEY to .env or as a shell environment variable.";
-		case "google":
-			return "Add GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY to .env or as a shell environment variable.";
-		case "vertex":
-			return "Add GOOGLE_CLOUD_PROJECT or GCLOUD_PROJECT to .env or as a shell environment variable, and make sure application default credentials are configured.";
-	}
+  switch (provider) {
+    case "openai":
+      return "Add OPENAI_API_KEY to .env or as a shell environment variable.";
+    case "anthropic":
+      return "Add ANTHROPIC_API_KEY to .env or as a shell environment variable.";
+    case "google":
+      return "Add GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY to .env or as a shell environment variable.";
+    case "vertex":
+      return "Add GOOGLE_CLOUD_PROJECT or GCLOUD_PROJECT to .env or as a shell environment variable, and make sure application default credentials are configured.";
+  }
 }
 
 function defaultModelCommandLine(): string {
-	return "npx libretto ai configure openai | anthropic | gemini | vertex";
+  return "npx libretto ai configure openai | anthropic | gemini | vertex";
 }
 
 function providerMissingCredentialSummary(provider: Provider): string {
-	switch (provider) {
-		case "openai":
-			return "OPENAI_API_KEY is missing";
-		case "anthropic":
-			return "ANTHROPIC_API_KEY is missing";
-		case "google":
-			return "GEMINI_API_KEY and GOOGLE_GENERATIVE_AI_API_KEY are missing";
-		case "vertex":
-			return "GOOGLE_CLOUD_PROJECT and GCLOUD_PROJECT are missing";
-	}
+  switch (provider) {
+    case "openai":
+      return "OPENAI_API_KEY is missing";
+    case "anthropic":
+      return "ANTHROPIC_API_KEY is missing";
+    case "google":
+      return "GEMINI_API_KEY and GOOGLE_GENERATIVE_AI_API_KEY are missing";
+    case "vertex":
+      return "GOOGLE_CLOUD_PROJECT and GCLOUD_PROJECT are missing";
+  }
 }
 
 function noSnapshotApiConfiguredMessage(): string {
-	return [
-		"Failed to analyze snapshot because no snapshot analyzer is configured.",
-		`Add OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY, or GOOGLE_CLOUD_PROJECT to .env or as a shell environment variable, or choose a default model with \`${defaultModelCommandLine()}\`.`,
-		"For more info, run `npx libretto init`.",
-	].join(" ");
+  return [
+    "Failed to analyze snapshot because no snapshot analyzer is configured.",
+    `Add OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY or GOOGLE_GENERATIVE_AI_API_KEY, or GOOGLE_CLOUD_PROJECT to .env or as a shell environment variable, or choose a default model with \`${defaultModelCommandLine()}\`.`,
+    "For more info, run `npx libretto init`.",
+  ].join(" ");
 }
 
 function missingProviderSnapshotMessage(
-	selection: SnapshotApiModelSelection,
+  selection: SnapshotApiModelSelection,
 ): string {
-	const configuredSource =
-		selection.source === "config"
-			? ` in ${LIBRETTO_CONFIG_PATH}`
-			: " from process env or .env";
-	return [
-		`Failed to analyze snapshot because ${selection.provider} is configured${configuredSource}, but ${providerMissingCredentialSummary(selection.provider)}.`,
-		providerSetupSentence(selection.provider),
-		"For more info, run `npx libretto init`.",
-	].join(" ");
+  const configuredSource =
+    selection.source === "config"
+      ? ` in ${LIBRETTO_CONFIG_PATH}`
+      : " from process env or .env";
+  return [
+    `Failed to analyze snapshot because ${selection.provider} is configured${configuredSource}, but ${providerMissingCredentialSummary(selection.provider)}.`,
+    providerSetupSentence(selection.provider),
+    "For more info, run `npx libretto init`.",
+  ].join(" ");
 }
 
 function readWorktreeEnvPath(): string | null {
-	const gitPath = join(REPO_ROOT, ".git");
-	if (!existsSync(gitPath)) return null;
-
-	try {
-		const gitPointer = readFileSync(gitPath, "utf-8").trim();
-		const match = gitPointer.match(/^gitdir:\s*(.+)$/i);
-		if (!match?.[1]) return null;
-		const worktreeGitDir = resolve(REPO_ROOT, match[1].trim());
-		const commonGitDir = resolve(worktreeGitDir, "..", "..");
-		return join(dirname(commonGitDir), ".env");
-	} catch {
-		return null;
-	}
+  const gitPath = join(REPO_ROOT, ".git");
+  if (!existsSync(gitPath)) return null;
+
+  try {
+    const gitPointer = readFileSync(gitPath, "utf-8").trim();
+    const match = gitPointer.match(/^gitdir:\s*(.+)$/i);
+    if (!match?.[1]) return null;
+    const worktreeGitDir = resolve(REPO_ROOT, match[1].trim());
+    const commonGitDir = resolve(worktreeGitDir, "..", "..");
+    return join(dirname(commonGitDir), ".env");
+  } catch {
+    return null;
+  }
 }
 
 export function loadSnapshotEnv(): void {
-	if (process.env.LIBRETTO_DISABLE_DOTENV?.trim() === "1") return;
-
-	const envPathCandidates = [
-		join(REPO_ROOT, ".env"),
-		readWorktreeEnvPath(),
-	].filter((value): value is string => Boolean(value));
-
-	const envPath = envPathCandidates.find((candidate) => existsSync(candidate));
-	if (!envPath) return;
-
-	for (const line of readFileSync(envPath, "utf-8").split("\n")) {
-		const parsed = parseDotEnvAssignment(line);
-		if (!parsed) continue;
-		if (!(parsed.key in process.env)) {
-			process.env[parsed.key] = parsed.value;
-		}
-	}
+  if (process.env.LIBRETTO_DISABLE_DOTENV?.trim() === "1") return;
+
+  const envPathCandidates = [
+    join(REPO_ROOT, ".env"),
+    readWorktreeEnvPath(),
+  ].filter((value): value is string => Boolean(value));
+
+  const envPath = envPathCandidates.find((candidate) => existsSync(candidate));
+  if (!envPath) return;
+
+  for (const line of readFileSync(envPath, "utf-8").split("\n")) {
+    const parsed = parseDotEnvAssignment(line);
+    if (!parsed) continue;
+    if (!(parsed.key in process.env)) {
+      process.env[parsed.key] = parsed.value;
+    }
+  }
 }
 
 export function parseDotEnvAssignment(
-	line: string,
+  line: string,
 ): { key: string; value: string } | null {
-	const trimmed = line.trim();
-	if (!trimmed || trimmed.startsWith("#")) return null;
-
-	const withoutExport = trimmed.startsWith("export ")
-		? trimmed.slice("export ".length).trimStart()
-		: trimmed;
-	const eqIdx = withoutExport.indexOf("=");
-	if (eqIdx < 1) return null;
-
-	const key = withoutExport.slice(0, eqIdx).trim();
-	if (!key) return null;
-
-	const rawValue = withoutExport.slice(eqIdx + 1).trimStart();
-	if (!rawValue) {
-		return { key, value: "" };
-	}
-
-	if (rawValue.startsWith('"')) {
-		const closeIdx = rawValue.indexOf('"', 1);
-		if (closeIdx > 0) {
-			return { key, value: rawValue.slice(1, closeIdx) };
-		}
-		return { key, value: rawValue.slice(1) };
-	}
-
-	if (rawValue.startsWith("'")) {
-		const closeIdx = rawValue.indexOf("'", 1);
-		if (closeIdx > 0) {
-			return { key, value: rawValue.slice(1, closeIdx) };
-		}
-		return { key, value: rawValue.slice(1) };
-	}
-
-	const inlineCommentIndex = rawValue.search(/\s#/);
-	const value =
-		inlineCommentIndex >= 0
-			? rawValue.slice(0, inlineCommentIndex).trimEnd()
-			: rawValue.trim();
-	return { key, value };
+  const trimmed = line.trim();
+  if (!trimmed || trimmed.startsWith("#")) return null;
+
+  const withoutExport = trimmed.startsWith("export ")
+    ? trimmed.slice("export ".length).trimStart()
+    : trimmed;
+  const eqIdx = withoutExport.indexOf("=");
+  if (eqIdx < 1) return null;
+
+  const key = withoutExport.slice(0, eqIdx).trim();
+  if (!key) return null;
+
+  const rawValue = withoutExport.slice(eqIdx + 1).trimStart();
+  if (!rawValue) {
+    return { key, value: "" };
+  }
+
+  if (rawValue.startsWith('"')) {
+    const closeIdx = rawValue.indexOf('"', 1);
+    if (closeIdx > 0) {
+      return { key, value: rawValue.slice(1, closeIdx) };
+    }
+    return { key, value: rawValue.slice(1) };
+  }
+
+  if (rawValue.startsWith("'")) {
+    const closeIdx = rawValue.indexOf("'", 1);
+    if (closeIdx > 0) {
+      return { key, value: rawValue.slice(1, closeIdx) };
+    }
+    return { key, value: rawValue.slice(1) };
+  }
+
+  const inlineCommentIndex = rawValue.search(/\s#/);
+  const value =
+    inlineCommentIndex >= 0
+      ? rawValue.slice(0, inlineCommentIndex).trimEnd()
+      : rawValue.trim();
+  return { key, value };
 }
 
 function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
-	const providersInPriorityOrder: Provider[] = [
-		"openai",
-		"anthropic",
-		"google",
-		"vertex",
-	];
-
-	for (const provider of providersInPriorityOrder) {
-		if (!hasProviderCredentials(provider)) continue;
-		return {
-			model: DEFAULT_SNAPSHOT_MODELS[provider],
-			provider,
-			source: `env:auto-${provider}` as SnapshotApiModelSelection["source"],
-		};
-	}
-
-	return null;
+  const providersInPriorityOrder: Provider[] = [
+    "openai",
+    "anthropic",
+    "google",
+    "vertex",
+  ];
+
+  for (const provider of providersInPriorityOrder) {
+    if (!hasProviderCredentials(provider)) continue;
+    return {
+      model: DEFAULT_SNAPSHOT_MODELS[provider],
+      provider,
+      source: `env:auto-${provider}` as SnapshotApiModelSelection["source"],
+    };
+  }
+
+  return null;
 }
 
 /**
@@ -196,41 +193,39 @@ function inferAutoSnapshotModel(): SnapshotApiModelSelection | null {
  * 2. Auto-detect from available API credentials in env
  */
 export function resolveSnapshotApiModel(
-	config: AiConfig | null = readAiConfig(),
+  config: AiConfig | null = readAiConfig(),
 ): SnapshotApiModelSelection | null {
-	loadSnapshotEnv();
-
-	if (config?.model) {
-		const { provider } = parseModel(config.model);
-		return {
-			model: config.model,
-			provider,
-			source: "config",
-		};
-	}
-
-	return inferAutoSnapshotModel();
+  loadSnapshotEnv();
+
+  if (config?.model) {
+    const { provider } = parseModel(config.model);
+    return {
+      model: config.model,
+      provider,
+      source: "config",
+    };
+  }
+
+  return inferAutoSnapshotModel();
 }
 
 export function resolveSnapshotApiModelOrThrow(
-	config: AiConfig | null = readAiConfig(),
+  config: AiConfig | null = readAiConfig(),
 ): SnapshotApiModelSelection {
-	const selection = resolveSnapshotApiModel(config);
-	if (!selection) {
-		throw new SnapshotApiUnavailableError(
-			noSnapshotApiConfiguredMessage(),
-		);
-	}
-
-	if (!hasProviderCredentials(selection.provider)) {
-		throw new SnapshotApiUnavailableError(
-			missingProviderSnapshotMessage(selection),
-		);
-	}
-
-	return selection;
+  const selection = resolveSnapshotApiModel(config);
+  if (!selection) {
+    throw new SnapshotApiUnavailableError(noSnapshotApiConfiguredMessage());
+  }
+
+  if (!hasProviderCredentials(selection.provider)) {
+    throw new SnapshotApiUnavailableError(
+      missingProviderSnapshotMessage(selection),
+    );
+  }
+
+  return selection;
 }
 
 export function isSnapshotApiUnavailableError(error: unknown): boolean {
-	return error instanceof SnapshotApiUnavailableError;
+  return error instanceof SnapshotApiUnavailableError;
 }

package/src/cli/core/telemetry.ts

@@ -1,4 +1,9 @@
-import { appendFileSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import {
+  appendFileSync,
+  existsSync,
+  readFileSync,
+  writeFileSync,
+} from "node:fs";
 import type { Page } from "playwright";
 import {
   getSessionActionsLogPath,
@@ -21,7 +26,12 @@ export type NetworkLogEntry = {
 
 export function readNetworkLog(
   session: string,
-  opts: { last?: number; filter?: string; method?: string; pageId?: string } = {},
+  opts: {
+    last?: number;
+    filter?: string;
+    method?: string;
+    pageId?: string;
+  } = {},
 ): NetworkLogEntry[] {
   assertSessionStateExistsOrThrow(session);
   const logPath = getSessionNetworkLogPath(session);
@@ -99,7 +109,10 @@ export function parentLogAction(
 ): void {
   try {
     const record = { ts: new Date().toISOString(), ...entry };
-    appendFileSync(getSessionActionsLogPath(session), JSON.stringify(record) + "\n");
+    appendFileSync(
+      getSessionActionsLogPath(session),
+      JSON.stringify(record) + "\n",
+    );
   } catch {}
 }