@getjack/jack 0.1.0 → 0.1.1

package/README.md

@@ -34,6 +34,22 @@ jack list
 - [Bun](https://bun.sh) >= 1.0.0
 - Cloudflare account (for deployments)
 
+## Releasing
+
+This project uses [Semantic Versioning](https://semver.org/).
+
+```bash
+# Bump version, commit, and tag
+npm version patch   # 0.1.1 → 0.1.2 (bug fixes)
+npm version minor   # 0.1.1 → 0.2.0 (new features)
+npm version major   # 0.1.1 → 1.0.0 (breaking changes)
+
+# Push to trigger publish
+git push && git push --tags
+```
+
+GitHub Actions automatically publishes to npm when a version tag is pushed.
+
 ## License
 
 Apache-2.0

package/package.json

@@ -1,41 +1,49 @@
 {
-	"name": "@getjack/jack",
-	"version": "0.1.0",
-	"description": "CLI for vibecoders to rapidly deploy to Cloudflare Workers",
-	"license": "Apache-2.0",
-	"type": "module",
-	"bin": {
-		"jack": "./src/index.ts"
-	},
-	"files": [
-		"src",
-		"templates"
-	],
-	"engines": {
-		"bun": ">=1.0.0"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/getjack-org/jack"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"keywords": ["cli", "cloudflare", "workers", "deploy", "vibecode"],
-	"scripts": {
-		"dev": "bun run src/index.ts",
-		"build": "bun build --compile src/index.ts --outfile dist/jack",
-		"lint": "biome check .",
-		"format": "biome format --write ."
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^1.9.0",
-		"bun-types": "latest"
-	},
-	"dependencies": {
-		"@inquirer/prompts": "^7.0.0",
-		"meow": "^14.0.0",
-		"posthog-node": "^5.17.4",
-		"yocto-spinner": "^1.0.0"
-	}
+  "name": "@getjack/jack",
+  "version": "0.1.1",
+  "description": "CLI for vibecoders to rapidly deploy to Cloudflare Workers",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "jack": "./src/index.ts"
+  },
+  "files": [
+    "src",
+    "templates"
+  ],
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getjack-org/jack"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "cli",
+    "cloudflare",
+    "workers",
+    "deploy",
+    "vibecode"
+  ],
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build --compile src/index.ts --outfile dist/jack",
+    "lint": "biome check .",
+    "format": "biome format --write ."
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "bun-types": "latest"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "meow": "^14.0.0",
+    "posthog-node": "^5.17.4",
+    "yocto-spinner": "^1.0.0",
+    "zod": "^4.2.1"
+  }
 }

package/src/commands/agents.ts

@@ -103,7 +103,7 @@ async function scanAndPrompt(): Promise<void> {
 
 	console.error("");
 	success(`Found ${newAgents.length} new agent(s):`);
-	for (const { id, path } of newAgents) {
+	for (const { id, path, launch } of newAgents) {
 		const definition = getAgentDefinition(id);
 		item(`${definition?.name}: ${path}`);
 
@@ -112,6 +112,7 @@ async function scanAndPrompt(): Promise<void> {
 			active: true,
 			path,
 			detectedAt: new Date().toISOString(),
+			launch,
 		});
 	}
 
@@ -120,6 +121,17 @@ async function scanAndPrompt(): Promise<void> {
 	info("Future projects will include context files for these agents");
 }
 
+function getFlagValues(args: string[], flag: string): string[] {
+	const values: string[] = [];
+	for (let i = 0; i < args.length; i++) {
+		if (args[i] === flag && args[i + 1]) {
+			values.push(args[i + 1]);
+			i++;
+		}
+	}
+	return values;
+}
+
 /**
  * Manually add an agent
  */
@@ -128,7 +140,7 @@ async function addAgentCommand(args: string[]): Promise<void> {
 
 	if (!agentId) {
 		error("Agent ID required");
-		info("Usage: jack agents add <id> [--path /custom/path]");
+		info("Usage: jack agents add <id> [--command cmd] [--arg value]");
 		info(`Available IDs: ${AGENT_REGISTRY.map((a) => a.id).join(", ")}`);
 		process.exit(1);
 	}
@@ -140,15 +152,32 @@ async function addAgentCommand(args: string[]): Promise<void> {
 		process.exit(1);
 	}
 
-	// Parse --path flag
-	const pathIndex = rest.indexOf("--path");
-	let customPath: string | undefined;
-	if (pathIndex >= 0 && rest[pathIndex + 1]) {
-		customPath = rest[pathIndex + 1];
+	// Parse flags
+	let customCommand: string | undefined;
+	for (let i = 0; i < rest.length; i++) {
+		if (rest[i] === "--command" && rest[i + 1]) {
+			customCommand = rest[i + 1];
+			break;
+		}
+	}
+	const customArgs = getFlagValues(rest, "--arg");
+
+	if (customArgs.length > 0 && !customCommand) {
+		error("Use --command with --arg");
+		info("Usage: jack agents add <id> [--command cmd] [--arg value]");
+		process.exit(1);
 	}
 
 	try {
-		await addAgent(agentId, customPath);
+		const launchOverride = customCommand
+			? {
+					type: "cli" as const,
+					command: customCommand,
+					args: customArgs.length ? customArgs : undefined,
+			  }
+			: undefined;
+
+		await addAgent(agentId, { launch: launchOverride });
 
 		success(`Added ${definition.name}`);
 		const config = await readConfig();
@@ -161,7 +190,9 @@ async function addAgentCommand(args: string[]): Promise<void> {
 		if (err instanceof Error) {
 			error(err.message);
 			if (err.message.includes("Could not detect")) {
-				info(`Specify path manually: jack agents add ${agentId} --path /path/to/agent`);
+				info(
+					`Specify launch manually: jack agents add ${agentId} --command /path/to/command`,
+				);
 			}
 		}
 		process.exit(1);

package/src/commands/cloud.ts

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { confirm } from "@inquirer/prompts";
+import { select } from "@inquirer/prompts";
 import { formatRelativeTime, formatSize } from "../lib/format.ts";
 import { error, info, item, output as outputSpinner, success } from "../lib/output.ts";
 import { scanProjectFiles } from "../lib/storage/file-filter.ts";
@@ -200,12 +200,16 @@ async function deleteCommand(args: string[]): Promise<void> {
 	console.error("");
 
 	// Confirm deletion
-	const confirmed = await confirm({
+	console.error("  Esc to skip\n");
+	const action = await select({
 		message: `Delete project '${projectName}' from cloud storage?`,
-		default: false,
+		choices: [
+			{ name: "1. Yes", value: "yes" },
+			{ name: "2. No", value: "no" },
+		],
 	});
 
-	if (!confirmed) {
+	if (action === "no") {
 		info("Cancelled");
 		return;
 	}

package/src/commands/down.ts

@@ -1,5 +1,6 @@
+import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { confirm, select } from "@inquirer/prompts";
+import { select } from "@inquirer/prompts";
 import {
 	checkWorkerExists,
 	deleteDatabase,
@@ -7,9 +8,58 @@ import {
 	exportDatabase,
 } from "../lib/cloudflare-api.ts";
 import { error, info, item, output, success, warn } from "../lib/output.ts";
-import { getProject, updateProject } from "../lib/registry.ts";
+import {
+	type Project,
+	getProject,
+	getProjectDatabaseName,
+	updateProject,
+	updateProjectDatabase,
+} from "../lib/registry.ts";
 import { deleteCloudProject, getProjectNameFromDir } from "../lib/storage/index.ts";
 
+/**
+ * Get database name for a project, with fallback to wrangler config
+ */
+async function resolveDbName(project: Project): Promise<string | null> {
+	// First check registry
+	const dbFromRegistry = getProjectDatabaseName(project);
+	if (dbFromRegistry) {
+		return dbFromRegistry;
+	}
+
+	// Fallback: read from wrangler config file
+	if (project.localPath && existsSync(project.localPath)) {
+		const jsoncPath = join(project.localPath, "wrangler.jsonc");
+		if (existsSync(jsoncPath)) {
+			try {
+				const content = await Bun.file(jsoncPath).text();
+				const jsonContent = content.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+				const config = JSON.parse(jsonContent);
+				if (config.d1_databases?.[0]?.database_name) {
+					return config.d1_databases[0].database_name;
+				}
+			} catch {
+				// Ignore parse errors
+			}
+		}
+
+		const tomlPath = join(project.localPath, "wrangler.toml");
+		if (existsSync(tomlPath)) {
+			try {
+				const content = await Bun.file(tomlPath).text();
+				const match = content.match(/database_name\s*=\s*"([^"]+)"/);
+				if (match?.[1]) {
+					return match[1];
+				}
+			} catch {
+				// Ignore read errors
+			}
+		}
+	}
+
+	return null;
+}
+
 export interface DownFlags {
 	force?: boolean;
 }
@@ -32,17 +82,17 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		const project = await getProject(name);
 		if (!project) {
 			warn(`Project '${name}' not found in registry`);
-			info("Will attempt to undeploy worker if it exists");
+			info("Will attempt to undeploy if deployed");
 		}
 
 		// Check if worker exists
-		output.start("Checking worker...");
+		output.start("Checking deployment...");
 		const workerExists = await checkWorkerExists(name);
 		output.stop();
 
 		if (!workerExists) {
 			console.error("");
-			warn(`Worker '${name}' not found`);
+			warn(`'${name}' is not deployed`);
 			info("Nothing to undeploy");
 			return;
 		}
@@ -50,10 +100,10 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		// Force mode - quick deletion without prompts
 		if (flags.force) {
 			console.error("");
-			info(`Undeploying worker '${name}'`);
+			info(`Undeploying '${name}'`);
 			console.error("");
 
-			output.start("Deleting worker...");
+			output.start("Undeploying...");
 			await deleteWorker(name);
 			output.stop();
 
@@ -66,8 +116,8 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 
 			console.error("");
-			success(`Worker '${name}' undeployed`);
-			info("D1 databases and R2 storage were not affected");
+			success(`'${name}' undeployed`);
+			info("Databases and cloud storage were not affected");
 			console.error("");
 			return;
 		}
@@ -76,46 +126,47 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		console.error("");
 		info(`Project: ${name}`);
 		if (project?.workerUrl) {
-			item(`Worker URL: ${project.workerUrl}`);
+			item(`URL: ${project.workerUrl}`);
 		}
-		if (project?.resources.d1Databases && project.resources.d1Databases.length > 0) {
-			item(`D1 Databases: ${project.resources.d1Databases.length}`);
-			for (const db of project.resources.d1Databases) {
-				item(`  - ${db}`);
-			}
+		const dbName = project ? await resolveDbName(project) : null;
+		if (dbName) {
+			item(`Database: ${dbName}`);
 		}
 		console.error("");
 
-		// Prompt for worker deletion
-		const workerAction = await select({
-			message: "What should we do with the worker?",
+		// Confirm undeploy
+		console.error("  Esc to skip\n");
+		const action = await select({
+			message: "Undeploy this project?",
 			choices: [
-				{ name: "Delete (undeploy and remove)", value: "delete" },
-				{ name: "Keep (cancel operation)", value: "keep" },
+				{ name: "1. Yes", value: "yes" },
+				{ name: "2. No", value: "no" },
 			],
-			default: "delete",
 		});
 
-		if (workerAction === "keep") {
+		if (action === "no") {
 			info("Cancelled");
 			return;
 		}
 
-		// Handle D1 databases if they exist
-		const databases = project?.resources.d1Databases || [];
-		const databasesToDelete: string[] = [];
+		// Handle database if it exists
+		let shouldDeleteDb = false;
 
-		for (const dbName of databases) {
+		if (dbName) {
 			console.error("");
-			info(`Found D1 database: ${dbName}`);
+			info(`Found database: ${dbName}`);
 
 			// Ask if they want to export first
-			const shouldExport = await confirm({
+			console.error("  Esc to skip\n");
+			const exportAction = await select({
 				message: `Export database '${dbName}' before deleting?`,
-				default: true,
+				choices: [
+					{ name: "1. Yes", value: "yes" },
+					{ name: "2. No", value: "no" },
+				],
 			});
 
-			if (shouldExport) {
+			if (exportAction === "yes") {
 				const exportPath = join(process.cwd(), `${dbName}-backup.sql`);
 				output.start(`Exporting database to ${exportPath}...`);
 				try {
@@ -125,11 +176,15 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 				} catch (err) {
 					output.stop();
 					error(`Failed to export database: ${err instanceof Error ? err.message : String(err)}`);
-					const continueAnyway = await confirm({
+					console.error("  Esc to skip\n");
+					const continueAction = await select({
 						message: "Continue without exporting?",
-						default: false,
+						choices: [
+							{ name: "1. Yes", value: "yes" },
+							{ name: "2. No", value: "no" },
+						],
 					});
-					if (!continueAnyway) {
+					if (continueAction === "no") {
 						info("Cancelled");
 						return;
 					}
@@ -137,25 +192,31 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 
 			// Ask if they want to delete the database
-			const shouldDelete = await confirm({
-				message: `Delete D1 database '${dbName}'?`,
-				default: false,
+			console.error("  Esc to skip\n");
+			const deleteAction = await select({
+				message: `Delete database '${dbName}'?`,
+				choices: [
+					{ name: "1. Yes", value: "yes" },
+					{ name: "2. No", value: "no" },
+				],
 			});
 
-			if (shouldDelete) {
-				databasesToDelete.push(dbName);
-			}
+			shouldDeleteDb = deleteAction === "yes";
 		}
 
 		// Handle R2 backup deletion
 		let shouldDeleteR2 = false;
 		if (project) {
 			console.error("");
-			const deleteR2Backup = await confirm({
-				message: "Delete R2 backup storage for this project?",
-				default: false,
+			console.error("  Esc to skip\n");
+			const deleteR2Action = await select({
+				message: "Delete cloud backup for this project?",
+				choices: [
+					{ name: "1. Yes", value: "yes" },
+					{ name: "2. No", value: "no" },
+				],
 			});
-			shouldDeleteR2 = deleteR2Backup;
+			shouldDeleteR2 = deleteR2Action === "yes";
 		}
 
 		// Execute deletions
@@ -163,25 +224,28 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		info("Executing cleanup...");
 		console.error("");
 
-		// Delete worker
-		output.start("Deleting worker...");
+		// Undeploy service
+		output.start("Undeploying...");
 		try {
 			await deleteWorker(name);
 			output.stop();
-			success(`Worker '${name}' deleted`);
+			success(`'${name}' undeployed`);
 		} catch (err) {
 			output.stop();
-			error(`Failed to delete worker: ${err instanceof Error ? err.message : String(err)}`);
+			error(`Failed to undeploy: ${err instanceof Error ? err.message : String(err)}`);
 			process.exit(1);
 		}
 
-		// Delete D1 databases
-		for (const dbName of databasesToDelete) {
+		// Delete database if requested
+		if (shouldDeleteDb && dbName) {
 			output.start(`Deleting database '${dbName}'...`);
 			try {
 				await deleteDatabase(dbName);
 				output.stop();
 				success(`Database '${dbName}' deleted`);
+
+				// Update registry
+				await updateProjectDatabase(name, null);
 			} catch (err) {
 				output.stop();
 				warn(
@@ -190,42 +254,29 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
-		// Delete R2 backup if requested
+		// Delete cloud backup if requested
 		if (shouldDeleteR2) {
-			output.start("Deleting R2 backup...");
+			output.start("Deleting cloud backup...");
 			try {
 				const deleted = await deleteCloudProject(name);
 				output.stop();
 				if (deleted) {
-					success("R2 backup deleted");
+					success("Cloud backup deleted");
 				} else {
-					warn("No R2 backup found or already deleted");
+					warn("No cloud backup found or already deleted");
 				}
 			} catch (err) {
 				output.stop();
-				warn(`Failed to delete R2 backup: ${err instanceof Error ? err.message : String(err)}`);
+				warn(`Failed to delete cloud backup: ${err instanceof Error ? err.message : String(err)}`);
 			}
 		}
 
 		// Update registry - keep entry but clear worker URL
 		if (project) {
-			const updates: {
-				workerUrl: null;
-				lastDeployed: null;
-				resources?: { d1Databases: string[] };
-			} = {
+			await updateProject(name, {
 				workerUrl: null,
 				lastDeployed: null,
-			};
-
-			// Remove deleted databases from registry
-			if (databasesToDelete.length > 0) {
-				updates.resources = {
-					d1Databases: databases.filter((db) => !databasesToDelete.includes(db)),
-				};
-			}
-
-			await updateProject(name, updates);
+			});
 		}
 
 		console.error("");

package/src/commands/init.ts

@@ -5,6 +5,11 @@ import {
 	updateAgent,
 } from "../lib/agents.ts";
 import { readConfig, writeConfig } from "../lib/config.ts";
+import {
+	getIdeDisplayName,
+	installMcpConfigsToAllIdes,
+	saveMcpConfig,
+} from "../lib/mcp-config.ts";
 import { info, item, spinner, success } from "../lib/output.ts";
 import { ensureAuth, ensureWrangler, isAuthenticated } from "../lib/wrangler.ts";
 
@@ -14,7 +19,11 @@ export async function isInitialized(): Promise<boolean> {
 	return await isAuthenticated();
 }
 
-export default async function init(): Promise<void> {
+interface InitOptions {
+	skipMcp?: boolean;
+}
+
+export default async function init(options: InitOptions = {}): Promise<void> {
 	// Immediate feedback
 	const spin = spinner("Checking setup...");
 
@@ -47,7 +56,7 @@ export default async function init(): Promise<void> {
 	let preferredAgent: string | undefined;
 	if (detectionResult.detected.length > 0) {
 		success(`Found ${detectionResult.detected.length} agent(s)`);
-		for (const { id, path } of detectionResult.detected) {
+		for (const { id, path, launch } of detectionResult.detected) {
 			const definition = getAgentDefinition(id);
 			item(`${definition?.name}: ${path}`);
 
@@ -56,6 +65,7 @@ export default async function init(): Promise<void> {
 				active: true,
 				path: path,
 				detectedAt: new Date().toISOString(),
+				launch,
 			});
 		}
 
@@ -69,7 +79,35 @@ export default async function init(): Promise<void> {
 		info("No agents detected (you can add them later with: jack agents add)");
 	}
 
-	// Step 4: Save config (preserve existing agents, just update init status)
+	// Step 4: Install MCP configs to detected IDEs (unless --skip-mcp)
+	if (!options.skipMcp) {
+		const mcpSpinner = spinner("Installing MCP server configs...");
+		try {
+			const installedIdes = await installMcpConfigsToAllIdes();
+			mcpSpinner.stop();
+
+			if (installedIdes.length > 0) {
+				success(`MCP server installed to ${installedIdes.length} IDE(s)`);
+				for (const ideId of installedIdes) {
+					item(`  ${getIdeDisplayName(ideId)}`);
+				}
+			} else {
+				info("No supported IDEs detected for MCP installation");
+			}
+		} catch (err) {
+			mcpSpinner.stop();
+			// Don't fail init if MCP install fails - just warn
+			info("Could not install MCP configs (non-critical)");
+		}
+
+		try {
+			await saveMcpConfig();
+		} catch {
+			// Non-critical; config persistence shouldn't block init
+		}
+	}
+
+	// Step 5: Save config (preserve existing agents, just update init status)
 	const existingConfig = await readConfig();
 	await writeConfig({
 		version: 1,

package/src/commands/mcp.ts

@@ -0,0 +1,18 @@
+import { error, info } from "../lib/output.ts";
+import { startMcpServer } from "../mcp/server.ts";
+
+interface McpOptions {
+	project?: string;
+}
+
+export default async function mcp(subcommand?: string, options: McpOptions = {}): Promise<void> {
+	if (subcommand !== "serve") {
+		error("Unknown subcommand. Use: jack mcp serve");
+		info("Usage: jack mcp serve [--project /path/to/project]");
+		process.exit(1);
+	}
+
+	await startMcpServer({
+		projectPath: options.project,
+	});
+}