@agent-native/core 0.14.8 → 0.15.1

package/dist/cli/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"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"}

package/dist/cli/create.js

@@ -92,20 +92,6 @@ async function createWorkspaceInteractive(name, opts, clack) {
     clack.intro("Create a new agent-native workspace");
     name = await promptNameIfMissing(name, clack, "workspace", "my-platform");
     const preselected = parseTemplateList(opts?.template);
-    const dispatchRecommendation = preselected.length === 0
-        ? [
-            "Dispatch is preselected because it is the recommended workspace",
-            "control plane for secrets, messaging, approvals, and cross-app routing.",
-        ]
-        : preselected.includes("dispatch")
-            ? [
-                "Dispatch is included, so the workspace will have a central",
-                "control plane for secrets, messaging, approvals, and cross-app routing.",
-            ]
-            : [
-                "Dispatch is recommended for most workspaces. You can add it later",
-                "with `npx @agent-native/core add-app --template=dispatch` if you skip it now.",
-            ];
     clack.note([
         `You're creating a workspace named "${name}". A workspace is a monorepo`,
         "container — it isn't an app itself. Inside it you pick one or more apps",
@@ -113,35 +99,46 @@ async function createWorkspaceInteractive(name, opts, clack) {
         "same workspace share auth, database, and the agent chat. Add more apps",
         "later with `npx @agent-native/core add-app`. Starter is a minimal scaffold —",
         "useful as a blank app to build from scratch alongside the others.",
-        ...dispatchRecommendation,
+        "Dispatch is always included as the workspace control plane —",
+        "it owns shared secrets, messaging, approvals, and cross-app routing.",
     ].join("\n"), "About workspaces");
-    // If templates were explicitly passed via --template, use them directly.
-    // Otherwise show the multi-select picker.
-    const templates = preselected.length > 0
-        ? preselected
+    // Dispatch is the workspace control plane (shared secrets, messaging,
+    // approvals, cross-app routing) and is always scaffolded — the picker
+    // only shows the optional apps. If the user explicitly passed
+    // `--template=...`, those entries get unioned with dispatch.
+    const optionalPicks = preselected.length > 0
+        ? preselected.filter((t) => t !== "dispatch")
         : await promptTemplatePicker(preselected, clack, {
-            defaultTemplates: ["dispatch", "starter"],
-            preferredFirst: ["dispatch", "starter"],
-            recommendedNames: ["dispatch"],
+            defaultTemplates: ["starter"],
+            preferredFirst: ["starter"],
+            excludeNames: ["dispatch"],
         });
-    if (templates.length === 0) {
-        clack.cancel("No apps selected. Cancelled.");
-        process.exit(0);
-    }
+    const templates = ["dispatch", ...optionalPicks];
     const targetDir = path.resolve(process.cwd(), name);
     if (fs.existsSync(targetDir)) {
         clack.cancel(`Directory "${name}" already exists.`);
         process.exit(1);
     }
     const s = clack.spinner();
-    s.start(`Working... no action needed. Scaffolding workspace with ${templates.length} app(s).`);
+    s.start(`Scaffolding workspace "${name}"...`);
     const firstApp = templates[0];
     try {
         await scaffoldWorkspaceRoot(targetDir, name);
         const workspaceCoreName = `@${name}/shared`;
-        for (const t of templates) {
+        for (let i = 0; i < templates.length; i++) {
+            const t = templates[i];
+            // Distinguish download vs local copy in the spinner so a multi-second
+            // GitHub fetch doesn't look like a frozen "Scaffolding..." message.
+            // Mirrors the local-vs-remote decision inside scaffoldAppTemplate.
+            const willDownload = t !== "blank" && t.startsWith("github:")
+                ? true
+                : !findLocalTemplate(t === "video" ? "videos" : t);
+            s.message(willDownload
+                ? `Downloading ${titleCase(t)} template (${i + 1}/${templates.length})...`
+                : `Scaffolding ${titleCase(t)} (${i + 1}/${templates.length})...`);
             const appDir = path.join(targetDir, "apps", t);
             await scaffoldAppTemplate(appDir, t);
+            s.message(`Configuring ${titleCase(t)} (${i + 1}/${templates.length})...`);
             replacePlaceholders(appDir, t, titleCase(t), name);
             rewriteTrackingAppId(appDir, t, t);
             workspacifyApp({
@@ -158,11 +155,15 @@ async function createWorkspaceInteractive(name, opts, clack) {
             // Each app owns its own .claude / .agents symlinks.
             setupAgentSymlinks(appDir);
         }
+        s.message("Adding shared packages...");
         await scaffoldRequiredPackages(templates, targetDir);
-        s.stop("Workspace scaffolded.");
+        s.stop(`Workspace scaffolded with ${templates.length} app${templates.length === 1 ? "" : "s"}.`);
     }
     catch (err) {
         s.stop("Failed to scaffold workspace.");
+        // Remove the partially-scaffolded workspace so a retry of `agent-native
+        // create <name>` doesn't trip the "Directory already exists" guard.
+        cleanupOnFailure(targetDir);
         clack.cancel(err?.message ?? String(err));
         process.exit(1);
     }
@@ -176,14 +177,21 @@ async function createWorkspaceInteractive(name, opts, clack) {
         ...templates.map((t, i) => `  ${i === templates.length - 1 ? "└─" : "├─"} apps/${t}/`.padEnd(30) +
             `   ← app`),
     ];
-    const dispatchNextStep = templates.includes("dispatch")
+    const dispatchNextStep = [
+        `Once running, open Dispatch — you'll see "Workspace: ${titleCase(name)}"`,
+        `at the top, with all your apps listed under it.`,
+    ];
+    const installSteps = hasPnpm()
         ? [
-            `Once running, open Dispatch — you'll see "Workspace: ${titleCase(name)}"`,
-            `at the top, with all your apps listed under it.`,
+            `  pnpm install`,
+            `  pnpm dev          # starts Dispatch on http://localhost:8092`,
         ]
         : [
-            `This workspace does not include Dispatch. We generally recommend it`,
-            `for workspace secrets, messaging, approvals, and cross-app routing.`,
+            `  # pnpm is required but wasn't found on your PATH. Install it first:`,
+            `  npm install -g pnpm`,
+            ``,
+            `  pnpm install`,
+            `  pnpm dev          # starts Dispatch on http://localhost:8092`,
         ];
     clack.outro([
         `Created workspace "${name}" with ${templates.length} app${templates.length === 1 ? "" : "s"}:`,
@@ -193,8 +201,7 @@ async function createWorkspaceInteractive(name, opts, clack) {
         `Next steps:`,
         ``,
         `  cd ${name}`,
-        `  pnpm install`,
-        `  pnpm dev          # starts Dispatch; other apps start on first visit`,
+        ...installSteps,
         ``,
         ...dispatchNextStep,
         ``,
@@ -202,6 +209,21 @@ async function createWorkspaceInteractive(name, opts, clack) {
         `Deploy the whole workspace:   pnpm exec agent-native deploy`,
     ].join("\n"));
 }
+/**
+ * Detect whether pnpm is on PATH. End-user machines often have npm/yarn but
+ * not pnpm; the workspace scaffold uses pnpm workspaces, so we surface a
+ * specific install hint in the outro when it's missing rather than letting
+ * the user hit `zsh: command not found: pnpm`.
+ */
+function hasPnpm() {
+    try {
+        execFileSync("pnpm", ["--version"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 async function scaffoldWorkspaceRoot(targetDir, name) {
     const packageRoot = path.resolve(__dirname, "../..");
     const rootTemplate = path.join(packageRoot, "src/templates/workspace-root");
@@ -230,11 +252,47 @@ async function scaffoldWorkspaceRoot(targetDir, name) {
     copyDir(coreTemplate, corePackageDir);
     replacePlaceholders(corePackageDir, name, titleCase(name));
     rewriteCoreDependencyVersions(corePackageDir);
+    setupAgentSymlinks(corePackageDir);
     // Ensure apps/ exists (even if empty).
     fs.mkdirSync(path.join(targetDir, "apps"), { recursive: true });
     // Root-level agent instructions apply before an agent descends into an app.
+    linkWorkspaceRootSkills(targetDir);
     setupAgentSymlinks(targetDir);
 }
+function linkWorkspaceRootSkills(targetDir) {
+    const sharedSkillsDir = path.join(targetDir, "packages", "shared", ".agents", "skills");
+    if (!fs.existsSync(sharedSkillsDir))
+        return;
+    const agentsDir = path.join(targetDir, ".agents");
+    const linkPath = path.join(agentsDir, "skills");
+    const target = "../packages/shared/.agents/skills";
+    fs.mkdirSync(agentsDir, { recursive: true });
+    try {
+        const stat = fs.lstatSync(linkPath);
+        if (stat.isSymbolicLink()) {
+            if (fs.readlinkSync(linkPath) === target)
+                return;
+            fs.unlinkSync(linkPath);
+        }
+        else {
+            return;
+        }
+    }
+    catch {
+        // Missing link; create below.
+    }
+    try {
+        fs.symlinkSync(target, linkPath, process.platform === "win32" ? "junction" : "dir");
+    }
+    catch {
+        try {
+            copyDir(sharedSkillsDir, linkPath);
+        }
+        catch {
+            // Best-effort fallback for environments that disallow symlinks.
+        }
+    }
+}
 /* ─────────────────────────────────────────────────────────────────────────
  * Adding an app into an existing workspace
  * ───────────────────────────────────────────────────────────────────────── */
@@ -314,6 +372,7 @@ async function scaffoldOneAppIntoWorkspace(workspace, appName, templateName, cla
     }
     catch (err) {
         s.stop(`Failed to scaffold apps/${appName}.`);
+        cleanupOnFailure(appDir);
         clack.cancel(err?.message ?? String(err));
         process.exit(1);
     }
@@ -362,20 +421,38 @@ async function createStandaloneApp(name, opts, clack) {
         template = picked;
     }
     const s = clack.spinner();
-    s.start("Working... no action needed. Scaffolding your app.");
+    s.start(`Downloading the ${template} template from GitHub…`);
     try {
         await scaffoldAppTemplate(targetDir, template);
+        s.message(`Setting up ${name}…`);
         postProcessStandalone(name, targetDir, template);
         s.stop("App created!");
     }
     catch (err) {
         s.stop("Failed to create app.");
+        cleanupOnFailure(targetDir);
         clack.cancel(err?.message ?? String(err));
         process.exit(1);
     }
     tryGitInit(targetDir);
     clack.outro(`Done! Next steps:\n\n  cd ${name}\n  pnpm install\n  pnpm dev`);
 }
+/**
+ * Remove a partially-scaffolded target directory after a scaffold failure so a
+ * retry doesn't hit the "Directory already exists" guard. Best-effort — the
+ * underlying failure is what we want surfaced, so we swallow rm errors and
+ * skip if the directory is somehow already gone.
+ */
+function cleanupOnFailure(targetDir) {
+    try {
+        if (fs.existsSync(targetDir)) {
+            fs.rmSync(targetDir, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // Ignore — original error is more useful than a cleanup failure.
+    }
+}
 /* ─────────────────────────────────────────────────────────────────────────
  * Shared scaffolding helpers
  * ───────────────────────────────────────────────────────────────────────── */