@getjack/jack 0.1.4 → 0.1.6

package/package.json

@@ -1,16 +1,13 @@
 {
 	"name": "@getjack/jack",
-	"version": "0.1.4",
+	"version": "0.1.6",
 	"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"
 	},
@@ -49,7 +46,6 @@
 		"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

@@ -17,7 +17,7 @@ import {
 } from "../lib/agents.ts";
 import { readConfig } from "../lib/config.ts";
 import { error, info, item, output as outputSpinner, success, warn } from "../lib/output.ts";
-import { getProject } from "../lib/registry.ts";
+import { readTemplateMetadata } from "../lib/project-link.ts";
 import { getProjectNameFromDir } from "../lib/storage/index.ts";
 import { resolveTemplate } from "../templates/index.ts";
 import type { Template } from "../templates/types.ts";
@@ -116,7 +116,7 @@ async function scanAndPrompt(): Promise<void> {
 	const newAgents = detectionResult.detected.filter(({ id }) => !existingAgents[id]);
 
 	if (newAgents.length === 0) {
-		success("No new agents found");
+		success("All agents up to date");
 		await listAgents();
 		return;
 	}
@@ -331,19 +331,10 @@ async function preferAgentCommand(args: string[]): Promise<void> {
 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
+		// When --project is specified, verify we're in that project's directory
 		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 {
@@ -354,7 +345,7 @@ async function refreshAgentFilesCommand(options: AgentsOptions = {}): Promise<vo
 				process.exit(1);
 			}
 		} catch {
-			error(`Current directory is not a valid project`);
+			error("Current directory is not a valid project");
 			info(`Run this command from the ${projectName} project directory`);
 			process.exit(1);
 		}
@@ -370,17 +361,11 @@ async function refreshAgentFilesCommand(options: AgentsOptions = {}): Promise<vo
 			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) {
+	// 2. Read template metadata from .jack/template.json
+	const templateMetadata = await readTemplateMetadata(projectDir);
+	if (!templateMetadata) {
 		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.");
@@ -391,10 +376,10 @@ async function refreshAgentFilesCommand(options: AgentsOptions = {}): Promise<vo
 	outputSpinner.start("Loading template...");
 	let template: Template;
 	try {
-		template = await resolveTemplate(project.template.name);
+		template = await resolveTemplate(templateMetadata.name);
 	} catch (err) {
 		outputSpinner.stop();
-		error(`Failed to load template: ${project.template.name}`);
+		error(`Failed to load template: ${templateMetadata.name}`);
 		if (err instanceof Error) {
 			info(err.message);
 		}

package/src/commands/clone.ts

@@ -1,8 +1,12 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { select } from "@inquirer/prompts";
+import { fetchProjectTags } from "../lib/control-plane.ts";
 import { formatSize } from "../lib/format.ts";
 import { box, error, info, spinner, success } from "../lib/output.ts";
+import { registerPath } from "../lib/paths-index.ts";
+import { linkProject, updateProjectLink } from "../lib/project-link.ts";
+import { resolveProject } from "../lib/project-resolver.ts";
 import { cloneFromCloud, getRemoteManifest } from "../lib/storage/index.ts";
 
 export interface CloneFlags {
@@ -74,6 +78,29 @@ export default async function clone(projectName?: string, flags: CloneFlags = {}
 
 	downloadSpin.success(`Restored to ./${flags.as ?? projectName}/`);
 
+	// Link project to control plane if it's a managed project
+	try {
+		const project = await resolveProject(projectName);
+		if (project?.sources.controlPlane && project.remote?.projectId) {
+			// Managed project - link with control plane project ID
+			await linkProject(targetDir, project.remote.projectId, "managed");
+			await registerPath(project.remote.projectId, targetDir);
+
+			// Fetch and restore tags from control plane
+			try {
+				const remoteTags = await fetchProjectTags(project.remote.projectId);
+				if (remoteTags.length > 0) {
+					await updateProjectLink(targetDir, { tags: remoteTags });
+					info(`Restored ${remoteTags.length} tag(s)`);
+				}
+			} catch {
+				// Silent fail - tag restoration is non-critical
+			}
+		}
+	} catch {
+		// Not a control plane project or offline - continue without linking
+	}
+
 	// Show next steps
 	box("Next steps:", [`cd ${flags.as ?? projectName}`, "bun install", "jack ship"]);
 }

package/src/commands/down.ts

@@ -9,8 +9,8 @@ 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 LocalProjectLink, readProjectLink } from "../lib/project-link.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";
 
@@ -19,11 +19,14 @@ import { deleteCloudProject, getProjectNameFromDir } from "../lib/storage/index.
  * For managed projects: fetch from control plane.
  * For BYO projects: parse from wrangler.jsonc in cwd.
  */
-async function resolveDatabaseName(project: Project, projectName: string): Promise<string | null> {
+async function resolveDatabaseName(
+	link: LocalProjectLink | null,
+	projectName: string,
+): Promise<string | null> {
 	// For managed projects, fetch from control plane
-	if (project.deploy_mode === "managed" && project.remote?.project_id) {
+	if (link?.deploy_mode === "managed") {
 		try {
-			const resources = await fetchProjectResources(project.remote.project_id);
+			const resources = await fetchProjectResources(link.project_id);
 			const d1 = resources.find((r) => r.resource_type === "d1");
 			return d1?.resource_name || null;
 		} catch {
@@ -70,50 +73,39 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
-		// Resolve project from all sources (registry + control plane)
+		// Resolve project from all sources (local link + control plane)
 		const resolved = await resolveProject(name);
 
+		// Read local project link
+		const link = await readProjectLink(process.cwd());
+
 		// Check if found only on control plane (orphaned managed project)
-		if (resolved?.sources.controlPlane && !resolved.sources.registry) {
+		if (resolved?.sources.controlPlane && !resolved.sources.filesystem) {
 			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 (!resolved && !project) {
+		if (!resolved && !link) {
 			// 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);
+		// Check if this is a managed project (from link or resolved data)
+		const isManaged = link?.deploy_mode === "managed" || resolved?.remote?.projectId;
 
 		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,
-			};
+			// Get the project ID from link or resolved data
+			const projectId = link?.project_id || resolved?.remote?.projectId;
+			const runjackUrl = resolved?.url || null;
+
+			if (!projectId) {
+				error("Cannot determine project ID for managed deletion");
+				process.exit(1);
+			}
 
 			// Route to managed deletion flow
-			const deleteSuccess = await managedDown(managedProject, name, flags);
+			const deleteSuccess = await managedDown({ projectId, runjackUrl }, name, flags);
 			if (!deleteSuccess) {
 				process.exit(0); // User cancelled
 			}
@@ -144,14 +136,6 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			await deleteWorker(name);
 			output.stop();
 
-			// Update registry - keep entry but clear worker URL
-			if (project) {
-				await updateProject(name, {
-					workerUrl: null,
-					lastDeployed: null,
-				});
-			}
-
 			console.error("");
 			success(`'${name}' undeployed`);
 			info("Databases and backups were not affected");
@@ -162,10 +146,10 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 		// Interactive mode - show what will be affected
 		console.error("");
 		info(`Project: ${name}`);
-		if (project?.workerUrl) {
-			item(`URL: ${project.workerUrl}`);
+		if (resolved?.url) {
+			item(`URL: ${resolved.url}`);
 		}
-		const dbName = project ? await resolveDatabaseName(project, name) : null;
+		const dbName = await resolveDatabaseName(link, name);
 		if (dbName) {
 			item(`Database: ${dbName}`);
 		}
@@ -223,12 +207,10 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 
 		// Handle backup deletion
 		let shouldDeleteR2 = false;
-		if (project) {
-			console.error("");
-			info("Delete backup for this project?");
-			const deleteR2Action = await promptSelect(["Yes", "No"]);
-			shouldDeleteR2 = deleteR2Action === 0;
-		}
+		console.error("");
+		info("Delete backup for this project?");
+		const deleteR2Action = await promptSelect(["Yes", "No"]);
+		shouldDeleteR2 = deleteR2Action === 0;
 
 		// Execute deletions
 		console.error("");
@@ -279,14 +261,6 @@ export default async function down(projectName?: string, flags: DownFlags = {}):
 			}
 		}
 
-		// Update registry - keep entry but clear worker URL
-		if (project) {
-			await updateProject(name, {
-				workerUrl: null,
-				lastDeployed: null,
-			});
-		}
-
 		console.error("");
 		success(`Project '${name}' undeployed`);
 		console.error("");

package/src/commands/feedback.ts

@@ -9,7 +9,7 @@ import pkg from "../../package.json";
 import { getCredentials } from "../lib/auth/store.ts";
 import { getControlApiUrl } from "../lib/control-plane.ts";
 import { error, info, output, success } from "../lib/output.ts";
-import { getProject } from "../lib/registry.ts";
+import { getDeployMode, readProjectLink } from "../lib/project-link.ts";
 import { getProjectNameFromDir } from "../lib/storage/index.ts";
 import { getTelemetryConfig } from "../lib/telemetry.ts";
 
@@ -171,10 +171,9 @@ async function collectMetadata(attachPersonalInfo: boolean): Promise<FeedbackMet
 	if (attachPersonalInfo) {
 		try {
 			projectName = await getProjectNameFromDir(process.cwd());
-			if (projectName) {
-				const project = await getProject(projectName);
-				deployMode = project?.deploy_mode ?? null;
-			}
+			// Read deploy mode from .jack/project.json
+			const link = await readProjectLink(process.cwd());
+			deployMode = link?.deploy_mode ?? null;
 		} catch {
 			// Not in a project directory, that's fine
 		}

package/src/commands/link.ts

@@ -0,0 +1,147 @@
+/**
+ * jack link - Link current directory to a jack cloud project or create BYO link
+ *
+ * Usage:
+ *   jack link my-api       Link to existing managed project
+ *   jack link --byo        Create BYO link (generates local ID)
+ *   jack link              Interactive: prompts for project selection if logged in
+ */
+
+import { existsSync } from "node:fs";
+import { select } from "@inquirer/prompts";
+import { isLoggedIn } from "../lib/auth/index.ts";
+import {
+	type ManagedProject,
+	findProjectBySlug,
+	listManagedProjects,
+} from "../lib/control-plane.ts";
+import { error, info, output, success } from "../lib/output.ts";
+import { registerPath } from "../lib/paths-index.ts";
+import { generateByoProjectId, linkProject, readProjectLink } from "../lib/project-link.ts";
+
+export interface LinkFlags {
+	byo?: boolean;
+}
+
+export default async function link(projectName?: string, flags: LinkFlags = {}): Promise<void> {
+	// Check if already linked
+	const existingLink = await readProjectLink(process.cwd());
+	if (existingLink) {
+		error("This directory is already linked");
+		info(`Project ID: ${existingLink.project_id}`);
+		info("To re-link, first run: jack unlink");
+		process.exit(1);
+	}
+
+	// Check for wrangler config
+	const hasWranglerConfig =
+		existsSync("wrangler.jsonc") || existsSync("wrangler.json") || existsSync("wrangler.toml");
+
+	if (!hasWranglerConfig) {
+		error("No wrangler config found");
+		info("Run this from a jack project directory");
+		process.exit(1);
+	}
+
+	// BYO mode - generate local ID
+	if (flags.byo) {
+		const projectId = generateByoProjectId();
+		output.start("Creating BYO link...");
+		await linkProject(process.cwd(), projectId, "byo");
+		await registerPath(projectId, process.cwd());
+		output.stop();
+		success("Linked as BYO project");
+		info(`Project ID: ${projectId}`);
+		return;
+	}
+
+	// Check if logged in for managed mode
+	const loggedIn = await isLoggedIn();
+
+	if (!loggedIn && !projectName) {
+		// 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");
+		process.exit(1);
+	}
+
+	// If project name provided, find it on control plane
+	if (projectName) {
+		if (!loggedIn) {
+			error("Login required to link managed projects");
+			info("Run: jack login");
+			process.exit(1);
+		}
+
+		output.start(`Finding project: ${projectName}...`);
+		let project: ManagedProject | null = null;
+		try {
+			project = await findProjectBySlug(projectName);
+		} catch (err) {
+			output.stop();
+			error("Failed to find project");
+			if (err instanceof Error) {
+				info(err.message);
+			}
+			process.exit(1);
+		}
+		output.stop();
+
+		if (!project) {
+			error(`Project not found: ${projectName}`);
+			info("List your projects with: jack projects list");
+			process.exit(1);
+		}
+
+		output.start("Linking project...");
+		await linkProject(process.cwd(), project.id, "managed");
+		await registerPath(project.id, process.cwd());
+		output.stop();
+		success(`Linked to: ${projectName}`);
+		return;
+	}
+
+	// Interactive mode - list and select project
+	output.start("Loading projects...");
+	let projects: ManagedProject[] = [];
+	try {
+		projects = await listManagedProjects();
+	} catch (err) {
+		output.stop();
+		error("Failed to load projects");
+		if (err instanceof Error) {
+			info(err.message);
+		}
+		process.exit(1);
+	}
+	output.stop();
+
+	if (projects.length === 0) {
+		error("No managed projects found");
+		info("Create one with: jack new");
+		info("Or link as BYO: jack link --byo");
+		process.exit(1);
+	}
+
+	console.error("");
+	const choice = await select({
+		message: "Select a project to link:",
+		choices: projects.map((p) => ({
+			value: p.id,
+			name: `${p.slug} (${p.status})`,
+		})),
+	});
+
+	const selected = projects.find((p) => p.id === choice);
+	if (!selected) {
+		error("No project selected");
+		process.exit(1);
+	}
+
+	output.start("Linking project...");
+	await linkProject(process.cwd(), selected.id, "managed");
+	await registerPath(selected.id, process.cwd());
+	output.stop();
+	success(`Linked to: ${selected.slug}`);
+}

package/src/commands/login.ts

@@ -1,6 +1,12 @@
+import { input } from "@inquirer/prompts";
 import { type DeviceAuthResponse, pollDeviceToken, startDeviceAuth } from "../lib/auth/client.ts";
 import { type AuthCredentials, saveCredentials } from "../lib/auth/store.ts";
-import { error, info, spinner, success } from "../lib/output.ts";
+import {
+	checkUsernameAvailable,
+	getCurrentUserProfile,
+	setUsername,
+} from "../lib/control-plane.ts";
+import { error, info, spinner, success, warn } from "../lib/output.ts";
 
 interface LoginOptions {
 	/** Skip the initial "Logging in..." message (used when called from auto-login) */
@@ -69,6 +75,9 @@ export default async function login(options: LoginOptions = {}): Promise<void> {
 
 				console.error("");
 				success(`Logged in as ${tokens.user.email}`);
+
+				// Prompt for username if not set
+				await promptForUsername(tokens.user.email);
 				return;
 			}
 		} catch (err) {
@@ -86,3 +95,117 @@ export default async function login(options: LoginOptions = {}): Promise<void> {
 function sleep(ms: number): Promise<void> {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
+
+async function promptForUsername(email: string): Promise<void> {
+	// Skip in non-TTY environments
+	if (!process.stdout.isTTY) {
+		return;
+	}
+
+	const spin = spinner("Checking account...");
+
+	try {
+		const profile = await getCurrentUserProfile();
+		spin.stop();
+
+		// If user already has a username, skip
+		if (profile?.username) {
+			return;
+		}
+
+		console.error("");
+		info("Choose a username for your jack cloud account.");
+		info("URLs will look like: alice-vibes.runjack.xyz");
+		console.error("");
+
+		// Generate suggestions from $USER env var and email
+		const suggestions = generateUsernameSuggestions(email);
+
+		let username: string | null = null;
+
+		while (!username) {
+			// Show suggestions if available
+			if (suggestions.length > 0) {
+				info(`Suggestions: ${suggestions.join(", ")}`);
+			}
+
+			const inputUsername = await input({
+				message: "Username:",
+				default: suggestions[0],
+				validate: (value) => {
+					if (!value || value.length < 3) {
+						return "Username must be at least 3 characters";
+					}
+					if (value.length > 39) {
+						return "Username must be 39 characters or less";
+					}
+					if (value !== value.toLowerCase()) {
+						return "Username must be lowercase";
+					}
+					if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]{1,2}$/.test(value)) {
+						return "Use only lowercase letters, numbers, and hyphens";
+					}
+					return true;
+				},
+			});
+
+			// Check availability
+			const checkSpin = spinner("Checking availability...");
+			const availability = await checkUsernameAvailable(inputUsername);
+			checkSpin.stop();
+
+			if (!availability.available) {
+				warn(availability.error || `Username "${inputUsername}" is already taken. Try another.`);
+				continue;
+			}
+
+			// Try to set the username
+			const setSpin = spinner("Setting username...");
+			try {
+				await setUsername(inputUsername);
+				setSpin.stop();
+				username = inputUsername;
+				success(`Username set to "${username}"`);
+			} catch (err) {
+				setSpin.stop();
+				warn(err instanceof Error ? err.message : "Failed to set username");
+			}
+		}
+	} catch (err) {
+		spin.stop();
+		// Non-fatal - user can set username later
+		warn("Could not set username. You can set it later.");
+	}
+}
+
+function generateUsernameSuggestions(email: string): string[] {
+	const suggestions: string[] = [];
+
+	// Try $USER environment variable first
+	const envUser = process.env.USER || process.env.USERNAME;
+	if (envUser) {
+		const normalized = normalizeToUsername(envUser);
+		if (normalized && normalized.length >= 3) {
+			suggestions.push(normalized);
+		}
+	}
+
+	// Try email local part
+	const emailLocal = email.split("@")[0];
+	if (emailLocal) {
+		const normalized = normalizeToUsername(emailLocal);
+		if (normalized && normalized.length >= 3 && !suggestions.includes(normalized)) {
+			suggestions.push(normalized);
+		}
+	}
+
+	return suggestions.slice(0, 3); // Max 3 suggestions
+}
+
+function normalizeToUsername(input: string): string {
+	return input
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, "-")
+		.replace(/^-+|-+$/g, "")
+		.slice(0, 39);
+}

package/src/commands/logs.ts

@@ -1,7 +1,6 @@
 import { existsSync } from "node:fs";
 import { output } from "../lib/output.ts";
-import { getProject } from "../lib/registry.ts";
-import { getProjectNameFromDir } from "../lib/storage/index.ts";
+import { getDeployMode } from "../lib/project-link.ts";
 
 // Lines containing these strings will be filtered out
 const FILTERED_PATTERNS = ["⛅️ wrangler"];
@@ -19,22 +18,13 @@ export default async function logs(): Promise<void> {
 		process.exit(1);
 	}
 
-	// Check if this is a managed project
-	let projectName: string | null = null;
-	try {
-		projectName = await getProjectNameFromDir(process.cwd());
-	} catch {
-		// Continue without project name - will fall through to wrangler tail
-	}
-
-	if (projectName) {
-		const project = await getProject(projectName);
-		if (project?.deploy_mode === "managed") {
-			output.warn("Real-time logs not yet available for managed projects");
-			output.info("Logs are being collected - web UI coming soon");
-			output.info("Track progress: https://github.com/getjack-org/jack/issues/2");
-			return;
-		}
+	// Check if this is a managed project (read from .jack/project.json)
+	const deployMode = await getDeployMode(process.cwd());
+	if (deployMode === "managed") {
+		output.warn("Real-time logs not yet available for managed projects");
+		output.info("Logs are being collected - web UI coming soon");
+		output.info("Track progress: https://github.com/getjack-org/jack/issues/2");
+		return;
 	}
 
 	// BYOC project - use wrangler tail

package/src/commands/new.ts

@@ -8,7 +8,13 @@ import { createProject } from "../lib/project-operations.ts";
 
 export default async function newProject(
 	nameOrPhrase?: string,
-	options: { template?: string; intent?: string; managed?: boolean; byo?: boolean; ci?: boolean } = {},
+	options: {
+		template?: string;
+		intent?: string;
+		managed?: boolean;
+		byo?: boolean;
+		ci?: boolean;
+	} = {},
 ): Promise<void> {
 	// Immediate feedback
 	output.start("Starting...");