@nextsparkjs/cli 0.1.0-beta.87 → 0.1.0-beta.89

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
 // src/cli.ts
 import { config } from "dotenv";
 import { Command } from "commander";
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 import { readFileSync as readFileSync11 } from "fs";
 
 // src/commands/dev.ts
@@ -22,7 +22,7 @@ import ora from "ora";
 
 // src/utils/paths.ts
 import { existsSync } from "fs";
-import { resolve, dirname } from "path";
+import { resolve, join, dirname } from "path";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -52,6 +52,16 @@ function isMonorepoMode() {
   const npmCorePath = resolve(cwd, "node_modules", "@nextsparkjs", "core");
   return !existsSync(npmCorePath);
 }
+function getAIWorkflowDir() {
+  const cwd = process.cwd();
+  const nmPath = join(cwd, "node_modules", "@nextsparkjs", "ai-workflow");
+  if (existsSync(nmPath)) return nmPath;
+  const webNmPath = join(cwd, "web", "node_modules", "@nextsparkjs", "ai-workflow");
+  if (existsSync(webNmPath)) return webNmPath;
+  const monoPath = join(cwd, "packages", "ai-workflow");
+  if (existsSync(monoPath)) return monoPath;
+  return null;
+}
 
 // src/commands/dev.ts
 async function devCommand(options) {
@@ -120,11 +130,11 @@ async function devCommand(options) {
 // src/commands/build.ts
 import { spawn as spawn2 } from "child_process";
 import { existsSync as existsSync2, readFileSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 import chalk2 from "chalk";
 import ora2 from "ora";
 function loadProjectEnv(projectRoot) {
-  const envPath = join(projectRoot, ".env");
+  const envPath = join2(projectRoot, ".env");
   const envVars = {};
   if (existsSync2(envPath)) {
     const content = readFileSync(envPath, "utf-8");
@@ -217,11 +227,11 @@ Build failed with exit code ${code}`));
 // src/commands/generate.ts
 import { spawn as spawn3 } from "child_process";
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import chalk3 from "chalk";
 import ora3 from "ora";
 function loadProjectEnv2(projectRoot) {
-  const envPath = join2(projectRoot, ".env");
+  const envPath = join3(projectRoot, ".env");
   const envVars = {};
   if (existsSync3(envPath)) {
     const content = readFileSync2(envPath, "utf-8");
@@ -301,11 +311,11 @@ Registry generation failed with exit code ${code}`));
 // src/commands/registry.ts
 import { spawn as spawn4 } from "child_process";
 import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import chalk4 from "chalk";
 import ora4 from "ora";
 function loadProjectEnv3(projectRoot) {
-  const envPath = join3(projectRoot, ".env");
+  const envPath = join4(projectRoot, ".env");
   const envVars = {};
   if (existsSync4(envPath)) {
     const content = readFileSync3(envPath, "utf-8");
@@ -427,7 +437,7 @@ Watcher exited with code ${code}`));
 
 // src/commands/init.ts
 import { existsSync as existsSync8, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync7 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 import chalk12 from "chalk";
 import ora8 from "ora";
 
@@ -437,22 +447,22 @@ import ora7 from "ora";
 import { confirm as confirm5, select as select6 } from "@inquirer/prompts";
 import { execSync } from "child_process";
 import { existsSync as existsSync7, readdirSync } from "fs";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // src/wizard/banner.ts
 import chalk5 from "chalk";
 import { readFileSync as readFileSync4 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { dirname as dirname2, join as join4 } from "path";
+import { dirname as dirname2, join as join5 } from "path";
 var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname2(__filename2);
 function getCliVersion() {
   const possiblePaths = [
-    join4(__dirname2, "../package.json"),
+    join5(__dirname2, "../package.json"),
     // from dist/
-    join4(__dirname2, "../../package.json"),
+    join5(__dirname2, "../../package.json"),
     // from dist/wizard/ or src/wizard/
-    join4(__dirname2, "../../../package.json")
+    join5(__dirname2, "../../../package.json")
     // fallback
   ];
   for (const packageJsonPath of possiblePaths) {
@@ -2019,7 +2029,7 @@ async function copyContentFeatures(config2) {
 
 // src/wizard/generators/theme-plugins-installer.ts
 import { existsSync as existsSync6, cpSync, mkdirSync, readFileSync as readFileSync6, writeFileSync } from "fs";
-import { join as join6, resolve as resolve2 } from "path";
+import { join as join7, resolve as resolve2 } from "path";
 import chalk9 from "chalk";
 import ora6 from "ora";
 
@@ -2027,12 +2037,12 @@ import ora6 from "ora";
 import chalk8 from "chalk";
 import ora5 from "ora";
 import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 async function addTheme(packageSpec, options = {}) {
   const spinner = ora5(`Adding theme ${packageSpec}`).start();
   let cleanup = null;
   try {
-    const contentsDir = join5(process.cwd(), "contents");
+    const contentsDir = join6(process.cwd(), "contents");
     if (!existsSync5(contentsDir)) {
       spinner.fail('contents/ directory not found. Run "nextspark init" first.');
       return;
@@ -2095,10 +2105,10 @@ async function addTheme(packageSpec, options = {}) {
 }
 function checkPluginExists(pluginName) {
   const name = pluginName.replace(/^@[^/]+\//, "").replace(/^nextspark-plugin-/, "").replace(/^plugin-/, "");
-  return existsSync5(join5(process.cwd(), "contents", "plugins", name));
+  return existsSync5(join6(process.cwd(), "contents", "plugins", name));
 }
 function getCoreVersion() {
-  const pkgPath = join5(process.cwd(), "node_modules", "@nextsparkjs", "core", "package.json");
+  const pkgPath = join6(process.cwd(), "node_modules", "@nextsparkjs", "core", "package.json");
   if (existsSync5(pkgPath)) {
     try {
       const pkg2 = JSON.parse(readFileSync5(pkgPath, "utf-8"));
@@ -2139,20 +2149,20 @@ var THEME_REQUIRED_PLUGINS2 = {
 };
 function isMonorepoMode2() {
   const possiblePaths = [
-    join6(process.cwd(), "pnpm-workspace.yaml"),
-    join6(process.cwd(), "..", "pnpm-workspace.yaml"),
-    join6(process.cwd(), "..", "..", "pnpm-workspace.yaml")
+    join7(process.cwd(), "pnpm-workspace.yaml"),
+    join7(process.cwd(), "..", "pnpm-workspace.yaml"),
+    join7(process.cwd(), "..", "..", "pnpm-workspace.yaml")
   ];
   return possiblePaths.some((p) => existsSync6(p));
 }
 function getMonorepoRoot() {
   const possibleRoots = [
     process.cwd(),
-    join6(process.cwd(), ".."),
-    join6(process.cwd(), "..", "..")
+    join7(process.cwd(), ".."),
+    join7(process.cwd(), "..", "..")
   ];
   for (const root of possibleRoots) {
-    if (existsSync6(join6(root, "pnpm-workspace.yaml"))) {
+    if (existsSync6(join7(root, "pnpm-workspace.yaml"))) {
       return resolve2(root);
     }
   }
@@ -2162,15 +2172,15 @@ function getLocalPackageDir(type, name) {
   const monorepoRoot = getMonorepoRoot();
   if (!monorepoRoot) return null;
   const baseDir = type === "theme" ? "themes" : "plugins";
-  const packageDir = join6(monorepoRoot, baseDir, name);
-  if (existsSync6(packageDir) && existsSync6(join6(packageDir, "package.json"))) {
+  const packageDir = join7(monorepoRoot, baseDir, name);
+  if (existsSync6(packageDir) && existsSync6(join7(packageDir, "package.json"))) {
     return packageDir;
   }
   return null;
 }
 async function copyLocalTheme(name, sourceDir) {
-  const targetDir = join6(process.cwd(), "contents", "themes", name);
-  const themesDir = join6(process.cwd(), "contents", "themes");
+  const targetDir = join7(process.cwd(), "contents", "themes", name);
+  const themesDir = join7(process.cwd(), "contents", "themes");
   if (!existsSync6(themesDir)) {
     mkdirSync(themesDir, { recursive: true });
   }
@@ -2183,8 +2193,8 @@ async function copyLocalTheme(name, sourceDir) {
   return true;
 }
 async function copyLocalPlugin(name, sourceDir) {
-  const targetDir = join6(process.cwd(), "contents", "plugins", name);
-  const pluginsDir = join6(process.cwd(), "contents", "plugins");
+  const targetDir = join7(process.cwd(), "contents", "plugins", name);
+  const pluginsDir = join7(process.cwd(), "contents", "plugins");
   if (!existsSync6(pluginsDir)) {
     mkdirSync(pluginsDir, { recursive: true });
   }
@@ -2197,7 +2207,7 @@ async function copyLocalPlugin(name, sourceDir) {
   return true;
 }
 async function updateTsConfigPaths(name, type) {
-  const tsconfigPath = join6(process.cwd(), "tsconfig.json");
+  const tsconfigPath = join7(process.cwd(), "tsconfig.json");
   if (!existsSync6(tsconfigPath)) {
     return;
   }
@@ -2242,7 +2252,7 @@ async function installTheme2(theme) {
     prefixText: "  "
   }).start();
   try {
-    const targetDir = join6(process.cwd(), "contents", "themes", theme);
+    const targetDir = join7(process.cwd(), "contents", "themes", theme);
     if (existsSync6(targetDir)) {
       spinner.info(chalk9.gray(`Reference theme ${theme} already exists`));
       return true;
@@ -2295,7 +2305,7 @@ async function installPlugins(plugins) {
       prefixText: "  "
     }).start();
     try {
-      const pluginDir = join6(process.cwd(), "contents", "plugins", plugin);
+      const pluginDir = join7(process.cwd(), "contents", "plugins", plugin);
       if (existsSync6(pluginDir)) {
         spinner.info(chalk9.gray(`Plugin ${plugin} already installed`));
         continue;
@@ -3116,6 +3126,7 @@ async function generateProject(config2) {
     await copyProjectFiles();
     await updateGlobalsCss(config2);
     await copyStarterTheme(config2);
+    await fs8.ensureDir(path7.join(process.cwd(), "contents", "plugins"));
     await copyContentFeatures(config2);
     await updateThemeConfig(config2);
     await updateDevConfig(config2);
@@ -3572,7 +3583,7 @@ async function runWizard(options = { mode: "interactive" }) {
       prefixText: "  "
     }).start();
     try {
-      const registryScript = join7(webDir, "node_modules/@nextsparkjs/core/scripts/build/registry.mjs");
+      const registryScript = join8(webDir, "node_modules/@nextsparkjs/core/scripts/build/registry.mjs");
       registrySpinner.stop();
       execSync(`node "${registryScript}" --build`, {
         cwd: webDir,
@@ -3589,8 +3600,8 @@ async function runWizard(options = { mode: "interactive" }) {
       const devCmd = isMonorepo ? "pnpm dev" : "pnpm dev";
       console.log(chalk11.yellow(`  Registries will be built automatically when you run "${devCmd}"`));
     }
-    await promptAIWorkflowSetup(config2);
-    showNextSteps(config2, selectedTheme);
+    const aiChoice = await promptAIWorkflowSetup(config2);
+    showNextSteps(config2, selectedTheme, aiChoice);
   } catch (error) {
     if (error instanceof Error) {
       if (error.message.includes("User force closed")) {
@@ -3697,8 +3708,9 @@ function formatDevTool(tool) {
   };
   return mapping[tool] || tool;
 }
-function showNextSteps(config2, referenceTheme = null) {
+function showNextSteps(config2, referenceTheme = null, aiChoice = "skip") {
   const isMonorepo = config2.projectType === "web-mobile";
+  const aiSetupDone = aiChoice === "claude";
   console.log("");
   console.log(chalk11.cyan("  " + "=".repeat(60)));
   console.log(chalk11.bold.green("  \u2728 NextSpark project ready!"));
@@ -3707,12 +3719,12 @@ function showNextSteps(config2, referenceTheme = null) {
   console.log(chalk11.bold.white("  Next steps:"));
   console.log("");
   const envPath = isMonorepo ? "web/.env" : ".env";
-  console.log(chalk11.white("  1. Configure your .env file:"));
-  console.log(chalk11.gray(`     Edit these values in ${envPath}:`));
+  console.log(chalk11.white("  1. Configure your environment:"));
+  console.log(chalk11.gray(`     Edit ${envPath} with your credentials:`));
   console.log("");
   console.log(chalk11.yellow("     DATABASE_URL"));
   console.log(chalk11.gray("     PostgreSQL connection string"));
-  console.log(chalk11.dim("     Example: postgresql://user:pass@localhost:5432/mydb"));
+  console.log(chalk11.gray(`     Recommended: ${chalk11.cyan("https://supabase.com")} | ${chalk11.cyan("https://neon.com")}`));
   console.log("");
   console.log(chalk11.yellow("     BETTER_AUTH_SECRET"));
   console.log(chalk11.gray("     Generate with:"));
@@ -3724,11 +3736,23 @@ function showNextSteps(config2, referenceTheme = null) {
   console.log(chalk11.white("  3. Start the development server:"));
   console.log(chalk11.cyan("     pnpm dev"));
   console.log("");
+  let nextStep = 4;
   if (isMonorepo) {
-    console.log(chalk11.white("  4. (Optional) Start the mobile app:"));
+    console.log(chalk11.white(`  ${nextStep}. (Optional) Start the mobile app:`));
     console.log(chalk11.cyan("     pnpm dev:mobile"));
     console.log(chalk11.gray("     Or: cd mobile && pnpm start"));
     console.log("");
+    nextStep++;
+  }
+  if (aiSetupDone) {
+    console.log(chalk11.white(`  ${nextStep}. Start building with AI:`));
+    console.log(chalk11.gray("     Open Claude Code in your project and run:"));
+    console.log(chalk11.cyan("     /how-to:start"));
+    console.log("");
+  } else {
+    console.log(chalk11.white(`  ${nextStep}. (Optional) Setup AI workflows:`));
+    console.log(chalk11.cyan("     nextspark setup:ai"));
+    console.log("");
   }
   console.log(chalk11.gray("  " + "-".repeat(60)));
   if (isMonorepo) {
@@ -3744,18 +3768,10 @@ function showNextSteps(config2, referenceTheme = null) {
     const refPath = isMonorepo ? `web/contents/themes/${referenceTheme}/` : `contents/themes/${referenceTheme}/`;
     console.log(chalk11.gray(`  Reference: ${chalk11.white(refPath)}`));
   }
-  console.log("");
-  console.log(chalk11.white(`  ${isMonorepo ? "5" : "4"}. (Optional) Setup AI workflows:`));
-  console.log(chalk11.cyan("     nextspark setup:ai"));
-  console.log("");
-  console.log(chalk11.gray("  Docs: https://nextspark.dev/docs"));
+  console.log(chalk11.gray(`  Docs: ${chalk11.cyan("https://nextspark.dev/docs")}`));
   console.log("");
 }
 async function promptAIWorkflowSetup(config2) {
-  console.log("");
-  console.log(chalk11.cyan("  " + "=".repeat(60)));
-  console.log(chalk11.bold.white("  AI Workflow Setup (Optional)"));
-  console.log(chalk11.cyan("  " + "=".repeat(60)));
   console.log("");
   const choice = await select6({
     message: "Setup AI-assisted development workflows?",
@@ -3767,12 +3783,11 @@ async function promptAIWorkflowSetup(config2) {
     ]
   });
   if (choice === "skip") {
-    showInfo('Skipped AI workflow setup. Run "nextspark setup:ai" later to set up.');
-    return;
+    return "skip";
   }
   if (choice === "cursor" || choice === "antigravity") {
     showInfo(`${choice} support is coming soon. For now, use Claude Code.`);
-    return;
+    return "skip";
   }
   const projectRoot = process.cwd();
   const isMonorepo = isMonorepoProject(config2);
@@ -3781,9 +3796,9 @@ async function promptAIWorkflowSetup(config2) {
       cwd: projectRoot,
       stdio: "inherit"
     });
-    let setupScript = join7(projectRoot, "node_modules", "@nextsparkjs", "ai-workflow", "scripts", "setup.mjs");
+    let setupScript = join8(projectRoot, "node_modules", "@nextsparkjs", "ai-workflow", "scripts", "setup.mjs");
     if (!existsSync7(setupScript) && isMonorepo) {
-      setupScript = join7(projectRoot, "web", "node_modules", "@nextsparkjs", "ai-workflow", "scripts", "setup.mjs");
+      setupScript = join8(projectRoot, "web", "node_modules", "@nextsparkjs", "ai-workflow", "scripts", "setup.mjs");
     }
     if (existsSync7(setupScript)) {
       execSync(`node "${setupScript}" ${choice}`, {
@@ -3796,7 +3811,9 @@ async function promptAIWorkflowSetup(config2) {
     }
   } catch (error) {
     showError('Failed to install AI workflow package. Run "nextspark setup:ai" later.');
+    return "skip";
   }
+  return choice;
 }
 function findLocalCoreTarball() {
   const cwd = process.cwd();
@@ -3806,14 +3823,14 @@ function findLocalCoreTarball() {
       (f) => f.includes("nextsparkjs-core") && f.endsWith(".tgz")
     );
     if (coreTarball) {
-      return join7(cwd, coreTarball);
+      return join8(cwd, coreTarball);
     }
   } catch {
   }
   return null;
 }
 function isCoreInstalled() {
-  const corePath = join7(process.cwd(), "node_modules", "@nextsparkjs", "core");
+  const corePath = join8(process.cwd(), "node_modules", "@nextsparkjs", "core");
   return existsSync7(corePath);
 }
 async function installCore() {
@@ -3831,8 +3848,8 @@ async function installCore() {
       packageSpec = localTarball;
       spinner.text = "Installing @nextsparkjs/core from local tarball...";
     }
-    const useYarn = existsSync7(join7(process.cwd(), "yarn.lock"));
-    const usePnpm = existsSync7(join7(process.cwd(), "pnpm-lock.yaml"));
+    const useYarn = existsSync7(join8(process.cwd(), "yarn.lock"));
+    const usePnpm = existsSync7(join8(process.cwd(), "pnpm-lock.yaml"));
     let installCmd;
     if (usePnpm) {
       installCmd = `pnpm add ${packageSpec}`;
@@ -3858,7 +3875,7 @@ async function installCore() {
   }
 }
 function isMobileInstalled() {
-  const mobilePath = join7(process.cwd(), "node_modules", "@nextsparkjs", "mobile");
+  const mobilePath = join8(process.cwd(), "node_modules", "@nextsparkjs", "mobile");
   return existsSync7(mobilePath);
 }
 function findLocalMobileTarball() {
@@ -3869,7 +3886,7 @@ function findLocalMobileTarball() {
       (f) => f.includes("nextsparkjs-mobile") && f.endsWith(".tgz")
     );
     if (mobileTarball) {
-      return join7(cwd, mobileTarball);
+      return join8(cwd, mobileTarball);
     }
   } catch {
   }
@@ -3890,8 +3907,8 @@ async function installMobile() {
       packageSpec = localTarball;
       spinner.text = "Installing @nextsparkjs/mobile from local tarball...";
     }
-    const useYarn = existsSync7(join7(process.cwd(), "yarn.lock"));
-    const usePnpm = existsSync7(join7(process.cwd(), "pnpm-lock.yaml"));
+    const useYarn = existsSync7(join8(process.cwd(), "yarn.lock"));
+    const usePnpm = existsSync7(join8(process.cwd(), "pnpm-lock.yaml"));
     let installCmd;
     if (usePnpm) {
       installCmd = `pnpm add ${packageSpec}`;
@@ -3929,10 +3946,10 @@ function parsePlugins(pluginsStr) {
 }
 function hasExistingProject() {
   const projectRoot = process.cwd();
-  return existsSync8(join8(projectRoot, "contents")) || existsSync8(join8(projectRoot, ".nextspark"));
+  return existsSync8(join9(projectRoot, "contents")) || existsSync8(join9(projectRoot, ".nextspark"));
 }
 function generateInitialRegistries(registriesDir) {
-  writeFileSync2(join8(registriesDir, "block-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "block-registry.ts"), `// Auto-generated by nextspark init
 import type { ComponentType } from 'react'
 
 export const BLOCK_REGISTRY: Record<string, {
@@ -3945,26 +3962,26 @@ export const BLOCK_REGISTRY: Record<string, {
 
 export const BLOCK_COMPONENTS: Record<string, React.LazyExoticComponent<ComponentType<any>>> = {}
 `);
-  writeFileSync2(join8(registriesDir, "theme-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "theme-registry.ts"), `// Auto-generated by nextspark init
 export const THEME_REGISTRY: Record<string, unknown> = {}
 `);
-  writeFileSync2(join8(registriesDir, "entity-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "entity-registry.ts"), `// Auto-generated by nextspark init
 export const ENTITY_REGISTRY: Record<string, unknown> = {}
 `);
-  writeFileSync2(join8(registriesDir, "entity-registry.client.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "entity-registry.client.ts"), `// Auto-generated by nextspark init
 export const CLIENT_ENTITY_REGISTRY: Record<string, unknown> = {}
 export function parseChildEntity(path: string) { return null }
 export function getEntityApiPath(entity: string) { return \`/api/\${entity}\` }
 export function clientMetaSystemAdapter() { return {} }
 export type ClientEntityConfig = Record<string, unknown>
 `);
-  writeFileSync2(join8(registriesDir, "billing-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "billing-registry.ts"), `// Auto-generated by nextspark init
 export const BILLING_REGISTRY = { plans: [], features: [] }
 `);
-  writeFileSync2(join8(registriesDir, "plugin-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "plugin-registry.ts"), `// Auto-generated by nextspark init
 export const PLUGIN_REGISTRY: Record<string, unknown> = {}
 `);
-  writeFileSync2(join8(registriesDir, "testing-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "testing-registry.ts"), `// Auto-generated by nextspark init
 export const FLOW_REGISTRY: Record<string, unknown> = {}
 export const FEATURE_REGISTRY: Record<string, unknown> = {}
 export const TAGS_REGISTRY: Record<string, unknown> = {}
@@ -3972,11 +3989,11 @@ export const COVERAGE_SUMMARY = { total: 0, covered: 0 }
 export type FlowEntry = unknown
 export type FeatureEntry = unknown
 `);
-  writeFileSync2(join8(registriesDir, "docs-registry.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "docs-registry.ts"), `// Auto-generated by nextspark init
 export const DOCS_REGISTRY = { sections: [], pages: [] }
 export type DocSectionMeta = { title: string; slug: string }
 `);
-  writeFileSync2(join8(registriesDir, "index.ts"), `// Auto-generated by nextspark init
+  writeFileSync2(join9(registriesDir, "index.ts"), `// Auto-generated by nextspark init
 export * from './block-registry'
 export * from './theme-registry'
 export * from './entity-registry'
@@ -3991,15 +4008,15 @@ async function simpleInit(options) {
   const spinner = ora8("Initializing NextSpark project...").start();
   const projectRoot = process.cwd();
   try {
-    const nextspark = join8(projectRoot, ".nextspark");
-    const registriesDir = join8(nextspark, "registries");
+    const nextspark = join9(projectRoot, ".nextspark");
+    const registriesDir = join9(nextspark, "registries");
     if (!existsSync8(registriesDir) || options.force) {
       mkdirSync2(registriesDir, { recursive: true });
       spinner.text = "Creating .nextspark/registries/";
       generateInitialRegistries(registriesDir);
       spinner.text = "Generated initial registries";
     }
-    const tsconfigPath = join8(projectRoot, "tsconfig.json");
+    const tsconfigPath = join9(projectRoot, "tsconfig.json");
     if (existsSync8(tsconfigPath)) {
       spinner.text = "Updating tsconfig.json paths...";
       const tsconfig = JSON.parse(readFileSync7(tsconfigPath, "utf-8"));
@@ -4011,7 +4028,7 @@ async function simpleInit(options) {
       };
       writeFileSync2(tsconfigPath, JSON.stringify(tsconfig, null, 2));
     }
-    const envExample = join8(projectRoot, ".env.example");
+    const envExample = join9(projectRoot, ".env.example");
     if (!existsSync8(envExample)) {
       const envContent = `# NextSpark Configuration
 DATABASE_URL="postgresql://user:password@localhost:5432/db"
@@ -4062,21 +4079,21 @@ async function initCommand(options) {
 
 // src/commands/add-mobile.ts
 import { existsSync as existsSync9, cpSync as cpSync2, readFileSync as readFileSync8, writeFileSync as writeFileSync3, renameSync, mkdirSync as mkdirSync3 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 import chalk13 from "chalk";
 import ora9 from "ora";
 import { execSync as execSync2 } from "child_process";
 function findMobileCoreDir() {
   const projectRoot = process.cwd();
-  const npmPath = join9(projectRoot, "node_modules", "@nextsparkjs", "mobile");
+  const npmPath = join10(projectRoot, "node_modules", "@nextsparkjs", "mobile");
   if (existsSync9(npmPath)) {
     return npmPath;
   }
-  const monoPath = join9(projectRoot, "packages", "mobile");
+  const monoPath = join10(projectRoot, "packages", "mobile");
   if (existsSync9(monoPath)) {
     return monoPath;
   }
-  const parentNpmPath = join9(projectRoot, "..", "node_modules", "@nextsparkjs", "mobile");
+  const parentNpmPath = join10(projectRoot, "..", "node_modules", "@nextsparkjs", "mobile");
   if (existsSync9(parentNpmPath)) {
     return parentNpmPath;
   }
@@ -4086,7 +4103,7 @@ function findMobileCoreDir() {
 }
 async function addMobileCommand(options = {}) {
   const projectRoot = process.cwd();
-  const mobileDir = join9(projectRoot, "mobile");
+  const mobileDir = join10(projectRoot, "mobile");
   console.log();
   console.log(chalk13.bold("Adding NextSpark Mobile App"));
   console.log();
@@ -4102,7 +4119,7 @@ async function addMobileCommand(options = {}) {
     console.log(chalk13.red(error.message));
     process.exit(1);
   }
-  const templatesDir = join9(mobileCoreDir, "templates");
+  const templatesDir = join10(mobileCoreDir, "templates");
   if (!existsSync9(templatesDir)) {
     console.log(chalk13.red("Error: Could not find mobile templates"));
     console.log(chalk13.gray(`Expected at: ${templatesDir}`));
@@ -4112,12 +4129,12 @@ async function addMobileCommand(options = {}) {
   try {
     mkdirSync3(mobileDir, { recursive: true });
     cpSync2(templatesDir, mobileDir, { recursive: true });
-    const pkgTemplatePath = join9(mobileDir, "package.json.template");
-    const pkgPath = join9(mobileDir, "package.json");
+    const pkgTemplatePath = join10(mobileDir, "package.json.template");
+    const pkgPath = join10(mobileDir, "package.json");
     if (existsSync9(pkgTemplatePath)) {
       renameSync(pkgTemplatePath, pkgPath);
       const pkg2 = JSON.parse(readFileSync8(pkgPath, "utf-8"));
-      const rootPkgPath = join9(projectRoot, "package.json");
+      const rootPkgPath = join10(projectRoot, "package.json");
       if (existsSync9(rootPkgPath)) {
         const rootPkg = JSON.parse(readFileSync8(rootPkgPath, "utf-8"));
         const rawName = rootPkg.name || "my-project";
@@ -4631,11 +4648,11 @@ async function doctorCommand() {
 // src/commands/db.ts
 import { spawn as spawn5 } from "child_process";
 import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import chalk16 from "chalk";
 import ora10 from "ora";
 function loadProjectEnv4(projectRoot) {
-  const envPath = join10(projectRoot, ".env");
+  const envPath = join11(projectRoot, ".env");
   const envVars = {};
   if (existsSync10(envPath)) {
     const content = readFileSync9(envPath, "utf-8");
@@ -4660,7 +4677,7 @@ async function dbMigrateCommand() {
   try {
     const coreDir = getCoreDir();
     const projectRoot = getProjectRoot();
-    const migrationsScript = join10(coreDir, "scripts", "db", "run-migrations.mjs");
+    const migrationsScript = join11(coreDir, "scripts", "db", "run-migrations.mjs");
     if (!existsSync10(migrationsScript)) {
       spinner.fail("Migrations script not found");
       console.error(chalk16.red(`Expected script at: ${migrationsScript}`));
@@ -4720,7 +4737,7 @@ async function dbSeedCommand() {
 
 // src/commands/sync-app.ts
 import { existsSync as existsSync11, readdirSync as readdirSync2, mkdirSync as mkdirSync4, copyFileSync, readFileSync as readFileSync10 } from "fs";
-import { join as join11, dirname as dirname4, relative } from "path";
+import { join as join12, dirname as dirname4, relative } from "path";
 import chalk17 from "chalk";
 import ora11 from "ora";
 var EXCLUDED_TEMPLATE_PATTERNS = ["(templates)"];
@@ -4743,7 +4760,7 @@ function getAllFiles(dir, baseDir = dir) {
   }
   const entries = readdirSync2(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join11(dir, entry.name);
+    const fullPath = join12(dir, entry.name);
     const relativePath = relative(baseDir, fullPath);
     if (entry.isDirectory()) {
       files.push(...getAllFiles(fullPath, baseDir));
@@ -4768,14 +4785,14 @@ function backupDirectory(source, target) {
   }
   const files = getAllFiles(source);
   for (const file of files) {
-    const sourcePath = join11(source, file);
-    const targetPath = join11(target, file);
+    const sourcePath = join12(source, file);
+    const targetPath = join12(target, file);
     copyFile(sourcePath, targetPath);
   }
 }
 function getCoreVersion2(coreDir) {
   try {
-    const pkgPath = join11(coreDir, "package.json");
+    const pkgPath = join12(coreDir, "package.json");
     const pkg2 = JSON.parse(readFileSync10(pkgPath, "utf-8"));
     return pkg2.version || "unknown";
   } catch {
@@ -4788,8 +4805,8 @@ async function syncAppCommand(options) {
     const coreDir = getCoreDir();
     const projectRoot = getProjectRoot();
     const coreVersion = getCoreVersion2(coreDir);
-    const templatesDir = join11(coreDir, "templates", "app");
-    const appDir = join11(projectRoot, "app");
+    const templatesDir = join12(coreDir, "templates", "app");
+    const appDir = join12(projectRoot, "app");
     if (!existsSync11(templatesDir)) {
       spinner.fail("Templates directory not found in @nextsparkjs/core");
       console.error(chalk17.red(`
@@ -4817,7 +4834,7 @@ async function syncAppCommand(options) {
     if (options.verbose) {
       console.log(chalk17.gray("  Files to sync:"));
       for (const file of filesToUpdate) {
-        const targetPath = join11(appDir, file);
+        const targetPath = join12(appDir, file);
         const status = existsSync11(targetPath) ? chalk17.yellow("update") : chalk17.green("create");
         console.log(chalk17.gray(`    ${status} ${file}`));
       }
@@ -4854,7 +4871,7 @@ async function syncAppCommand(options) {
       }
     }
     if (options.backup && !options.dryRun) {
-      const backupDir = join11(projectRoot, `app.backup.v${coreVersion}.${Date.now()}`);
+      const backupDir = join12(projectRoot, `app.backup.v${coreVersion}.${Date.now()}`);
       spinner.start("Creating backup...");
       backupDirectory(appDir, backupDir);
       spinner.succeed(`Backup created: ${relative(projectRoot, backupDir)}`);
@@ -4864,8 +4881,8 @@ async function syncAppCommand(options) {
       let updated = 0;
       let created = 0;
       for (const file of filesToUpdate) {
-        const sourcePath = join11(templatesDir, file);
-        const targetPath = join11(appDir, file);
+        const sourcePath = join12(templatesDir, file);
+        const targetPath = join12(appDir, file);
         const isNew = !existsSync11(targetPath);
         copyFile(sourcePath, targetPath);
         if (isNew) {
@@ -4878,12 +4895,12 @@ async function syncAppCommand(options) {
         }
       }
       spinner.succeed(`Synced ${filesToUpdate.length} files (${updated} updated, ${created} created)`);
-      const rootTemplatesDir = join11(coreDir, "templates");
+      const rootTemplatesDir = join12(coreDir, "templates");
       let rootUpdated = 0;
       let rootCreated = 0;
       for (const file of ROOT_TEMPLATE_FILES) {
-        const sourcePath = join11(rootTemplatesDir, file);
-        const targetPath = join11(projectRoot, file);
+        const sourcePath = join12(rootTemplatesDir, file);
+        const targetPath = join12(projectRoot, file);
         if (existsSync11(sourcePath)) {
           const isNew = !existsSync11(targetPath);
           copyFile(sourcePath, targetPath);
@@ -4935,20 +4952,10 @@ ${error.stack}
 
 // src/commands/setup-ai.ts
 import { existsSync as existsSync12 } from "fs";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { execSync as execSync3 } from "child_process";
 import chalk18 from "chalk";
 import ora12 from "ora";
-function resolveAIWorkflowPath() {
-  const cwd = process.cwd();
-  const nmPath = join12(cwd, "node_modules", "@nextsparkjs", "ai-workflow");
-  if (existsSync12(nmPath)) return nmPath;
-  const webNmPath = join12(cwd, "web", "node_modules", "@nextsparkjs", "ai-workflow");
-  if (existsSync12(webNmPath)) return webNmPath;
-  const monoPath = join12(cwd, "packages", "ai-workflow");
-  if (existsSync12(monoPath)) return monoPath;
-  return null;
-}
 var VALID_EDITORS = ["claude", "cursor", "antigravity", "all"];
 async function setupAICommand(options) {
   const editor = options.editor || "claude";
@@ -4961,7 +4968,7 @@ async function setupAICommand(options) {
   console.log(chalk18.cyan("  AI Workflow Setup"));
   console.log(chalk18.gray("  " + "-".repeat(40)));
   console.log("");
-  const pkgPath = resolveAIWorkflowPath();
+  const pkgPath = getAIWorkflowDir();
   if (!pkgPath) {
     console.log(chalk18.red("  @nextsparkjs/ai-workflow package not found."));
     console.log("");
@@ -4970,7 +4977,7 @@ async function setupAICommand(options) {
     console.log("");
     process.exit(1);
   }
-  const setupScript = join12(pkgPath, "scripts", "setup.mjs");
+  const setupScript = join13(pkgPath, "scripts", "setup.mjs");
   if (!existsSync12(setupScript)) {
     console.log(chalk18.red("  Setup script not found in ai-workflow package."));
     console.log(chalk18.gray(`  Expected: ${setupScript}`));
@@ -4996,6 +5003,88 @@ async function setupAICommand(options) {
   }
 }
 
+// src/commands/sync-ai.ts
+import { existsSync as existsSync13 } from "fs";
+import { join as join14 } from "path";
+import { execSync as execSync4 } from "child_process";
+import chalk19 from "chalk";
+import ora13 from "ora";
+var VALID_EDITORS2 = ["claude", "cursor", "antigravity", "all"];
+async function syncAICommand(options) {
+  const editor = options.editor || "claude";
+  if (!VALID_EDITORS2.includes(editor)) {
+    console.log(chalk19.red(`  Unknown editor: ${editor}`));
+    console.log(chalk19.gray(`  Available: ${VALID_EDITORS2.join(", ")}`));
+    process.exit(1);
+  }
+  console.log("");
+  console.log(chalk19.cyan("  AI Workflow Sync"));
+  console.log(chalk19.gray("  " + "-".repeat(40)));
+  console.log("");
+  const editorDir = editor === "cursor" ? ".cursor" : ".claude";
+  const editorDirPath = join14(process.cwd(), editorDir);
+  if (!existsSync13(editorDirPath)) {
+    console.log(chalk19.red(`  No ${editorDir}/ directory found.`));
+    console.log("");
+    console.log(chalk19.gray("  AI workflow must be set up first. Run:"));
+    console.log(chalk19.cyan("    nextspark setup:ai --editor " + editor));
+    console.log("");
+    process.exit(1);
+  }
+  const pkgPath = getAIWorkflowDir();
+  if (!pkgPath) {
+    console.log(chalk19.red("  @nextsparkjs/ai-workflow package not found."));
+    console.log("");
+    console.log(chalk19.gray("  Install it first:"));
+    console.log(chalk19.cyan("    pnpm add -D -w @nextsparkjs/ai-workflow"));
+    console.log("");
+    process.exit(1);
+  }
+  const setupScript = join14(pkgPath, "scripts", "setup.mjs");
+  if (!existsSync13(setupScript)) {
+    console.log(chalk19.red("  Setup script not found in ai-workflow package."));
+    console.log(chalk19.gray(`  Expected: ${setupScript}`));
+    process.exit(1);
+  }
+  if (!options.force) {
+    console.log(chalk19.yellow("  This will sync AI workflow files from @nextsparkjs/ai-workflow."));
+    console.log(chalk19.gray("  Framework files will be overwritten. Custom files will be preserved."));
+    console.log(chalk19.gray("  Config JSON files will never be overwritten.\n"));
+    try {
+      const { confirm: confirm6 } = await import("@inquirer/prompts");
+      const confirmed = await confirm6({
+        message: "Proceed with sync?",
+        default: true
+      });
+      if (!confirmed) {
+        console.log(chalk19.yellow("\n  Sync cancelled.\n"));
+        process.exit(0);
+      }
+    } catch {
+      console.error(chalk19.red("\n  Failed to load confirmation prompt. Use --force to skip.\n"));
+      process.exit(1);
+    }
+  }
+  const spinner = ora13({
+    text: `Syncing AI workflow for ${editor}...`,
+    prefixText: "  "
+  }).start();
+  try {
+    spinner.stop();
+    execSync4(`node "${setupScript}" ${editor}`, {
+      cwd: process.cwd(),
+      stdio: "inherit"
+    });
+  } catch (error) {
+    console.log("");
+    console.log(chalk19.red("  AI workflow sync failed."));
+    if (error instanceof Error) {
+      console.log(chalk19.gray(`  ${error.message}`));
+    }
+    process.exit(1);
+  }
+}
+
 // src/cli.ts
 config();
 var pkg = JSON.parse(readFileSync11(new URL("../package.json", import.meta.url), "utf-8"));
@@ -5021,8 +5110,9 @@ program.command("db:migrate").description("Run database migrations (alias)").act
 program.command("db:seed").description("Seed database with sample data (alias)").action(dbSeedCommand);
 program.command("sync:app").description("Sync /app folder with @nextsparkjs/core templates").option("--dry-run", "Preview changes without applying").option("-f, --force", "Skip confirmation prompt").option("--backup", "Backup existing files before overwriting").option("-v, --verbose", "Show detailed file operations").action(syncAppCommand);
 program.command("setup:ai").description("Setup AI workflow for your editor (Claude Code, Cursor, Antigravity)").option("-e, --editor <editor>", "Editor to setup (claude, cursor, antigravity, all)", "claude").action(setupAICommand);
+program.command("sync:ai").description("Sync AI workflow files from @nextsparkjs/ai-workflow").option("-e, --editor <editor>", "Editor to sync (claude, cursor, antigravity, all)", "claude").option("-f, --force", "Skip confirmation prompt").action(syncAICommand);
 program.showHelpAfterError();
 program.configureOutput({
-  writeErr: (str) => process.stderr.write(chalk19.red(str))
+  writeErr: (str) => process.stderr.write(chalk20.red(str))
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/cli",
-  "version": "0.1.0-beta.87",
+  "version": "0.1.0-beta.89",
   "description": "NextSpark CLI - Complete development toolkit",
   "type": "module",
   "bin": {