@wundero/bts 3.44.1-preview-20260929-07a3082

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+import { b as types_exports, g as getSchemaResult, i as SchemaNameSchema, k as setProcessMode, l as create, s as add, u as createBtsCli, x as getLatestCLIVersion } from "./src-Bs-QhN50.mjs";
+import { lineByLineConsoleLogger } from "trpc-cli";
+import z from "zod";
+import { McpServer } from "@modelcontextprotocol/server";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+//#region src/mcp.ts
+const ToolResponseSchema = z.object({
+	ok: z.boolean(),
+	data: z.any().optional(),
+	error: z.string().optional()
+});
+const SchemaToolInputSchema = z.object({ name: SchemaNameSchema.optional().describe("Schema name to inspect. Defaults to all.") });
+const McpCreateProjectInputSchema = types_exports.CreateInputSchema.safeExtend({
+	projectName: z.string().describe("Project name or relative path"),
+	frontend: z.array(types_exports.FrontendSchema).describe("Explicit frontend app surfaces. Do not use native frontends as styling options."),
+	backend: types_exports.BackendSchema.describe("Explicit backend framework"),
+	runtime: types_exports.RuntimeSchema.describe("Explicit runtime environment"),
+	database: types_exports.DatabaseSchema.describe("Explicit database choice"),
+	orm: types_exports.ORMSchema.describe("Explicit ORM choice"),
+	api: types_exports.APISchema.describe("Explicit API layer"),
+	auth: types_exports.AuthSchema.describe("Explicit authentication provider"),
+	payments: types_exports.PaymentsSchema.describe("Explicit payments provider"),
+	emailRenderer: types_exports.EmailRendererSchema.describe("Explicit email renderer"),
+	emailDeploy: types_exports.EmailDeploySchema.describe("Explicit email deployment choice"),
+	addons: z.array(types_exports.AddonsSchema).describe("Explicit addon list. Use [] when no addons are needed."),
+	examples: z.array(types_exports.ExamplesSchema).describe("Explicit example list. Use [] when no examples are needed."),
+	git: z.boolean().describe("Whether to initialize a git repository"),
+	packageManager: types_exports.PackageManagerSchema.describe("Explicit package manager"),
+	install: z.boolean().describe("Whether to install dependencies"),
+	dbSetup: types_exports.DatabaseSetupSchema.describe("Explicit database setup/provisioning choice"),
+	webDeploy: types_exports.WebDeploySchema.describe("Explicit web deployment choice"),
+	serverDeploy: types_exports.ServerDeploySchema.describe("Explicit server deployment choice"),
+	addonOptions: types_exports.AddonOptionsSchema.optional(),
+	dbSetupOptions: types_exports.DbSetupOptionsSchema.optional(),
+	shadcn: types_exports.ShadcnConfigSchema.optional().describe("shadcn theme configuration. Set preset to a preset code, named preset, or preset URL."),
+	directoryConflict: types_exports.DirectoryConflictSchema.optional()
+}).describe("Explicit Better T Stack project configuration for MCP use. Provide the full stack config instead of relying on inferred defaults.");
+function formatToolSuccess(data) {
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify(data, null, 2)
+		}],
+		structuredContent: {
+			ok: true,
+			data
+		}
+	};
+}
+function formatToolError(cause) {
+	const message = cause instanceof Error ? cause.message : String(cause);
+	return {
+		content: [{
+			type: "text",
+			text: message
+		}],
+		structuredContent: {
+			ok: false,
+			error: message
+		},
+		isError: true
+	};
+}
+function getProjectToolAnnotations() {
+	return {
+		destructiveHint: true,
+		idempotentHint: false,
+		openWorldHint: true
+	};
+}
+function getMcpInstallTimeoutMessage(packageManager) {
+	return [
+		"MCP project creation requires `install: false`.",
+		"Dependency installation can exceed common MCP client request timeouts and cause the connection to close before the tool returns.",
+		`Scaffold the project first, then run \`${packageManager} install\` in the generated project directory from a terminal.`
+	].join(" ");
+}
+function getStackGuidance() {
+	return {
+		workflow: [
+			"Call bts_get_schema or bts_get_stack_guidance before constructing a config if the request is ambiguous.",
+			"For project creation, build a full explicit config before calling bts_plan_project.",
+			"Always call bts_plan_project before bts_create_project.",
+			"Only call bts_create_project after the plan succeeds and matches the user's intent.",
+			"Use bts_plan_addons before bts_add_addons when adding addons or scaffolding a workspace package in an existing project."
+		],
+		createContract: {
+			requiresExplicitFields: [
+				"projectName",
+				"frontend",
+				"backend",
+				"runtime",
+				"database",
+				"orm",
+				"api",
+				"auth",
+				"payments",
+				"emailRenderer",
+				"emailDeploy",
+				"addons",
+				"examples",
+				"git",
+				"packageManager",
+				"install",
+				"dbSetup",
+				"webDeploy",
+				"serverDeploy"
+			],
+			optionalFields: [
+				"addonOptions",
+				"dbSetupOptions",
+				"shadcn",
+				"directoryConflict"
+			],
+			rule: "Do not call bts_plan_project or bts_create_project with a partial payload. MCP project creation requires the full explicit stack config."
+		},
+		fieldNotes: {
+			frontend: "frontend is for app surfaces only. Choose explicit app targets such as next, react-router, tanstack-router, native-bare, native-uniwind, or native-unistyles.",
+			addons: "addons must be an explicit array. Use [] when no addons are requested.",
+			examples: "examples must be an explicit array. Use [] when no examples are requested.",
+			dbSetup: "dbSetup is always required. Use 'none' when no managed database provisioning is requested.",
+			webDeploy: "webDeploy is always required. Use 'none' when no web deployment target is requested.",
+			serverDeploy: "serverDeploy is always required. Use 'none' when no server deployment target is requested.",
+			emailRenderer: "emailRenderer is always required. Use 'none' when no email rendering setup is requested.",
+			emailDeploy: "emailDeploy is always required. Use 'none' when no email deployment target is requested.",
+			packageManager: "packageManager is always required because installation and reproducible commands depend on it.",
+			install: "install is always required. For MCP project creation, prefer false because many clients enforce request timeouts around long-running dependency installs.",
+			git: "git is always required. Set it to true or false explicitly instead of relying on defaults.",
+			shadcn: "shadcn is optional and only applies to React web frontends. When provided it must include a preset (code, named preset, or preset URL); base defaults to baseui."
+		},
+		ambiguityRules: [
+			"If the user request leaves major stack choices unspecified, stop and resolve them before calling bts_plan_project.",
+			"Do not infer extra app surfaces, addons, examples, or provisioning choices from a template name or styling preference.",
+			"If the user wants the smallest valid stack, still send the full config with explicit 'none', [] , true, or false values where appropriate.",
+			"For MCP execution, scaffold with install=false and let the user or agent run dependency installation separately from a terminal session."
+		]
+	};
+}
+function createBtsMcpServer() {
+	setProcessMode("mcp");
+	const server = new McpServer({
+		name: "create-better-t-stack",
+		version: getLatestCLIVersion()
+	}, { cacheHints: { "tools/list": {
+		ttlMs: 36e5,
+		cacheScope: "public"
+	} } });
+	server.registerTool("bts_get_stack_guidance", {
+		title: "Get Better T Stack MCP Guidance",
+		description: "Read MCP-specific guidance for choosing valid Better T Stack configurations. Use this before planning when user intent is ambiguous. This explains the full explicit config required by MCP project creation, plus important field semantics and ambiguity rules.",
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Get Better T Stack MCP Guidance",
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, 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.",
+		inputSchema: SchemaToolInputSchema,
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Get Better T Stack Schemas",
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, 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.",
+		inputSchema: McpCreateProjectInputSchema,
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Plan Better T Stack Project",
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async (input) => {
+		try {
+			const result = await create(input.projectName, {
+				...input,
+				dryRun: true,
+				disableAnalytics: true
+			});
+			if (result.isErr()) return formatToolError(result.error);
+			return formatToolSuccess(input.install ? {
+				...result.value,
+				warnings: [getMcpInstallTimeoutMessage(input.packageManager)],
+				recommendedMcpExecution: {
+					...input,
+					install: false
+				}
+			} : result.value);
+		} catch (error) {
+			return formatToolError(error);
+		}
+	});
+	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.",
+		inputSchema: McpCreateProjectInputSchema,
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Create Better T Stack Project",
+			...getProjectToolAnnotations()
+		}
+	}, async (input) => {
+		try {
+			if (input.install) return formatToolError(getMcpInstallTimeoutMessage(input.packageManager));
+			const result = await create(input.projectName, {
+				...input,
+				disableAnalytics: input.disableAnalytics ?? false
+			});
+			if (result.isErr()) return formatToolError(result.error);
+			return formatToolSuccess(result.value);
+		} catch (error) {
+			return formatToolError(error);
+		}
+	});
+	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.",
+		inputSchema: types_exports.AddInputSchema,
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Plan Better T Stack Project Additions",
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true,
+			openWorldHint: false
+		}
+	}, async (input) => {
+		try {
+			const result = await add({
+				...input,
+				dryRun: true
+			});
+			if (!result?.success) return formatToolError(result?.error ?? "Failed to plan project additions");
+			return formatToolSuccess(result);
+		} 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.",
+		inputSchema: types_exports.AddInputSchema,
+		outputSchema: ToolResponseSchema,
+		annotations: {
+			title: "Apply Better T Stack Project Additions",
+			destructiveHint: true,
+			idempotentHint: false,
+			openWorldHint: true
+		}
+	}, async (input) => {
+		try {
+			const result = await add(input);
+			if (!result?.success) return formatToolError(result?.error ?? "Failed to update project");
+			return formatToolSuccess(result);
+		} catch (error) {
+			return formatToolError(error);
+		}
+	});
+	return server;
+}
+function startBtsMcpServer() {
+	return serveStdio(() => createBtsMcpServer());
+}
+//#endregion
+//#region src/cli.ts
+const [, , command, ...args] = process.argv;
+if (command === "mcp") {
+	if (args.includes("--help") || args.includes("-h")) {
+		console.log(`Usage: create-better-t-stack mcp
+
+Start the Better T Stack MCP server over stdio.
+
+This command is intended to be launched by an MCP client, for example:
+  create-better-t-stack mcp`);
+		process.exit(0);
+	}
+	await startBtsMcpServer();
+} else await createBtsCli().run({ logger: lineByLineConsoleLogger });
+//#endregion
+export {};