@getjack/jack 0.1.3 → 0.1.5

package/README.md

@@ -0,0 +1,103 @@
+<p align="center">
+  <h1 align="center">jack</h1>
+  <p align="center"><strong>Ship before you forget why you started.</strong></p>
+</p>
+
+<p align="center">
+  <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>
+</p>
+
+---
+
+<p align="center">
+  <img src="https://docs.getjack.org/jack-demo.gif" alt="jack demo" width="600">
+</p>
+
+---
+
+You're vibecoding. Ideas are flowing. You want to ship.
+
+But first: config files, deployment setup, secret management, debugging infrastructure errors...
+
+**30 minutes later, the spark is gone.**
+
+jack removes the friction between your idea and a live URL.
+
+```bash
+bunx @getjack/jack new my-app   # → deployed. live. done.
+```
+
+That's it. Write code. Ship again with `jack ship`. Stay in flow.
+
+---
+
+## Why jack
+
+**Instant deployment** — `jack new` creates AND deploys. You have a live URL before your first commit.
+
+**Works with your agent** — Claude Code, Cursor, Codex, whatever. Every project includes AI context files so your agent understands the stack from prompt one.
+
+**Roaming secrets** — Configure once, use across all projects. No more per-project secret ceremony.
+
+**Project tracking** — 100 experiments scattered everywhere? `jack ls` finds them all.
+
+**No lock-in** — Standard config files, standard TypeScript. Your projects work without jack installed.
+
+---
+
+## Quick Start
+
+```bash
+# One command to create and deploy
+bunx @getjack/jack new my-app
+
+# Or install globally
+bun add -g @getjack/jack
+jack new my-app
+```
+
+You'll need [Bun](https://bun.sh) and a Cloudflare account (free tier works).
+
+---
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `jack new <name>` | Create and deploy a new project |
+| `jack ship` | Deploy current project |
+| `jack ls` | Show all your projects |
+| `jack open` | Open project in browser |
+| `jack secrets` | Manage project secrets |
+| `jack feedback` | Share feedback or report issues |
+
+Full documentation at **[docs.getjack.org](https://docs.getjack.org)**
+
+---
+
+## Who This Is For
+
+Builders who ship constantly. You spin up new projects all the time, and suddenly you have dozens scattered across your machine—each with its own env vars, secrets, and deploy setup you've already forgotten.
+
+jack keeps you organized. One command to ship, one place to find everything, zero setup overhead. Stay creative, skip the ceremony.
+
+---
+
+## Philosophy
+
+In Gibson's *Neuromancer*, "jacking in" means plugging directly into cyberspace. The body becomes irrelevant—you're pure thought in the matrix.
+
+jack handles the infrastructure so you stay in creative flow. The boring parts disappear. You just build.
+
+---
+
+## License
+
+Apache-2.0
+
+<p align="center">
+  <i>Every deployment friction point is a creative thought lost.</i>
+</p>

package/package.json

@@ -1,16 +1,13 @@
 {
 	"name": "@getjack/jack",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"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/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...");