@atlashub/smartstack-cli 3.38.0 → 3.39.0

package/dist/mcp-entry.mjs

@@ -27185,13 +27185,13 @@ async function validateControllerRoutes(structure, _config, result) {
       if (navRouteMatch) {
         const routePath = navRouteMatch[1];
         const parts = routePath.split(".");
-        if (parts.length < 2) {
-          result.warnings.push({
-            type: "warning",
+        if (parts.length < 3) {
+          result.errors.push({
+            type: "error",
             category: "controllers",
             message: `Controller "${fileName}" has NavRoute with insufficient depth: "${routePath}"`,
             file: path8.relative(structure.root, file),
-            suggestion: 'NavRoute should have at least 2 levels: "application.module" (e.g., "administration.users")'
+            suggestion: 'NavRoute must have at least 3 levels: "application.module.section" (e.g., "administration.users.management")'
           });
         }
         const hasUppercase = parts.some((part) => part !== part.toLowerCase());
@@ -27222,7 +27222,7 @@ async function validateControllerRoutes(structure, _config, result) {
         category: "controllers",
         message: `Controller "${fileName}" uses hardcoded Route instead of NavRoute`,
         file: path8.relative(structure.root, file),
-        suggestion: 'Use [NavRoute("application.module")] for navigation-based routing'
+        suggestion: 'Use [NavRoute("application.module.section")] for navigation-based routing'
       });
     }
   }
@@ -34423,21 +34423,24 @@ var require_lib = __commonJS({
 import path10 from "path";
 function resolveHierarchy(navRoute) {
   if (!navRoute) {
-    return { application: "", module: "", domainPath: "", infraPath: "", controllerArea: "" };
+    return { application: "", module: "", section: "", domainPath: "", infraPath: "", controllerArea: "" };
   }
   const segments = navRoute.split(".");
   const toPascal = (s) => s.split("-").map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
   const application = segments[0] ? toPascal(segments[0]) : "";
   const module = segments[1] ? toPascal(segments[1]) : "";
+  const section = segments[2] ? toPascal(segments[2]) : "";
   let domainPath = "";
-  if (segments.length >= 2) {
+  if (segments.length >= 3) {
+    domainPath = path10.join(application, module, section);
+  } else if (segments.length >= 2) {
     domainPath = path10.join(application, module);
   } else if (segments.length === 1) {
     domainPath = application;
   }
   const infraPath = domainPath;
   const controllerArea = application;
-  return { application, module, domainPath, infraPath, controllerArea };
+  return { application, module, section, domainPath, infraPath, controllerArea };
 }
 async function handleScaffoldExtension(args, config2) {
   const input = ScaffoldExtensionInputSchema.parse(args);
@@ -35401,12 +35404,12 @@ public class {{name}}Controller : ControllerBase
     result.instructions.push("");
     result.instructions.push("NavRoute resolves API routes from Navigation entities in the database.");
     result.instructions.push("Ensure the navigation path exists (seed data required):");
-    result.instructions.push(`  Application > Module matching "${navRoute}"`);
+    result.instructions.push(`  Application > Module > Section matching "${navRoute}"`);
   } else {
     result.instructions.push("Controller created with traditional routing.");
     result.instructions.push("");
     result.instructions.push("\u26A0\uFE0F  Consider using NavRoute for navigation-based routing:");
-    result.instructions.push(`  [NavRoute("application.module")]`);
+    result.instructions.push(`  [NavRoute("application.module.section")]`);
     result.instructions.push("");
     result.instructions.push("API endpoints (with traditional routing):");
     result.instructions.push(`  GET    /api/${name.toLowerCase()}`);
@@ -36470,7 +36473,7 @@ var init_scaffold_extension = __esm({
               },
               navRoute: {
                 type: "string",
-                description: 'Navigation route path for controller (e.g., "administration.users"). Required for controllers.'
+                description: 'Navigation route path for controller (e.g., "administration.users.management"). Minimum 3 levels: application.module.section. Optional 4th: resource.'
               },
               navRouteSuffix: {
                 type: "string",
@@ -53017,8 +53020,8 @@ function generatePermissionsForNavRoute(navRoute, customActions, includeStandard
   const permissions = [];
   const parts = navRoute.split(".");
   const application = parts[0];
-  if (parts.length < 2) {
-    throw new Error(`Invalid NavRoute format: ${navRoute}. Expected format: application.module`);
+  if (parts.length < 3) {
+    throw new Error(`Invalid NavRoute format: ${navRoute}. Expected format: application.module.section (minimum 3 levels, optional 4th: resource)`);
   }
   if (includeWildcard) {
     permissions.push({
@@ -53128,9 +53131,20 @@ function formatPermissionDescription(navRoute, action) {
   const parts = navRoute.split(".");
   const application = parts[0];
   const module = parts[1];
-  const applicationName = application.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-  const moduleName = module.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const section = parts[2];
+  const toTitleCase = (s) => s.split(/[-_]/).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const applicationName = toTitleCase(application);
+  const moduleName = toTitleCase(module);
   const actionVerb = getActionVerb(action);
+  if (parts.length >= 4) {
+    const sectionName = toTitleCase(section);
+    const resourceName = toTitleCase(parts[parts.length - 1]);
+    return `${actionVerb} ${resourceName} in ${applicationName} > ${moduleName} > ${sectionName}`;
+  }
+  if (section) {
+    const sectionName = toTitleCase(section);
+    return `${actionVerb} ${sectionName} in ${applicationName} > ${moduleName}`;
+  }
   return `${actionVerb} ${moduleName} in ${applicationName}`;
 }
 function getActionVerb(action) {
@@ -53186,12 +53200,27 @@ function getUniqueNavRouteCount(permissions) {
 }
 function generateHasDataCode(permissions, navRoute) {
   const parts = navRoute.split(".");
-  const moduleName = parts.length >= 2 ? parts[parts.length - 1] : "custom";
-  const moduleVarName = `${moduleName}ModuleId`;
+  const lastSegment = parts[parts.length - 1];
+  const depth = parts.length;
+  let permissionLevel;
+  let fkProperty;
+  let fkVarName;
+  let seedDataSource;
+  if (depth >= 4) {
+    permissionLevel = "PermissionLevel.Resource";
+    fkProperty = "ResourceId";
+    fkVarName = `${lastSegment}ResourceId`;
+    seedDataSource = "NavigationResourceSeedData.cs";
+  } else {
+    permissionLevel = "PermissionLevel.Section";
+    fkProperty = "SectionId";
+    fkVarName = `${lastSegment}SectionId`;
+    seedDataSource = "NavigationSectionSeedData.cs";
+  }
   let code = "```csharp\n";
-  code += `// 1. Add module ID variable (get from NavigationModuleSeedData.cs)
+  code += `// 1. Add ${fkProperty} variable (get from ${seedDataSource})
 `;
-  code += `var ${moduleVarName} = Guid.Parse("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"); // TODO: Replace with actual ID
+  code += `var ${fkVarName} = Guid.Parse("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"); // TODO: Replace with actual ID
 
 `;
   code += `// 2. Add these entries to the HasData() return array:
@@ -53201,11 +53230,11 @@ function generateHasDataCode(permissions, navRoute) {
     const action = perm.code.split(".").pop();
     const guidPlaceholder = generatePlaceholderGuid();
     if (isWildcard) {
-      code += `new { Id = Guid.Parse("${guidPlaceholder}"), Path = "${perm.code}", Level = PermissionLevel.Module, IsWildcard = true, ModuleId = ${moduleVarName}, Description = "${perm.description}", CreatedAt = seedDate },
+      code += `new { Id = Guid.Parse("${guidPlaceholder}"), Path = "${perm.code}", Level = ${permissionLevel}, IsWildcard = true, ${fkProperty} = ${fkVarName}, Description = "${perm.description}", CreatedAt = seedDate },
 `;
     } else {
       const actionEnum = getActionEnum(action || "read");
-      code += `new { Id = Guid.Parse("${guidPlaceholder}"), Path = "${perm.code}", Level = PermissionLevel.Module, Action = PermissionAction.${actionEnum}, IsWildcard = false, ModuleId = ${moduleVarName}, Description = "${perm.description}", CreatedAt = seedDate },
+      code += `new { Id = Guid.Parse("${guidPlaceholder}"), Path = "${perm.code}", Level = ${permissionLevel}, Action = PermissionAction.${actionEnum}, IsWildcard = false, ${fkProperty} = ${fkVarName}, Description = "${perm.description}", CreatedAt = seedDate },
 `;
     }
   }
@@ -58120,13 +58149,8 @@ function generateClientRoutesConfig(routes, pageFiles, includeGuards) {
   lines.push("");
   return lines.join("\n");
 }
-function getLayoutName(application) {
-  const layoutMap = {
-    administration: "AdminLayout",
-    support: "SupportLayout",
-    myspace: "UserLayout"
-  };
-  return layoutMap[application] || `${capitalize(application)}Layout`;
+function getLayoutName(_application) {
+  return "AppLayout";
 }
 function toKebabCase(segment) {
   return segment.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
@@ -58190,7 +58214,7 @@ Creates:
 Example:
   scaffold_routes source="controllers" scope="all"
 
-Scans backend controllers for [NavRoute("application.module")] attributes
+Scans backend controllers for [NavRoute("application.module.section")] attributes
 and generates corresponding frontend routing infrastructure.`,
       inputSchema: {
         type: "object",
@@ -60803,7 +60827,7 @@ async function checkAuthorization(structure, result) {
           message: `Controller ${controllerName} missing authorization attribute`,
           file: path23.relative(structure.root, file),
           line: lineNumber,
-          suggestion: 'Add [NavRoute("application.module")] or [Authorize] attribute to the controller class',
+          suggestion: 'Add [NavRoute("application.module.section")] or [Authorize] attribute to the controller class',
           cweId: "CWE-862"
         });
       }
@@ -64710,7 +64734,7 @@ Tables are organized by domain using prefixes:
 | Prefix | Domain | Example Tables |
 |--------|--------|----------------|
 | \`auth_\` | Authorization | auth_Users, auth_Roles, auth_Permissions |
-| \`nav_\` | Navigation | nav_Applications, nav_Modules, nav_Sections |
+| \`nav_\` | Navigation | nav_Applications, nav_Modules, nav_Sections, nav_Resources |
 | \`usr_\` | User profiles | usr_Profiles, usr_Preferences |
 | \`ai_\` | AI features | ai_Providers, ai_Models, ai_Prompts |
 | \`cfg_\` | Configuration | cfg_Settings |
@@ -64744,7 +64768,7 @@ In addition to the platform prefixes above, client applications define their own
 
 ### Navigation Scope System
 
-All navigation data (Application, Module, Section) uses a **Scope** field to distinguish system data from client extensions:
+All navigation data (Application, Module, Section, Resource) uses a **Scope** field to distinguish system data from client extensions:
 
 | Scope | Usage | Description | Example Code |
 |-------|-------|-------------|--------------|
@@ -64753,10 +64777,10 @@ All navigation data (Application, Module, Section) uses a **Scope** field to dis
 | \`${scopeTypes[2]}\` | Partner modules | Provided by certified partners | \`partner_integration\` |
 | \`${scopeTypes[3]}\` | Community modules | Open-source community contributions | \`community_tool\` |
 
-**Navigation Hierarchy (3 levels):**
+**Navigation Hierarchy (4 levels):**
 
 \`\`\`
-Application \u2192 Module \u2192 Section
+Application \u2192 Module \u2192 Section \u2192 Resource (optional)
 \`\`\`
 
 **Examples for each level:**
@@ -64764,8 +64788,9 @@ Application \u2192 Module \u2192 Section
 | Level | Core Example | Extension Example |
 |-------|--------------|-------------------|
 | Application | Code: \`administration\`<br/>Scope: \`${scopeTypes[0]}\` | Code: \`custom_app\`<br/>Scope: \`${scopeTypes[1]}\` |
-| Module | Code: \`users\`<br/>Route: \`administration.users\`<br/>Scope: \`${scopeTypes[0]}\` | Code: \`inventory\`<br/>Route: \`operations.inventory\`<br/>Scope: \`${scopeTypes[1]}\` |
+| Module | Code: \`users\`<br/>Route: \`administration.users.management\`<br/>Scope: \`${scopeTypes[0]}\` | Code: \`inventory\`<br/>Route: \`operations.inventory.list\`<br/>Scope: \`${scopeTypes[1]}\` |
 | Section | Code: \`management\`<br/>Scope: \`${scopeTypes[0]}\` | Code: \`reports\`<br/>Scope: \`${scopeTypes[1]}\` |
+| Resource (optional) | Code: \`dashboard\`<br/>Scope: \`${scopeTypes[0]}\` | Code: \`analytics\`<br/>Scope: \`${scopeTypes[1]}\` |
 
 **Rules:**
 1. \`${scopeTypes[0]}\` modules are **protected** - clients cannot create or modify them
@@ -65583,7 +65608,7 @@ All tenant-related tables use the \`tenant_\` prefix:
 
 ### Layout Standards
 
-All application layouts MUST follow the AdminLayout pattern for consistent user experience.
+All applications use the unified AppLayout for consistent user experience.
 
 #### Standard Structure
 
@@ -65725,7 +65750,7 @@ import { Breadcrumb } from '@/components/ui/Breadcrumb';
 #### Hierarchy Pattern
 
 \`\`\`
-Application > Module > [Section] > [Entity Name]
+Application > Module > [Section] > [Resource] > [Entity Name]
 \`\`\`
 
 **Examples:**