@atlashub/smartstack-cli 1.11.0 → 1.13.1

package/templates/ralph/ralph.config.yaml

@@ -0,0 +1,113 @@
+# Ralph Weegund Configuration
+# Auto-generated by SmartStack CLI
+# Documentation: https://atlashub.ch/docs/ralph
+
+version: "1.0.0"
+
+# MCP Servers - REQUIRED for Ralph to function
+mcp:
+  required:
+    - name: context7
+      description: "Library documentation and code examples"
+      install_command: "claude mcp add context7"
+      health_check: true
+
+    - name: smartstack
+      description: "SmartStack validation and scaffolding"
+      install_command: "claude mcp add smartstack"
+      health_check: true
+
+  # Behavior when MCP is unavailable
+  on_unavailable: "abort"  # abort | warn | ignore
+
+  # Health check interval (seconds) - 0 to disable
+  health_check_interval: 300
+
+# Logging configuration
+logging:
+  enabled: true
+  level: "info"  # debug | info | warn | error
+
+  # Log directory (relative to project root)
+  directory: ".ralph/logs"
+
+  # Log file naming pattern
+  file_pattern: "ralph-{date}.log"
+
+  # Retention in days (0 = unlimited)
+  retention_days: 30
+
+  # What to log
+  log_mcp_calls: true
+  log_tool_usage: true
+  log_iterations: true
+  log_file_changes: true
+
+# Feature reports
+reports:
+  enabled: true
+
+  # Reports directory (relative to project root)
+  directory: ".ralph/reports"
+
+  # Auto-generate report on feature completion
+  auto_generate: true
+
+  # Report format
+  format: "markdown"  # markdown | json | html
+
+  # Include in report
+  include:
+    mcp_usage_stats: true
+    files_created: true
+    files_modified: true
+    duration: true
+    iterations_count: true
+    validations_performed: true
+
+# Iteration settings
+iteration:
+  # Maximum iterations before forced stop (0 = unlimited)
+  max_iterations: 0
+
+  # Pause between iterations (milliseconds)
+  pause_ms: 1000
+
+  # Completion detection
+  completion:
+    # Require explicit completion promise
+    require_promise: true
+
+    # Keywords that indicate completion
+    keywords:
+      - "TASK_COMPLETE"
+      - "FEATURE_DONE"
+
+# Metrics and counters
+metrics:
+  enabled: true
+
+  # Track MCP tool usage
+  track_mcp_tools: true
+
+  # Track file operations
+  track_file_ops: true
+
+  # Export metrics on completion
+  export_on_complete: true
+
+# Alerting (future feature)
+alerts:
+  enabled: false
+
+  # Alert on MCP failure
+  on_mcp_failure: true
+
+  # Alert on max iterations reached
+  on_max_iterations: true
+
+  # Alert destinations (future)
+  # destinations:
+  #   - type: "console"
+  #   - type: "file"
+  #   - type: "webhook"

package/templates/scripts/setup-ralph-loop.sh

@@ -0,0 +1,173 @@
+#!/bin/bash
+# Ralph Loop Setup Script
+# SmartStack CLI - https://atlashub.ch
+#
+# This script initializes the Ralph loop with MCP validation
+# Usage: setup-ralph-loop.sh "PROMPT" [--max-iterations N] [--completion-promise TEXT]
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Configuration
+RALPH_CONFIG_FILE=".ralph/ralph.config.yaml"
+RALPH_LOG_DIR=".ralph/logs"
+REQUIRED_MCP_SERVERS=("context7" "smartstack")
+
+# Parse arguments
+PROMPT=""
+MAX_ITERATIONS=0
+COMPLETION_PROMISE=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --max-iterations)
+            MAX_ITERATIONS="$2"
+            shift 2
+            ;;
+        --completion-promise)
+            COMPLETION_PROMISE="$2"
+            shift 2
+            ;;
+        *)
+            if [[ -z "$PROMPT" ]]; then
+                PROMPT="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Functions
+log_info() {
+    echo -e "${BLUE}[Ralph]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[Ralph]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[Ralph]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[Ralph]${NC} $1"
+}
+
+check_mcp_server() {
+    local server_name="$1"
+    # Check if MCP server is available via claude mcp list
+    if claude mcp list 2>/dev/null | grep -q "$server_name"; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+validate_mcp_servers() {
+    log_info "Validating required MCP servers..."
+    local all_ok=true
+
+    for server in "${REQUIRED_MCP_SERVERS[@]}"; do
+        if check_mcp_server "$server"; then
+            log_success "  ✓ $server available"
+        else
+            log_error "  ✗ $server NOT FOUND"
+            log_warning "    Install with: claude mcp add $server"
+            all_ok=false
+        fi
+    done
+
+    if [[ "$all_ok" == "false" ]]; then
+        log_error ""
+        log_error "Ralph requires ALL MCP servers to be available."
+        log_error "Please install missing servers and try again."
+        log_error ""
+        log_error "Quick fix: smartstack check-mcp"
+        exit 1
+    fi
+
+    log_success "All MCP servers validated ✓"
+}
+
+ensure_ralph_structure() {
+    # Create .ralph directory structure if not exists
+    if [[ ! -d ".ralph" ]]; then
+        log_info "Creating .ralph directory structure..."
+        mkdir -p ".ralph/logs"
+        mkdir -p ".ralph/reports"
+
+        # Copy default config if available
+        if [[ -f "${CLAUDE_PLUGIN_ROOT}/templates/ralph/ralph.config.yaml" ]]; then
+            cp "${CLAUDE_PLUGIN_ROOT}/templates/ralph/ralph.config.yaml" ".ralph/"
+        fi
+
+        log_success ".ralph structure created"
+    fi
+
+    # Ensure log directory exists
+    mkdir -p "$RALPH_LOG_DIR"
+}
+
+init_session_log() {
+    local session_id=$(date +%Y%m%d_%H%M%S)
+    local log_file="$RALPH_LOG_DIR/ralph-session-$session_id.log"
+
+    echo "# Ralph Session Log" > "$log_file"
+    echo "# Started: $(date -Iseconds)" >> "$log_file"
+    echo "# Prompt: $PROMPT" >> "$log_file"
+    echo "# Max Iterations: $MAX_ITERATIONS" >> "$log_file"
+    echo "# Completion Promise: $COMPLETION_PROMISE" >> "$log_file"
+    echo "" >> "$log_file"
+
+    export RALPH_SESSION_LOG="$log_file"
+    export RALPH_SESSION_ID="$session_id"
+
+    log_info "Session log: $log_file"
+}
+
+# Main execution
+echo ""
+echo -e "${BLUE}╔══════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║${NC}       ${GREEN}Ralph Weegund${NC} - SmartStack        ${BLUE}║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════╝${NC}"
+echo ""
+
+# Validate prompt
+if [[ -z "$PROMPT" ]]; then
+    log_error "No prompt provided!"
+    log_info "Usage: /ralph-loop \"Your feature description\""
+    exit 1
+fi
+
+# Run validations
+validate_mcp_servers
+ensure_ralph_structure
+init_session_log
+
+# Display configuration
+echo ""
+log_info "Configuration:"
+echo "  • Prompt: $PROMPT"
+[[ $MAX_ITERATIONS -gt 0 ]] && echo "  • Max iterations: $MAX_ITERATIONS"
+[[ -n "$COMPLETION_PROMISE" ]] && echo "  • Completion promise: $COMPLETION_PROMISE"
+echo ""
+
+log_success "Ralph is ready. Starting iteration loop..."
+echo ""
+
+# Export for Claude to use
+export RALPH_PROMPT="$PROMPT"
+export RALPH_MAX_ITERATIONS="$MAX_ITERATIONS"
+export RALPH_COMPLETION_PROMISE="$COMPLETION_PROMISE"
+export RALPH_STARTED="true"
+
+# The actual loop behavior is handled by Claude Code
+# This script just sets up the environment
+exit 0

package/templates/skills/_shared.md

@@ -0,0 +1,117 @@
+# Skills SmartStack - Fonctions Partagées
+
+## Stratégie Modèles
+
+| Tâche | Modèle | Raison |
+|-------|--------|--------|
+| Génération code | **Sonnet** | Rapport qualité/coût optimal |
+| Audit sécurité | **Opus** | Analyse critique requise |
+| Validation finale | **Opus** | Décisions architecturales |
+
+## Architecture SmartStack
+
+```
+Domain → Application → Infrastructure → API → Web
+```
+
+### Layers
+| Layer | Responsabilité | Namespace |
+|-------|---------------|-----------|
+| Domain | Entités, ValueObjects | `SmartStack.Domain.{Context}` |
+| Application | Services, DTOs, Interfaces | `SmartStack.Application.{Context}` |
+| Infrastructure | Implémentations, EF Core | `SmartStack.Infrastructure.{Context}` |
+| API | Controllers, Middleware | `SmartStack.Api.Controllers.{Area}` |
+| Web | React components, pages | `src/pages/{context}/{app}/{module}` |
+
+## Permissions (2 fichiers obligatoires)
+
+### 1. Permissions.cs (Application layer)
+```csharp
+public static class {Module}
+{
+    public const string View = "{context}.{app}.{module}.view";
+    public const string Create = "{context}.{app}.{module}.create";
+    public const string Update = "{context}.{app}.{module}.update";
+    public const string Delete = "{context}.{app}.{module}.delete";
+}
+```
+
+### 2. PermissionConfiguration.cs (Infrastructure layer)
+```csharp
+builder.HasData(
+    new { Id = nextId++, Path = Permissions.{Module}.View, ... },
+    new { Id = nextId++, Path = Permissions.{Module}.Create, ... },
+    ...
+);
+```
+
+## i18n (4 langues obligatoires)
+
+| Langue | Fichier | Code |
+|--------|---------|------|
+| Français | `fr.json` | `fr` |
+| English | `en.json` | `en` |
+| Italiano | `it.json` | `it` |
+| Deutsch | `de.json` | `de` |
+
+### Structure i18n
+```json
+{
+  "{context}": {
+    "{application}": {
+      "{module}": {
+        "title": "...",
+        "fields": { ... },
+        "actions": { ... },
+        "messages": { ... }
+      }
+    }
+  }
+}
+```
+
+## Services Communs à Injecter
+
+| Service | Usage |
+|---------|-------|
+| `IApplicationDbContext` | Accès DB |
+| `ICurrentUserService` | User courant |
+| `ILogger<T>` | Logging |
+| `IMapper` | AutoMapper |
+| `IPermissionService` | Cache permissions |
+
+## Validation Sécurité
+
+### Logs Critiques
+| Événement | Niveau |
+|-----------|--------|
+| Login échoué | `Critical` |
+| Permission refusée | `Critical` |
+| Compte verrouillé | `Critical` |
+| Password change | `Warning` |
+| Suppression | `Warning` |
+
+### Protection Comptes Système
+```csharp
+if (entity.UserType == UserType.System || entity.UserType == UserType.LocalAdmin)
+    return BadRequest(new { message = "Cannot modify system accounts" });
+```
+
+## Checklist Validation Commune
+
+```
+□ Permissions créées (Permissions.cs + PermissionConfiguration.cs)
+□ Migration EF Core créée
+□ i18n 4 langues (fr, en, it, de)
+□ Tests unitaires
+□ Documentation API (ProducesResponseType)
+```
+
+## Références MCP Tools
+
+| Tool | Usage |
+|------|-------|
+| `mcp__smartstack__validate_conventions` | Validation conventions |
+| `mcp__smartstack__scaffold_extension` | Génération code |
+| `mcp__smartstack__check_migrations` | Vérification migrations |
+| `mcp__smartstack__scaffold_tests` | Génération tests |