@atlashub/smartstack-cli 3.39.0 → 3.40.0

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

@@ -1,173 +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
+#!/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/_resources/config-safety.md

@@ -1,61 +1,61 @@
-# Configuration File Safety Rules
-
-## appsettings*.json Protection
-
-### MANDATORY Rules
-
-1. **NEVER use Write tool on `appsettings*.json`** — ALWAYS use Edit for targeted changes
-2. **NEVER remove existing top-level sections** — only add or modify values within existing structure
-3. **NEVER delete configuration keys** — replace secret VALUES with `<CONFIGURE_HERE>` placeholder
-4. **When adding a new section**, use Edit to insert at the correct location (before the closing `}`)
-
-### WHY
-
-Claude's Write tool replaces the entire file. If you read a 200-line appsettings.json but only reproduce 150 lines in the Write, 50 lines of configuration are permanently lost. This has caused production incidents where entire authentication, logging, or integration sections disappeared.
-
-### Correct Patterns
-
-| Action | Tool | Approach |
-|--------|------|----------|
-| Add new section | Edit | Find closing `}`, replace with new section + `}` |
-| Modify a value | Edit | Target the specific key-value pair |
-| Add a key to section | Edit | Find the section's closing `}`, add key before it |
-| Replace secrets | Edit | Replace the VALUE only, keep the key |
-
-### Example: Adding a New Section
-
-```
-// Use Edit tool with:
-// old_string:   "Serilog": { ... }\n}
-// new_string:   "Serilog": { ... },\n  "NewSection": { "Key": "<CONFIGURE_HERE>" }\n}
-```
-
-### Secret Value Handling
-
-```json
-// WRONG - removing the key entirely
-"Jwt": { }
-
-// WRONG - deleting the section
-// (section missing from file)
-
-// CORRECT - placeholder value preserving structure
-"Jwt": {
-  "SecretKey": "<CONFIGURE_HERE>",
-  "Issuer": "<CONFIGURE_HERE>",
-  "Audience": "<CONFIGURE_HERE>",
-  "ExpirationMinutes": 60
-}
-```
-
-### Exception: New File Creation
-
-Write is acceptable ONLY when creating a NEW `appsettings.*.json` file that does not yet exist on disk (e.g., `appsettings.Local.json` during `/gitflow start`). The PreToolUse hook automatically allows this case.
-
-### Protection Layers
-
-| Layer | Mechanism | When |
-|-------|-----------|------|
-| Hook `appsettings-guard.sh` | PreToolUse on Write | Blocks Write if top-level sections would be lost |
-| Commit agent step 2b | During `/gitflow commit` | Detects section removal vs HEAD before staging |
-| These instructions | During development | Prevents the issue from occurring |
+# Configuration File Safety Rules
+
+## appsettings*.json Protection
+
+### MANDATORY Rules
+
+1. **NEVER use Write tool on `appsettings*.json`** — ALWAYS use Edit for targeted changes
+2. **NEVER remove existing top-level sections** — only add or modify values within existing structure
+3. **NEVER delete configuration keys** — replace secret VALUES with `<CONFIGURE_HERE>` placeholder
+4. **When adding a new section**, use Edit to insert at the correct location (before the closing `}`)
+
+### WHY
+
+Claude's Write tool replaces the entire file. If you read a 200-line appsettings.json but only reproduce 150 lines in the Write, 50 lines of configuration are permanently lost. This has caused production incidents where entire authentication, logging, or integration sections disappeared.
+
+### Correct Patterns
+
+| Action | Tool | Approach |
+|--------|------|----------|
+| Add new section | Edit | Find closing `}`, replace with new section + `}` |
+| Modify a value | Edit | Target the specific key-value pair |
+| Add a key to section | Edit | Find the section's closing `}`, add key before it |
+| Replace secrets | Edit | Replace the VALUE only, keep the key |
+
+### Example: Adding a New Section
+
+```
+// Use Edit tool with:
+// old_string:   "Serilog": { ... }\n}
+// new_string:   "Serilog": { ... },\n  "NewSection": { "Key": "<CONFIGURE_HERE>" }\n}
+```
+
+### Secret Value Handling
+
+```json
+// WRONG - removing the key entirely
+"Jwt": { }
+
+// WRONG - deleting the section
+// (section missing from file)
+
+// CORRECT - placeholder value preserving structure
+"Jwt": {
+  "SecretKey": "<CONFIGURE_HERE>",
+  "Issuer": "<CONFIGURE_HERE>",
+  "Audience": "<CONFIGURE_HERE>",
+  "ExpirationMinutes": 60
+}
+```
+
+### Exception: New File Creation
+
+Write is acceptable ONLY when creating a NEW `appsettings.*.json` file that does not yet exist on disk (e.g., `appsettings.Local.json` during `/gitflow start`). The PreToolUse hook automatically allows this case.
+
+### Protection Layers
+
+| Layer | Mechanism | When |
+|-------|-----------|------|
+| Hook `appsettings-guard.sh` | PreToolUse on Write | Blocks Write if top-level sections would be lost |
+| Commit agent step 2b | During `/gitflow commit` | Detects section removal vs HEAD before staging |
+| These instructions | During development | Prevents the issue from occurring |

package/templates/skills/_resources/context-digest-template.md

@@ -1,53 +1,53 @@
-# Context Digest Pattern
-
-## Purpose
-
-Reduces token usage between multi-step skill executions (BA, ralph-loop) by compressing step outputs into compact summaries.
-
-## How It Works
-
-```
-Step N completes
-    ↓
-Generate digest (max 50 lines)
-    ↓
-Pass digest to Step N+1 (in-context)
-    ↓
-Step N+1 reads:
-  - Digest from previous step (compact)
-  - 00-context.md for state variables
-  - Full output files ONLY if digest indicates need
-```
-
-## Digest Sections
-
-| Section | Max Lines | Content |
-|---------|-----------|---------|
-| Changes | 10 | Files modified with brief description |
-| Decisions | 10 | Key architectural decisions |
-| Findings | 10 | Issues found, patterns identified |
-| State | 5 | Updated state variables |
-| Blockers | 5 | Open issues, unresolved questions |
-| Next | 5 | What the next step needs to know |
-
-## Token Savings Estimate
-
-| Scenario | Without Digest | With Digest | Savings |
-|----------|---------------|-------------|---------|
-| step-01 → step-02 | ~2000 tokens | ~500 tokens | 75% |
-| step-02 → step-03 | ~1500 tokens | ~400 tokens | 73% |
-| step-03 → step-04 | ~1800 tokens | ~450 tokens | 75% |
-| **Total workflow** | ~5300 tokens | ~1350 tokens | **~75%** |
-
-## Applies To
-
-- BA skill (between phases)
-- Ralph-loop skill (between tasks)
-- Any future multi-step skill
-
-## Resume Exception
-
-When a skill resumes via `-r` flag:
-- Digest is ephemeral (not saved to disk)
-- Resume reads full output files from `.claude/output/` or `.business-analyse/`
-- This ensures complete state restoration after session break
+# Context Digest Pattern
+
+## Purpose
+
+Reduces token usage between multi-step skill executions (BA, ralph-loop) by compressing step outputs into compact summaries.
+
+## How It Works
+
+```
+Step N completes
+    ↓
+Generate digest (max 50 lines)
+    ↓
+Pass digest to Step N+1 (in-context)
+    ↓
+Step N+1 reads:
+  - Digest from previous step (compact)
+  - 00-context.md for state variables
+  - Full output files ONLY if digest indicates need
+```
+
+## Digest Sections
+
+| Section | Max Lines | Content |
+|---------|-----------|---------|
+| Changes | 10 | Files modified with brief description |
+| Decisions | 10 | Key architectural decisions |
+| Findings | 10 | Issues found, patterns identified |
+| State | 5 | Updated state variables |
+| Blockers | 5 | Open issues, unresolved questions |
+| Next | 5 | What the next step needs to know |
+
+## Token Savings Estimate
+
+| Scenario | Without Digest | With Digest | Savings |
+|----------|---------------|-------------|---------|
+| step-01 → step-02 | ~2000 tokens | ~500 tokens | 75% |
+| step-02 → step-03 | ~1500 tokens | ~400 tokens | 73% |
+| step-03 → step-04 | ~1800 tokens | ~450 tokens | 75% |
+| **Total workflow** | ~5300 tokens | ~1350 tokens | **~75%** |
+
+## Applies To
+
+- BA skill (between phases)
+- Ralph-loop skill (between tasks)
+- Any future multi-step skill
+
+## Resume Exception
+
+When a skill resumes via `-r` flag:
+- Digest is ephemeral (not saved to disk)
+- Resume reads full output files from `.claude/output/` or `.business-analyse/`
+- This ensures complete state restoration after session break