@atlashub/smartstack-cli 3.21.0 → 3.22.0

package/dist/mcp-entry.mjs

@@ -57047,13 +57047,40 @@ async function scaffoldRoutes(input, config2) {
     result.instructions.push("");
     result.instructions.push("## App.tsx Wiring Instructions");
     result.instructions.push("");
-    result.instructions.push("Import page components and add routes INSIDE the appropriate Layout wrapper in App.tsx.");
-    result.instructions.push("Routes must be added in BOTH the standard block and the tenant-prefixed block (/t/:slug/...).");
+    result.instructions.push("**Detect App.tsx pattern first**, then follow the matching instructions:");
     result.instructions.push("");
     const routeTree = buildRouteTree(navRoutes);
+    result.instructions.push("### Pattern A: mergeRoutes (if App.tsx uses `contextRoutes: ContextRouteExtensions`)");
+    result.instructions.push("");
+    result.instructions.push("Add routes to `contextRoutes.{context}[]` with **RELATIVE** paths (no leading `/`):");
+    result.instructions.push("");
+    result.instructions.push("```tsx");
+    result.instructions.push("const contextRoutes: ContextRouteExtensions = {");
+    for (const [context, applications] of Object.entries(routeTree)) {
+      result.instructions.push(`  ${context}: [`);
+      for (const [, modules] of Object.entries(applications)) {
+        for (const route of modules) {
+          const modulePath = route.navRoute.split(".").slice(1).join("/");
+          const pageEntry = pageFiles.get(route.navRoute);
+          const component = pageEntry?.[0]?.componentName || `${route.navRoute.split(".").map(capitalize).join("")}Page`;
+          result.instructions.push(`    { path: '${modulePath}', element: <${component} /> },`);
+        }
+      }
+      result.instructions.push("  ],");
+    }
+    result.instructions.push("};");
+    result.instructions.push("```");
+    result.instructions.push("");
+    result.instructions.push("Routes are automatically injected into BOTH standard and tenant-prefixed trees by `mergeRoutes()`.");
+    result.instructions.push("**DO NOT** add business/platform/personal routes to `clientRoutes[]` \u2014 that array is only for routes outside SmartStack contexts.");
+    result.instructions.push("");
+    result.instructions.push('### Pattern B: JSX Routes (if App.tsx uses `<Route path="/{context}" element={<{Layout} />}>`)');
+    result.instructions.push("");
+    result.instructions.push("Insert `<Route>` children INSIDE the appropriate Layout wrapper:");
+    result.instructions.push("");
     for (const [context, applications] of Object.entries(routeTree)) {
       const layoutName = getLayoutName(context);
-      result.instructions.push(`### ${capitalize(context)} context (inside <Route path="/${context}" element={<${layoutName} />}>):`);
+      result.instructions.push(`#### ${capitalize(context)} context (inside \`<Route path="/${context}" element={<${layoutName} />}>\`):`);
       result.instructions.push("");
       result.instructions.push("```tsx");
       for (const [, modules] of Object.entries(applications)) {
@@ -57547,6 +57574,7 @@ function generateClientRoutesConfig(routes, pageFiles, includeGuards) {
     " */",
     "",
     "import type { RouteObject } from 'react-router-dom';",
+    "import type { ContextRouteExtensions } from '@atlashub/smartstack';",
     "import { Navigate } from 'react-router-dom';"
   ];
   if (includeGuards) {
@@ -57648,6 +57676,24 @@ function generateClientRoutesConfig(routes, pageFiles, includeGuards) {
   }
   lines.push("};");
   lines.push("");
+  lines.push("/**");
+  lines.push(" * Context route extensions for mergeRoutes() pattern.");
+  lines.push(" * Import and spread into your App.tsx contextRoutes:");
+  lines.push(" *");
+  lines.push(" * ```tsx");
+  lines.push(" * import { contextRouteExtensions } from './routes/clientRoutes.generated';");
+  lines.push(" * const contextRoutes: ContextRouteExtensions = {");
+  lines.push(" *   ...contextRouteExtensions,");
+  lines.push(" *   // your additional routes...");
+  lines.push(" * };");
+  lines.push(" * ```");
+  lines.push(" */");
+  lines.push("export const contextRouteExtensions: ContextRouteExtensions = {");
+  for (const context of contexts) {
+    lines.push(`  ${context}: ${context}Routes,`);
+  }
+  lines.push("};");
+  lines.push("");
   return lines.join("\n");
 }
 function getLayoutName(context) {
@@ -58028,6 +58074,25 @@ async function validateAppWiring(webPath, backendRoutes, result) {
     result.appWiring.issues.push("App.tsx does not import any route configuration");
     return;
   }
+  const caseMismatches = [];
+  for (const route of backendRoutes) {
+    const modulePath = route.webPath.replace(/^\//, "");
+    if (modulePath !== modulePath.toLowerCase()) {
+      const kebabPath = modulePath.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+      caseMismatches.push(
+        `Route "${route.navRoute}" uses PascalCase in URL. Found: ${modulePath} \u2192 Expected: ${kebabPath}`
+      );
+    }
+  }
+  if (caseMismatches.length > 0) {
+    result.appWiring.issues.push(
+      `Case mismatch detected (${caseMismatches.length} routes with uppercase):`
+    );
+    result.appWiring.issues.push(...caseMismatches);
+    result.appWiring.issues.push(
+      "Fix: Use ToKebabCase() in NavigationSeedData route generation (see core-seed-data.md)"
+    );
+  }
   for (const route of backendRoutes) {
     const modulePath = route.navRoute.split(".").slice(1).join("/");
     const lastSegment = route.navRoute.split(".").pop() || "";