@getjack/jack 0.1.6 → 0.1.8

package/src/mcp/test-utils.ts

@@ -0,0 +1,112 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+export interface McpClientOptions {
+	command: string;
+	args?: string[];
+	cwd?: string;
+	env?: NodeJS.ProcessEnv;
+	clientName?: string;
+	clientVersion?: string;
+}
+
+export interface McpTestClient {
+	client: Client;
+	transport: StdioClientTransport;
+	getStderr(): string;
+	close(): Promise<void>;
+}
+
+export async function openMcpTestClient(options: McpClientOptions): Promise<McpTestClient> {
+	const transport = new StdioClientTransport({
+		command: options.command,
+		args: options.args ?? [],
+		cwd: options.cwd,
+		env: options.env,
+		stderr: "pipe",
+	});
+
+	let stderr = "";
+	transport.stderr?.on("data", (chunk) => {
+		stderr += chunk.toString();
+	});
+
+	const client = new Client({
+		name: options.clientName ?? "jack-mcp-test",
+		version: options.clientVersion ?? "0.1.0",
+	});
+
+	try {
+		await client.connect(transport);
+	} catch (error) {
+		await transport.close();
+		throw error;
+	}
+
+	return {
+		client,
+		transport,
+		getStderr: () => stderr,
+		close: () => transport.close(),
+	};
+}
+
+export function parseMcpToolResult(toolResult: {
+	content?: Array<{ type: string; text?: string }>;
+}): unknown {
+	const toolText = toolResult.content?.[0]?.type === "text" ? toolResult.content[0].text : null;
+	if (!toolText) {
+		throw new Error("MCP tool response missing text content");
+	}
+
+	const parsed = JSON.parse(toolText);
+	if (!parsed.success) {
+		const message = parsed.error?.message ?? "unknown error";
+		throw new Error(`MCP tool failed: ${message}`);
+	}
+
+	return parsed.data;
+}
+
+export async function verifyMcpToolsAndResources(client: Client): Promise<void> {
+	const tools = await client.listTools();
+	if (!tools.tools?.length) {
+		throw new Error("MCP server reported no tools");
+	}
+
+	const resources = await client.listResources();
+	if (!resources.resources?.length) {
+		throw new Error("MCP server reported no resources");
+	}
+
+	await client.readResource({ uri: "agents://context" });
+}
+
+export async function callMcpListProjects(
+	client: Client,
+	filter?: "all" | "local" | "deployed" | "cloud",
+): Promise<unknown[]> {
+	const response = await client.callTool({
+		name: "list_projects",
+		arguments: filter ? { filter } : {},
+	});
+
+	const data = parseMcpToolResult(response);
+	if (!Array.isArray(data)) {
+		throw new Error("MCP list_projects returned unexpected data");
+	}
+
+	return data;
+}
+
+export async function callMcpGetProjectStatus(
+	client: Client,
+	args: { name?: string; project_path?: string },
+): Promise<unknown> {
+	const response = await client.callTool({
+		name: "get_project_status",
+		arguments: args,
+	});
+
+	return parseMcpToolResult(response);
+}

package/src/templates/index.ts

@@ -1,6 +1,8 @@
 import { existsSync } from "node:fs";
 import { readFile, readdir } from "node:fs/promises";
 import { dirname, join } from "node:path";
+import { unzipSync } from "fflate";
+import { getControlApiUrl } from "../lib/control-plane.ts";
 import { parseJsonc } from "../lib/jsonc.ts";
 import type { TemplateMetadata as TemplateOrigin } from "../lib/project-link.ts";
 import type { Template } from "./types";
@@ -97,8 +99,118 @@ async function loadTemplate(name: string): Promise<Template> {
 	};
 }
 
+// Internal files that should be excluded from templates
+const INTERNAL_FILES = [".jack.json", ".jack/template.json"];
+
+/**
+ * Extract zip buffer to file map, excluding internal files
+ */
+function extractZipToFiles(zipData: ArrayBuffer): Record<string, string> {
+	const files: Record<string, string> = {};
+	const unzipped = unzipSync(new Uint8Array(zipData));
+
+	for (const [path, content] of Object.entries(unzipped)) {
+		// Skip directories (they have zero-length content or end with /)
+		if (content.length === 0 || path.endsWith("/")) continue;
+
+		// Skip internal files
+		if (path && !INTERNAL_FILES.includes(path)) {
+			files[path] = new TextDecoder().decode(content);
+		}
+	}
+
+	return files;
+}
+
+/**
+ * Read metadata from extracted files (before they're filtered)
+ */
+function extractMetadataFromZip(zipData: ArrayBuffer): Record<string, unknown> {
+	const unzipped = unzipSync(new Uint8Array(zipData));
+
+	for (const [path, content] of Object.entries(unzipped)) {
+		// Skip directories
+		if (content.length === 0 || path.endsWith("/")) continue;
+
+		if (path === ".jack.json") {
+			return parseJsonc(new TextDecoder().decode(content));
+		}
+	}
+
+	return {};
+}
+
+/**
+ * Fetch a published template from jack cloud (public endpoint, no auth)
+ */
+async function fetchPublishedTemplate(username: string, slug: string): Promise<Template> {
+	const response = await fetch(
+		`${getControlApiUrl()}/v1/projects/${encodeURIComponent(username)}/${encodeURIComponent(slug)}/source`,
+	);
+
+	if (!response.ok) {
+		if (response.status === 404) {
+			throw new Error(
+				`Template not found: ${username}/${slug}\n\nMake sure the project exists and is published with: jack publish`,
+			);
+		}
+		throw new Error(`Failed to fetch template: ${response.status}`);
+	}
+
+	const zipData = await response.arrayBuffer();
+	const metadata = extractMetadataFromZip(zipData);
+	const files = extractZipToFiles(zipData);
+
+	return {
+		description: (metadata.description as string) || `Fork of ${username}/${slug}`,
+		secrets: (metadata.secrets as string[]) || [],
+		optionalSecrets: metadata.optionalSecrets as Template["optionalSecrets"],
+		capabilities: metadata.capabilities as Template["capabilities"],
+		requires: metadata.requires as Template["requires"],
+		hooks: metadata.hooks as Template["hooks"],
+		agentContext: metadata.agentContext as Template["agentContext"],
+		intent: metadata.intent as Template["intent"],
+		files,
+	};
+}
+
+/**
+ * Fetch user's own project as a template (authenticated)
+ */
+async function fetchUserTemplate(slug: string): Promise<Template | null> {
+	const { authFetch } = await import("../lib/auth/index.ts");
+
+	const response = await authFetch(
+		`${getControlApiUrl()}/v1/me/projects/${encodeURIComponent(slug)}/source`,
+	);
+
+	if (response.status === 404) {
+		return null; // Not found, will try other sources
+	}
+
+	if (!response.ok) {
+		throw new Error(`Failed to fetch your project: ${response.status}`);
+	}
+
+	const zipData = await response.arrayBuffer();
+	const metadata = extractMetadataFromZip(zipData);
+	const files = extractZipToFiles(zipData);
+
+	return {
+		description: (metadata.description as string) || `Your project: ${slug}`,
+		secrets: (metadata.secrets as string[]) || [],
+		optionalSecrets: metadata.optionalSecrets as Template["optionalSecrets"],
+		capabilities: metadata.capabilities as Template["capabilities"],
+		requires: metadata.requires as Template["requires"],
+		hooks: metadata.hooks as Template["hooks"],
+		agentContext: metadata.agentContext as Template["agentContext"],
+		intent: metadata.intent as Template["intent"],
+		files,
+	};
+}
+
 /**
- * Resolve template by name or GitHub URL
+ * Resolve template by name
  */
 export async function resolveTemplate(template?: string): Promise<Template> {
 	// No template → hello (omakase default)
@@ -111,14 +223,26 @@ export async function resolveTemplate(template?: string): Promise<Template> {
 		return loadTemplate(template);
 	}
 
-	// GitHub: user/repo or full URL → fetch from network
+	// username/slug format - fetch from jack cloud
 	if (template.includes("/")) {
-		const { fetchFromGitHub } = await import("../lib/github");
-		return fetchFromGitHub(template);
+		const [username, slug] = template.split("/", 2);
+		return fetchPublishedTemplate(username, slug);
+	}
+
+	// Try as user's own project first
+	try {
+		const userTemplate = await fetchUserTemplate(template);
+		if (userTemplate) {
+			return userTemplate;
+		}
+	} catch (_err) {
+		// If auth fails or project not found, fall through to error
 	}
 
 	// Unknown template
-	throw new Error(`Unknown template: ${template}\n\nAvailable: ${BUILTIN_TEMPLATES.join(", ")}`);
+	throw new Error(
+		`Unknown template: ${template}\n\nAvailable built-in templates: ${BUILTIN_TEMPLATES.join(", ")}\nOr use username/slug format for published projects`,
+	);
 }
 
 /**
@@ -131,9 +255,15 @@ export async function resolveTemplateWithOrigin(
 	const templateName = templateOption || "hello";
 
 	// Determine origin type
-	const isGitHub = templateName.includes("/");
+	let originType: "builtin" | "user" | "published" = "builtin";
+	if (templateOption?.includes("/")) {
+		originType = "published";
+	} else if (templateOption && !BUILTIN_TEMPLATES.includes(templateOption)) {
+		originType = "user";
+	}
+
 	const origin: TemplateOrigin = {
-		type: isGitHub ? "github" : "builtin",
+		type: originType,
 		name: templateName,
 	};
 

package/templates/nextjs/.jack.json

@@ -1,28 +1,28 @@
 {
-  "name": "nextjs",
-  "description": "Next.js App (SSR on Cloudflare)",
-  "secrets": [],
-  "capabilities": [],
-  "intent": {
-    "keywords": ["next", "nextjs", "react", "ssr", "full-stack", "server components", "rsc"],
-    "examples": ["next.js app", "server-rendered react", "react ssr"]
-  },
-  "agentContext": {
-    "summary": "A Next.js app deployed with jack. Supports SSR, SSG, and React Server Components.",
-    "full_text": "## Project Structure\n\n- `app/` - Next.js App Router pages and layouts\n- `public/` - Static assets\n- `open-next.config.ts` - OpenNext configuration\n- `wrangler.jsonc` - Worker configuration\n\n## Commands\n\n- `bun run dev` - Local development\n- `jack ship` - Deploy to production\n- `bun run preview` - Preview production build locally\n\n## Conventions\n\n- Uses App Router (not Pages Router)\n- SSR and SSG work out of the box\n- Server Components supported\n\n## Resources\n\n- [OpenNext Docs](https://opennext.js.org/cloudflare)\n- [Next.js App Router](https://nextjs.org/docs/app)"
-  },
-  "hooks": {
-    "postDeploy": [
-      {
-        "action": "clipboard",
-        "text": "{{url}}",
-        "message": "Deploy URL copied to clipboard"
-      },
-      {
-        "action": "box",
-        "title": "Deployed: {{name}}",
-        "lines": ["URL: {{url}}", "", "Next.js app is live!"]
-      }
-    ]
-  }
+	"name": "nextjs",
+	"description": "Next.js App (SSR on Cloudflare)",
+	"secrets": [],
+	"capabilities": [],
+	"intent": {
+		"keywords": ["next", "nextjs", "react", "ssr", "full-stack", "server components", "rsc"],
+		"examples": ["next.js app", "server-rendered react", "react ssr"]
+	},
+	"agentContext": {
+		"summary": "A Next.js app deployed with jack. Supports SSR, SSG, and React Server Components.",
+		"full_text": "## Project Structure\n\n- `app/` - Next.js App Router pages and layouts\n- `public/` - Static assets\n- `open-next.config.ts` - OpenNext configuration\n- `wrangler.jsonc` - Worker configuration\n\n## Commands\n\n- `bun run dev` - Local development\n- `jack ship` - Deploy to production\n- `bun run preview` - Preview production build locally\n\n## Conventions\n\n- Uses App Router (not Pages Router)\n- SSR and SSG work out of the box\n- Server Components supported\n\n## Resources\n\n- [OpenNext Docs](https://opennext.js.org/cloudflare)\n- [Next.js App Router](https://nextjs.org/docs/app)"
+	},
+	"hooks": {
+		"postDeploy": [
+			{
+				"action": "clipboard",
+				"text": "{{url}}",
+				"message": "Deploy URL copied to clipboard"
+			},
+			{
+				"action": "box",
+				"title": "Deployed: {{name}}",
+				"lines": ["URL: {{url}}", "", "Next.js app is live!"]
+			}
+		]
+	}
 }

package/templates/nextjs/app/globals.css

@@ -1,9 +1,9 @@
 * {
-  box-sizing: border-box;
-  margin: 0;
-  padding: 0;
+	box-sizing: border-box;
+	margin: 0;
+	padding: 0;
 }
 
 body {
-  font-family: system-ui, -apple-system, sans-serif;
+	font-family: system-ui, -apple-system, sans-serif;
 }

package/templates/nextjs/app/layout.tsx

@@ -1,19 +1,19 @@
-import type { Metadata } from 'next';
-import './globals.css';
+import type { Metadata } from "next";
+import "./globals.css";
 
 export const metadata: Metadata = {
-  title: 'jack-template',
-  description: 'Next.js app built with jack',
+	title: "jack-template",
+	description: "Next.js app built with jack",
 };
 
 export default function RootLayout({
-  children,
+	children,
 }: {
-  children: React.ReactNode;
+	children: React.ReactNode;
 }) {
-  return (
-    <html lang="en">
-      <body>{children}</body>
-    </html>
-  );
+	return (
+		<html lang="en">
+			<body>{children}</body>
+		</html>
+	);
 }

package/templates/nextjs/app/page.tsx

@@ -1,8 +1,10 @@
 export default function Home() {
-  return (
-    <main style={{ padding: '2rem', fontFamily: 'system-ui' }}>
-      <h1>jack-template</h1>
-      <p>Ship it with <code>jack ship</code></p>
-    </main>
-  );
+	return (
+		<main style={{ padding: "2rem", fontFamily: "system-ui" }}>
+			<h1>jack-template</h1>
+			<p>
+				Ship it with <code>jack ship</code>
+			</p>
+		</main>
+	);
 }

package/templates/nextjs/cloudflare-env.d.ts

@@ -1,3 +1,3 @@
 interface CloudflareEnv {
-  ASSETS: Fetcher;
+	ASSETS: Fetcher;
 }

package/templates/nextjs/next.config.ts

@@ -1,5 +1,5 @@
-import type { NextConfig } from "next";
 import { initOpenNextCloudflareForDev } from "@opennextjs/cloudflare";
+import type { NextConfig } from "next";
 
 initOpenNextCloudflareForDev();
 

package/templates/nextjs/open-next.config.ts

@@ -2,5 +2,5 @@ import { defineCloudflareConfig } from "@opennextjs/cloudflare";
 import r2IncrementalCache from "@opennextjs/cloudflare/overrides/incremental-cache/r2-incremental-cache";
 
 export default defineCloudflareConfig({
-  incrementalCache: r2IncrementalCache,
+	incrementalCache: r2IncrementalCache,
 });

package/templates/nextjs/package.json

@@ -1,24 +1,24 @@
 {
-  "name": "jack-template",
-  "type": "module",
-  "private": true,
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
-    "deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",
-    "cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts"
-  },
-  "dependencies": {
-    "@opennextjs/cloudflare": "^1.0.0",
-    "next": "^15.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
-  },
-  "devDependencies": {
-    "@cloudflare/workers-types": "^4.20241205.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "typescript": "^5.6.0"
-  }
+	"name": "jack-template",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"dev": "next dev",
+		"build": "next build",
+		"preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
+		"deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",
+		"cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts"
+	},
+	"dependencies": {
+		"@opennextjs/cloudflare": "^1.0.0",
+		"next": "^15.0.0",
+		"react": "^19.0.0",
+		"react-dom": "^19.0.0"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20241205.0",
+		"@types/react": "^19.0.0",
+		"@types/react-dom": "^19.0.0",
+		"typescript": "^5.6.0"
+	}
 }

package/templates/nextjs/tsconfig.json

@@ -1,44 +1,28 @@
 {
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": [
-      "ES2022",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "jsx": "preserve",
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "incremental": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "paths": {
-      "@/*": [
-        "./*"
-      ]
-    },
-    "plugins": [
-      {
-        "name": "next"
-      }
-    ],
-    "types": [
-      "@cloudflare/workers-types"
-    ],
-    "allowJs": true
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    "cloudflare-env.d.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
+	"compilerOptions": {
+		"target": "ES2022",
+		"lib": ["ES2022", "DOM", "DOM.Iterable"],
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"jsx": "preserve",
+		"strict": true,
+		"skipLibCheck": true,
+		"noEmit": true,
+		"incremental": true,
+		"esModuleInterop": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"paths": {
+			"@/*": ["./*"]
+		},
+		"plugins": [
+			{
+				"name": "next"
+			}
+		],
+		"types": ["@cloudflare/workers-types"],
+		"allowJs": true
+	},
+	"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "cloudflare-env.d.ts"],
+	"exclude": ["node_modules"]
 }

package/templates/nextjs/wrangler.jsonc

@@ -1,17 +1,17 @@
 {
-  "$schema": "node_modules/wrangler/config-schema.json",
-  "name": "jack-template",
-  "main": ".open-next/worker.js",
-  "compatibility_date": "2024-12-30",
-  "compatibility_flags": ["nodejs_compat"],
-  "assets": {
-    "directory": ".open-next/assets",
-    "binding": "ASSETS"
-  },
-  "r2_buckets": [
-    {
-      "binding": "NEXT_INC_CACHE_R2_BUCKET",
-      "bucket_name": "jack-template-cache"
-    }
-  ]
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "jack-template",
+	"main": ".open-next/worker.js",
+	"compatibility_date": "2024-12-30",
+	"compatibility_flags": ["nodejs_compat"],
+	"assets": {
+		"directory": ".open-next/assets",
+		"binding": "ASSETS"
+	},
+	"r2_buckets": [
+		{
+			"binding": "NEXT_INC_CACHE_R2_BUCKET",
+			"bucket_name": "jack-template-cache"
+		}
+	]
 }