@getjack/jack 0.1.2 → 0.1.3

package/package.json

@@ -1,49 +1,56 @@
 {
-  "name": "@getjack/jack",
-  "version": "0.1.2",
-  "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"
-  }
+	"name": "@getjack/jack",
+	"version": "0.1.3",
+	"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"
+	],
+	"engines": {
+		"bun": ">=1.0.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/getjack-org/jack"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"cli",
+		"deploy",
+		"vibecoding",
+		"vibecode",
+		"shipping",
+		"edge",
+		"serverless",
+		"ai-agent",
+		"claude",
+		"cursor"
+	],
+	"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": {
+		"@types/archiver": "^7.0.0",
+		"bun-types": "latest"
+	},
+	"dependencies": {
+		"@inquirer/prompts": "^7.0.0",
+		"@modelcontextprotocol/sdk": "^1.25.1",
+		"archiver": "^7.0.1",
+		"human-id": "^4.1.3",
+		"meow": "^14.0.0",
+		"posthog-node": "^5.17.4",
+		"yocto-spinner": "^1.0.0",
+		"zod": "^4.2.1"
+	}
 }

package/src/commands/agents.ts

@@ -1,8 +1,12 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { regenerateAgentFiles } from "../lib/agent-files.ts";
 import {
 	AGENT_REGISTRY,
 	addAgent,
 	disableAgent,
 	enableAgent,
+	getActiveAgents,
 	getAgentDefinition,
 	getPreferredAgent,
 	pathExists,
@@ -12,12 +16,24 @@ import {
 	updateAgent,
 } from "../lib/agents.ts";
 import { readConfig } from "../lib/config.ts";
-import { error, info, item, output as outputSpinner, success } from "../lib/output.ts";
+import { error, info, item, output as outputSpinner, success, warn } from "../lib/output.ts";
+import { getProject } from "../lib/registry.ts";
+import { getProjectNameFromDir } from "../lib/storage/index.ts";
+import { resolveTemplate } from "../templates/index.ts";
+import type { Template } from "../templates/types.ts";
 
 /**
  * Main agents command - handles all agent management
  */
-export default async function agents(subcommand?: string, args: string[] = []): Promise<void> {
+interface AgentsOptions {
+	project?: string;
+}
+
+export default async function agents(
+	subcommand?: string,
+	args: string[] = [],
+	options: AgentsOptions = {},
+): Promise<void> {
 	if (!subcommand) {
 		return await listAgents();
 	}
@@ -35,9 +51,11 @@ export default async function agents(subcommand?: string, args: string[] = []):
 			return await disableAgentCommand(args);
 		case "prefer":
 			return await preferAgentCommand(args);
+		case "refresh":
+			return await refreshAgentFilesCommand(options);
 		default:
 			error(`Unknown subcommand: ${subcommand}`);
-			info("Available: scan, add, remove, enable, disable, prefer");
+			info("Available: scan, add, remove, enable, disable, prefer, refresh");
 			process.exit(1);
 	}
 }
@@ -76,7 +94,7 @@ async function listAgents(): Promise<void> {
 		console.error("");
 	}
 
-	info("Commands: jack agents scan | add | remove | enable | disable | prefer");
+	info("Commands: jack agents scan | add | remove | enable | disable | prefer | refresh");
 }
 
 /**
@@ -89,6 +107,7 @@ async function scanAndPrompt(): Promise<void> {
 
 	if (detectionResult.detected.length === 0) {
 		info("No agents detected");
+		await listAgents();
 		return;
 	}
 
@@ -98,6 +117,7 @@ async function scanAndPrompt(): Promise<void> {
 
 	if (newAgents.length === 0) {
 		success("No new agents found");
+		await listAgents();
 		return;
 	}
 
@@ -119,13 +139,16 @@ async function scanAndPrompt(): Promise<void> {
 	console.error("");
 	success("New agents enabled");
 	info("Future projects will include context files for these agents");
+	await listAgents();
 }
 
 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]);
+		const current = args[i];
+		const next = args[i + 1];
+		if (current === flag && next) {
+			values.push(next);
 			i++;
 		}
 	}
@@ -174,7 +197,7 @@ async function addAgentCommand(args: string[]): Promise<void> {
 					type: "cli" as const,
 					command: customCommand,
 					args: customArgs.length ? customArgs : undefined,
-			  }
+				}
 			: undefined;
 
 		await addAgent(agentId, { launch: launchOverride });
@@ -190,9 +213,7 @@ async function addAgentCommand(args: string[]): Promise<void> {
 		if (err instanceof Error) {
 			error(err.message);
 			if (err.message.includes("Could not detect")) {
-				info(
-					`Specify launch manually: jack agents add ${agentId} --command /path/to/command`,
-				);
+				info(`Specify launch manually: jack agents add ${agentId} --command /path/to/command`);
 			}
 		}
 		process.exit(1);
@@ -303,3 +324,117 @@ async function preferAgentCommand(args: string[]): Promise<void> {
 		process.exit(1);
 	}
 }
+
+/**
+ * Refresh agent context files from template
+ */
+async function refreshAgentFilesCommand(options: AgentsOptions = {}): Promise<void> {
+	const projectDir = process.cwd();
+	let projectName: string;
+	let project = null;
+
+	if (options.project) {
+		// When --project is specified, we still need to run from that project's directory
+		// since localPath is no longer stored in the registry
+		projectName = options.project;
+		project = await getProject(projectName);
+
+		if (!project) {
+			error(`Project "${projectName}" not found in registry`);
+			info("List projects with: jack projects list");
+			process.exit(1);
+		}
+
+		// Verify the current directory matches the project
+		try {
+			const cwdProjectName = await getProjectNameFromDir(projectDir);
+			if (cwdProjectName !== projectName) {
+				error(`Current directory is not the project "${projectName}"`);
+				info(`Run this command from the ${projectName} project directory`);
+				process.exit(1);
+			}
+		} catch {
+			error(`Current directory is not a valid project`);
+			info(`Run this command from the ${projectName} project directory`);
+			process.exit(1);
+		}
+	} else {
+		// 1. Detect project name from wrangler config
+		outputSpinner.start("Detecting project...");
+		try {
+			projectName = await getProjectNameFromDir(projectDir);
+		} catch {
+			outputSpinner.stop();
+			error("Could not determine project");
+			info("Run this command from a project directory, or use --project <name>");
+			process.exit(1);
+		}
+		outputSpinner.stop();
+
+		// 2. Get project from registry to find template origin
+		project = await getProject(projectName);
+		if (!project) {
+			error(`Project "${projectName}" not found in registry`);
+			info("List projects with: jack projects list");
+			process.exit(1);
+		}
+	}
+
+	if (!project?.template) {
+		error("No template lineage found for this project");
+		info("This project was created before lineage tracking was added.");
+		info("Re-create the project with `jack new` to enable refresh.");
+		process.exit(1);
+	}
+
+	// 3. Resolve template (fetch if GitHub, load if builtin)
+	outputSpinner.start("Loading template...");
+	let template: Template;
+	try {
+		template = await resolveTemplate(project.template.name);
+	} catch (err) {
+		outputSpinner.stop();
+		error(`Failed to load template: ${project.template.name}`);
+		if (err instanceof Error) {
+			info(err.message);
+		}
+		process.exit(1);
+	}
+	outputSpinner.stop();
+
+	// 4. Backup existing files
+	const agentsMdPath = join(projectDir, "AGENTS.md");
+	if (existsSync(agentsMdPath)) {
+		const backupPath = `${agentsMdPath}.backup`;
+		const content = await Bun.file(agentsMdPath).text();
+		await Bun.write(backupPath, content);
+		success("Backed up AGENTS.md → AGENTS.md.backup");
+	}
+
+	const claudeMdPath = join(projectDir, "CLAUDE.md");
+	if (existsSync(claudeMdPath)) {
+		const backupPath = `${claudeMdPath}.backup`;
+		const content = await Bun.file(claudeMdPath).text();
+		await Bun.write(backupPath, content);
+		success("Backed up CLAUDE.md → CLAUDE.md.backup");
+	}
+
+	// 5. Get active agents
+	const activeAgents = await getActiveAgents();
+	if (activeAgents.length === 0) {
+		warn("No active agents configured");
+		info("Run: jack agents scan");
+		process.exit(1);
+	}
+
+	// 6. Regenerate agent files
+	const updatedFiles = await regenerateAgentFiles(projectDir, projectName, template, activeAgents);
+
+	console.error("");
+	success("Refreshed agent context files:");
+	for (const file of updatedFiles) {
+		item(file);
+	}
+	console.error("");
+	info("Review changes: git diff AGENTS.md");
+}

package/src/commands/down.ts

@@ -1,63 +1,55 @@
-import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { select } from "@inquirer/prompts";
 import {
 	checkWorkerExists,
 	deleteDatabase,
 	deleteWorker,
 	exportDatabase,
 } from "../lib/cloudflare-api.ts";
+import { fetchProjectResources } from "../lib/control-plane.ts";
+import { promptSelect } from "../lib/hooks.ts";
+import { managedDown } from "../lib/managed-down.ts";
 import { error, info, item, output, success, warn } from "../lib/output.ts";
-import {
-	type Project,
-	getProject,
-	getProjectDatabaseName,
-	updateProject,
-	updateProjectDatabase,
-} from "../lib/registry.ts";
+import { resolveProject } from "../lib/project-resolver.ts";
+import { type Project, getProject, updateProject } from "../lib/registry.ts";
+import { parseWranglerResources } from "../lib/resources.ts";
 import { deleteCloudProject, getProjectNameFromDir } from "../lib/storage/index.ts";
 
 /**
- * Get database name for a project, with fallback to wrangler config
+ * Resolve database name for a project.
+ * For managed projects: fetch from control plane.
+ * For BYO projects: parse from wrangler.jsonc in cwd.
  */
-async function resolveDbName(project: Project): Promise<string | null> {
-	// First check registry
-	const dbFromRegistry = getProjectDatabaseName(project);
-	if (dbFromRegistry) {
-		return dbFromRegistry;
+async function resolveDatabaseName(project: Project, projectName: string): Promise<string | null> {
+	// For managed projects, fetch from control plane
+	if (project.deploy_mode === "managed" && project.remote?.project_id) {
+		try {
+			const resources = await fetchProjectResources(project.remote.project_id);
+			const d1 = resources.find((r) => r.resource_type === "d1");
+			return d1?.resource_name || null;
+		} catch {
+			return null;
+		}
 	}
 
-	// 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
-			}
+	// For BYO, parse from wrangler config in cwd
+	try {
+		let cwdProjectName: string | null = null;
+		try {
+			cwdProjectName = await getProjectNameFromDir(process.cwd());
+		} catch {
+			cwdProjectName = null;
 		}
 
-		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
-			}
+		if (!cwdProjectName || cwdProjectName !== projectName) {
+			warn(`Run this command from the ${projectName} project directory to manage its database.`);
+			return null;
 		}
-	}
 
-	return null;
+		const resources = await parseWranglerResources(process.cwd());
+		return resources.d1?.name || null;
+	} catch {
+		return null;
+	}
 }
 
 export interface DownFlags {
@@ -78,13 +70,58 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
-		// Get project from registry
+		// Resolve project from all sources (registry + control plane)
+		const resolved = await resolveProject(name);
+
+		// Check if found only on control plane (orphaned managed project)
+		if (resolved?.sources.controlPlane && !resolved.sources.registry) {
+			console.error("");
+			info(`Found "${name}" on jack cloud, linking locally...`);
+		}
+
+		// Get the registry project (may have been created by resolver cache)
 		const project = await getProject(name);
-		if (!project) {
-			warn(`Project '${name}' not found in registry`);
+
+		if (!resolved && !project) {
+			// Not found anywhere
+			warn(`Project '${name}' not found`);
 			info("Will attempt to undeploy if deployed");
 		}
 
+		// Check if this is a managed project (either from resolved or registry)
+		const isManaged =
+			resolved?.remote?.projectId ||
+			(project?.deploy_mode === "managed" && project.remote?.project_id);
+
+		if (isManaged) {
+			// Build project object for managedDown if we only have resolved data
+			const managedProject: Project = project || {
+				workerUrl: resolved?.url || null,
+				createdAt: resolved?.createdAt || new Date().toISOString(),
+				lastDeployed: resolved?.updatedAt || null,
+				status: resolved?.status === "live" ? "live" : "build_failed",
+				deploy_mode: "managed",
+				remote:
+					resolved?.remote && resolved.url
+						? {
+								project_id: resolved.remote.projectId,
+								project_slug: resolved.slug,
+								org_id: resolved.remote.orgId,
+								runjack_url: resolved.url,
+							}
+						: undefined,
+			};
+
+			// Route to managed deletion flow
+			const deleteSuccess = await managedDown(managedProject, name, flags);
+			if (!deleteSuccess) {
+				process.exit(0); // User cancelled
+			}
+			return;
+		}
+
+		// Continue with existing BYO flow...
+
 		// Check if worker exists
 		output.start("Checking deployment...");
 		const workerExists = await checkWorkerExists(name);
@@ -117,7 +154,7 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 
 			console.error("");
 			success(`'${name}' undeployed`);
-			info("Databases and cloud storage were not affected");
+			info("Databases and backups were not affected");
 			console.error("");
 			return;
 		}
@@ -128,23 +165,18 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		if (project?.workerUrl) {
 			item(`URL: ${project.workerUrl}`);
 		}
-		const dbName = project ? await resolveDbName(project) : null;
+		const dbName = project ? await resolveDatabaseName(project, name) : null;
 		if (dbName) {
 			item(`Database: ${dbName}`);
 		}
 		console.error("");
 
 		// Confirm undeploy
-		console.error("  Esc to skip\n");
-		const action = await select({
-			message: "Undeploy this project?",
-			choices: [
-				{ name: "1. Yes", value: "yes" },
-				{ name: "2. No", value: "no" },
-			],
-		});
-
-		if (action === "no") {
+		console.error("");
+		info("Undeploy this project?");
+		const action = await promptSelect(["Yes", "No"]);
+
+		if (action !== 0) {
 			info("Cancelled");
 			return;
 		}
@@ -157,16 +189,11 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			info(`Found database: ${dbName}`);
 
 			// Ask if they want to export first
-			console.error("  Esc to skip\n");
-			const exportAction = await select({
-				message: `Export database '${dbName}' before deleting?`,
-				choices: [
-					{ name: "1. Yes", value: "yes" },
-					{ name: "2. No", value: "no" },
-				],
-			});
+			console.error("");
+			info(`Export database '${dbName}' before deleting?`);
+			const exportAction = await promptSelect(["Yes", "No"]);
 
-			if (exportAction === "yes") {
+			if (exportAction === 0) {
 				const exportPath = join(process.cwd(), `${dbName}-backup.sql`);
 				output.start(`Exporting database to ${exportPath}...`);
 				try {
@@ -176,15 +203,10 @@ 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)}`);
-					console.error("  Esc to skip\n");
-					const continueAction = await select({
-						message: "Continue without exporting?",
-						choices: [
-							{ name: "1. Yes", value: "yes" },
-							{ name: "2. No", value: "no" },
-						],
-					});
-					if (continueAction === "no") {
+					console.error("");
+					info("Continue without exporting?");
+					const continueAction = await promptSelect(["Yes", "No"]);
+					if (continueAction !== 0) {
 						info("Cancelled");
 						return;
 					}
@@ -192,31 +214,20 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 
 			// Ask if they want to delete the database
-			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" },
-				],
-			});
+			console.error("");
+			info(`Delete database '${dbName}'?`);
+			const deleteAction = await promptSelect(["Yes", "No"]);
 
-			shouldDeleteDb = deleteAction === "yes";
+			shouldDeleteDb = deleteAction === 0;
 		}
 
-		// Handle R2 backup deletion
+		// Handle backup deletion
 		let shouldDeleteR2 = false;
 		if (project) {
 			console.error("");
-			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 = deleteR2Action === "yes";
+			info("Delete backup for this project?");
+			const deleteR2Action = await promptSelect(["Yes", "No"]);
+			shouldDeleteR2 = deleteR2Action === 0;
 		}
 
 		// Execute deletions
@@ -243,9 +254,6 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 				await deleteDatabase(dbName);
 				output.stop();
 				success(`Database '${dbName}' deleted`);
-
-				// Update registry
-				await updateProjectDatabase(name, null);
 			} catch (err) {
 				output.stop();
 				warn(
@@ -254,20 +262,20 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
-		// Delete cloud backup if requested
+		// Delete backup if requested
 		if (shouldDeleteR2) {
-			output.start("Deleting cloud backup...");
+			output.start("Deleting backup...");
 			try {
 				const deleted = await deleteCloudProject(name);
 				output.stop();
 				if (deleted) {
-					success("Cloud backup deleted");
+					success("Backup deleted");
 				} else {
-					warn("No cloud backup found or already deleted");
+					warn("No backup found or already deleted");
 				}
 			} catch (err) {
 				output.stop();
-				warn(`Failed to delete cloud backup: ${err instanceof Error ? err.message : String(err)}`);
+				warn(`Failed to delete backup: ${err instanceof Error ? err.message : String(err)}`);
 			}
 		}