@atlashub/smartstack-cli 3.23.0 → 3.24.0

package/package.json

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

package/templates/mcp-scaffolding/component.tsx.hbs

@@ -174,7 +174,27 @@ export const {{name}}: React.FC<{{name}}Props> = ({
 
       {/* Form */}
       <form onSubmit={handleSubmit} className="p-6 space-y-6">
-        {/* TODO: Add form fields */}
+        {/*
+          TODO: Add form fields based on entity properties.
+          IMPORTANT — Field type mapping:
+          - string properties → <input type="text" />
+          - bool properties → <input type="checkbox" />
+          - number properties → <input type="number" />
+          - DateTime properties → <input type="date" />
+          - Guid FK properties (e.g., EmployeeId, DepartmentId) → <EntityLookup /> (NEVER plain text input!)
+
+          For FK fields, use EntityLookup from @/components/ui/EntityLookup:
+          <EntityLookup
+            apiEndpoint="/api/{related-entity-route}"
+            value={data.relatedEntityId}
+            onChange={(id) => handleChange('relatedEntityId', id)}
+            label="Related Entity"
+            mapOption={(item) => ({ id: item.id, label: item.name, sublabel: item.code })}
+            required
+          />
+
+          See smartstack-frontend.md section 6 for the full EntityLookup pattern.
+        */}
         <div className="text-[var(--text-secondary)] text-center py-8">
           Add your form fields here
         </div>

package/templates/skills/apex/references/smartstack-api.md

@@ -228,13 +228,33 @@ public class {Name}Service : I{Name}Service
         _logger = logger;
     }
 
-    public async Task<List<{Name}ResponseDto>> GetAllAsync(CancellationToken ct)
+    public async Task<PaginatedResult<{Name}ResponseDto>> GetAllAsync(
+        string? search = null,
+        int page = 1,
+        int pageSize = 20,
+        CancellationToken ct = default)
     {
-        return await _db.{Name}s
+        var query = _db.{Name}s
             .Where(x => x.TenantId == _currentUser.TenantId)  // MANDATORY tenant filter
-            .AsNoTracking()
+            .AsNoTracking();
+
+        // Search filter — enables EntityLookup on frontend
+        if (!string.IsNullOrWhiteSpace(search))
+        {
+            query = query.Where(x =>
+                x.Name.Contains(search) ||
+                x.Code.Contains(search));
+        }
+
+        var totalCount = await query.CountAsync(ct);
+        var items = await query
+            .OrderBy(x => x.Name)
+            .Skip((page - 1) * pageSize)
+            .Take(pageSize)
             .Select(x => new {Name}ResponseDto(x.Id, x.Code, x.Name, x.CreatedAt))
             .ToListAsync(ct);
+
+        return new PaginatedResult<{Name}ResponseDto>(items, totalCount, page, pageSize);
     }
 
     public async Task<{Name}ResponseDto?> GetByIdAsync(Guid id, CancellationToken ct)
@@ -313,8 +333,12 @@ public class {Name}Controller : ControllerBase
 
     [HttpGet]
     [RequirePermission(Permissions.{Module}.Read)]
-    public async Task<ActionResult<List<{Name}ResponseDto>>> GetAll(CancellationToken ct)
-        => Ok(await _service.GetAllAsync(ct));
+    public async Task<ActionResult<PaginatedResult<{Name}ResponseDto>>> GetAll(
+        [FromQuery] string? search = null,
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        CancellationToken ct = default)
+        => Ok(await _service.GetAllAsync(search, page, pageSize, ct));
 
     [HttpGet("{id:guid}")]
     [RequirePermission(Permissions.{Module}.Read)]
@@ -479,3 +503,5 @@ services.AddValidatorsFromAssemblyContaining<Create{Name}DtoValidator>();
 | Route `"humanresources"` in seed data | Must be full path `"/business/human-resources"` |
 | Route without leading `/` | All routes must start with `/` |
 | `Permission.Create()` | Does NOT exist — use `CreateForModule()`, `CreateForSection()`, etc. |
+| `GetAllAsync()` without search param | ALL GetAll endpoints MUST support `?search=` for EntityLookup |
+| FK field as plain text input | Frontend MUST use `EntityLookup` component for Guid FK fields |