@atlashub/smartstack-cli 4.5.0 → 4.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/project/DependencyInjection.Application.cs.template

@@ -17,8 +17,8 @@ public static class DependencyInjection
         this IServiceCollection services)
     {
         // TODO: Register your application services here
-        // Example:
-        // services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(DependencyInjection).Assembly));
+        // NOTE: MediatR is already registered by AddSmartStack() — do NOT register it again here.
+        // Only add client-specific services (e.g., custom validators, domain services).
 
         return services;
     }

package/templates/project/Program.cs.template

@@ -1,46 +1,101 @@
+using Serilog;
+using Serilog.Events;
 using Microsoft.EntityFrameworkCore;
 using SmartStack.Api.Extensions;
 using {{ProjectName}}.Infrastructure;
 using {{ProjectName}}.Infrastructure.Persistence;
 using {{ProjectName}}.Application;
 
-var builder = WebApplication.CreateBuilder(args);
+// Bootstrap logger for startup errors
+Log.Logger = new LoggerConfiguration()
+    .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
+    .Enrich.FromLogContext()
+    .WriteTo.Console()
+    .CreateBootstrapLogger();
 
-// ===================================================================
-// 1. Add SmartStack Core services (from NuGet package)
-// ===================================================================
-builder.Services.AddSmartStack(builder.Configuration, options =>
+try
 {
-    options.EnableDevSeeding = builder.Environment.IsDevelopment();
-});
-
-// ===================================================================
-// 2. Add client-specific services (Dual-DbContext pattern)
-// ===================================================================
-builder.Services.Add{{ProjectName}}Infrastructure(builder.Configuration);
-builder.Services.Add{{ProjectName}}Application();
-
-var app = builder.Build();
-
-// ===================================================================
-// 3. Initialize SmartStack + apply migrations (in correct order!)
-// ===================================================================
-// This initializes SmartStack and applies Core migrations automatically
-await app.InitializeSmartStackAsync();
-
-// Apply Extensions migrations AFTER Core migrations
-// Your client-specific tables may have FK references to Core tables
-if (app.Environment.IsDevelopment())
-{
-    using var scope = app.Services.CreateScope();
-    var extDb = scope.ServiceProvider.GetRequiredService<ExtensionsDbContext>();
-    await extDb.Database.MigrateAsync();
-}
+    Log.Information("Starting {{ProjectName}} API");
+
+    var builder = WebApplication.CreateBuilder(args);
+
+    // Configure Kestrel to use HTTP/1.1 on all configured endpoints
+    builder.WebHost.ConfigureKestrel((context, options) =>
+    {
+        options.ConfigureEndpointDefaults(listenOptions =>
+        {
+            listenOptions.Protocols = Microsoft.AspNetCore.Server.Kestrel.Core.HttpProtocols.Http1;
+        });
+    });
+
+    // Load appsettings.Local.json if it exists (for local development overrides)
+    builder.Configuration.AddJsonFile("appsettings.Local.json", optional: true, reloadOnChange: true);
+
+    // Serilog configuration from appsettings
+    builder.Host.UseSmartStackSerilog();
+
+    // Application Insights SDK (must be added before Serilog runs)
+    var aiConnectionString = builder.Configuration["Logging:Sinks:ApplicationInsights:ConnectionString"];
+    var aiEnabled = builder.Configuration.GetValue<bool>("Logging:Sinks:ApplicationInsights:Enabled");
+    if (!string.IsNullOrEmpty(aiConnectionString) && aiEnabled)
+    {
+        builder.Services.AddApplicationInsightsTelemetry(options =>
+        {
+            options.ConnectionString = aiConnectionString;
+        });
+    }
+
+    // ===================================================================
+    // 1. Add SmartStack Core services (from NuGet package)
+    // ===================================================================
+    builder.Services.AddSmartStack(builder.Configuration, options =>
+    {
+        options.EnableDevSeeding = builder.Environment.IsDevelopment();
+    });
+
+    // ===================================================================
+    // 2. Add client-specific services (Dual-DbContext pattern)
+    // ===================================================================
+    builder.Services.Add{{ProjectName}}Infrastructure(builder.Configuration);
+    builder.Services.Add{{ProjectName}}Application();
+
+    var app = builder.Build();
 
-// ===================================================================
-// 4. SmartStack middleware & endpoints
-// ===================================================================
-app.UseSmartStack();
-app.MapSmartStack();
+    // ===================================================================
+    // 3. Initialize SmartStack + apply migrations (in correct order!)
+    // ===================================================================
+    // This initializes SmartStack and applies Core migrations automatically
+    await app.InitializeSmartStackAsync();
 
-app.Run();
+    // Apply Extensions migrations AFTER Core migrations
+    // Your client-specific tables may have FK references to Core tables
+    if (app.Environment.IsDevelopment())
+    {
+        using var scope = app.Services.CreateScope();
+        var extDb = scope.ServiceProvider.GetRequiredService<ExtensionsDbContext>();
+        await extDb.Database.MigrateAsync();
+    }
+
+    // ===================================================================
+    // 4. SmartStack middleware & endpoints
+    // ===================================================================
+    // Swagger UI (development only)
+    app.UseSmartStackSwagger();
+
+    // SmartStack middleware pipeline
+    app.UseSmartStack();
+
+    // Map controllers and SignalR hubs
+    app.MapSmartStack();
+
+    Log.Information("{{ProjectName}} API started successfully");
+    app.Run();
+}
+catch (Exception ex)
+{
+    Log.Fatal(ex, "Application terminated unexpectedly");
+}
+finally
+{
+    Log.CloseAndFlush();
+}

package/templates/skills/apex/references/frontend-route-wiring-app-tsx.md

@@ -0,0 +1,139 @@
+# Frontend: Route Wiring in App.tsx
+
+> Referenced from `steps/step-03-execute.md` — Detailed route wiring patterns and verification.
+
+---
+
+## Step 4: Wire Routes to App.tsx (BLOCKING)
+
+**CRITICAL:** This step is MANDATORY. Without it, routes exist as files but are invisible to the React Router. The page will be BLANK.
+
+After `scaffold_routes` generates the route files, you MUST manually insert the routes into `App.tsx`.
+
+---
+
+## Step 4a: Import Page Components
+
+At the top of App.tsx:
+
+```tsx
+import { {EntityName}Page } from '@/pages/{Application}/{Module}/{EntityName}Page';
+// Or lazy-loaded:
+const {EntityName}Page = lazy(() => import('@/pages/{Application}/{Module}/{EntityName}Page'));
+```
+
+---
+
+## Step 4b: Detect App.tsx Routing Pattern
+
+Read App.tsx and detect which pattern is used:
+
+### Pattern A: applicationRoutes Object
+
+**If App.tsx contains:** `applicationRoutes: ApplicationRouteExtensions`
+
+→ Add routes to `applicationRoutes.{application}[]` with **RELATIVE** paths (no leading `/`)
+
+```tsx
+const applicationRoutes: ApplicationRouteExtensions = {
+  'human-resources': [
+    // existing routes...
+    { path: '{module_kebab}/{section_kebab}', element: <{EntityName}ListPage /> },
+    { path: '{module_kebab}/{section_kebab}/new', element: <Create{EntityName}Page /> },
+    { path: '{module_kebab}/{section_kebab}/:id', element: <{EntityName}DetailPage /> },
+    { path: '{module_kebab}/{section_kebab}/:id/edit', element: <Create{EntityName}Page /> },
+
+    // Parent redirect routes (MANDATORY — prevents /login redirect on parent navigation)
+    { path: '{module_kebab}', element: <Navigate to="{module_kebab}/{first_section_kebab}" replace /> },
+    { path: '', element: <Navigate to="{first_module_kebab}/{first_section_kebab}" replace /> },
+  ],
+};
+```
+
+Routes are automatically injected into BOTH standard (`/{application}/...`) and tenant-prefixed (`/t/:slug/{application}/...`) route trees by `mergeRoutes()`. No manual duplication needed.
+
+### Pattern B: JSX Routes
+
+**If App.tsx contains:** `<Route path="/{application}" element={<{Layout} />}>`
+
+→ Insert `<Route>` children inside the Layout wrapper:
+
+```tsx
+<Route path="/human-resources" element={<AppLayout />}>
+  {/* ... existing routes ... */}
+  <Route path="{module_kebab}" element={<{EntityName}Page />} />
+</Route>
+```
+
+**ALSO add the same routes inside the tenant-prefixed block:**
+
+Find `<Route path="/t/:slug">` and add the **same route entries** there.
+
+---
+
+## Step 4c: Application-to-Layout Mapping
+
+| Application prefix | Layout Component | Route path |
+|---------|------------------|------------|
+| `administration.*` | `AppLayout` | `/administration` |
+| `*` (business apps) | `AppLayout` | `/{application}` |
+| `myspace.*` | `AppLayout` | `/myspace` |
+
+---
+
+## Step 4d: Verify Wiring
+
+```
+Tool: mcp__smartstack__validate_frontend_routes
+Args:
+  scope: "routes"
+```
+
+If `appWiring.issues` is not empty, fix the wiring before proceeding.
+
+---
+
+## Step 4e: Parent Redirect Routes (MANDATORY)
+
+**CRITICAL:** Without parent redirects, navigating to an application or module URL (e.g., `/human-resources` or `/human-resources/employees`) will cause a redirect to `/login` because no route matches.
+
+For each application, you MUST add:
+
+1. **Application root redirect** — redirects `/{application}` to the first module/section:
+   ```tsx
+   { path: '', element: <Navigate to="{first_module}/{first_section}" replace /> }
+   ```
+
+2. **Module redirect** (if modules have sections) — redirects `/{application}/{module}` to first section:
+   ```tsx
+   { path: '{module}', element: <Navigate to="{module}/{first_section}" replace /> }
+   ```
+
+**Example:** For NavRoutes `human-resources.employees.management` and `human-resources.employees.departments`:
+```tsx
+{ path: 'employees', element: <Navigate to="employees/management" replace /> },
+{ path: '', element: <Navigate to="employees/management" replace /> },
+```
+
+The `to` prop is resolved relative to the **parent route** (`/{application}`), so always use the full path from the application root.
+
+> Note: `scaffold_routes` with `outputFormat: "clientRoutes"` generates these redirects automatically.
+
+---
+
+## Forbidden Patterns (BOTH patterns)
+
+- Adding application routes to `clientRoutes[]` with absolute paths — `clientRoutes` is ONLY for routes outside SmartStack applications (e.g., `/about`, `/pricing`)
+- Adding routes OUTSIDE the Layout wrapper (shell will not render)
+- Using `createBrowserRouter` (SmartStack uses `useRoutes()` + `mergeRoutes()`)
+
+---
+
+## Verification Checklist
+
+- [ ] Routes are inside the AppLayout wrapper
+- [ ] Routes use NESTED structure (not flat)
+- [ ] Application kebab-case matches navigation seed data
+- [ ] Both standard and tenant-prefixed blocks have routes (if using Pattern B)
+- [ ] Page components are imported at top of App.tsx
+- [ ] `mcp__smartstack__validate_frontend_routes` returns no issues

package/templates/skills/apex/references/person-extension-pattern.md

@@ -542,15 +542,17 @@ public record CustomerResponseDto(
 
 ```tsx
 // Composite columns from response DTO (already resolved by backend)
-<SmartTable
+<DataTable
   columns={[
-    { key: 'code', label: t('module:columns.code', 'Code') },
-    { key: 'displayFirstName', label: t('module:columns.firstName', 'First Name') },
-    { key: 'displayLastName', label: t('module:columns.lastName', 'Last Name') },
-    { key: 'displayEmail', label: t('module:columns.email', 'Email') },
+    { key: 'code', label: t('module:columns.code', 'Code'), sortable: true },
+    { key: 'displayFirstName', label: t('module:columns.firstName', 'First Name'), sortable: true },
+    { key: 'displayLastName', label: t('module:columns.lastName', 'Last Name'), sortable: true },
+    { key: 'displayEmail', label: t('module:columns.email', 'Email'), sortable: true },
     { key: 'status', label: t('module:columns.status', 'Status') },
   ]}
   data={items}
+  searchable
+  pagination={{ pageSize: 10 }}
 />
 ```