vibe-and-thrive 1.7.4 → 1.8.0

package/bin/postinstall.sh

@@ -102,6 +102,27 @@ install_ralph() {
   if [[ ! -f "PROMPT.md" ]] && [[ -f "$PKG_ROOT/templates/PROMPT.md" ]]; then
     cp "$PKG_ROOT/templates/PROMPT.md" "PROMPT.md"
   fi
+
+  # Install CLAUDE.md if missing (project-specific AI instructions)
+  if [[ ! -f "CLAUDE.md" ]]; then
+    local claude_template=""
+    # Select template based on project type
+    if [[ -f "manage.py" ]]; then
+      claude_template="$PKG_ROOT/templates/examples/CLAUDE-django.md"
+    elif [[ -f "pyproject.toml" ]] && grep -q "fastapi" pyproject.toml 2>/dev/null; then
+      claude_template="$PKG_ROOT/templates/examples/CLAUDE-fastapi.md"
+    elif [[ -d "frontend" ]] && [[ -d "backend" || -d "api" ]]; then
+      claude_template="$PKG_ROOT/templates/examples/CLAUDE-fullstack.md"
+    elif [[ -f "package.json" ]] && grep -q '"react"' package.json 2>/dev/null; then
+      claude_template="$PKG_ROOT/templates/examples/CLAUDE-react.md"
+    elif [[ -f "package.json" ]]; then
+      claude_template="$PKG_ROOT/templates/examples/CLAUDE-node.md"
+    fi
+
+    if [[ -n "$claude_template" ]] && [[ -f "$claude_template" ]]; then
+      cp "$claude_template" "CLAUDE.md"
+    fi
+  fi
 }
 
 configure_mcp() {

package/bin/ralph.sh

@@ -126,8 +126,10 @@ main() {
       ralph_help
       ;;
     version|-v|--version)
-      echo "ralph 2.0.0 (bash)"
-      echo "Part of vibe-and-thrive"
+      # Read version from package.json
+      local version
+      version=$(jq -r '.version // "unknown"' "$SCRIPT_DIR/../package.json" 2>/dev/null || echo "unknown")
+      echo "ralph $version (vibe-and-thrive)"
       ;;
     *)
       print_error "Unknown command: $cmd"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-and-thrive",
-  "version": "1.7.4",
+  "version": "1.8.0",
   "description": "Ship quality code faster with AI - RALPH autonomous loop, Claude Code hooks, and pre-commit checks",
   "author": "Allie Jones <allie@allthrive.ai>",
   "license": "MIT",

package/ralph/verify/review.sh

@@ -20,13 +20,14 @@ run_code_review() {
     return 0
   fi
 
-  # Get the diff of uncommitted changes
+  # Get the diff of uncommitted changes (limit size to prevent memory issues)
   local diff
-  diff=$(git diff HEAD 2>/dev/null)
+  local max_diff_lines=2000
+  diff=$(git diff HEAD 2>/dev/null | head -n "$max_diff_lines")
 
   if [[ -z "$diff" ]]; then
     # No uncommitted changes, check staged
-    diff=$(git diff --cached 2>/dev/null)
+    diff=$(git diff --cached 2>/dev/null | head -n "$max_diff_lines")
   fi
 
   if [[ -z "$diff" ]]; then
@@ -34,6 +35,13 @@ run_code_review() {
     return 0
   fi
 
+  # Check if diff was truncated
+  local full_diff_lines
+  full_diff_lines=$(git diff HEAD 2>/dev/null | wc -l)
+  if [[ "$full_diff_lines" -gt "$max_diff_lines" ]]; then
+    echo "    (diff truncated from $full_diff_lines to $max_diff_lines lines)"
+  fi
+
   # Get story context for the review
   local story_json
   story_json=$(jq --arg id "$story" '.stories[] | select(.id==$id)' "$RALPH_DIR/prd.json" 2>/dev/null)

package/templates/examples/CLAUDE-django.md

@@ -1,5 +1,14 @@
 # Project Instructions for AI Coding Agents
 
+## Naming Conventions
+- **Files**: `snake_case.py` — e.g., `user_views.py`, `auth_serializers.py`
+- **Functions/Variables**: `snake_case` — e.g., `get_user_by_id`, `is_authenticated`
+- **Classes**: `PascalCase` — e.g., `UserViewSet`, `AuthSerializer`
+- **Models**: `PascalCase` singular — e.g., `User`, `BlogPost` (Django pluralizes table names)
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_UPLOAD_SIZE`, `DEFAULT_PAGE_SIZE`
+- **URL patterns**: `kebab-case` — e.g., `/api/user-profile/`, `/api/blog-posts/`
+- **Template files**: `snake_case.html` — e.g., `user_detail.html`
+
 ## Tech Stack
 - **Backend**: Django 5, Django REST Framework
 - **Database**: PostgreSQL

package/templates/examples/CLAUDE-fastapi.md

@@ -1,5 +1,14 @@
 # CLAUDE.md - FastAPI Project
 
+## Naming Conventions
+- **Files**: `snake_case.py` — e.g., `user_service.py`, `auth_router.py`
+- **Functions/Variables**: `snake_case` — e.g., `get_user_by_id`, `is_valid`
+- **Classes**: `PascalCase` — e.g., `UserService`, `AuthRouter`
+- **Pydantic Models**: `PascalCase` — e.g., `UserCreate`, `UserResponse`
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_RETRIES`, `DEFAULT_LIMIT`
+- **Database tables**: `snake_case` — e.g., `user_sessions`, `api_keys`
+- **API endpoints**: `kebab-case` — e.g., `/api/user-profile`, `/api/v1/auth`
+
 ## Project Overview
 
 This is a FastAPI backend application with async SQLAlchemy and Pydantic.

package/templates/examples/CLAUDE-fastmcp.md

@@ -1,5 +1,13 @@
 # CLAUDE.md - FastMCP Server
 
+## Naming Conventions
+- **Files**: `snake_case.py` — e.g., `search_tool.py`, `db_resource.py`
+- **Functions/Variables**: `snake_case` — e.g., `search_files`, `is_valid`
+- **Classes**: `PascalCase` — e.g., `SearchResult`, `FileResource`
+- **Tool names**: `snake_case` — e.g., `search_files`, `read_database`
+- **Resource URIs**: `kebab-case` — e.g., `file://project-files`, `db://user-data`
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_RESULTS`, `DEFAULT_TIMEOUT`
+
 ## Project Overview
 
 This is an MCP (Model Context Protocol) server built with FastMCP. It exposes tools, resources, and prompts to LLM clients.

package/templates/examples/CLAUDE-fullstack.md

@@ -1,5 +1,23 @@
 # Project Instructions for AI Coding Agents
 
+## Naming Conventions
+
+### Frontend (React/TypeScript)
+- **Files**: `PascalCase.tsx` for components, `camelCase.ts` for utilities
+- **Components**: `PascalCase` — e.g., `UserProfile`, `AuthProvider`
+- **Hooks**: `useCamelCase` — e.g., `useAuth`, `useUserData`
+- **Functions/Variables**: `camelCase` — e.g., `handleSubmit`, `isLoading`
+
+### Backend (Django/Python)
+- **Files**: `snake_case.py` — e.g., `user_views.py`
+- **Functions/Variables**: `snake_case` — e.g., `get_user_by_id`
+- **Classes**: `PascalCase` — e.g., `UserViewSet`, `UserSerializer`
+
+### Shared
+- **API endpoints**: `kebab-case` — e.g., `/api/user-profile/`
+- **Database tables**: `snake_case` — e.g., `user_sessions`
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_RETRIES`
+
 ## Tech Stack
 - **Frontend**: React 18, TypeScript, Vite, TailwindCSS
 - **Backend**: Django 5, Django REST Framework

package/templates/examples/CLAUDE-node.md

@@ -1,5 +1,13 @@
 # Project Instructions for AI Coding Agents
 
+## Naming Conventions
+- **Files**: `kebab-case.ts` — e.g., `user-service.ts`, `auth-middleware.ts`
+- **Functions/Variables**: `camelCase` — e.g., `getUserById`, `isValid`
+- **Classes/Interfaces/Types**: `PascalCase` — e.g., `UserService`, `CreateUserInput`
+- **Constants**: `SCREAMING_SNAKE` — e.g., `MAX_RETRIES`, `DEFAULT_PORT`
+- **Database tables**: `snake_case` — e.g., `user_sessions` (Prisma converts to camelCase)
+- **API endpoints**: `kebab-case` — e.g., `/api/user-profile`, `/api/auth/sign-in`
+
 ## Tech Stack
 - **Runtime**: Node.js 20+
 - **Framework**: Express.js / Fastify

package/templates/examples/CLAUDE-react.md

@@ -1,5 +1,14 @@
 # Project Instructions for AI Coding Agents
 
+## Naming Conventions
+- **Files**: `PascalCase.tsx` for components, `camelCase.ts` for utilities — e.g., `UserProfile.tsx`, `useAuth.ts`
+- **Components**: `PascalCase` — e.g., `UserProfile`, `AuthProvider`
+- **Hooks**: `useCamelCase` — e.g., `useAuth`, `useUserData`
+- **Functions/Variables**: `camelCase` — e.g., `handleSubmit`, `isLoading`
+- **Types/Interfaces**: `PascalCase` — e.g., `UserProps`, `AuthState`
+- **Constants**: `SCREAMING_SNAKE` — e.g., `API_BASE_URL`, `MAX_RETRIES`
+- **CSS classes**: `kebab-case` (TailwindCSS utility classes are standard)
+
 ## Tech Stack
 - **Frontend**: React 18, TypeScript, Vite
 - **Styling**: TailwindCSS