@atlashub/smartstack-cli 2.8.0 → 3.0.0

package/templates/skills/validate-feature/steps/step-01-compile.md

@@ -0,0 +1,38 @@
+---
+name: step-01-compile
+description: Build the full solution to verify compilation
+next_step: steps/step-02-unit-tests.md
+---
+
+# Step 1: Compilation Check
+
+## BLOCKING - Must pass before proceeding
+
+### 1. Locate the solution file
+
+```bash
+# Find the .sln file
+ls *.sln 2>/dev/null || find . -maxdepth 2 -name "*.sln" -type f
+```
+
+### 2. Build the entire solution
+
+```bash
+dotnet build {SolutionFile} --verbosity minimal
+```
+
+### 3. Evaluate result
+
+- **Build succeeded** -> Proceed to step 2
+- **Build failed** -> Read the error output, identify the issue:
+  - Missing using statement -> Add it
+  - Type not found -> Check project references
+  - Method signature mismatch -> Fix the code
+  - **Re-build until it succeeds**
+
+### 4. Store state
+
+```
+{solution_file} = path to .sln file
+{build_result} = PASS or FAIL
+```

package/templates/skills/validate-feature/steps/step-02-unit-tests.md

@@ -0,0 +1,45 @@
+---
+name: step-02-unit-tests
+description: Run unit tests to verify business logic
+prev_step: steps/step-01-compile.md
+next_step: steps/step-03-integration-tests.md
+---
+
+# Step 2: Unit Tests
+
+## BLOCKING - All unit tests must pass
+
+### 1. Locate the test project
+
+```bash
+# Find test project
+ls tests/*/*.csproj 2>/dev/null || ls *Tests*/*.csproj 2>/dev/null
+```
+
+### 2. Run unit tests only
+
+```bash
+dotnet test {TestProject} --no-build --filter "FullyQualifiedName~Unit" --verbosity normal
+```
+
+If the filter doesn't match, try:
+
+```bash
+dotnet test {TestProject} --no-build --filter "Category!=Integration" --verbosity normal
+```
+
+### 3. Evaluate result
+
+- **All tests passed** -> Proceed to step 3
+- **Tests failed** -> Read the failure output:
+  - Assertion failure -> Check if the test expectation matches the implementation
+  - Exception thrown -> Check if the service/entity code is correct
+  - Compilation error -> Should not happen (step 1 passed), but fix if it does
+  - **Fix and re-run until all pass**
+
+### 4. Store state
+
+```
+{unit_test_count} = number of tests that passed
+{unit_test_result} = PASS or FAIL
+```

package/templates/skills/validate-feature/steps/step-03-integration-tests.md

@@ -0,0 +1,53 @@
+---
+name: step-03-integration-tests
+description: Run integration tests to verify real DB operations
+prev_step: steps/step-02-unit-tests.md
+next_step: steps/step-04-api-smoke.md
+---
+
+# Step 3: Integration Tests
+
+## BLOCKING - All integration tests must pass
+
+### 1. Run integration tests
+
+```bash
+dotnet test {TestProject} --no-build --filter "FullyQualifiedName~Integration" --verbosity normal
+```
+
+If the filter doesn't match, try:
+
+```bash
+dotnet test {TestProject} --no-build --filter "FullyQualifiedName~ControllerIntegrationTests|FullyQualifiedName~RepositoryTests" --verbosity normal
+```
+
+### 2. What these tests verify
+
+Integration tests use `SmartStackTestFactory` (WebApplicationFactory with SQLite) to run the REAL application pipeline:
+
+| What | How |
+|------|-----|
+| Controller routing | HTTP requests hit actual controller endpoints |
+| DI pipeline | Real services and repositories are injected |
+| Database operations | SQLite in-memory stores and retrieves data |
+| Auth middleware | TestAuthHandler provides fake authenticated user |
+| Tenant isolation | Requests with different tenant IDs see different data |
+| Data persistence | POST creates data, GET retrieves it from DB |
+
+### 3. Evaluate result
+
+- **All tests passed** -> Proceed to step 4
+- **Tests failed** -> Common issues:
+  - `Program` not accessible -> Add `public partial class Program { }` to Program.cs
+  - DbContext configuration error -> Check that SQLite provider is properly configured
+  - Service not registered -> Check DI registration in `Program.cs` or startup
+  - Migration issue -> Ensure `EnsureCreatedAsync()` works with SQLite
+  - Tenant filter issue -> Check global query filters work with test tenant
+  - **Fix and re-run until all pass**
+
+### 4. Store state
+
+```
+{integration_test_count} = number of tests that passed
+{integration_test_result} = PASS or FAIL
+```

package/templates/skills/validate-feature/steps/step-04-api-smoke.md

@@ -0,0 +1,157 @@
+---
+name: step-04-api-smoke
+description: Start the API and test CRUD endpoints with real HTTP requests
+prev_step: steps/step-03-integration-tests.md
+---
+
+# Step 4: API Smoke Test
+
+## BLOCKING - All CRUD endpoints must respond correctly
+
+### 1. Find the API project
+
+```bash
+# Find the API project
+ls src/*Api*/*.csproj 2>/dev/null || ls *Api*/*.csproj 2>/dev/null
+```
+
+### 2. Start the API in the background
+
+```bash
+# Start the API on a test port
+dotnet run --project {ApiProject} --urls "http://localhost:5099" &
+API_PID=$!
+```
+
+### 3. Wait for the API to be ready
+
+```bash
+# Poll the health endpoint (or root) until it responds
+for i in $(seq 1 30); do
+  curl -s -o /dev/null -w "%{http_code}" http://localhost:5099/health 2>/dev/null
+  if [ $? -eq 0 ]; then
+    echo "API is ready"
+    break
+  fi
+  sleep 1
+done
+```
+
+If no `/health` endpoint exists, try:
+```bash
+curl -s -o /dev/null -w "%{http_code}" http://localhost:5099/api/{entity_code}
+```
+
+### 4. Authenticate (if required)
+
+```bash
+# Try to login with default test credentials
+TOKEN=$(curl -s -X POST http://localhost:5099/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email":"admin@smartstack.io","password":"Admin123!"}' \
+  | jq -r '.token // .accessToken // empty')
+```
+
+If auth is not configured yet, tests may work without a token (depending on configuration).
+
+### 5. Test CRUD endpoints
+
+**Set common headers:**
+```bash
+AUTH_HEADER="Authorization: Bearer $TOKEN"
+TENANT_HEADER="X-Tenant-Id: 11111111-1111-1111-1111-111111111111"
+CONTENT_TYPE="Content-Type: application/json"
+```
+
+#### 5.1 GET all (expect 200)
+```bash
+curl -s -w "\n%{http_code}" \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" \
+  http://localhost:5099/api/{entity_code}
+```
+Expected: HTTP 200
+
+#### 5.2 POST create (expect 201 or 200)
+```bash
+CREATED=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" -H "$CONTENT_TYPE" \
+  -d '{"code":"smoke-test-01","name":"Smoke Test Entity"}' \
+  http://localhost:5099/api/{entity_code})
+```
+Expected: HTTP 201 or 200
+Extract the created entity ID from the response.
+
+#### 5.3 GET by ID (expect 200)
+```bash
+curl -s -w "\n%{http_code}" \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" \
+  http://localhost:5099/api/{entity_code}/{created_id}
+```
+Expected: HTTP 200 with the entity data
+
+#### 5.4 PUT update (expect 200)
+```bash
+curl -s -w "\n%{http_code}" \
+  -X PUT \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" -H "$CONTENT_TYPE" \
+  -d '{"code":"smoke-test-01","name":"Updated Smoke Test"}' \
+  http://localhost:5099/api/{entity_code}/{created_id}
+```
+Expected: HTTP 200
+
+#### 5.5 DELETE (expect 204)
+```bash
+curl -s -w "\n%{http_code}" \
+  -X DELETE \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" \
+  http://localhost:5099/api/{entity_code}/{created_id}
+```
+Expected: HTTP 204
+
+#### 5.6 GET deleted (expect 404)
+```bash
+curl -s -w "\n%{http_code}" \
+  -H "$AUTH_HEADER" -H "$TENANT_HEADER" \
+  http://localhost:5099/api/{entity_code}/{created_id}
+```
+Expected: HTTP 404 (confirms deletion)
+
+### 6. Stop the API
+
+```bash
+kill $API_PID 2>/dev/null
+```
+
+### 7. Evaluate results
+
+Build a report:
+
+```markdown
+## Feature Validation: {entity_name}
+
+| Check | Result | Details |
+|-------|--------|---------|
+| Solution build | {build_result} | |
+| Unit tests | {unit_test_result} | {unit_test_count} passed |
+| Integration tests | {integration_test_result} | {integration_test_count} passed |
+| GET /api/{entity_code} | {status} | |
+| POST /api/{entity_code} | {status} | |
+| GET /api/{entity_code}/{id} | {status} | |
+| PUT /api/{entity_code}/{id} | {status} | |
+| DELETE /api/{entity_code}/{id} | {status} | |
+| GET deleted entity | {status} | |
+
+### Overall: {ALL_PASS or FAILURES_DETECTED}
+```
+
+### 8. Handle failures
+
+If any smoke test fails:
+- **401 Unauthorized** -> Auth not configured, check JWT setup
+- **403 Forbidden** -> Permissions not seeded, check PermissionConfiguration
+- **404 Not Found** -> Route not registered, check controller NavRoute
+- **500 Internal Server Error** -> Check API logs for exception details
+- **Connection refused** -> API didn't start, check startup configuration
+
+Report all findings to the user with actionable next steps.