@atlashub/smartstack-cli 4.31.0 → 4.33.0

package/dist/mcp-entry.mjs

@@ -25984,6 +25984,7 @@ var init_types3 = __esm({
         entityProperties: external_exports.array(EntityPropertySchema).optional().describe("Entity properties for DTO/Validator generation"),
         navRoute: external_exports.string().optional().describe('Navigation route path for controller (e.g., "administration.users"). Required for controllers.'),
         navRouteSuffix: external_exports.string().optional().describe('Optional suffix for NavRoute (e.g., "dashboard" for sub-resources)'),
+        customSegment: external_exports.string().optional().describe('Optional custom URL segment for NavRoute (e.g., "user/dashboard")'),
         withHierarchyFunction: external_exports.boolean().optional().describe("For entity type with self-reference (ParentId): generate TVF SQL script for hierarchy traversal"),
         hierarchyDirection: external_exports.enum(["ancestors", "descendants", "both"]).optional().describe("Direction for hierarchy traversal function (default: both)"),
         isPersonRole: external_exports.boolean().optional().describe("If true, entity is a Person Extension linked to User via UserId FK"),
@@ -26101,7 +26102,7 @@ var init_types3 = __esm({
         includeLayouts: external_exports.boolean().default(true).describe("Generate layout components"),
         includeGuards: external_exports.boolean().default(true).describe("Include route guards for permissions"),
         generateRegistry: external_exports.boolean().default(true).describe("Generate navRoutes.generated.ts"),
-        outputFormat: external_exports.enum(["standalone", "applicationRoutes", "clientRoutes"]).default("applicationRoutes").describe('Output format: "standalone" generates createBrowserRouter(), "applicationRoutes" generates exportable RouteObject[] arrays for App.tsx integration (note: "clientRoutes" is a deprecated alias for "applicationRoutes")'),
+        outputFormat: external_exports.enum(["standalone", "applicationRoutes", "clientRoutes", "componentRegistry"]).default("componentRegistry").describe('Output format: "componentRegistry" (v3.7+) generates PageRegistry.register() calls for DynamicRouter. "applicationRoutes" (deprecated) generates RouteObject[] arrays for App.tsx. "standalone" generates createBrowserRouter(). "clientRoutes" is a deprecated alias for "applicationRoutes".'),
         dryRun: external_exports.boolean().default(false).describe("Preview without writing files")
       }).optional()
     });
@@ -27984,6 +27985,60 @@ async function validateFrontendRoutes(structure, _config, result) {
     return;
   }
   const appContent = await readText(appFiles[0]);
+  const registryFiles = await findFiles("**/componentRegistry.generated.ts", { cwd: structure.web });
+  const usesDynamicRouter = registryFiles.length > 0;
+  if (usesDynamicRouter) {
+    const registryContent = await readText(registryFiles[0]);
+    const registeredKeys = /* @__PURE__ */ new Set();
+    const registerMatches = registryContent.matchAll(/PageRegistry\.register\s*\(\s*['"]([^'"]+)['"]/g);
+    for (const match2 of registerMatches) {
+      registeredKeys.add(match2[1]);
+    }
+    const seedFiles2 = await findFiles("**/*NavigationSeedData.cs", { cwd: structure.root });
+    const seedNavRoutes2 = [];
+    for (const file of seedFiles2) {
+      const content = await readText(file);
+      const routeMatches = content.matchAll(/(?:route:\s*|Route\s*=\s*)["']([^"']+)["']/g);
+      for (const match2 of routeMatches) {
+        seedNavRoutes2.push({
+          route: match2[1],
+          file: path8.relative(structure.root, file)
+        });
+      }
+    }
+    const missingRoutes2 = [];
+    for (const nav of seedNavRoutes2) {
+      const segments = nav.route.split("/").filter(Boolean);
+      const componentKey = segments.join(".");
+      if (!registeredKeys.has(componentKey)) {
+        missingRoutes2.push(nav);
+      }
+    }
+    if (missingRoutes2.length > 0) {
+      for (const missing of missingRoutes2.slice(0, 5)) {
+        result.errors.push({
+          type: "error",
+          category: "frontend-routes",
+          message: `Navigation route "${missing.route}" from seed data has no PageRegistry.register() entry`,
+          file: path8.relative(structure.root, registryFiles[0]),
+          suggestion: `Run scaffold_routes (outputFormat: "componentRegistry") to regenerate (defined in ${missing.file})`
+        });
+      }
+      if (missingRoutes2.length > 5) {
+        result.errors.push({
+          type: "error",
+          category: "frontend-routes",
+          message: `... and ${missingRoutes2.length - 5} more seed data routes missing from componentRegistry`
+        });
+      }
+    }
+    result.warnings.push({
+      type: "warning",
+      category: "frontend-routes",
+      message: `Frontend routes summary (DynamicRouter): ${registeredKeys.size} registered keys, ${missingRoutes2.length} missing from componentRegistry`
+    });
+    return;
+  }
   const hasApplicationRoutes = appContent.includes("applicationRoutes") || appContent.includes("clientRoutes");
   const hasRouteComponents = /<Route\s/.test(appContent);
   if (!hasApplicationRoutes && !hasRouteComponents) {
@@ -34705,7 +34760,14 @@ function resolveHierarchy(navRoute) {
     domainPath = application;
   }
   const infraPath = domainPath;
-  const controllerArea = application;
+  let controllerArea = "";
+  if (segments.length >= 3) {
+    controllerArea = path10.join(application, module, section);
+  } else if (segments.length >= 2) {
+    controllerArea = path10.join(application, module);
+  } else if (segments.length === 1) {
+    controllerArea = application;
+  }
   return { application, module, section, domainPath, infraPath, controllerArea };
 }
 async function handleScaffoldExtension(args, config2) {
@@ -35635,88 +35697,117 @@ GO
 }
 async function scaffoldController(name, options, structure, config2, result, dryRun = false) {
   const hierarchy = resolveHierarchy(options?.navRoute);
-  const namespace = options?.namespace || (hierarchy.controllerArea ? `${config2.conventions.namespaces.api}.Controllers.${hierarchy.controllerArea}` : `${config2.conventions.namespaces.api}.Controllers`);
+  const namespaceArea = hierarchy.controllerArea.replace(/[\\/]/g, ".");
+  const namespace = options?.namespace || (namespaceArea ? `${config2.conventions.namespaces.api}.Controllers.${namespaceArea}` : `${config2.conventions.namespaces.api}.Controllers`);
   const navRoute = options?.navRoute;
   const navRouteSuffix = options?.navRouteSuffix;
-  const routeAttribute = navRoute ? navRouteSuffix ? `[NavRoute("${navRoute}", Suffix = "${navRouteSuffix}")]` : `[NavRoute("${navRoute}")]` : `[Route("api/[controller]")]`;
+  const customSegment = options?.customSegment;
+  const navRouteParams = [];
+  if (navRoute) {
+    navRouteParams.push(`"${navRoute}"`);
+    if (navRouteSuffix) navRouteParams.push(`Suffix = "${navRouteSuffix}"`);
+    if (customSegment) navRouteParams.push(`CustomSegment = "${customSegment}"`);
+  }
+  const routeAttribute = navRoute ? `[NavRoute(${navRouteParams.join(", ")})]` : `[Route("api/[controller]")]`;
   const navRouteUsing = navRoute ? "using SmartStack.Api.Routing;\n" : "";
-  const controllerTemplate = `using Microsoft.AspNetCore.Authorization;
+  const controllerTemplate = `using MediatR;
 using Microsoft.AspNetCore.Mvc;
-using Microsoft.Extensions.Logging;
-${navRouteUsing}
+using SmartStack.Api.Authorization;
+${navRouteUsing}using SmartStack.Application.Common.Authorization;
+
 namespace {{namespace}};
 
 /// <summary>
 /// API controller for {{name}} operations.
-/// IMPORTANT: Use [RequirePermission] on each endpoint for RBAC enforcement.
 /// </summary>
 [ApiController]
 {{routeAttribute}}
-[Authorize]
+[Microsoft.AspNetCore.Authorization.Authorize]
+[Produces("application/json")]
+[Tags("{{namePlural}}")]
 public class {{name}}Controller : ControllerBase
 {
-    private readonly I{{name}}Service _service;
-    private readonly ILogger<{{name}}Controller> _logger;
+    private readonly ISender _mediator;
 
-    public {{name}}Controller(I{{name}}Service service, ILogger<{{name}}Controller> logger)
-    {
-        _service = service;
-        _logger = logger;
-    }
+    public {{name}}Controller(ISender mediator) => _mediator = mediator;
 
     /// <summary>
     /// Get all {{nameLower}}s
     /// </summary>
     [HttpGet]
-    // TODO: Add [RequirePermission(Permissions.{Module}.Read)] for RBAC
-    public async Task<ActionResult<IEnumerable<object>>> GetAll(CancellationToken ct)
+    [RequirePermission(Permissions.{{module}}.{{namePlural}}.View)]
+    [ProducesResponseType(typeof(List<{{name}}ListDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    public async Task<ActionResult<List<{{name}}ListDto>>> GetAll(CancellationToken ct)
     {
-        // TODO: Call _service.GetAllAsync(ct)
-        return Ok(Array.Empty<object>());
+        var result = await _mediator.Send(new Get{{namePlural}}Query(), ct);
+        return Ok(result);
     }
 
     /// <summary>
     /// Get {{nameLower}} by ID
     /// </summary>
     [HttpGet("{id:guid}")]
-    // TODO: Add [RequirePermission(Permissions.{Module}.Read)] for RBAC
-    public async Task<ActionResult<object>> GetById(Guid id, CancellationToken ct)
+    [RequirePermission(Permissions.{{module}}.{{namePlural}}.View)]
+    [ProducesResponseType(typeof({{name}}DetailDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    public async Task<ActionResult<{{name}}DetailDto>> GetById(Guid id, CancellationToken ct)
     {
-        // TODO: Call _service.GetByIdAsync(id, ct)
-        return NotFound();
+        var result = await _mediator.Send(new Get{{name}}ByIdQuery(id), ct);
+        if (result == null) return NotFound(new { message = "{{name}} not found" });
+        return Ok(result);
     }
 
     /// <summary>
     /// Create new {{nameLower}}
     /// </summary>
     [HttpPost]
-    // TODO: Add [RequirePermission(Permissions.{Module}.Create)] for RBAC
-    public async Task<ActionResult<object>> Create([FromBody] object request, CancellationToken ct)
+    [RequirePermission(Permissions.{{module}}.{{namePlural}}.Create)]
+    [ProducesResponseType(typeof({{name}}DetailDto), StatusCodes.Status201Created)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    public async Task<ActionResult<{{name}}DetailDto>> Create(
+        [FromBody] Create{{name}}Request request, CancellationToken ct)
     {
-        // TODO: Call _service.CreateAsync(dto, ct)
-        return CreatedAtAction(nameof(GetById), new { id = Guid.NewGuid() }, null);
+        var result = await _mediator.Send(new Create{{name}}Command(request), ct);
+        return CreatedAtAction(nameof(GetById), new { id = result.Id }, result);
     }
 
     /// <summary>
     /// Update {{nameLower}}
     /// </summary>
     [HttpPut("{id:guid}")]
-    // TODO: Add [RequirePermission(Permissions.{Module}.Update)] for RBAC
-    public async Task<ActionResult> Update(Guid id, [FromBody] object request, CancellationToken ct)
+    [RequirePermission(Permissions.{{module}}.{{namePlural}}.Update)]
+    [ProducesResponseType(typeof({{name}}DetailDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    public async Task<ActionResult<{{name}}DetailDto>> Update(
+        Guid id, [FromBody] Update{{name}}Request request, CancellationToken ct)
     {
-        // TODO: Call _service.UpdateAsync(id, dto, ct)
-        return NoContent();
+        var result = await _mediator.Send(new Update{{name}}Command(id, request), ct);
+        if (result.IsNotFound) return NotFound(new { message = "{{name}} not found" });
+        return Ok(result.Data);
     }
 
     /// <summary>
     /// Delete {{nameLower}}
     /// </summary>
     [HttpDelete("{id:guid}")]
-    // TODO: Add [RequirePermission(Permissions.{Module}.Delete)] for RBAC
-    public async Task<ActionResult> Delete(Guid id, CancellationToken ct)
+    [RequirePermission(Permissions.{{module}}.{{namePlural}}.Delete)]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    public async Task<IActionResult> Delete(Guid id, CancellationToken ct)
     {
-        // TODO: Call _service.DeleteAsync(id, ct)
-        return NoContent();
+        var success = await _mediator.Send(new Delete{{name}}Command(id), ct);
+        return success ? NoContent() : NotFound(new { message = "{{name}} not found" });
     }
 }
 `;
@@ -35724,6 +35815,8 @@ public class {{name}}Controller : ControllerBase
     namespace,
     name,
     nameLower: name.charAt(0).toLowerCase() + name.slice(1),
+    namePlural: name + "s",
+    module: hierarchy.module || name,
     routeAttribute
   };
   const controllerContent = import_handlebars.default.compile(controllerTemplate)(context);
@@ -35739,7 +35832,7 @@ public class {{name}}Controller : ControllerBase
   result.files.push({ path: controllerFilePath, content: controllerContent, type: "created" });
   if (navRoute) {
     result.instructions.push("Controller created with NavRoute (route resolved from DB at startup).");
-    result.instructions.push(`NavRoute: ${navRoute}${navRouteSuffix ? ` (Suffix: ${navRouteSuffix})` : ""}`);
+    result.instructions.push(`NavRoute: ${navRoute}${navRouteSuffix ? ` (Suffix: ${navRouteSuffix})` : ""}${customSegment ? ` (CustomSegment: ${customSegment})` : ""}`);
     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):");
@@ -36818,6 +36911,10 @@ var init_scaffold_extension = __esm({
                 type: "string",
                 description: 'Optional suffix for NavRoute (e.g., "dashboard" for sub-resources)'
               },
+              customSegment: {
+                type: "string",
+                description: 'Optional custom URL segment for NavRoute (e.g., "user/dashboard")'
+              },
               withHierarchyFunction: {
                 type: "boolean",
                 description: "For entity type with self-reference (ParentId): generate TVF SQL script for hierarchy traversal"
@@ -57877,11 +57974,36 @@ async function scaffoldRoutes(input, config2) {
     }
     result.files.push({ path: registryFile, content: registryContent, type: "created" });
   }
-  const outputFormat = options?.outputFormat ?? "applicationRoutes";
+  const outputFormat = options?.outputFormat ?? "componentRegistry";
   if (outputFormat === "clientRoutes") {
     if (!result.warnings) result.warnings = [];
     result.warnings.push('outputFormat "clientRoutes" is DEPRECATED. Use "applicationRoutes" instead (same behavior, correct naming).');
   }
+  if (outputFormat === "applicationRoutes") {
+    if (!result.warnings) result.warnings = [];
+    result.warnings.push(
+      'outputFormat "applicationRoutes" is DEPRECATED (v3.7+). Use "componentRegistry" for PageRegistry + DynamicRouter pattern. See: DynamicRouter replaces manual App.tsx wiring.'
+    );
+  }
+  if (outputFormat === "componentRegistry") {
+    const pageFiles = await discoverPageFiles(webPath, navRoutes);
+    const registryContent = generateComponentRegistry(navRoutes, pageFiles, webPath);
+    const registryFile = path19.join(
+      options?.outputPath || path19.join(webPath, "src", "extensions"),
+      "componentRegistry.generated.ts"
+    );
+    if (!dryRun) {
+      await ensureDirectory(path19.dirname(registryFile));
+      await writeText(registryFile, registryContent);
+    }
+    result.files.push({ path: registryFile, content: registryContent, type: "created" });
+    result.instructions.push(`Generated PageRegistry.register() calls for ${navRoutes.length} NavRoutes`);
+    result.instructions.push("");
+    result.instructions.push("## Setup (one-time)");
+    result.instructions.push("1. Ensure `main.tsx` imports `./extensions/componentRegistry.generated`");
+    result.instructions.push("2. Ensure navigation seed data has matching `componentKey` values");
+    result.instructions.push("3. DynamicRouter resolves routes automatically \u2014 no App.tsx wiring needed");
+  }
   if (outputFormat === "applicationRoutes" || outputFormat === "clientRoutes") {
     const pageFiles = await discoverPageFiles(webPath, navRoutes);
     const applicationRoutesContent = generateApplicationRoutesConfig(navRoutes, pageFiles, includeGuards);
@@ -58646,6 +58768,41 @@ function generateApplicationRoutesConfig(routes, pageFiles, includeGuards) {
   lines.push("");
   return lines.join("\n");
 }
+function generateComponentRegistry(navRoutes, pageFiles, _webPath) {
+  const lines = [];
+  lines.push("/**");
+  lines.push(" * Auto-generated by MCP scaffold_routes \u2014 DO NOT EDIT");
+  lines.push(" * Registers all SmartStack pages into PageRegistry for DynamicRouter resolution.");
+  lines.push(" */");
+  lines.push("import { lazy } from 'react';");
+  lines.push("import { PageRegistry } from '@/extensions/PageRegistry';");
+  lines.push("");
+  const routeTree = buildRouteTree(navRoutes);
+  for (const [app, modules] of Object.entries(routeTree)) {
+    lines.push(`// === ${app} ===`);
+    for (const [, moduleRoutes] of Object.entries(modules)) {
+      for (const route of moduleRoutes) {
+        const discovery = pageFiles.get(route.navRoute);
+        if (!discovery) continue;
+        const componentKey = route.navRoute.split(".").map(toKebabCase).join(".");
+        if (discovery.list) {
+          lines.push(`PageRegistry.register('${componentKey}', lazy(() => import('${discovery.list.importPath}').then(m => ({ default: m.${discovery.list.componentName} }))));`);
+        }
+        if (discovery.detail) {
+          lines.push(`PageRegistry.register('${componentKey}.detail', lazy(() => import('${discovery.detail.importPath}').then(m => ({ default: m.${discovery.detail.componentName} }))));`);
+        }
+        if (discovery.create) {
+          lines.push(`PageRegistry.register('${componentKey}.create', lazy(() => import('${discovery.create.importPath}').then(m => ({ default: m.${discovery.create.componentName} }))));`);
+        }
+        if (discovery.edit) {
+          lines.push(`PageRegistry.register('${componentKey}.edit', lazy(() => import('${discovery.edit.importPath}').then(m => ({ default: m.${discovery.edit.componentName} }))));`);
+        }
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
 function getLayoutName(_application) {
   return "AppLayout";
 }
@@ -58754,7 +58911,7 @@ and generates corresponding frontend routing infrastructure.`,
               includeLayouts: { type: "boolean", default: true },
               includeGuards: { type: "boolean", default: true },
               generateRegistry: { type: "boolean", default: true },
-              outputFormat: { type: "string", enum: ["standalone", "applicationRoutes", "clientRoutes"], default: "applicationRoutes", description: "standalone: createBrowserRouter(), applicationRoutes: RouteObject[] arrays for App.tsx (clientRoutes is a deprecated alias)" },
+              outputFormat: { type: "string", enum: ["standalone", "applicationRoutes", "clientRoutes", "componentRegistry"], default: "componentRegistry", description: "componentRegistry (v3.7+): PageRegistry.register() calls for DynamicRouter. applicationRoutes (deprecated): RouteObject[] arrays for App.tsx. standalone: createBrowserRouter(). clientRoutes: deprecated alias for applicationRoutes." },
               dryRun: { type: "boolean", default: false }
             }
           }
@@ -58809,17 +58966,26 @@ async function validateFrontendRoutes2(input, config2) {
   if (scope === "all" || scope === "api-clients") {
     await validateApiClients(webPath, backendRoutes, result);
   }
-  if (scope === "all" || scope === "routes") {
+  const componentRegistryPath = path20.join(webPath, "src", "extensions", "componentRegistry.generated.ts");
+  const usesDynamicRouter = await fileExists(componentRegistryPath);
+  if ((scope === "all" || scope === "routes") && !usesDynamicRouter) {
     await validateRoutes(webPath, backendRoutes, result);
   }
-  if (scope === "all" || scope === "routes") {
+  if ((scope === "all" || scope === "routes") && !usesDynamicRouter) {
     await validateAppWiring(webPath, backendRoutes, result);
   }
-  if (scope === "all" || scope === "routes") {
+  if ((scope === "all" || scope === "routes") && !usesDynamicRouter) {
     await validateCrudRoutes(webPath, backendRoutes, result);
   }
+  if (scope === "all" || scope === "routes") {
+    await validateComponentRegistry(webPath, backendRoutes, result);
+  }
   generateRecommendations2(result);
-  result.valid = result.apiClients.issues.filter((i) => i.severity === "error").length === 0 && result.routes.missing.length === 0 && result.registry.exists && result.appWiring.issues.length === 0;
+  if (usesDynamicRouter) {
+    result.valid = result.apiClients.issues.filter((i) => i.severity === "error").length === 0 && result.registry.exists && (!result.componentRegistry || result.componentRegistry.missingKeys.length === 0);
+  } else {
+    result.valid = result.apiClients.issues.filter((i) => i.severity === "error").length === 0 && result.routes.missing.length === 0 && result.registry.exists && result.appWiring.issues.length === 0;
+  }
   return result;
 }
 async function discoverBackendNavRoutes(structure) {
@@ -59084,6 +59250,13 @@ async function validateAppWiring(webPath, backendRoutes, result) {
   const hasRoutesImport = appContent.includes("from './routes") || appContent.includes("from '../routes");
   const hasInlineRoutes = appContent.includes("<Route ");
   result.appWiring.routesImported = hasApplicationRoutesImport || hasRoutesImport || hasInlineRoutes;
+  const hasDynamicRouter = appContent.includes("DynamicRouter") || appContent.includes("<DynamicRouter");
+  const hasComponentRegistry = appContent.includes("componentRegistry.generated");
+  if (hasDynamicRouter || hasComponentRegistry) {
+    result.appWiring.routesImported = true;
+    result.appWiring.issues = [];
+    return;
+  }
   if (!result.appWiring.routesImported) {
     result.appWiring.issues.push("App.tsx does not import any route configuration");
     return;
@@ -59163,6 +59336,39 @@ async function validateCrudRoutes(webPath, backendRoutes, result) {
     }
   }
 }
+async function validateComponentRegistry(webPath, backendRoutes, result) {
+  const registryPath = path20.join(webPath, "src", "extensions", "componentRegistry.generated.ts");
+  if (!await fileExists(registryPath)) {
+    result.componentRegistry = { exists: false, registeredKeys: [], missingKeys: [] };
+    result.recommendations.push('Run `scaffold_routes outputFormat="componentRegistry"` to generate componentRegistry.generated.ts');
+    return;
+  }
+  const content = await readText(registryPath);
+  const registerCalls = content.matchAll(/PageRegistry\.register\s*\(\s*['"]([^'"]+)['"]/g);
+  const registeredKeys = /* @__PURE__ */ new Set();
+  for (const match2 of registerCalls) {
+    registeredKeys.add(match2[1]);
+  }
+  const missingKeys = [];
+  for (const route of backendRoutes) {
+    const componentKey = route.navRoute.split(".").map(toKebabCase).join(".");
+    if (!registeredKeys.has(componentKey)) {
+      missingKeys.push(componentKey);
+    }
+  }
+  result.componentRegistry = {
+    exists: true,
+    registeredKeys: [...registeredKeys],
+    missingKeys
+  };
+  const mainPath = path20.join(webPath, "src", "main.tsx");
+  if (await fileExists(mainPath)) {
+    const mainContent = await readText(mainPath);
+    if (!mainContent.includes("componentRegistry.generated")) {
+      result.recommendations.push("main.tsx does not import componentRegistry.generated \u2014 pages will not be registered");
+    }
+  }
+}
 function generateRecommendations2(result) {
   if (!result.registry.exists) {
     result.recommendations.push('Run `scaffold_routes source="controllers"` to generate route registry');
@@ -59185,7 +59391,11 @@ function generateRecommendations2(result) {
   if (result.routes.orphaned.length > 0) {
     result.recommendations.push(`${result.routes.orphaned.length} frontend routes have no backend NavRoute`);
   }
-  if (result.appWiring && !result.appWiring.exists) {
+  if (result.componentRegistry && !result.componentRegistry.exists) {
+    result.recommendations.push('No componentRegistry.generated.ts found. Run `scaffold_routes outputFormat="componentRegistry"` to generate it.');
+  } else if (result.componentRegistry && result.componentRegistry.missingKeys.length > 0) {
+    result.recommendations.push(`${result.componentRegistry.missingKeys.length} backend routes missing from componentRegistry. Run \`scaffold_routes\` to regenerate.`);
+  } else if (result.appWiring && !result.appWiring.exists) {
     result.recommendations.push("No App.tsx found. Create App.tsx with route configuration.");
   } else if (result.appWiring && result.appWiring.issues.length > 0) {
     const unwired = result.appWiring.issues.filter((i) => i.includes("not wired")).length;
@@ -59278,6 +59488,23 @@ function formatResult6(result, _input) {
       lines.push("");
     }
   }
+  if (result.componentRegistry) {
+    lines.push("## Component Registry");
+    lines.push("");
+    lines.push(`| Check | Status |`);
+    lines.push(`|-------|--------|`);
+    lines.push(`| Registry Exists | ${result.componentRegistry.exists ? "Yes" : "No"} |`);
+    lines.push(`| Registered Keys | ${result.componentRegistry.registeredKeys.length} |`);
+    lines.push(`| Missing Keys | ${result.componentRegistry.missingKeys.length} |`);
+    lines.push("");
+    if (result.componentRegistry.missingKeys.length > 0) {
+      lines.push("### Missing PageRegistry Entries");
+      for (const key of result.componentRegistry.missingKeys) {
+        lines.push(`- \`${key}\``);
+      }
+      lines.push("");
+    }
+  }
   lines.push("## Recommendations");
   lines.push("");
   for (const rec of result.recommendations) {