@agent-native/core 0.6.1 → 0.7.1

package/dist/cli/create.js

@@ -3,286 +3,306 @@ import path from "path";
 import { fileURLToPath } from "url";
 import { execFileSync } from "child_process";
 import { setupAgentSymlinks } from "./setup-agents.js";
+import { workspacifyApp, parseWorkspaceScope } from "./workspacify.js";
+import { visibleTemplates, allTemplateNames, } from "@agent-native/shared-app-config";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const REPO = "BuilderIO/agent-native";
 const TEMPLATES_DIR = "templates";
+/** Blank scaffold option appended to every picker. */
+const BLANK_OPTION = {
+    name: "blank",
+    label: "Blank",
+    hint: "Empty starter — build from scratch",
+};
 /**
- * Template definitions with descriptions for the interactive picker.
- */
-const TEMPLATES = [
-    {
-        value: "blank",
-        label: "Blank",
-        hint: "Empty starter — build from scratch",
-    },
-    {
-        value: "mail",
-        label: "Mail",
-        hint: "AI-native Superhuman — email client with keyboard shortcuts and AI triage",
-    },
-    {
-        value: "calendar",
-        label: "Calendar",
-        hint: "AI-native Google Calendar — manage events, sync, and public booking",
-    },
-    {
-        value: "content",
-        label: "Content",
-        hint: "AI-native Notion/Google Docs — write and organize with agent assistance",
-    },
-    {
-        value: "slides",
-        label: "Slides",
-        hint: "AI-native Google Slides — generate and edit React presentations",
-    },
-    {
-        value: "videos",
-        label: "Video",
-        hint: "AI-native video editing with Remotion",
-    },
-    {
-        value: "analytics",
-        label: "Analytics",
-        hint: "AI-native Amplitude/Mixpanel — connect data sources, prompt for charts",
-    },
-    {
-        value: "forms",
-        label: "Forms",
-        hint: "AI-native form builder — create, edit, and manage forms",
-    },
-    {
-        value: "issues",
-        label: "Issues",
-        hint: "AI-native Jira — project management and issue tracking",
-    },
-    {
-        value: "recruiting",
-        label: "Recruiting",
-        hint: "AI-native Greenhouse — manage candidates and recruiting pipelines",
-    },
-    {
-        value: "starter",
-        label: "Starter",
-        hint: "Minimal scaffold with the agent chat and core architecture wired up",
-    },
-];
-/**
- * Known first-party template names (for validation).
- * Includes the alias "video" → "videos" for backwards compat.
- */
-const KNOWN_TEMPLATES = [
-    ...TEMPLATES.map((t) => t.value).filter((v) => v !== "blank"),
-    "video",
-];
-/**
- * Scaffold a new agent-native app.
+ * Main entry for `agent-native create [name]`.
+ *
+ * Default behavior: scaffold a workspace at <name>/ with a multi-select
+ * template picker. Use --standalone for the single-app standalone flow.
  *
- * Interactive mode: prompts for app name and template if not provided.
- * With --template <name>: downloads the template from GitHub.
- * With --template github:user/repo: downloads from a custom GitHub repo.
+ * If run *inside* an existing workspace, falls through to the add-app
+ * flow that scaffolds one new app under apps/<name>/.
  */
 export async function createApp(name, opts) {
     const clack = await import("@clack/prompts");
-    clack.intro("Create a new agent-native app");
-    // Prompt for name if not provided
-    if (!name) {
-        const nameResult = await clack.text({
-            message: "What is your app name?",
-            placeholder: "my-app",
-            validate(value) {
-                if (!value)
-                    return "App name is required";
-                if (!/^[a-z][a-z0-9-]*$/.test(value)) {
-                    return "Use lowercase letters, numbers, and hyphens (must start with a letter)";
-                }
-                if (fs.existsSync(path.resolve(process.cwd(), value))) {
-                    return `Directory "${value}" already exists`;
-                }
-            },
-        });
-        if (clack.isCancel(nameResult)) {
-            clack.cancel("Cancelled.");
-            process.exit(0);
-        }
-        name = nameResult;
+    // If we're already inside a workspace, the meaning of `create <name>` is
+    // "add a new app to this workspace". Delegate to add-app.
+    const workspace = detectWorkspace(process.cwd());
+    if (workspace) {
+        await addAppToWorkspace(name, opts);
+        return;
     }
-    else {
-        // Validate provided name
-        if (!/^[a-z][a-z0-9-]*$/.test(name)) {
-            clack.cancel(`Invalid app name "${name}". Use lowercase letters, numbers, and hyphens.`);
-            process.exit(1);
-        }
+    // Standalone escape hatch — behaves like the old single-app flow.
+    if (opts?.standalone) {
+        await createStandaloneApp(name, opts, clack);
+        return;
+    }
+    // When exactly one template is specified explicitly, treat it as a
+    // standalone scaffold (script-friendly, matches historic behavior).
+    // Use `--template a,b` or pass no --template to opt into the workspace
+    // flow with the multi-select picker.
+    const parsed = parseTemplateList(opts?.template);
+    if (parsed.length === 1) {
+        await createStandaloneApp(name, opts, clack);
+        return;
+    }
+    // Default: create a workspace.
+    await createWorkspaceInteractive(name, opts, clack);
+}
+/* ─────────────────────────────────────────────────────────────────────────
+ * Workspace creation (new default)
+ * ───────────────────────────────────────────────────────────────────────── */
+async function createWorkspaceInteractive(name, opts, clack) {
+    clack.intro("Create a new agent-native workspace");
+    name = await promptNameIfMissing(name, clack, "workspace", "my-platform");
+    // Multi-select picker for apps to include.
+    const preselected = parseTemplateList(opts?.template);
+    const templates = await promptTemplatePicker(preselected, clack);
+    if (templates.length === 0) {
+        clack.cancel("No apps selected. Cancelled.");
+        process.exit(0);
     }
     const targetDir = path.resolve(process.cwd(), name);
     if (fs.existsSync(targetDir)) {
         clack.cancel(`Directory "${name}" already exists.`);
         process.exit(1);
     }
-    // Prompt for template if not provided
-    let template = opts?.template;
-    if (!template) {
-        const templateResult = await clack.select({
-            message: "Which template would you like to use?",
-            options: TEMPLATES.map((t) => ({
-                value: t.value,
-                label: t.label,
-                hint: t.hint,
-            })),
-        });
-        if (clack.isCancel(templateResult)) {
-            clack.cancel("Cancelled.");
-            process.exit(0);
-        }
-        template = templateResult;
-    }
     const s = clack.spinner();
-    s.start("Scaffolding your app...");
+    s.start(`Scaffolding workspace with ${templates.length} app(s)...`);
     try {
-        if (template === "blank") {
-            createFromDefault(name, targetDir);
-        }
-        else {
-            await createFromTemplate(name, targetDir, template);
+        await scaffoldWorkspaceRoot(targetDir, name);
+        const workspaceCoreName = `@${name}/core-module`;
+        for (const t of templates) {
+            const appDir = path.join(targetDir, "apps", t);
+            await scaffoldAppTemplate(appDir, t);
+            workspacifyApp({
+                appDir,
+                appName: t,
+                workspaceRoot: targetDir,
+                workspaceCoreName,
+            });
+            fixPackageJsonName(appDir, t);
+            renameGitignore(appDir);
+            // Each app owns its own .claude / .agents symlinks.
+            setupAgentSymlinks(appDir);
         }
-        s.stop("App created!");
+        s.stop("Workspace scaffolded.");
     }
     catch (err) {
-        s.stop("Failed to create app.");
+        s.stop("Failed to scaffold workspace.");
         throw err;
     }
-    clack.outro(`Done! Next steps:\n\n  cd ${name}\n  pnpm install\n  pnpm dev`);
+    const firstApp = templates[0];
+    clack.outro([
+        `Done! Next steps:`,
+        ``,
+        `  cd ${name}`,
+        `  cp .env.example .env     # ANTHROPIC_API_KEY, DATABASE_URL, BETTER_AUTH_SECRET`,
+        `  pnpm install`,
+        `  pnpm --filter ${firstApp} dev`,
+        ``,
+        `Add another app later:  agent-native add-app`,
+        `Deploy the whole workspace:  agent-native deploy`,
+    ].join("\n"));
 }
-/**
- * Create from the bundled default template (no --template flag).
- */
-function createFromDefault(name, targetDir) {
+async function scaffoldWorkspaceRoot(targetDir, name) {
     const packageRoot = path.resolve(__dirname, "../..");
-    const templateDir = path.join(packageRoot, "src/templates/default");
-    if (!fs.existsSync(templateDir)) {
-        console.error(`Template directory not found at ${templateDir}. Is the package installed correctly?`);
-        process.exit(1);
-    }
-    copyDir(templateDir, targetDir);
-    postProcess(name, targetDir);
+    const rootTemplate = path.join(packageRoot, "src/templates/workspace-root");
+    const coreTemplate = path.join(packageRoot, "src/templates/workspace-core");
+    copyDir(rootTemplate, targetDir);
+    replacePlaceholders(targetDir, name, titleCase(name));
+    renameGitignore(targetDir);
+    const corePackageDir = path.join(targetDir, "packages", "core-module");
+    fs.mkdirSync(path.join(targetDir, "packages"), { recursive: true });
+    copyDir(coreTemplate, corePackageDir);
+    replacePlaceholders(corePackageDir, name, titleCase(name));
+    // Ensure apps/ exists (even if empty).
+    fs.mkdirSync(path.join(targetDir, "apps"), { recursive: true });
 }
+/* ─────────────────────────────────────────────────────────────────────────
+ * Adding an app into an existing workspace
+ * ───────────────────────────────────────────────────────────────────────── */
 /**
- * Create from a named template or GitHub repo.
+ * Entry for `agent-native add-app [name]`. Called from inside a workspace.
+ * Shows the multi-select picker (excluding already-installed apps) and
+ * scaffolds each selected template under apps/<name>/.
  *
- * Supports:
- *   --template mail           (first-party template from BuilderIO/agent-native)
- *   --template github:user/repo  (community template from a GitHub repo)
+ * When `name` is provided with `--template foo`, scaffolds exactly one app
+ * named <name> using template foo (non-interactive).
  */
-async function createFromTemplate(name, targetDir, template) {
-    // Normalize "video" → "videos" (docs use singular, dir is plural)
-    let resolvedTemplate = template;
-    if (resolvedTemplate === "video")
-        resolvedTemplate = "videos";
-    if (resolvedTemplate.startsWith("github:")) {
-        // Community template: github:user/repo
-        const repo = resolvedTemplate.slice("github:".length);
-        await downloadGitHubRepo(repo, targetDir);
+export async function addAppToWorkspace(name, opts) {
+    const clack = await import("@clack/prompts");
+    const workspace = detectWorkspace(process.cwd());
+    if (!workspace) {
+        clack.cancel("Not inside a workspace. Run `agent-native create` to make one first, or use `--standalone`.");
+        process.exit(1);
     }
-    else if (KNOWN_TEMPLATES.includes(resolvedTemplate)) {
-        // First-party template from monorepo
-        await downloadGitHubSubdir(REPO, `${TEMPLATES_DIR}/${resolvedTemplate}`, targetDir);
+    clack.intro("Add an app to your workspace");
+    const installed = listInstalledApps(workspace.workspaceRoot);
+    // Non-interactive path: name + single --template
+    const preselected = parseTemplateList(opts?.template);
+    if (name && preselected.length === 1) {
+        const tpl = preselected[0];
+        await scaffoldOneAppIntoWorkspace(workspace, name, tpl, clack);
+        return;
     }
-    else {
-        console.error(`Unknown template "${template}". Available templates: ${KNOWN_TEMPLATES.filter((t) => t !== "videos").join(", ")}`);
-        console.error(`For community templates, use: --template github:user/repo`);
-        process.exit(1);
+    const templates = await promptTemplatePicker(preselected, clack, {
+        excludeNames: installed,
+        message: "Which apps do you want to add?",
+    });
+    if (templates.length === 0) {
+        clack.cancel("No apps selected. Cancelled.");
+        process.exit(0);
+    }
+    for (const t of templates) {
+        await scaffoldOneAppIntoWorkspace(workspace, t, t, clack);
     }
-    postProcess(name, targetDir);
 }
-/**
- * Validate a GitHub repo string (user/repo) to prevent injection.
- */
-function validateRepoName(repo) {
-    if (!/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(repo)) {
-        console.error(`Invalid repository name "${repo}". Expected format: user/repo`);
+async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, clack) {
+    const appsDir = path.join(workspace.workspaceRoot, "apps");
+    fs.mkdirSync(appsDir, { recursive: true });
+    const appDir = path.join(appsDir, appName);
+    if (fs.existsSync(appDir)) {
+        clack.cancel(`Directory "apps/${appName}" already exists.`);
         process.exit(1);
     }
-}
-/**
- * Download a tarball from a URL and extract it to a directory.
- * Uses execFileSync with array args to avoid shell injection.
- */
-function downloadAndExtract(url, destDir) {
-    fs.mkdirSync(destDir, { recursive: true });
-    // Download with curl (no shell — execFileSync passes args directly)
-    const tarball = execFileSync("curl", ["-sL", url], {
-        maxBuffer: 100 * 1024 * 1024,
-    });
-    // Write tarball to a temp file, then extract (avoids pipe through shell)
-    const tarPath = path.join(destDir, ".download.tar.gz");
-    fs.writeFileSync(tarPath, tarball);
+    const s = clack.spinner();
+    s.start(`Scaffolding apps/${appName} from ${templateName}...`);
     try {
-        execFileSync("tar", ["xzf", tarPath, "--strip-components=1", "-C", destDir], {
-            stdio: "pipe",
+        await scaffoldAppTemplate(appDir, templateName);
+        workspacifyApp({
+            appDir,
+            appName,
+            workspaceRoot: workspace.workspaceRoot,
+            workspaceCoreName: workspace.workspaceCoreName,
         });
+        fixPackageJsonName(appDir, appName);
+        renameGitignore(appDir);
+        setupAgentSymlinks(appDir);
+        s.stop(`Scaffolded apps/${appName}.`);
     }
-    finally {
-        fs.unlinkSync(tarPath);
+    catch (err) {
+        s.stop(`Failed to scaffold apps/${appName}.`);
+        throw err;
     }
+    clack.outro(`Done!\n\n  pnpm install\n  pnpm --filter ${appName} dev`);
 }
-/**
- * Download a subdirectory from a GitHub repo using the tarball API.
- */
-async function downloadGitHubSubdir(repo, subdir, targetDir) {
-    validateRepoName(repo);
-    const tarUrl = `https://api.github.com/repos/${repo}/tarball/main`;
-    // Download and extract into a temp dir, then copy the subdir
-    const tmpDir = path.join(targetDir, "..", `.agent-native-tmp-${Date.now()}`);
-    try {
-        downloadAndExtract(tarUrl, tmpDir);
-        const srcDir = path.join(tmpDir, subdir);
-        if (!fs.existsSync(srcDir)) {
-            console.error(`Template directory "${subdir}" not found in ${repo}. Check the template name.`);
-            process.exit(1);
+/* ─────────────────────────────────────────────────────────────────────────
+ * Standalone creation (escape hatch)
+ * ───────────────────────────────────────────────────────────────────────── */
+async function createStandaloneApp(name, opts, clack) {
+    clack.intro("Create a new standalone agent-native app");
+    name = await promptNameIfMissing(name, clack, "app", "my-app");
+    const targetDir = path.resolve(process.cwd(), name);
+    if (fs.existsSync(targetDir)) {
+        clack.cancel(`Directory "${name}" already exists.`);
+        process.exit(1);
+    }
+    // Standalone is single-select — pick one template.
+    let template = opts?.template && !opts.template.includes(",") ? opts.template : undefined;
+    if (!template) {
+        const picked = await clack.select({
+            message: "Which template would you like to use?",
+            options: [
+                ...visibleTemplates().map((t) => ({
+                    value: t.name,
+                    label: t.label,
+                    hint: t.hint,
+                })),
+                {
+                    value: BLANK_OPTION.name,
+                    label: BLANK_OPTION.label,
+                    hint: BLANK_OPTION.hint,
+                },
+            ],
+        });
+        if (clack.isCancel(picked)) {
+            clack.cancel("Cancelled.");
+            process.exit(0);
         }
-        // Copy template to target
-        copyDir(srcDir, targetDir);
+        template = picked;
     }
-    finally {
-        // Clean up temp dir
-        fs.rmSync(tmpDir, { recursive: true, force: true });
+    const s = clack.spinner();
+    s.start("Scaffolding your app...");
+    try {
+        await scaffoldAppTemplate(targetDir, template);
+        postProcessStandalone(name, targetDir);
+        s.stop("App created!");
+    }
+    catch (err) {
+        s.stop("Failed to create app.");
+        throw err;
     }
+    clack.outro(`Done! Next steps:\n\n  cd ${name}\n  pnpm install\n  pnpm dev`);
 }
+/* ─────────────────────────────────────────────────────────────────────────
+ * Shared scaffolding helpers
+ * ───────────────────────────────────────────────────────────────────────── */
 /**
- * Download an entire GitHub repo (for community templates).
+ * Scaffold a single app template into `targetDir`. Resolves:
+ *   - "blank" → bundled default template
+ *   - "github:user/repo" → download the whole repo
+ *   - first-party template name → download that subdir from BuilderIO/agent-native
  */
-async function downloadGitHubRepo(repo, targetDir) {
-    validateRepoName(repo);
-    const tarUrl = `https://api.github.com/repos/${repo}/tarball/main`;
-    try {
-        downloadAndExtract(tarUrl, targetDir);
+async function scaffoldAppTemplate(targetDir, template) {
+    fs.mkdirSync(path.dirname(targetDir), { recursive: true });
+    if (template === "blank") {
+        const packageRoot = path.resolve(__dirname, "../..");
+        const defaultDir = path.join(packageRoot, "src/templates/default");
+        if (!fs.existsSync(defaultDir)) {
+            throw new Error(`Default template not found at ${defaultDir}. Is the package installed correctly?`);
+        }
+        copyDir(defaultDir, targetDir);
+        return;
     }
-    catch {
-        console.error(`Failed to download template from ${repo}. Check the repo name and that it's public.`);
-        process.exit(1);
+    // Normalize legacy alias
+    let resolved = template === "video" ? "videos" : template;
+    if (resolved.startsWith("github:")) {
+        const repo = resolved.slice("github:".length);
+        await downloadGitHubRepo(repo, targetDir);
+        return;
+    }
+    if (!allTemplateNames().includes(resolved)) {
+        throw new Error(`Unknown template "${template}". Known: ${allTemplateNames().join(", ")} — or use github:user/repo for community templates.`);
+    }
+    // If running from the framework monorepo with a local templates/ dir, use
+    // that. Otherwise download from GitHub. This keeps `agent-native create`
+    // fast during framework development.
+    const localTemplate = findLocalTemplate(resolved);
+    if (localTemplate) {
+        copyDir(localTemplate, targetDir);
+    }
+    else {
+        await downloadGitHubSubdir(REPO, `${TEMPLATES_DIR}/${resolved}`, targetDir);
     }
 }
 /**
- * Post-process a scaffolded template: replace placeholders, set up symlinks, etc.
+ * When developing the framework itself, prefer the sibling templates/<name>
+ * directory. Returns undefined when running as a published package.
  */
-function postProcess(name, targetDir) {
-    // Replace {{APP_NAME}} and {{APP_TITLE}} placeholders in all text files
-    const appTitle = name
-        .split("-")
-        .map((w) => w[0].toUpperCase() + w.slice(1))
-        .join(" ");
-    replacePlaceholders(targetDir, name, appTitle);
-    // Update package.json name field (templates have their own name)
-    const pkgPath = path.join(targetDir, "package.json");
-    if (fs.existsSync(pkgPath)) {
-        try {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-            pkg.name = name;
-            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+function findLocalTemplate(name) {
+    let dir = path.resolve(__dirname);
+    for (let i = 0; i < 10; i++) {
+        const candidate = path.join(dir, "templates", name);
+        if (fs.existsSync(path.join(candidate, "package.json"))) {
+            return candidate;
         }
-        catch { }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
     }
-    // Copy defaults files
+    return undefined;
+}
+/**
+ * Post-process a standalone scaffold: replace placeholders, strip
+ * workspace:* deps, set up agent symlinks, etc.
+ */
+function postProcessStandalone(name, targetDir) {
+    const appTitle = titleCase(name);
+    replacePlaceholders(targetDir, name, appTitle);
+    fixPackageJsonName(targetDir, name);
     for (const base of ["learnings"]) {
         const defaultsFile = path.join(targetDir, `${base}.defaults.md`);
         const targetFile = path.join(targetDir, `${base}.md`);
@@ -290,19 +310,15 @@ function postProcess(name, targetDir) {
             fs.copyFileSync(defaultsFile, targetFile);
         }
     }
-    // Rename gitignore (npm strips .gitignore from packages)
-    const gitignoreSrc = path.join(targetDir, "_gitignore");
-    const gitignoreDst = path.join(targetDir, ".gitignore");
-    if (fs.existsSync(gitignoreSrc)) {
-        fs.renameSync(gitignoreSrc, gitignoreDst);
-    }
-    // Remove monorepo-specific files that don't belong in standalone apps
+    renameGitignore(targetDir);
+    // Drop monorepo-only files that standalone apps shouldn't ship.
     for (const f of ["DEVELOPING.md"]) {
         const p = path.join(targetDir, f);
         if (fs.existsSync(p))
             fs.unlinkSync(p);
     }
-    // Fix package.json: remove workspace: references
+    // Resolve workspace:* deps to `latest` for standalone.
+    const pkgPath = path.join(targetDir, "package.json");
     if (fs.existsSync(pkgPath)) {
         try {
             const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
@@ -316,7 +332,6 @@ function postProcess(name, targetDir) {
                     continue;
                 for (const [key, val] of Object.entries(deps)) {
                     if (typeof val === "string" && val.startsWith("workspace:")) {
-                        // Replace workspace:* with "latest"
                         deps[key] = "latest";
                     }
                 }
@@ -325,19 +340,194 @@ function postProcess(name, targetDir) {
         }
         catch { }
     }
-    // Create symlinks for all agent tools (Claude, Cursor, Windsurf, etc.)
     setupAgentSymlinks(targetDir);
 }
+/* ─────────────────────────────────────────────────────────────────────────
+ * Prompting helpers
+ * ───────────────────────────────────────────────────────────────────────── */
+async function promptNameIfMissing(name, clack, kind, placeholder) {
+    if (name) {
+        if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+            clack.cancel(`Invalid ${kind} name "${name}". Use lowercase letters, numbers, and hyphens.`);
+            process.exit(1);
+        }
+        return name;
+    }
+    const result = await clack.text({
+        message: `What is your ${kind} name?`,
+        placeholder,
+        validate(value) {
+            if (!value)
+                return `${kind[0].toUpperCase() + kind.slice(1)} name is required`;
+            if (!/^[a-z][a-z0-9-]*$/.test(value)) {
+                return "Use lowercase letters, numbers, and hyphens (must start with a letter)";
+            }
+            if (fs.existsSync(path.resolve(process.cwd(), value))) {
+                return `Directory "${value}" already exists`;
+            }
+        },
+    });
+    if (clack.isCancel(result)) {
+        clack.cancel("Cancelled.");
+        process.exit(0);
+    }
+    return result;
+}
+async function promptTemplatePicker(preselected, clack, opts) {
+    const excluded = new Set(opts?.excludeNames ?? []);
+    const options = visibleTemplates()
+        .filter((t) => !excluded.has(t.name))
+        .map((t) => ({
+        value: t.name,
+        label: t.label,
+        hint: t.hint,
+    }));
+    // If there's nothing left to pick, the caller gets an empty selection —
+    // they decide how to handle it.
+    if (options.length === 0)
+        return [];
+    // Default pre-selection: what the user passed via --template, falling
+    // back to "starter" when that's available and nothing else is pre-picked.
+    const defaults = preselected.length > 0
+        ? preselected.filter((p) => options.some((o) => o.value === p))
+        : options.some((o) => o.value === "starter")
+            ? ["starter"]
+            : [];
+    const result = await clack.multiselect({
+        message: opts?.message ?? "Which apps would you like to include?",
+        options,
+        initialValues: defaults,
+        required: false,
+    });
+    if (clack.isCancel(result)) {
+        clack.cancel("Cancelled.");
+        process.exit(0);
+    }
+    return result;
+}
+function parseTemplateList(input) {
+    if (!input)
+        return [];
+    return input
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function listInstalledApps(workspaceRoot) {
+    const appsDir = path.join(workspaceRoot, "apps");
+    if (!fs.existsSync(appsDir))
+        return [];
+    return fs
+        .readdirSync(appsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+}
+/* ─────────────────────────────────────────────────────────────────────────
+ * Workspace detection
+ * ───────────────────────────────────────────────────────────────────────── */
 /**
- * Recursively replace {{APP_NAME}} and {{APP_TITLE}} placeholders in all
- * text files under `dir`. Binary files are skipped silently.
+ * Walk up from startDir looking for a package.json with
+ * `agent-native.workspaceCore` set. Returns the workspace root and core
+ * package name, or null if not inside a workspace.
  */
-function replacePlaceholders(dir, appName, appTitle) {
+export function detectWorkspace(startDir) {
+    let dir = path.resolve(startDir);
+    for (let i = 0; i < 20; i++) {
+        const pkgPath = path.join(dir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+                const wsCore = pkg?.["agent-native"]?.workspaceCore;
+                if (typeof wsCore === "string" && wsCore.length > 0) {
+                    return { workspaceRoot: dir, workspaceCoreName: wsCore };
+                }
+            }
+            catch { }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+export { parseWorkspaceScope };
+/* ─────────────────────────────────────────────────────────────────────────
+ * Download / copy helpers
+ * ───────────────────────────────────────────────────────────────────────── */
+function validateRepoName(repo) {
+    if (!/^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/.test(repo)) {
+        throw new Error(`Invalid repository name "${repo}". Expected format: user/repo`);
+    }
+}
+function downloadAndExtract(url, destDir) {
+    fs.mkdirSync(destDir, { recursive: true });
+    const tarball = execFileSync("curl", ["-sL", url], {
+        maxBuffer: 100 * 1024 * 1024,
+    });
+    const tarPath = path.join(destDir, ".download.tar.gz");
+    fs.writeFileSync(tarPath, tarball);
+    try {
+        execFileSync("tar", ["xzf", tarPath, "--strip-components=1", "-C", destDir], { stdio: "pipe" });
+    }
+    finally {
+        fs.unlinkSync(tarPath);
+    }
+}
+async function downloadGitHubSubdir(repo, subdir, targetDir) {
+    validateRepoName(repo);
+    const tarUrl = `https://api.github.com/repos/${repo}/tarball/main`;
+    const tmpDir = path.join(targetDir, "..", `.agent-native-tmp-${Date.now()}`);
+    try {
+        downloadAndExtract(tarUrl, tmpDir);
+        const srcDir = path.join(tmpDir, subdir);
+        if (!fs.existsSync(srcDir)) {
+            throw new Error(`Template directory "${subdir}" not found in ${repo}.`);
+        }
+        copyDir(srcDir, targetDir);
+    }
+    finally {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+}
+async function downloadGitHubRepo(repo, targetDir) {
+    validateRepoName(repo);
+    const tarUrl = `https://api.github.com/repos/${repo}/tarball/main`;
+    downloadAndExtract(tarUrl, targetDir);
+}
+/* ─────────────────────────────────────────────────────────────────────────
+ * Text / filesystem helpers
+ * ───────────────────────────────────────────────────────────────────────── */
+function titleCase(name) {
+    return name
+        .split("-")
+        .map((w) => (w ? w[0].toUpperCase() + w.slice(1) : w))
+        .join(" ");
+}
+function fixPackageJsonName(appDir, name) {
+    const pkgPath = path.join(appDir, "package.json");
+    if (!fs.existsSync(pkgPath))
+        return;
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        pkg.name = name;
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    }
+    catch { }
+}
+function renameGitignore(dir) {
+    const src = path.join(dir, "_gitignore");
+    const dst = path.join(dir, ".gitignore");
+    if (fs.existsSync(src))
+        fs.renameSync(src, dst);
+}
+function replacePlaceholders(dir, appName, appTitle, workspaceName) {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
         const p = path.join(dir, entry.name);
-        if (entry.isSymbolicLink() || entry.isDirectory()) {
-            if (!entry.isSymbolicLink())
-                replacePlaceholders(p, appName, appTitle);
+        if (entry.isSymbolicLink())
+            continue;
+        if (entry.isDirectory()) {
+            replacePlaceholders(p, appName, appTitle, workspaceName);
             continue;
         }
         let content;
@@ -345,15 +535,22 @@ function replacePlaceholders(dir, appName, appTitle) {
             content = fs.readFileSync(p, "utf-8");
         }
         catch {
-            continue; // skip unreadable / binary files
+            continue;
         }
+        const hasWs = workspaceName !== undefined && content.includes("{{WORKSPACE_NAME}}");
         if (!content.includes("{{APP_NAME}}") &&
-            !content.includes("{{APP_TITLE}}")) {
+            !content.includes("{{APP_TITLE}}") &&
+            !hasWs) {
             continue;
         }
-        fs.writeFileSync(p, content
+        let next = content;
+        if (workspaceName !== undefined) {
+            next = next.replace(/\{\{WORKSPACE_NAME\}\}/g, workspaceName);
+        }
+        next = next
             .replace(/\{\{APP_NAME\}\}/g, appName)
-            .replace(/\{\{APP_TITLE\}\}/g, appTitle));
+            .replace(/\{\{APP_TITLE\}\}/g, appTitle);
+        fs.writeFileSync(p, next);
     }
 }
 function copyDir(src, dest, root) {
@@ -364,15 +561,11 @@ function copyDir(src, dest, root) {
         const destPath = path.join(dest, entry.name);
         if (entry.isSymbolicLink()) {
             const target = fs.readlinkSync(srcPath);
-            // Resolve one level (path math only, no disk follow) to check
-            // whether the symlink stays inside the template tree.
             const resolvedTarget = path.resolve(path.dirname(srcPath), target);
             if (resolvedTarget.startsWith(resolvedRoot)) {
-                // Internal symlink (e.g. .claude/skills -> ../.agents/skills) — preserve it
                 fs.symlinkSync(target, destPath);
             }
             else if (fs.statSync(srcPath).isDirectory()) {
-                // External symlink to directory — dereference and copy contents
                 copyDir(srcPath, destPath, resolvedRoot);
             }
             else {