@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/skills/utils/subcommands/test-web.md

@@ -1,123 +1,123 @@
----
-name: test-web
-description: Test web accessibility and content validation
-argument-hint: --quick|--chrome|--report|<url>
-allowed-tools: WebFetch, WebSearch, Read, Write, Bash
-model: sonnet
----
-
-# Test Web Accessibility
-
-Tests accessibility and content of project web resources.
-
-## Execution Modes
-
-| Mode | Flag | Description |
-|------|------|-------------|
-| Quick | `--quick` | WebFetch only (HTTP 200 + text content) |
-| Chrome | `--chrome` | E2E tests with Claude for Chrome (requires `claude --chrome`) |
-| Report | `--report` | Generates detailed report in reports/ |
-| Full | (default) | Quick + Chrome if available |
-
-## Configuration
-
-Reads configuration from: `.claude/test-web/config.json`
-
-## Workflow
-
-### Quick Mode (--quick)
-
-1. **Load configuration**
-   ```bash
-   cat .claude/test-web/config.json
-   ```
-
-2. **For each target type "fetch"**:
-   - `WebFetch(url, "Verify that the page is accessible and contains: {expects.contains}")`
-   - Check HTTP status (200 expected)
-   - Verify expected content presence
-
-3. **For each target type "search"**:
-   - `WebSearch(query)`
-   - Verify results exist
-
-4. **Report**: Display results in console
-
-### Chrome Mode (--chrome)
-
-**Prerequisites**:
-- "Claude for Chrome" extension installed
-- Max/Pro/Team/Enterprise plan
-- Claude Code launched with: `claude --chrome`
-
-1. **Verify Chrome mode is active**
-2. **For each chrome target**:
-   - Navigate to URL
-   - Execute actions (click, verify, etc.)
-   - Capture screenshots if requested
-
-3. **Report**: Generate report with captures
-
-### Report Mode (--report)
-
-Generates markdown file in `.claude/test-web/reports/`:
-
-```markdown
-# Test Web Report - YYYY-MM-DD HH:mm
-
-## Summary
-| Target | Status | Time |
-|--------|--------|------|
-| ... | PASS/FAIL | Xms |
-
-## Details
-### Target Name
-- URL: ...
-- Expected: ...
-- Result: ...
-- Screenshot: (if chrome mode)
-```
-
-## Output Format
-
-### Success
-
-```
-TEST WEB RESULTS
-------------------------------------
-OK GitHub Repository     200 OK    "README" found
-OK npm Package           200 OK    "claude-tools" found
-OK Google Indexation     Results   Found in search
-
-Status: 3/3 PASS
-------------------------------------
-```
-
-### Failure
-
-```
-TEST WEB RESULTS
-------------------------------------
-OK GitHub Repository     200 OK    "README" found
-FAIL npm Package         404       Package not found
-WARN Google Indexation   Results   No relevant results
-
-Status: 1/3 PASS, 1 FAIL, 1 WARNING
-------------------------------------
-```
-
-## Examples
-
-```bash
-# Quick test of all configured URLs
-/utils:test-web --quick
-
-# E2E test with browser (requires claude --chrome)
-/utils:test-web --chrome
-
-# Test specific URL
-/utils:test-web https://github.com/example/repo
-
-# Generate detailed report
-/utils:test-web --report
-```
+---
+name: test-web
+description: Test web accessibility and content validation
+argument-hint: --quick|--chrome|--report|<url>
+allowed-tools: WebFetch, WebSearch, Read, Write, Bash
+model: sonnet
+---
+
+# Test Web Accessibility
+
+Tests accessibility and content of project web resources.
+
+## Execution Modes
+
+| Mode | Flag | Description |
+|------|------|-------------|
+| Quick | `--quick` | WebFetch only (HTTP 200 + text content) |
+| Chrome | `--chrome` | E2E tests with Claude for Chrome (requires `claude --chrome`) |
+| Report | `--report` | Generates detailed report in reports/ |
+| Full | (default) | Quick + Chrome if available |
+
+## Configuration
+
+Reads configuration from: `.claude/test-web/config.json`
+
+## Workflow
+
+### Quick Mode (--quick)
+
+1. **Load configuration**
+   ```bash
+   cat .claude/test-web/config.json
+   ```
+
+2. **For each target type "fetch"**:
+   - `WebFetch(url, "Verify that the page is accessible and contains: {expects.contains}")`
+   - Check HTTP status (200 expected)
+   - Verify expected content presence
+
+3. **For each target type "search"**:
+   - `WebSearch(query)`
+   - Verify results exist
+
+4. **Report**: Display results in console
+
+### Chrome Mode (--chrome)
+
+**Prerequisites**:
+- "Claude for Chrome" extension installed
+- Max/Pro/Team/Enterprise plan
+- Claude Code launched with: `claude --chrome`
+
+1. **Verify Chrome mode is active**
+2. **For each chrome target**:
+   - Navigate to URL
+   - Execute actions (click, verify, etc.)
+   - Capture screenshots if requested
+
+3. **Report**: Generate report with captures
+
+### Report Mode (--report)
+
+Generates markdown file in `.claude/test-web/reports/`:
+
+```markdown
+# Test Web Report - YYYY-MM-DD HH:mm
+
+## Summary
+| Target | Status | Time |
+|--------|--------|------|
+| ... | PASS/FAIL | Xms |
+
+## Details
+### Target Name
+- URL: ...
+- Expected: ...
+- Result: ...
+- Screenshot: (if chrome mode)
+```
+
+## Output Format
+
+### Success
+
+```
+TEST WEB RESULTS
+------------------------------------
+OK GitHub Repository     200 OK    "README" found
+OK npm Package           200 OK    "claude-tools" found
+OK Google Indexation     Results   Found in search
+
+Status: 3/3 PASS
+------------------------------------
+```
+
+### Failure
+
+```
+TEST WEB RESULTS
+------------------------------------
+OK GitHub Repository     200 OK    "README" found
+FAIL npm Package         404       Package not found
+WARN Google Indexation   Results   No relevant results
+
+Status: 1/3 PASS, 1 FAIL, 1 WARNING
+------------------------------------
+```
+
+## Examples
+
+```bash
+# Quick test of all configured URLs
+/utils test-web --quick
+
+# E2E test with browser (requires claude --chrome)
+/utils test-web --chrome
+
+# Test specific URL
+/utils test-web https://github.com/example/repo
+
+# Generate detailed report
+/utils test-web --report
+```

package/templates/skills/validate/SKILL.md

@@ -1,181 +1,181 @@
----
-name: validate
-description: Validate SmartStack conventions using MCP
-argument-hint: "[scope]"
-model: sonnet
-allowed-tools: Read, Grep, Glob, ToolSearch
----
-
-<objective>
-Validate the SmartStack project against established conventions using the SmartStack MCP server.
-Use before commits, PRs, or as part of CI/CD to ensure code quality.
-</objective>
-
-<quick_start>
-```bash
-/validate                 # Run all validations
-/validate:tables          # Validate table naming only
-/validate:migrations      # Validate migration naming only
-/validate:services        # Validate service patterns only
-/validate:namespaces      # Validate namespace structure only
-```
-</quick_start>
-
-<subcommands>
-
-| Command | Checks | Description |
-|---------|--------|-------------|
-| `/validate` | all | Run all convention checks |
-| `/validate:tables` | tables | SQL schemas, domain prefixes |
-| `/validate:migrations` | migrations | Naming format, ordering |
-| `/validate:services` | services | I*Service interfaces |
-| `/validate:namespaces` | namespaces | Layer separation |
-
-</subcommands>
-
-<mcp_integration>
-
-**Tool:** `mcp__smartstack__validate_conventions`
-
-Call the MCP tool with appropriate checks:
-
-```json
-{
-  "tool": "mcp__smartstack__validate_conventions",
-  "parameters": {
-    "checks": ["all"]
-  }
-}
-```
-
-For specific checks:
-```json
-{
-  "checks": ["tables", "migrations"]
-}
-```
-
-</mcp_integration>
-
-<validation_rules>
-
-### Tables (`checks: ["tables"]`)
-
-| Rule | Valid | Invalid |
-|------|-------|---------|
-| Schema | `core`, `extensions` | `dbo`, custom |
-| Prefix | `auth_Users`, `nav_Items` | `Users`, `Items` |
-
-**Valid prefixes:** `auth_`, `nav_`, `usr_`, `ai_`, `cfg_`, `wkf_`, `support_`, `entra_`, `ref_`, `loc_`, `lic_`
-
-### Migrations (`checks: ["migrations"]`)
-
-| Rule | Valid | Invalid |
-|------|-------|---------|
-| Format | `core_v1.0.0_001_AddUsers` | `AddUsersTable` |
-| Order | v1.0.0 before v1.1.0 | v1.1.0 before v1.0.0 |
-
-**Format:** `{context}_v{version}_{sequence}_{Description}`
-
-### Services (`checks: ["services"]`)
-
-| Rule | Valid | Invalid |
-|------|-------|---------|
-| Interface | `IUserService` | `UserServiceInterface` |
-| Implementation | `UserService : IUserService` | `UserService` (no interface) |
-
-### Namespaces (`checks: ["namespaces"]`)
-
-| Layer | Expected Namespace |
-|-------|-------------------|
-| Domain | `SmartStack.Domain.*` |
-| Application | `SmartStack.Application.*` |
-| Infrastructure | `SmartStack.Infrastructure.*` |
-| Api | `SmartStack.Api.*` |
-
-</validation_rules>
-
-<output_format>
-
-**If `valid: true` with no warnings:**
-```
-================================================================================
-                    SMARTSTACK CONVENTIONS VALIDATION
-================================================================================
-
-STATUS: PASSED
-
-Checks performed: tables, migrations, services, namespaces
-Errors: 0
-Warnings: 0
-
-All conventions validated successfully!
-================================================================================
-```
-
-**If `valid: false` or has warnings:**
-```
-================================================================================
-                    SMARTSTACK CONVENTIONS VALIDATION
-================================================================================
-
-STATUS: {valid ? "PASSED (with warnings)" : "FAILED"}
-
-ERRORS ({count})
---------------------------------------------------------------------------------
-  [{category}] {message}
-    File: {file}
-    Suggestion: {suggestion}
---------------------------------------------------------------------------------
-
-WARNINGS ({count})
---------------------------------------------------------------------------------
-  [{category}] {message}
-    File: {file}
-    Suggestion: {suggestion}
---------------------------------------------------------------------------------
-================================================================================
-```
-
-</output_format>
-
-<options>
-
-| Option | Description |
-|--------|-------------|
-| `--fix` | Auto-fix simple issues (rename suggestions) |
-| `--json` | Output raw MCP JSON response |
-| `--strict` | Treat warnings as errors |
-
-</options>
-
-<cicd_integration>
-
-```yaml
-# GitHub Actions
-- name: Validate SmartStack conventions
-  run: |
-    OUTPUT=$(claude-code "/validate --json")
-    VALID=$(echo $OUTPUT | jq '.valid')
-    if [ "$VALID" != "true" ]; then
-      echo "::error::SmartStack convention violations detected"
-      exit 1
-    fi
-```
-
-</cicd_integration>
-
-<why_mcp>
-
-1. **Centralized Rules:** Convention rules defined once in MCP config
-2. **Consistency:** Same validation in CLI, CI/CD, and IDE
-3. **Extensibility:** Add new checks in MCP, available everywhere
-4. **Structured Output:** Typed responses for automation
-
-</why_mcp>
-
-<success_criteria>
-- MCP validate_conventions called with correct checks
-- Validation report displayed with pass/fail per check
-- All errors and warnings listed with file references and suggestions
-</success_criteria>
+---
+name: validate
+description: Validate SmartStack conventions using MCP
+argument-hint: "[scope]"
+model: sonnet
+allowed-tools: Read, Grep, Glob, ToolSearch
+---
+
+<objective>
+Validate the SmartStack project against established conventions using the SmartStack MCP server.
+Use before commits, PRs, or as part of CI/CD to ensure code quality.
+</objective>
+
+<quick_start>
+```bash
+/validate                 # Run all validations
+/validate tables          # Validate table naming only
+/validate migrations      # Validate migration naming only
+/validate services        # Validate service patterns only
+/validate namespaces      # Validate namespace structure only
+```
+</quick_start>
+
+<subcommands>
+
+| Command | Checks | Description |
+|---------|--------|-------------|
+| `/validate` | all | Run all convention checks |
+| `/validate tables` | tables | SQL schemas, domain prefixes |
+| `/validate migrations` | migrations | Naming format, ordering |
+| `/validate services` | services | I*Service interfaces |
+| `/validate namespaces` | namespaces | Layer separation |
+
+</subcommands>
+
+<mcp_integration>
+
+**Tool:** `mcp__smartstack__validate_conventions`
+
+Call the MCP tool with appropriate checks:
+
+```json
+{
+  "tool": "mcp__smartstack__validate_conventions",
+  "parameters": {
+    "checks": ["all"]
+  }
+}
+```
+
+For specific checks:
+```json
+{
+  "checks": ["tables", "migrations"]
+}
+```
+
+</mcp_integration>
+
+<validation_rules>
+
+### Tables (`checks: ["tables"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Schema | `core`, `extensions` | `dbo`, custom |
+| Prefix | `auth_Users`, `nav_Items` | `Users`, `Items` |
+
+**Valid prefixes:** `auth_`, `nav_`, `usr_`, `ai_`, `cfg_`, `wkf_`, `support_`, `entra_`, `ref_`, `loc_`, `lic_`
+
+### Migrations (`checks: ["migrations"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Format | `core_v1.0.0_001_AddUsers` | `AddUsersTable` |
+| Order | v1.0.0 before v1.1.0 | v1.1.0 before v1.0.0 |
+
+**Format:** `{context}_v{version}_{sequence}_{Description}`
+
+### Services (`checks: ["services"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Interface | `IUserService` | `UserServiceInterface` |
+| Implementation | `UserService : IUserService` | `UserService` (no interface) |
+
+### Namespaces (`checks: ["namespaces"]`)
+
+| Layer | Expected Namespace |
+|-------|-------------------|
+| Domain | `SmartStack.Domain.*` |
+| Application | `SmartStack.Application.*` |
+| Infrastructure | `SmartStack.Infrastructure.*` |
+| Api | `SmartStack.Api.*` |
+
+</validation_rules>
+
+<output_format>
+
+**If `valid: true` with no warnings:**
+```
+================================================================================
+                    SMARTSTACK CONVENTIONS VALIDATION
+================================================================================
+
+STATUS: PASSED
+
+Checks performed: tables, migrations, services, namespaces
+Errors: 0
+Warnings: 0
+
+All conventions validated successfully!
+================================================================================
+```
+
+**If `valid: false` or has warnings:**
+```
+================================================================================
+                    SMARTSTACK CONVENTIONS VALIDATION
+================================================================================
+
+STATUS: {valid ? "PASSED (with warnings)" : "FAILED"}
+
+ERRORS ({count})
+--------------------------------------------------------------------------------
+  [{category}] {message}
+    File: {file}
+    Suggestion: {suggestion}
+--------------------------------------------------------------------------------
+
+WARNINGS ({count})
+--------------------------------------------------------------------------------
+  [{category}] {message}
+    File: {file}
+    Suggestion: {suggestion}
+--------------------------------------------------------------------------------
+================================================================================
+```
+
+</output_format>
+
+<options>
+
+| Option | Description |
+|--------|-------------|
+| `--fix` | Auto-fix simple issues (rename suggestions) |
+| `--json` | Output raw MCP JSON response |
+| `--strict` | Treat warnings as errors |
+
+</options>
+
+<cicd_integration>
+
+```yaml
+# GitHub Actions
+- name: Validate SmartStack conventions
+  run: |
+    OUTPUT=$(claude-code "/validate --json")
+    VALID=$(echo $OUTPUT | jq '.valid')
+    if [ "$VALID" != "true" ]; then
+      echo "::error::SmartStack convention violations detected"
+      exit 1
+    fi
+```
+
+</cicd_integration>
+
+<why_mcp>
+
+1. **Centralized Rules:** Convention rules defined once in MCP config
+2. **Consistency:** Same validation in CLI, CI/CD, and IDE
+3. **Extensibility:** Add new checks in MCP, available everywhere
+4. **Structured Output:** Typed responses for automation
+
+</why_mcp>
+
+<success_criteria>
+- MCP validate_conventions called with correct checks
+- Validation report displayed with pass/fail per check
+- All errors and warnings listed with file references and suggestions
+</success_criteria>