@getjack/jack 0.1.22 → 0.1.23

package/src/lib/project-operations.ts

@@ -16,6 +16,7 @@ import {
 } from "../templates/index.ts";
 import type { EnvVar, Template } from "../templates/types.ts";
 import { generateAgentFiles } from "./agent-files.ts";
+import { ensureAgentIntegration } from "./agent-integration.ts";
 import {
 	getActiveAgents,
 	getAgentDefinition,
@@ -535,14 +536,17 @@ async function runAutoDetectFlow(
 	dryRun = false,
 ): Promise<AutoDetectResult> {
 	// Step 1: Validate project (file count, size limits)
+	const validationSpin = reporter.spinner("Scanning project...");
 	const validation = await validateProject(projectPath);
 	if (!validation.valid) {
+		validationSpin.error("Project too large or invalid");
 		track(Events.AUTO_DETECT_REJECTED, { reason: "validation_failed" });
 		throw new JackError(
 			JackErrorCode.VALIDATION_ERROR,
 			validation.error || "Project validation failed",
 		);
 	}
+	validationSpin.success(`Scanned ${validation.fileCount} files`);
 
 	// Step 2: Detect project type
 	const detection = detectProjectType(projectPath);
@@ -565,9 +569,11 @@ async function runAutoDetectFlow(
 	if (detection.type === "unknown") {
 		track(Events.AUTO_DETECT_FAILED, { reason: "unknown_type" });
 
+		// Use detection.error if available (e.g., monorepo message), otherwise generic
 		throw new JackError(
 			JackErrorCode.VALIDATION_ERROR,
-			"Could not detect project type\n\nSupported types:\n  - Vite (React, Vue, etc.)\n  - Hono API\n  - SvelteKit (with @sveltejs/adapter-cloudflare)\n\nTo deploy manually, create a wrangler.jsonc file.\nDocs: https://docs.getjack.org/guides/manual-setup",
+			detection.error ||
+				"Could not detect project type\n\nSupported types:\n  - Vite (React, Vue, etc.)\n  - Hono API\n  - SvelteKit (with @sveltejs/adapter-cloudflare)\n\nTo deploy manually, create a wrangler.jsonc file.\nDocs: https://docs.getjack.org/guides/manual-setup",
 		);
 	}
 
@@ -875,17 +881,17 @@ export async function createProject(
 
 			// No match - prompt user to choose
 			if (interactive) {
-				const { select } = await import("@clack/prompts");
+				const { promptSelectValue, isCancel } = await import("./hooks.ts");
 				console.error("");
 				console.error(`  No template matched for: "${intentPhrase}"`);
 				console.error("");
 
-				const choice = await select({
-					message: "Select a template:",
-					options: BUILTIN_TEMPLATES.map((t, i) => ({ value: t, label: `${i + 1}. ${t}` })),
-				});
+				const choice = await promptSelectValue(
+					"Select a template:",
+					BUILTIN_TEMPLATES.map((t) => ({ value: t, label: t })),
+				);
 
-				if (typeof choice !== "string") {
+				if (isCancel(choice) || typeof choice !== "string") {
 					throw new JackError(JackErrorCode.VALIDATION_ERROR, "No template selected", undefined, {
 						exitCode: 0,
 						reported: true,
@@ -917,18 +923,18 @@ export async function createProject(
 
 			// Multiple matches
 			if (interactive) {
-				const { select } = await import("@clack/prompts");
+				const { promptSelectValue, isCancel } = await import("./hooks.ts");
 				console.error("");
 				console.error(`  Multiple templates matched: "${intentPhrase}"`);
 				console.error("");
 
 				const matchedNames = matches.map((m) => m.template);
-				const choice = await select({
-					message: "Select a template:",
-					options: matchedNames.map((t, i) => ({ value: t, label: `${i + 1}. ${t}` })),
-				});
+				const choice = await promptSelectValue(
+					"Select a template:",
+					matchedNames.map((t) => ({ value: t, label: t })),
+				);
 
-				if (typeof choice !== "string") {
+				if (isCancel(choice) || typeof choice !== "string") {
 					throw new JackError(JackErrorCode.VALIDATION_ERROR, "No template selected", undefined, {
 						exitCode: 0,
 						reported: true,
@@ -1609,6 +1615,18 @@ export async function deployProject(options: DeployOptions = {}): Promise<Deploy
 		deployMode = link?.deploy_mode ?? "byo";
 	}
 
+	// Ensure agent integration is set up (JACK.md, MCP config)
+	// This is idempotent and runs silently
+	try {
+		await ensureAgentIntegration(projectPath, {
+			projectName,
+			silent: true,
+		});
+	} catch (err) {
+		// Don't fail deploy if agent integration fails
+		debug("Agent integration setup failed:", err);
+	}
+
 	// Ensure wrangler is installed (auto-install if needed)
 	if (!dryRun) {
 		let installSpinner: OperationSpinner | null = null;

package/src/lib/prompts.ts

@@ -1,5 +1,7 @@
-import { isCancel, select, text } from "@clack/prompts";
+import { text } from "@clack/prompts";
+import { isCancel } from "./hooks.ts";
 import type { DetectedSecret } from "./env-parser.ts";
+import { promptSelectValue } from "./hooks.ts";
 import { info, success, warn } from "./output.ts";
 import { getSavedSecrets, getSecretsPath, maskSecret, saveSecrets } from "./secrets.ts";
 
@@ -23,14 +25,11 @@ export async function promptSaveSecrets(detected: DetectedSecret[]): Promise<voi
 	}
 	console.error("");
 
-	const action = await select({
-		message: "What would you like to do?",
-		options: [
-			{ value: "save", label: "Save to jack for future projects" },
-			{ value: "paste", label: "Paste additional secrets" },
-			{ value: "skip", label: "Skip for now" },
-		],
-	});
+	const action = await promptSelectValue("What would you like to do?", [
+		{ value: "save", label: "Save to jack for future projects" },
+		{ value: "paste", label: "Paste additional secrets" },
+		{ value: "skip", label: "Skip for now" },
+	]);
 
 	if (isCancel(action) || action === "skip") {
 		return;
@@ -111,13 +110,10 @@ export async function promptUseSecrets(): Promise<Record<string, string> | null>
 	}
 	console.error("");
 
-	const action = await select({
-		message: "Use them for this project?",
-		options: [
-			{ label: "Yes", value: "yes" },
-			{ label: "No", value: "no" },
-		],
-	});
+	const action = await promptSelectValue("Use them for this project?", [
+		{ value: "yes", label: "Yes" },
+		{ value: "no", label: "No" },
+	]);
 
 	if (isCancel(action) || action !== "yes") {
 		return null;
@@ -154,13 +150,10 @@ export async function promptUseSecretsFromList(
 		return false;
 	}
 
-	const action = await select({
-		message: "Use saved secrets for this project?",
-		options: [
-			{ label: "Yes", value: "yes" },
-			{ label: "No", value: "no" },
-		],
-	});
+	const action = await promptSelectValue("Use saved secrets for this project?", [
+		{ value: "yes", label: "Yes" },
+		{ value: "no", label: "No" },
+	]);
 
 	return !isCancel(action) && action === "yes";
 }

package/src/lib/services/db-execute.ts

@@ -147,7 +147,26 @@ async function executeViaWrangler(
 		.quiet();
 
 	if (result.exitCode !== 0) {
+		// Wrangler outputs errors to stdout as JSON, not stderr
+		const stdout = result.stdout.toString().trim();
 		const stderr = result.stderr.toString().trim();
+
+		// Try to parse JSON error from stdout first
+		try {
+			const data = JSON.parse(stdout);
+			if (data.error) {
+				// Wrangler error format: { error: { text: "...", notes: [{ text: "..." }] } }
+				const errorText = data.error.text || data.error.message || "Unknown error";
+				const notes = data.error.notes?.map((n: { text: string }) => n.text).join("; ");
+				return {
+					success: false,
+					error: notes ? `${errorText} (${notes})` : errorText,
+				};
+			}
+		} catch {
+			// Not JSON, fall through to stderr
+		}
+
 		return {
 			success: false,
 			error: stderr || `Failed to execute SQL on ${databaseName}`,
@@ -172,6 +191,8 @@ async function executeViaWrangler(
 							last_row_id: firstResult.meta.last_row_id,
 						}
 					: undefined,
+				// Capture error details from wrangler response
+				error: firstResult.error || firstResult.message,
 			};
 		}
 
@@ -198,7 +219,25 @@ async function executeFileViaWrangler(
 		.quiet();
 
 	if (result.exitCode !== 0) {
+		// Wrangler outputs errors to stdout as JSON, not stderr
+		const stdout = result.stdout.toString().trim();
 		const stderr = result.stderr.toString().trim();
+
+		// Try to parse JSON error from stdout first
+		try {
+			const data = JSON.parse(stdout);
+			if (data.error) {
+				const errorText = data.error.text || data.error.message || "Unknown error";
+				const notes = data.error.notes?.map((n: { text: string }) => n.text).join("; ");
+				return {
+					success: false,
+					error: notes ? `${errorText} (${notes})` : errorText,
+				};
+			}
+		} catch {
+			// Not JSON, fall through to stderr
+		}
+
 		return {
 			success: false,
 			error: stderr || `Failed to execute SQL file on ${databaseName}`,

package/src/lib/services/sql-classifier.test.ts

@@ -229,9 +229,9 @@ describe("sql-classifier", () => {
 				expect(result.operation).toBe("SELECT");
 			});
 
-			it("treats unknown operations as write for safety", () => {
+			it("treats unknown operations as read (let SQLite handle errors)", () => {
 				const result = classifyStatement("VACUUM");
-				expect(result.risk).toBe("write");
+				expect(result.risk).toBe("read");
 				expect(result.operation).toBe("VACUUM");
 			});
 

package/src/lib/services/sql-classifier.ts

@@ -143,8 +143,8 @@ export function classifyStatement(sql: string): ClassifiedStatement {
 			case "SELECT":
 				return { sql: trimmed, risk: "read", operation: "SELECT" };
 			default:
-				// Unknown CTE operation - default to write for safety
-				return { sql: trimmed, risk: "write", operation };
+				// Unknown CTE operation - let SQLite handle it
+				return { sql: trimmed, risk: "read", operation };
 		}
 	}
 
@@ -205,8 +205,9 @@ export function classifyStatement(sql: string): ClassifiedStatement {
 		return { sql: trimmed, risk: "read", operation: "PRAGMA" };
 	}
 
-	// Unknown operations default to write for safety
-	return { sql: trimmed, risk: "write", operation };
+	// Unknown operations default to read - let SQLite handle syntax errors
+	// Invalid SQL can't modify data, so no point requiring --write for gibberish
+	return { sql: trimmed, risk: "read", operation };
 }
 
 /**

package/src/lib/version-check.ts

@@ -85,20 +85,25 @@ function isNewerVersion(latest: string, current: string): boolean {
 /**
  * Check if an update is available (uses cache, non-blocking)
  * Returns the latest version if newer, null otherwise
+ * @param skipCache - If true, bypass the cache and always fetch from npm
  */
-export async function checkForUpdate(): Promise<string | null> {
+export async function checkForUpdate(
+	skipCache = false,
+): Promise<string | null> {
 	const currentVersion = getCurrentVersion();
 
-	// Check cache first
-	const cache = await readVersionCache();
-	const now = Date.now();
-
-	if (cache && now - cache.checkedAt < CACHE_TTL_MS) {
-		// Use cached value
-		if (isNewerVersion(cache.latestVersion, currentVersion)) {
-			return cache.latestVersion;
+	// Check cache first (unless skipCache is true)
+	if (!skipCache) {
+		const cache = await readVersionCache();
+		const now = Date.now();
+
+		if (cache && now - cache.checkedAt < CACHE_TTL_MS) {
+			// Use cached value
+			if (isNewerVersion(cache.latestVersion, currentVersion)) {
+				return cache.latestVersion;
+			}
+			return null;
 		}
-		return null;
 	}
 
 	// Fetch fresh version (don't await in caller for non-blocking)

package/src/lib/zip-packager.ts

@@ -45,6 +45,12 @@ export interface ManifestData {
 		vars?: Record<string, string>;
 		r2?: Array<{ binding: string; bucket_name: string }>;
 		kv?: Array<{ binding: string }>;
+		vectorize?: Array<{
+			binding: string;
+			preset?: string;
+			dimensions?: number;
+			metric?: string;
+		}>;
 	};
 }
 
@@ -224,6 +230,16 @@ function extractBindingsFromConfig(config?: WranglerConfig): ManifestData["bindi
 		}));
 	}
 
+	// Extract Vectorize bindings
+	if (config.vectorize && config.vectorize.length > 0) {
+		bindings.vectorize = config.vectorize.map((vec) => ({
+			binding: vec.binding,
+			preset: vec.preset,
+			dimensions: vec.dimensions,
+			metric: vec.metric,
+		}));
+	}
+
 	// Return undefined if no bindings were extracted
 	return Object.keys(bindings).length > 0 ? bindings : undefined;
 }

package/src/mcp/resources/index.ts

@@ -67,15 +67,30 @@ export function registerResources(
 
 		if (uri === "agents://context") {
 			const projectPath = options.projectPath ?? process.cwd();
+			const jackPath = join(projectPath, "JACK.md");
 			const agentsPath = join(projectPath, "AGENTS.md");
 			const claudePath = join(projectPath, "CLAUDE.md");
 
 			const contents: string[] = [];
 
+			// Try to read JACK.md first (jack-specific context)
+			if (existsSync(jackPath)) {
+				try {
+					const jackContent = await Bun.file(jackPath).text();
+					contents.push("# JACK.md\n\n");
+					contents.push(jackContent);
+				} catch {
+					// Ignore read errors
+				}
+			}
+
 			// Try to read AGENTS.md
 			if (existsSync(agentsPath)) {
 				try {
 					const agentsContent = await Bun.file(agentsPath).text();
+					if (contents.length > 0) {
+						contents.push("\n\n---\n\n");
+					}
 					contents.push("# AGENTS.md\n\n");
 					contents.push(agentsContent);
 				} catch {
@@ -97,13 +112,38 @@ export function registerResources(
 				}
 			}
 
+			// If no agent files found, return jack guidance as fallback
 			if (contents.length === 0) {
+				const fallbackGuidance = `# Jack Project
+
+This project is managed by jack.
+
+## Commands
+- \`jack ship\` - Deploy changes
+- \`jack logs\` - Stream production logs
+- \`jack services\` - Manage databases and other services
+
+**Always use jack commands. Never use wrangler directly.**
+
+## MCP Tools Available
+
+If connected, prefer \`mcp__jack__*\` tools over CLI:
+- \`mcp__jack__deploy_project\` - Deploy changes
+- \`mcp__jack__execute_sql\` - Query databases
+- \`mcp__jack__get_project_status\` - Check status
+
+## Documentation
+
+Full docs: https://docs.getjack.org/llms-full.txt
+
+Check for JACK.md in the project root for project-specific instructions.
+`;
 				return {
 					contents: [
 						{
 							uri,
-							mimeType: "text/plain",
-							text: "No agent context files found in project directory",
+							mimeType: "text/markdown",
+							text: fallbackGuidance,
 						},
 					],
 				};

package/src/templates/index.ts

@@ -10,7 +10,7 @@ import type { Template } from "./types";
 // Resolve templates directory relative to this file (src/templates -> templates)
 const TEMPLATES_DIR = join(dirname(dirname(import.meta.dir)), "templates");
 
-export const BUILTIN_TEMPLATES = ["hello", "miniapp", "api", "nextjs", "saas"];
+export const BUILTIN_TEMPLATES = ["hello", "miniapp", "api", "nextjs", "saas", "simple-api-starter", "ai-chat", "semantic-search"];
 
 /**
  * Resolved template with origin tracking for lineage
@@ -104,8 +104,57 @@ async function loadTemplate(name: string): Promise<Template> {
 // Internal files that should be excluded from templates
 const INTERNAL_FILES = [".jack.json", ".jack/template.json"];
 
+// Wrangler config files that need sanitization when forking (JSONC only, no TOML support)
+const WRANGLER_CONFIG_FILES = ["wrangler.jsonc", "wrangler.json"];
+
 /**
- * Extract zip buffer to file map, excluding internal files
+ * Strip provider-specific IDs from wrangler config bindings.
+ * When forking a template, the original author's resource IDs won't work
+ * for the new user - wrangler 4.45.0+ will auto-provision new resources.
+ *
+ * Stripped fields:
+ * - D1: database_id (author's database)
+ * - KV: id (author's namespace)
+ * - R2: nothing (bucket_name is just a name, not a provider ID)
+ */
+function sanitizeWranglerConfig(content: string, filename: string): string {
+	// Only handle JSON/JSONC files
+	if (!filename.endsWith(".json") && !filename.endsWith(".jsonc")) {
+		return content;
+	}
+
+	try {
+		const config = parseJsonc(content);
+
+		// D1: strip database_id
+		if (Array.isArray(config.d1_databases)) {
+			for (const db of config.d1_databases) {
+				if (db && typeof db === "object" && "database_id" in db) {
+					delete db.database_id;
+				}
+			}
+		}
+
+		// KV: strip id
+		if (Array.isArray(config.kv_namespaces)) {
+			for (const kv of config.kv_namespaces) {
+				if (kv && typeof kv === "object" && "id" in kv) {
+					delete kv.id;
+				}
+			}
+		}
+
+		// Re-serialize with formatting
+		return JSON.stringify(config, null, "\t");
+	} catch {
+		// If parsing fails, return original content
+		return content;
+	}
+}
+
+/**
+ * Extract zip buffer to file map, excluding internal files.
+ * Sanitizes wrangler config to remove provider IDs (D1 database_id, KV id).
  */
 function extractZipToFiles(zipData: ArrayBuffer): Record<string, string> {
 	const files: Record<string, string> = {};
@@ -117,7 +166,17 @@ function extractZipToFiles(zipData: ArrayBuffer): Record<string, string> {
 
 		// Skip internal files
 		if (path && !INTERNAL_FILES.includes(path)) {
-			files[path] = new TextDecoder().decode(content);
+			let fileContent = new TextDecoder().decode(content);
+
+			// Sanitize wrangler config files to strip provider IDs
+			// This ensures forked projects create new resources instead of
+			// trying to use the original author's resources
+			const filename = path.split("/").pop() || path;
+			if (filename === "wrangler.jsonc" || filename === "wrangler.json") {
+				fileContent = sanitizeWranglerConfig(fileContent, filename);
+			}
+
+			files[path] = fileContent;
 		}
 	}
 
@@ -288,6 +347,7 @@ export function renderTemplate(template: Template, vars: { name: string }): Temp
 		rendered[path] = content
 			.replace(/jack-template-db/g, `${vars.name}-db`)
 			.replace(/jack-template-cache/g, `${vars.name}-cache`)
+			.replace(/jack-template-vectors/g, `${vars.name}-vectors`)
 			.replace(/jack-template/g, vars.name);
 	}
 	return { ...template, files: rendered };

package/templates/ai-chat/.jack.json

@@ -0,0 +1,29 @@
+{
+	"name": "ai-chat",
+	"description": "AI chat with streaming UI (free Cloudflare AI)",
+	"secrets": [],
+	"capabilities": ["ai"],
+	"intent": {
+		"keywords": ["ai", "chat", "llm", "mistral", "completion", "chatbot"],
+		"examples": ["AI chatbot", "chat interface", "LLM chat app"]
+	},
+	"hooks": {
+		"postDeploy": [
+			{
+				"action": "clipboard",
+				"text": "{{url}}",
+				"message": "URL copied to clipboard"
+			},
+			{
+				"action": "box",
+				"title": "AI Chat: {{name}}",
+				"lines": [
+					"{{url}}",
+					"",
+					"Open in browser to start chatting!",
+					"Rate limit: 10 requests/minute"
+				]
+			}
+		]
+	}
+}

package/templates/ai-chat/bun.lock

@@ -0,0 +1,18 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "jack-template",
+      "devDependencies": {
+        "@cloudflare/workers-types": "^4.20241205.0",
+        "typescript": "^5.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@cloudflare/workers-types": ["@cloudflare/workers-types@4.20260120.0", "", {}, "sha512-B8pueG+a5S+mdK3z8oKu1ShcxloZ7qWb68IEyLLaepvdryIbNC7JVPcY0bWsjS56UQVKc5fnyRge3yZIwc9bxw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+  }
+}

package/templates/ai-chat/package.json

@@ -0,0 +1,14 @@
+{
+	"name": "jack-template",
+	"version": "0.0.1",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"dev": "wrangler dev",
+		"deploy": "wrangler deploy"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20241205.0",
+		"typescript": "^5.0.0"
+	}
+}