@getjack/jack 0.1.15 → 0.1.17

package/README.md

@@ -7,7 +7,7 @@
   <a href="https://www.npmjs.com/package/@getjack/jack"><img src="https://img.shields.io/npm/v/@getjack/jack" alt="npm"></a>
   <a href="https://github.com/getjack-org/jack/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="license"></a>
   <a href="https://docs.getjack.org"><img src="https://img.shields.io/badge/docs-getjack.org-green" alt="docs"></a>
-  <a href="https://discord.gg/fb64krv48R"><img src="https://img.shields.io/badge/discord-community-5865F2" alt="discord"></a>
+  <a href="https://community.getjack.org"><img src="https://img.shields.io/badge/discord-community-5865F2" alt="discord"></a>
 </p>
 
 ---

package/package.json

@@ -1,13 +1,16 @@
 {
 	"name": "@getjack/jack",
-	"version": "0.1.15",
+	"version": "0.1.17",
 	"description": "Ship before you forget why you started. The vibecoder's deployment CLI.",
 	"license": "Apache-2.0",
 	"type": "module",
 	"bin": {
 		"jack": "./src/index.ts"
 	},
-	"files": ["src", "templates"],
+	"files": [
+		"src",
+		"templates"
+	],
 	"engines": {
 		"bun": ">=1.0.0"
 	},
@@ -41,6 +44,7 @@
 		"bun-types": "latest"
 	},
 	"dependencies": {
+		"@clack/prompts": "^0.11.0",
 		"@modelcontextprotocol/sdk": "^1.25.1",
 		"archiver": "^7.0.1",
 		"fflate": "^0.8.2",

package/src/commands/clone.ts

@@ -72,7 +72,8 @@ export default async function clone(projectName?: string, flags: CloneFlags = {}
 
 	if (!result.success) {
 		downloadSpin.error("Clone failed");
-		error(result.error || "Unknown error");
+		error(result.error || "Could not download project files");
+		info("Check your network connection and try again");
 		process.exit(1);
 	}
 

package/src/commands/community.ts

@@ -0,0 +1,47 @@
+/**
+ * jack community - Open the jack community Discord
+ */
+
+import { $ } from "bun";
+import { error } from "../lib/output.ts";
+
+const COMMUNITY_URL = "https://community.getjack.org";
+
+export default async function community(): Promise<void> {
+	console.error("");
+	console.error("  Chat with other vibecoders and the jack team.");
+	console.error("");
+	console.error(`  Press Enter to open the browser or visit ${COMMUNITY_URL}`);
+
+	// Wait for Enter key
+	await waitForEnter();
+
+	// Open browser using platform-specific command
+	const cmd =
+		process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+
+	try {
+		await $`${cmd} ${COMMUNITY_URL}`;
+	} catch (err) {
+		error(`Failed to open browser: ${err instanceof Error ? err.message : String(err)}`);
+		console.error(`  Visit: ${COMMUNITY_URL}`);
+	}
+}
+
+async function waitForEnter(): Promise<void> {
+	return new Promise((resolve) => {
+		if (!process.stdin.isTTY) {
+			// Non-interactive, just resolve immediately
+			resolve();
+			return;
+		}
+
+		process.stdin.setRawMode(true);
+		process.stdin.resume();
+		process.stdin.once("data", () => {
+			process.stdin.setRawMode(false);
+			process.stdin.pause();
+			resolve();
+		});
+	});
+}

package/src/commands/down.ts

@@ -100,27 +100,10 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
+		// Track auth state for final messaging
+		let authState: Awaited<ReturnType<typeof getAuthState>> | null = null;
 		if (!resolved && !link) {
-			// Project not found - provide auth-aware messaging
-			const authState = await getAuthState();
-
-			if (authState === "logged-in") {
-				// We're logged in and control plane didn't find it - definitely not a managed project
-				warn(`Project '${name}' not tracked by jack`);
-				info("Checking your Cloudflare account...");
-			} else if (authState === "session-expired") {
-				// Session expired - can't verify if this is a managed project
-				warn(`Project '${name}' not found locally`);
-				info("Session expired - can't check jack cloud");
-				info("If this was deployed via jack, run: jack login");
-				info("Checking your Cloudflare account...");
-			} else {
-				// Not logged in - can't verify if this is a managed project
-				warn(`Project '${name}' not found locally`);
-				info("Not logged in - can't check jack cloud");
-				info("If this was deployed via jack, run: jack login");
-				info("Checking your Cloudflare account...");
-			}
+			authState = await getAuthState();
 		}
 
 		// Check if this is a managed project (from link or resolved data)
@@ -153,8 +136,14 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 
 		if (!workerExists) {
 			console.error("");
-			warn(`'${name}' is not deployed`);
-			info("Nothing to undeploy");
+			error(`Project '${name}' not found`);
+			if (authState === "session-expired") {
+				info("Session expired. Run: jack login");
+			} else if (authState === "not-logged-in") {
+				info("Not logged in. Run: jack login");
+			} else {
+				info("Run jack projects to see your projects");
+			}
 			return;
 		}
 

package/src/commands/link.ts

@@ -46,11 +46,11 @@ export default async function link(projectName?: string, flags: LinkFlags = {}):
 	// BYO mode - generate local ID
 	if (flags.byo) {
 		const projectId = generateByoProjectId();
-		output.start("Creating BYO link...");
+		output.start("Linking to your Cloudflare account...");
 		await linkProject(process.cwd(), projectId, "byo");
 		await registerPath(projectId, process.cwd());
 		output.stop();
-		success("Linked as BYO project");
+		success("Linked to your Cloudflare account");
 		info(`Project ID: ${projectId}`);
 		return;
 	}
@@ -62,7 +62,7 @@ export default async function link(projectName?: string, flags: LinkFlags = {}):
 		// Not logged in and no project name - suggest options
 		error("Not logged in to jack cloud");
 		info("Login with: jack login");
-		info("Or create a BYO link: jack link --byo");
+		info("Or link to your Cloudflare account: jack link --byo");
 		process.exit(1);
 	}
 
@@ -118,9 +118,9 @@ export default async function link(projectName?: string, flags: LinkFlags = {}):
 	output.stop();
 
 	if (projects.length === 0) {
-		error("No managed projects found");
+		error("No projects found");
 		info("Create one with: jack new");
-		info("Or link as BYO: jack link --byo");
+		info("Or link to your Cloudflare account: jack link --byo");
 		process.exit(1);
 	}
 

package/src/commands/projects.ts

@@ -448,7 +448,7 @@ async function removeProjectEntry(args: string[]): Promise<void> {
 	// Warn if still deployed
 	if (project.status === "live") {
 		console.error("");
-		warn("Project is still deployed; removal does not undeploy the worker");
+		warn("Project is still live; this only removes it from jack, not from Cloudflare");
 	}
 
 	console.error("");
@@ -496,7 +496,7 @@ async function removeProjectEntry(args: string[]): Promise<void> {
 	// Hint about undeploying
 	if (project.status === "live") {
 		console.error("");
-		info(`To undeploy the worker, run: jack down ${name}`);
+		info(`To take it offline: jack down ${name}`);
 	}
 }
 

package/src/commands/publish.ts

@@ -12,8 +12,8 @@ export default async function publish(): Promise<void> {
 	}
 
 	if (link.deploy_mode !== "managed") {
-		output.error("Only managed projects can be published");
-		output.info("Projects deployed with BYOC (bring your own cloud) cannot be published");
+		output.error("Only jack cloud projects can be published");
+		output.info("Projects on your own Cloudflare account cannot be published");
 		process.exit(1);
 	}
 

package/src/commands/services.ts

@@ -1,10 +1,17 @@
-import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
 import { fetchProjectResources } from "../lib/control-plane.ts";
 import { formatSize } from "../lib/format.ts";
 import { error, info, item, output as outputSpinner, success, warn } from "../lib/output.ts";
 import { readProjectLink } from "../lib/project-link.ts";
 import { parseWranglerResources } from "../lib/resources.ts";
 import { createDatabase } from "../lib/services/db-create.ts";
+import {
+	DestructiveOperationError,
+	WriteNotAllowedError,
+	executeSql,
+	executeSqlFile,
+} from "../lib/services/db-execute.ts";
 import { listDatabases } from "../lib/services/db-list.ts";
 import {
 	deleteDatabase,
@@ -12,6 +19,7 @@ import {
 	generateExportFilename,
 	getDatabaseInfo as getWranglerDatabaseInfo,
 } from "../lib/services/db.ts";
+import { getRiskDescription } from "../lib/services/sql-classifier.ts";
 import { getProjectNameFromDir } from "../lib/storage/index.ts";
 import { Events, track } from "../lib/telemetry.ts";
 
@@ -125,13 +133,19 @@ function showDbHelp(): void {
 	console.error("  info       Show database information (default)");
 	console.error("  create     Create a new database");
 	console.error("  list       List all databases in the project");
+	console.error("  execute    Execute SQL against the database");
 	console.error("  export     Export database to SQL file");
 	console.error("  delete     Delete a database");
 	console.error("");
 	console.error("Examples:");
-	console.error("  jack services db          Show info about the default database");
-	console.error("  jack services db create   Create a new database");
-	console.error("  jack services db list     List all databases");
+	console.error(
+		"  jack services db                                   Show info about the default database",
+	);
+	console.error("  jack services db create                            Create a new database");
+	console.error("  jack services db list                              List all databases");
+	console.error('  jack services db execute "SELECT * FROM users"     Run a read query');
+	console.error('  jack services db execute "INSERT..." --write       Run a write query');
+	console.error("  jack services db execute --file schema.sql --write Run SQL from file");
 	console.error("");
 }
 
@@ -149,13 +163,15 @@ async function dbCommand(args: string[], options: ServiceOptions): Promise<void>
 			return await dbCreate(args.slice(1), options);
 		case "list":
 			return await dbList(options);
+		case "execute":
+			return await dbExecute(args.slice(1), options);
 		case "export":
 			return await dbExport(options);
 		case "delete":
 			return await dbDelete(options);
 		default:
 			error(`Unknown action: ${action}`);
-			info("Available: info, create, list, export, delete");
+			info("Available: info, create, list, execute, export, delete");
 			process.exit(1);
 	}
 }
@@ -186,9 +202,8 @@ async function dbInfo(options: ServiceOptions): Promise<void> {
 
 	if (!dbInfo) {
 		console.error("");
-		error("No database found for this project.");
-		info("For managed projects, create a database with: jack services db create");
-		info("For BYO projects, add d1_databases to your wrangler.jsonc");
+		error("No database found for this project");
+		info("Create one with: jack services db create");
 		console.error("");
 		return;
 	}
@@ -228,9 +243,8 @@ async function dbExport(options: ServiceOptions): Promise<void> {
 
 	if (!dbInfo) {
 		console.error("");
-		error("No database found for this project.");
-		info("For managed projects, create a database with: jack services db create");
-		info("For BYO projects, add d1_databases to your wrangler.jsonc");
+		error("No database found for this project");
+		info("Create one with: jack services db create");
 		console.error("");
 		return;
 	}
@@ -267,9 +281,8 @@ async function dbDelete(options: ServiceOptions): Promise<void> {
 
 	if (!dbInfo) {
 		console.error("");
-		error("No database found for this project.");
-		info("For managed projects, create a database with: jack services db create");
-		info("For BYO projects, add d1_databases to your wrangler.jsonc");
+		error("No database found for this project");
+		info("Create one with: jack services db create");
 		console.error("");
 		return;
 	}
@@ -430,3 +443,251 @@ async function dbList(options: ServiceOptions): Promise<void> {
 		process.exit(1);
 	}
 }
+
+/**
+ * Parse execute command arguments
+ * Supports:
+ *   jack services db execute "SELECT * FROM users"
+ *   jack services db execute "INSERT..." --write
+ *   jack services db execute --file schema.sql --write
+ *   jack services db execute --db my-other-db "SELECT..."
+ */
+interface ExecuteArgs {
+	sql?: string;
+	filePath?: string;
+	allowWrite: boolean;
+	databaseName?: string;
+}
+
+function parseExecuteArgs(args: string[]): ExecuteArgs {
+	const result: ExecuteArgs = {
+		allowWrite: false,
+	};
+
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (!arg) continue;
+
+		if (arg === "--write" || arg === "-w") {
+			result.allowWrite = true;
+			continue;
+		}
+
+		if (arg === "--file" || arg === "-f") {
+			result.filePath = args[i + 1];
+			i++; // Skip the next arg
+			continue;
+		}
+
+		if (arg.startsWith("--file=")) {
+			result.filePath = arg.slice("--file=".length);
+			continue;
+		}
+
+		if (arg === "--db" || arg === "--database") {
+			result.databaseName = args[i + 1];
+			i++; // Skip the next arg
+			continue;
+		}
+
+		if (arg.startsWith("--db=")) {
+			result.databaseName = arg.slice("--db=".length);
+			continue;
+		}
+
+		if (arg.startsWith("--database=")) {
+			result.databaseName = arg.slice("--database=".length);
+			continue;
+		}
+
+		// Any other non-flag argument is the SQL query
+		if (!arg.startsWith("-")) {
+			result.sql = arg;
+		}
+	}
+
+	return result;
+}
+
+/**
+ * Execute SQL against the database
+ */
+async function dbExecute(args: string[], _options: ServiceOptions): Promise<void> {
+	const execArgs = parseExecuteArgs(args);
+
+	// Validate input
+	if (!execArgs.sql && !execArgs.filePath) {
+		console.error("");
+		error("No SQL provided");
+		info('Usage: jack services db execute "SELECT * FROM users"');
+		info("       jack services db execute --file schema.sql --write");
+		console.error("");
+		process.exit(1);
+	}
+
+	// Cannot specify both SQL and file
+	if (execArgs.sql && execArgs.filePath) {
+		console.error("");
+		error("Cannot specify both inline SQL and --file");
+		info("Use either inline SQL or --file, not both");
+		console.error("");
+		process.exit(1);
+	}
+
+	// If using --file, verify file exists
+	if (execArgs.filePath) {
+		const absPath = resolve(process.cwd(), execArgs.filePath);
+		if (!existsSync(absPath)) {
+			console.error("");
+			error(`File not found: ${execArgs.filePath}`);
+			console.error("");
+			process.exit(1);
+		}
+		execArgs.filePath = absPath;
+	}
+
+	const projectDir = process.cwd();
+
+	try {
+		outputSpinner.start("Executing SQL...");
+
+		let result;
+		if (execArgs.filePath) {
+			result = await executeSqlFile({
+				projectDir,
+				filePath: execArgs.filePath,
+				databaseName: execArgs.databaseName,
+				allowWrite: execArgs.allowWrite,
+				interactive: true,
+			});
+		} else {
+			result = await executeSql({
+				projectDir,
+				sql: execArgs.sql!,
+				databaseName: execArgs.databaseName,
+				allowWrite: execArgs.allowWrite,
+				interactive: true,
+			});
+		}
+
+		// Handle destructive operations - need confirmation BEFORE execution
+		if (result.requiresConfirmation) {
+			outputSpinner.stop();
+
+			// Find the destructive statements
+			const destructiveStmts = result.statements.filter((s) => s.risk === "destructive");
+
+			console.error("");
+			warn("This SQL contains destructive operations:");
+			for (const stmt of destructiveStmts) {
+				item(`${stmt.operation}: ${stmt.sql.slice(0, 60)}${stmt.sql.length > 60 ? "..." : ""}`);
+			}
+			console.error("");
+
+			// Require typed confirmation
+			const { text } = await import("@clack/prompts");
+			const confirmText = destructiveStmts
+				.map((s) => s.operation)
+				.join(" ")
+				.toUpperCase();
+
+			const userInput = await text({
+				message: `Type "${confirmText}" to confirm:`,
+				validate: (value) => {
+					if (value.toUpperCase() !== confirmText) {
+						return `Please type "${confirmText}" exactly to confirm`;
+					}
+				},
+			});
+
+			if (typeof userInput !== "string") {
+				info("Cancelled");
+				return;
+			}
+
+			// NOW execute with confirmation (interactive: false means "already confirmed")
+			outputSpinner.start("Executing SQL...");
+			if (execArgs.filePath) {
+				result = await executeSqlFile({
+					projectDir,
+					filePath: execArgs.filePath,
+					databaseName: execArgs.databaseName,
+					allowWrite: true,
+					interactive: false, // Already confirmed, execute now
+				});
+			} else {
+				result = await executeSql({
+					projectDir,
+					sql: execArgs.sql!,
+					databaseName: execArgs.databaseName,
+					allowWrite: true,
+					interactive: false, // Already confirmed, execute now
+				});
+			}
+		}
+
+		outputSpinner.stop();
+
+		if (!result.success) {
+			console.error("");
+			error(result.error || "SQL execution failed");
+			console.error("");
+			process.exit(1);
+		}
+
+		// Show results
+		console.error("");
+		success(`SQL executed (${getRiskDescription(result.risk)})`);
+
+		if (result.meta?.changes !== undefined && result.meta.changes > 0) {
+			item(`Rows affected: ${result.meta.changes}`);
+		}
+
+		if (result.meta?.duration_ms !== undefined) {
+			item(`Duration: ${result.meta.duration_ms}ms`);
+		}
+
+		if (result.warning) {
+			console.error("");
+			warn(result.warning);
+		}
+
+		// Output query results
+		if (result.results && result.results.length > 0) {
+			console.error("");
+			console.log(JSON.stringify(result.results, null, 2));
+		}
+		console.error("");
+
+		// Track telemetry
+		track(Events.SQL_EXECUTED, {
+			risk_level: result.risk,
+			statement_count: result.statements.length,
+			from_file: !!execArgs.filePath,
+		});
+	} catch (err) {
+		outputSpinner.stop();
+
+		if (err instanceof WriteNotAllowedError) {
+			console.error("");
+			error(err.message);
+			info("Add the --write flag to allow data modification:");
+			info(`  jack services db execute "${execArgs.sql || `--file ${execArgs.filePath}`}" --write`);
+			console.error("");
+			process.exit(1);
+		}
+
+		if (err instanceof DestructiveOperationError) {
+			console.error("");
+			error(err.message);
+			info("Destructive operations require confirmation via CLI.");
+			console.error("");
+			process.exit(1);
+		}
+
+		console.error("");
+		error(`SQL execution failed: ${err instanceof Error ? err.message : String(err)}`);
+		console.error("");
+		process.exit(1);
+	}
+}

package/src/commands/sync.ts

@@ -20,8 +20,8 @@ export default async function sync(flags: SyncFlags = {}): Promise<void> {
 
 	// Check for wrangler config
 	if (!hasWranglerConfig()) {
-		error("No wrangler config found in current directory");
-		error("Run: jack new <project-name>");
+		error("Not in a project directory");
+		info("Run jack new <name> to create a project");
 		process.exit(1);
 	}
 
@@ -39,10 +39,12 @@ export default async function sync(flags: SyncFlags = {}): Promise<void> {
 	const result = await syncToCloud(projectDir, { force, dryRun, verbose });
 
 	if (!result.success) {
-		syncSpin.error("Sync failed");
+		syncSpin.stop();
+		error("Sync failed");
 		if (result.error) {
-			error(result.error);
+			info(result.error);
 		}
+		info("Check your network connection and try again");
 		process.exit(1);
 	}
 

package/src/index.ts

@@ -49,6 +49,7 @@ const cli = meow(
     mcp                 MCP server for AI agents
     telemetry           Usage data settings
     feedback            Share feedback or report issues
+    community           Join the jack Discord
 
   Run 'jack <command> --help' for command-specific options.
 
@@ -370,6 +371,12 @@ try {
 			await withTelemetry("feedback", feedback)();
 			break;
 		}
+		case "community":
+		case "discord": {
+			const { default: community } = await import("./commands/community.ts");
+			await withTelemetry("community", community)();
+			break;
+		}
 		case "link": {
 			const { default: link } = await import("./commands/link.ts");
 			await withTelemetry("link", link)(args[0], { byo: cli.flags.byo });

package/src/lib/build-helper.ts

@@ -217,11 +217,11 @@ export async function buildProject(options: BuildOptions): Promise<BuildOutput>
 
 	if (dryRunResult.exitCode !== 0) {
 		reporter?.stop();
-		reporter?.error("Worker build failed");
+		reporter?.error("Build failed");
 		throw new JackError(
 			JackErrorCode.BUILD_FAILED,
-			"Worker build failed",
-			"Check your wrangler.jsonc and worker code for errors",
+			"Build failed",
+			"Check your code for syntax errors",
 			{
 				exitCode: dryRunResult.exitCode,
 				stderr: dryRunResult.stderr.toString(),

package/src/lib/hooks.ts

@@ -478,6 +478,26 @@ const actionHandlers: {
 			if (action.successMessage) {
 				ui.success(substituteVars(action.successMessage, context));
 			}
+
+			// Redeploy if deployAfter is set and we have a valid project directory
+			if (action.deployAfter && context.projectDir) {
+				const deployMsg = action.deployMessage || "Deploying...";
+				ui.info(deployMsg);
+
+				const proc = Bun.spawn(["wrangler", "deploy"], {
+					cwd: context.projectDir,
+					stdout: "ignore",
+					stderr: "pipe",
+				});
+				await proc.exited;
+
+				if (proc.exitCode === 0) {
+					ui.success("Deployed");
+				} else {
+					const stderr = await new Response(proc.stderr).text();
+					ui.warn(`Deploy failed: ${stderr.slice(0, 200)}`);
+				}
+			}
 		}
 
 		return true;