create-better-t-stack 3.41.0 → 3.41.2

package/README.md

@@ -130,7 +130,7 @@ This CLI collects anonymous usage data to help improve the tool. The data collec
 - Platform (OS)
 - How the CLI was driven (prompts, flags, `--yes`, JSON, the programmatic API, or the MCP server)
 
-Separately, a small number of anonymous diagnostic events are sent for failures (stage and error class, never full messages or paths), cancelled prompts, other commands such as `add` and `history`, slow runs, and MCP tool usage. See the [analytics documentation](https://better-t-stack.dev/docs/analytics) for the exact list.
+Separately, one anonymous failure event is sent when a scaffold breaks (stage and error class, never full messages or paths). See the [analytics documentation](https://better-t-stack.dev/docs/analytics) for details.
 
 **Telemetry is enabled by default in published versions** to help us understand usage patterns and improve the tool.
 

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as setProcessMode, S as getLatestCLIVersion, b as scrubReason, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as durationBucket, x as types_exports, y as reportDiagnostic } from "./src-NAkPN6DN.mjs";
+import { D as setProcessMode, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as types_exports, y as getLatestCLIVersion } from "./src-CCnlcJnd.mjs";
 import z from "zod";
 import { McpServer } from "@modelcontextprotocol/server";
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
@@ -58,44 +58,6 @@ function formatToolError(cause) {
 		isError: true
 	};
 }
-const reportedSessions = /* @__PURE__ */ new WeakSet();
-/** One session event per connection, sent when the client identity is first known. */
-function reportMcpSession(server) {
-	if (reportedSessions.has(server)) return;
-	reportedSessions.add(server);
-	const client = server.server.getClientVersion();
-	reportDiagnostic("mcp_session", {
-		client: client?.name ?? "unknown",
-		clientVersion: client?.version ?? "unknown"
-	});
-}
-/**
-* Times every tool call and reports the outcome. Diagnostics are fire-and-forget here
-* because the server process is long-lived and must not add latency to tool results.
-*/
-function instrumentTool(server, tool, handler, isOptedOut) {
-	return async (...args) => {
-		if (isOptedOut?.(...args)) return handler(...args);
-		reportMcpSession(server);
-		const startTime = Date.now();
-		const result = await handler(...args);
-		const ok = !("isError" in result);
-		reportDiagnostic("mcp_tool", {
-			tool,
-			ok,
-			duration: durationBucket(Date.now() - startTime)
-		});
-		if (!ok) reportDiagnostic("mcp_tool_error", {
-			tool,
-			error: "ToolError",
-			reason: scrubReason(result.structuredContent.error)
-		});
-		return result;
-	};
-}
-function isCreateOptedOut(input) {
-	return input.disableAnalytics === true;
-}
 function getProjectToolAnnotations() {
 	return {
 		destructiveHint: true,
@@ -185,13 +147,13 @@ function createBtsMcpServer() {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, instrumentTool(server, "bts_get_stack_guidance", async () => {
+	}, async () => {
 		try {
 			return formatToolSuccess(getStackGuidance());
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}));
+	});
 	server.registerTool("bts_get_schema", {
 		title: "Get Better T Stack Schemas",
 		description: "Inspect Better T Stack CLI and input schemas so agents can plan valid create/add requests. Use this together with bts_get_stack_guidance before creating a project if any part of the request is ambiguous.",
@@ -204,13 +166,13 @@ function createBtsMcpServer() {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, instrumentTool(server, "bts_get_schema", async ({ name }) => {
+	}, async ({ name }) => {
 		try {
 			return formatToolSuccess(getSchemaResult(name ?? "all"));
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}));
+	});
 	server.registerTool("bts_plan_project", {
 		title: "Plan Better T Stack Project",
 		description: "Validate and preview a Better T Stack project creation without writing files or provisioning resources. Always use this before bts_create_project. This tool requires an explicit full stack config rather than a partial payload with inferred defaults.",
@@ -223,7 +185,7 @@ function createBtsMcpServer() {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, instrumentTool(server, "bts_plan_project", async (input) => {
+	}, async (input) => {
 		try {
 			const result = await create(input.projectName, {
 				...input,
@@ -242,7 +204,7 @@ function createBtsMcpServer() {
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}, isCreateOptedOut));
+	});
 	server.registerTool("bts_create_project", {
 		title: "Create Better T Stack Project",
 		description: "Create a Better T Stack project on disk using the same silent programmatic flow as the CLI JSON API. Call this only after bts_plan_project succeeds and the plan clearly matches the user's intent. This tool requires an explicit full stack config.",
@@ -252,7 +214,7 @@ function createBtsMcpServer() {
 			title: "Create Better T Stack Project",
 			...getProjectToolAnnotations()
 		}
-	}, instrumentTool(server, "bts_create_project", async (input) => {
+	}, async (input) => {
 		try {
 			if (input.install) return formatToolError(getMcpInstallTimeoutMessage(input.packageManager));
 			const result = await create(input.projectName, {
@@ -264,7 +226,7 @@ function createBtsMcpServer() {
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}, isCreateOptedOut));
+	});
 	server.registerTool("bts_plan_addons", {
 		title: "Plan Better T Stack Project Additions",
 		description: "Validate and preview addon installation or workspace package scaffolding for an existing Better T Stack project without writing files. Always use this before bts_add_addons.",
@@ -277,7 +239,7 @@ function createBtsMcpServer() {
 			idempotentHint: true,
 			openWorldHint: false
 		}
-	}, instrumentTool(server, "bts_plan_addons", async (input) => {
+	}, async (input) => {
 		try {
 			const result = await add({
 				...input,
@@ -288,7 +250,7 @@ function createBtsMcpServer() {
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}));
+	});
 	server.registerTool("bts_add_addons", {
 		title: "Apply Better T Stack Project Additions",
 		description: "Install addons or scaffold a workspace package in an existing Better T Stack project using the same silent flow as add-json. Call this only after bts_plan_addons succeeds and the planned changes match the user's intent.",
@@ -300,7 +262,7 @@ function createBtsMcpServer() {
 			idempotentHint: false,
 			openWorldHint: true
 		}
-	}, instrumentTool(server, "bts_add_addons", async (input) => {
+	}, async (input) => {
 		try {
 			const result = await add(input);
 			if (!result?.success) return formatToolError(result?.error ?? "Failed to update project");
@@ -308,7 +270,7 @@ function createBtsMcpServer() {
 		} catch (error) {
 			return formatToolError(error);
 		}
-	}));
+	});
 	return server;
 }
 function startBtsMcpServer() {

package/dist/index.d.mts

@@ -12,12 +12,9 @@ declare const UserCancelledError_base: import("better-result").TaggedErrorClass<
  */
 declare class UserCancelledError extends UserCancelledError_base<{
   message: string;
-  /** Name of the prompt that was open when the user cancelled, when known. */
-  prompt?: string;
 }> {
   constructor(args?: {
     message?: string;
-    prompt?: string;
   });
 }
 declare const CLIError_base: import("better-result").TaggedErrorClass<"CLIError">;

package/dist/index.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { C as CLIError, D as ProjectCreationError, E as DirectoryConflictError, O as UserCancelledError, T as DatabaseSetupError, _ as ProjectLauncherSchema, a as TEMPLATE_COUNT, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, k as ValidationError, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as CompatibilityError } from "./src-NAkPN6DN.mjs";
+import { C as DirectoryConflictError, E as ValidationError, S as DatabaseSetupError, T as UserCancelledError, _ as ProjectLauncherSchema, a as TEMPLATE_COUNT, b as CLIError, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as ProjectCreationError, x as CompatibilityError } from "./src-CCnlcJnd.mjs";
 export { CLIError, CompatibilityError, DatabaseSetupError, DirectoryConflictError, EMBEDDED_TEMPLATES, GeneratorError, ProjectCreationError, ProjectLauncherSchema, Result, SchemaNameSchema, TEMPLATE_COUNT, UserCancelledError, ValidationError, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generate, getSchemaResult, router, sponsors };

package/dist/{src-NAkPN6DN.mjs → src-CCnlcJnd.mjs}

@@ -377,10 +377,7 @@ const cliConsola = {
 */
 var UserCancelledError = class extends TaggedError("UserCancelledError") {
 	constructor(args) {
-		super({
-			message: args?.message ?? "Operation cancelled",
-			prompt: args?.prompt
-		});
+		super({ message: args?.message ?? "Operation cancelled" });
 	}
 };
 /**
@@ -1756,9 +1753,8 @@ function isTelemetryEnabled() {
 //#endregion
 //#region src/utils/diagnostics.ts
 /**
-* Diagnostic events go to the self-hosted Umami instance (a separate "CLI" website),
-* not to the Convex project dataset. They cover what the project-creation event
-* cannot: failures, cancellations, non-create commands, slow stages, and MCP usage.
+* Failure diagnostics go to the self-hosted Umami instance (a separate "CLI" website),
+* not to the Convex project dataset, which only records successful creations.
 * Everything is a no-op until UMAMI_CLI_WEBSITE_ID is baked in at build time.
 */
 const UMAMI_HOST_URL = "https://umami.amanv.cloud";
@@ -1766,17 +1762,6 @@ const UMAMI_CLI_WEBSITE_ID = "e658611d-dbcc-4d3a-bc4e-182b9f5b0d5d";
 const SEND_TIMEOUT_MS$1 = 3e3;
 const MAX_STRING_LENGTH = 500;
 const MAX_REASON_LENGTH = 160;
-const DURATION_BUCKETS = [
-	[1e3, "<1s"],
-	[5e3, "1-5s"],
-	[15e3, "5-15s"],
-	[6e4, "15-60s"],
-	[3e5, "1-5m"]
-];
-function durationBucket(elapsedMs) {
-	for (const [limit, label] of DURATION_BUCKETS) if (elapsedMs < limit) return label;
-	return ">5m";
-}
 /** Class name of the failure, which is stable and never carries user content. */
 function errorClass(cause) {
 	if (cause instanceof Error) return cause.name || cause.constructor.name || "Error";
@@ -1794,7 +1779,7 @@ function failureStage(cause) {
 }
 /**
 * First line of an error message with anything that could identify a machine or
-* project replaced by placeholders: file paths, URLs, emails, and quoted names.
+* project replaced by placeholders: quoted names, URLs, emails, and paths.
 */
 function scrubReason(cause) {
 	const scrubbed = ((cause instanceof Error ? cause.message : String(cause)).split(/\r?\n/, 1)[0] ?? "").replaceAll(/(["'`])(?:(?!\1).)*\1/g, "<name>").replaceAll(/https?:\/\/[^\s)\]"'>]+/gi, "<url>").replaceAll(/[\w.+-]+@[\w-]+\.[\w.-]+/g, "<email>").replaceAll(/(?:[a-zA-Z]:)?(?:[\\/][\w.@+ -]+)+[\\/][\w.@+-]+(?:[ \w.@+-]*\.\w+)?/g, "<path>").replaceAll(/\S*[\\/]\S*/g, "<path>").replaceAll(/\s+/g, " ").trim();
@@ -1807,11 +1792,6 @@ function clampValue(value) {
 function isDiagnosticsEnabled() {
 	return Boolean(UMAMI_HOST_URL) && Boolean(UMAMI_CLI_WEBSITE_ID) && isTelemetryEnabled() && !getContext().analyticsDisabled;
 }
-function eventUrl(name, data) {
-	if (name.startsWith("mcp_")) return "/mcp";
-	const command = data.command;
-	return command === void 0 ? `/${name}` : `/${String(command)}`;
-}
 function buildDiagnosticPayload(name, data) {
 	const eventData = {};
 	for (const [key, value] of Object.entries(data)) if (value !== void 0) eventData[key] = clampValue(value);
@@ -1820,7 +1800,7 @@ function buildDiagnosticPayload(name, data) {
 		payload: {
 			website: UMAMI_CLI_WEBSITE_ID,
 			hostname: "cli",
-			url: eventUrl(name, eventData),
+			url: `/${data.command}`,
 			title: name,
 			name,
 			data: eventData
@@ -1846,16 +1826,6 @@ async function reportDiagnostic(name, data) {
 		catch: () => void 0
 	});
 }
-/** Reports a stage only when it crossed the slow threshold, so the event is a signal. */
-async function reportSlowStage(command, stage, elapsedMs, packageManager) {
-	if (elapsedMs < 6e4) return;
-	await reportDiagnostic("cli_slow", {
-		command,
-		stage,
-		duration: durationBucket(elapsedMs),
-		packageManager
-	});
-}
 //#endregion
 //#region src/utils/input-hardening.ts
 function hasControlCharacters(value) {
@@ -2731,10 +2701,7 @@ async function navigableGroup(prompts, opts) {
 			if (isCancel$1(result)) {
 				if (opts?.onCancel) {
 					results[name] = "canceled";
-					opts.onCancel({
-						results,
-						prompt: String(name)
-					});
+					opts.onCancel({ results });
 				}
 				return results;
 			}
@@ -4921,9 +4888,8 @@ async function addHandler(input, options = {}) {
 		silent,
 		mode
 	}, async () => {
-		const startTime = Date.now();
 		const result = await addHandlerInternal(input);
-		await reportAddOutcome(input, result, Date.now() - startTime);
+		await reportAddOutcome(input, result);
 		if (result.isOk()) return result.value;
 		const error = result.error;
 		if (UserCancelledError.is(error)) {
@@ -4945,36 +4911,13 @@ async function addHandler(input, options = {}) {
 		process.exit(1);
 	});
 }
-async function reportAddOutcome(input, result, elapsedMs) {
-	const mode = resolveInvocationMode(false);
-	const duration = durationBucket(elapsedMs);
-	if (result.isOk()) {
-		await reportDiagnostic("cli_command", {
-			command: "add",
-			mode,
-			ok: true,
-			duration
-		});
-		return;
-	}
+async function reportAddOutcome(input, result) {
+	if (result.isOk()) return;
 	const error = result.error;
-	if (UserCancelledError.is(error)) {
-		await reportDiagnostic("cli_cancelled", {
-			command: "add",
-			mode,
-			prompt: error.prompt ?? "unknown"
-		});
-		return;
-	}
-	await reportDiagnostic("cli_command", {
-		command: "add",
-		mode,
-		ok: false,
-		duration
-	});
+	if (UserCancelledError.is(error)) return;
 	await reportDiagnostic("cli_failed", {
 		command: "add",
-		mode,
+		mode: resolveInvocationMode(false),
 		stage: failureStage(error),
 		error: errorClass(error),
 		reason: scrubReason(error),
@@ -6278,11 +6221,8 @@ async function gatherConfig(flags, projectName, projectDir, relativePath, option
 				]
 			}
 		],
-		onCancel: ({ prompt }) => {
-			throw new UserCancelledError({
-				message: "Operation cancelled",
-				prompt
-			});
+		onCancel: () => {
+			throw new UserCancelledError({ message: "Operation cancelled" });
 		}
 	});
 	return {
@@ -6367,10 +6307,7 @@ async function getProjectName(initialName) {
 				}
 			}
 		});
-		if (isCancel(response)) throw new UserCancelledError({
-			message: "Operation cancelled.",
-			prompt: "projectName"
-		});
+		if (isCancel(response)) throw new UserCancelledError({ message: "Operation cancelled." });
 		projectPath = response || defaultName;
 		isValid = true;
 	}
@@ -9005,14 +8942,10 @@ async function createProject(options, cliInput) {
 		}));
 		yield* Result.await(formatProject(projectDir));
 		if (!isSilent()) log.success("Project scaffolded");
-		if (options.install) {
-			const installStartTime = Date.now();
-			yield* Result.await(installDependencies({
-				projectDir,
-				packageManager: options.packageManager
-			}));
-			await reportSlowStage("create", "install", Date.now() - installStartTime, options.packageManager);
-		}
+		if (options.install) yield* Result.await(installDependencies({
+			projectDir,
+			packageManager: options.packageManager
+		}));
 		yield* Result.await(initializeGit(projectDir, options.git));
 		if (!isSilent()) await displayPostInstallInstructions({
 			...options,
@@ -9084,7 +9017,7 @@ async function executeCreateProjectHandler(input, options) {
 		const startTime = Date.now();
 		const timeScaffolded = (/* @__PURE__ */ new Date()).toISOString();
 		const result = await createProjectHandlerInternal(input, startTime, timeScaffolded);
-		await reportCreateOutcome(input, result, Date.now() - startTime);
+		await reportCreateOutcome(input, result);
 		return {
 			result,
 			startTime,
@@ -9092,25 +9025,14 @@ async function executeCreateProjectHandler(input, options) {
 		};
 	});
 }
-/** Diagnostics for what the success-only project event cannot show; awaited so it beats process.exit. */
-async function reportCreateOutcome(input, result, elapsedMs) {
-	const mode = resolveInvocationMode(input.yes);
-	if (result.isOk()) {
-		if (!input.dryRun) await reportSlowStage("create", "create", elapsedMs, input.packageManager ?? "unknown");
-		return;
-	}
+/** Failure diagnostics, which the success-only project event cannot show; awaited so it beats process.exit. */
+async function reportCreateOutcome(input, result) {
+	if (result.isOk()) return;
 	const error = result.error;
-	if (UserCancelledError.is(error)) {
-		await reportDiagnostic("cli_cancelled", {
-			command: "create",
-			mode,
-			prompt: error.prompt ?? "unknown"
-		});
-		return;
-	}
+	if (UserCancelledError.is(error)) return;
 	await reportDiagnostic("cli_failed", {
 		command: "create",
-		mode,
+		mode: resolveInvocationMode(input.yes),
 		stage: failureStage(error),
 		error: errorClass(error),
 		reason: scrubReason(error),
@@ -9500,9 +9422,9 @@ const router = t.router({
 		return result;
 	}),
 	schema: t.procedure.meta({ description: "Show runtime CLI and input schemas as JSON" }).input(z.object({ name: SchemaNameSchema.describe("Schema name to inspect") })).query(({ input }) => getSchemaResult(input.name)),
-	sponsors: t.procedure.meta({ description: "Show Better-T-Stack sponsors" }).mutation(() => trackCommand("sponsors", () => showSponsorsCommand())),
-	docs: t.procedure.meta({ description: "Open Better-T-Stack documentation" }).mutation(() => trackCommand("docs", () => openDocsCommand())),
-	builder: t.procedure.meta({ description: "Open the web-based stack builder" }).mutation(() => trackCommand("builder", () => openBuilderCommand())),
+	sponsors: t.procedure.meta({ description: "Show Better-T-Stack sponsors" }).mutation(() => showSponsorsCommand()),
+	docs: t.procedure.meta({ description: "Open Better-T-Stack documentation" }).mutation(() => openDocsCommand()),
+	builder: t.procedure.meta({ description: "Open the web-based stack builder" }).mutation(() => openBuilderCommand()),
 	add: t.procedure.meta({ description: "Add addons or a workspace package to an existing Better-T-Stack project" }).input(z.object({
 		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
 		package: types_exports.WorkspacePackageNameSchema.optional(),
@@ -9530,29 +9452,9 @@ const router = t.router({
 		clear: z.boolean().optional().default(false).describe("Clear all history"),
 		json: z.boolean().optional().default(false).describe("Output as JSON")
 	})).mutation(async ({ input }) => {
-		await trackCommand("history", () => historyHandler(input), (ok) => ok);
+		await historyHandler(input);
 	})
 });
-/** Usage diagnostics for commands that have no project event of their own. */
-async function trackCommand(command, run, isOk = () => true) {
-	const startTime = Date.now();
-	try {
-		const value = await run();
-		await reportDiagnostic("cli_command", {
-			command,
-			ok: isOk(value),
-			duration: durationBucket(Date.now() - startTime)
-		});
-		return value;
-	} catch (cause) {
-		await reportDiagnostic("cli_command", {
-			command,
-			ok: false,
-			duration: durationBucket(Date.now() - startTime)
-		});
-		throw cause;
-	}
-}
 function createBtsCli() {
 	return createCli({
 		router,
@@ -9739,4 +9641,4 @@ async function add(options = {}) {
 	};
 }
 //#endregion
-export { setProcessMode as A, CLIError as C, ProjectCreationError as D, DirectoryConflictError as E, UserCancelledError as O, getLatestCLIVersion as S, DatabaseSetupError as T, ProjectLauncherSchema as _, TEMPLATE_COUNT as a, scrubReason as b, builder as c, createVirtual as d, docs as f, sponsors as g, router as h, SchemaNameSchema as i, ValidationError as k, create as l, getSchemaResult as m, GeneratorError$1 as n, VirtualFileSystem$1 as o, generate$1 as p, Result$1 as r, add as s, EMBEDDED_TEMPLATES$1 as t, createBtsCli as u, durationBucket as v, CompatibilityError as w, types_exports as x, reportDiagnostic as y };
+export { DirectoryConflictError as C, setProcessMode as D, ValidationError as E, DatabaseSetupError as S, UserCancelledError as T, ProjectLauncherSchema as _, TEMPLATE_COUNT as a, CLIError as b, builder as c, createVirtual as d, docs as f, sponsors as g, router as h, SchemaNameSchema as i, create as l, getSchemaResult as m, GeneratorError$1 as n, VirtualFileSystem$1 as o, generate$1 as p, Result$1 as r, add as s, EMBEDDED_TEMPLATES$1 as t, createBtsCli as u, types_exports as v, ProjectCreationError as w, CompatibilityError as x, getLatestCLIVersion as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.41.0",
+  "version": "3.41.2",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "keywords": [
     "better-auth",
@@ -69,8 +69,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-t-stack/template-generator": "^3.41.0",
-    "@better-t-stack/types": "^3.41.0",
+    "@better-t-stack/template-generator": "^3.41.2",
+    "@better-t-stack/types": "^3.41.2",
     "@clack/core": "^1.4.3",
     "@clack/prompts": "^1.7.0",
     "@modelcontextprotocol/server": "2.0.0",