@the-bearded-bear/claude-craft 4.3.0 → 4.4.0-next.bcb55f4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,222 @@
1
+ #!/bin/bash
2
+ #===============================================================================
3
+ # check-prerequisites.sh - Verify Claude Craft Prerequisites
4
+ #
5
+ # Usage:
6
+ # ./check-prerequisites.sh [--verbose] [--fix]
7
+ #
8
+ # Options:
9
+ # --verbose Show detailed version information
10
+ # --fix Show installation commands for missing tools
11
+ #
12
+ # Exit codes:
13
+ # 0 - All required prerequisites installed
14
+ # 1 - Missing required prerequisites
15
+ #===============================================================================
16
+
17
+ set -e
18
+
19
+ # Colors
20
+ RED='\033[0;31m'
21
+ GREEN='\033[0;32m'
22
+ YELLOW='\033[1;33m'
23
+ CYAN='\033[0;36m'
24
+ NC='\033[0m'
25
+
26
+ # Options
27
+ VERBOSE=false
28
+ FIX=false
29
+
30
+ for arg in "$@"; do
31
+ case $arg in
32
+ --verbose) VERBOSE=true ;;
33
+ --fix) FIX=true ;;
34
+ esac
35
+ done
36
+
37
+ echo -e "${CYAN}╔════════════════════════════════════════════════════════════╗${NC}"
38
+ echo -e "${CYAN}║${NC} Claude Craft Prerequisites Check ${CYAN}║${NC}"
39
+ echo -e "${CYAN}╚════════════════════════════════════════════════════════════╝${NC}"
40
+ echo ""
41
+
42
+ ERRORS=0
43
+
44
+ # Detect OS
45
+ detect_os() {
46
+ if [[ "$OSTYPE" == "darwin"* ]]; then
47
+ echo "macos"
48
+ elif [[ -f /etc/debian_version ]]; then
49
+ echo "debian"
50
+ elif [[ -f /etc/arch-release ]]; then
51
+ echo "arch"
52
+ elif [[ -f /etc/redhat-release ]]; then
53
+ echo "rhel"
54
+ else
55
+ echo "unknown"
56
+ fi
57
+ }
58
+
59
+ OS=$(detect_os)
60
+
61
+ # Check function
62
+ check() {
63
+ local cmd=$1
64
+ local description=$2
65
+ local install_macos=$3
66
+ local install_debian=$4
67
+ local required=$5
68
+
69
+ if command -v "$cmd" &> /dev/null; then
70
+ if $VERBOSE; then
71
+ local version=$($cmd --version 2>&1 | head -n1)
72
+ echo -e " ${GREEN}[OK]${NC} $cmd: $version"
73
+ else
74
+ echo -e " ${GREEN}[OK]${NC} $cmd"
75
+ fi
76
+ return 0
77
+ else
78
+ if [[ "$required" == "required" ]]; then
79
+ echo -e " ${RED}[MISSING]${NC} $cmd - $description"
80
+ ((ERRORS++))
81
+ if $FIX; then
82
+ case $OS in
83
+ macos) echo -e " ${YELLOW}Fix:${NC} $install_macos" ;;
84
+ debian) echo -e " ${YELLOW}Fix:${NC} $install_debian" ;;
85
+ arch) echo -e " ${YELLOW}Fix:${NC} Check Arch Wiki for $cmd" ;;
86
+ *) echo -e " ${YELLOW}Fix:${NC} Install $cmd manually" ;;
87
+ esac
88
+ fi
89
+ else
90
+ echo -e " ${YELLOW}[OPTIONAL]${NC} $cmd - $description"
91
+ if $FIX; then
92
+ case $OS in
93
+ macos) echo -e " ${YELLOW}Install:${NC} $install_macos" ;;
94
+ debian) echo -e " ${YELLOW}Install:${NC} $install_debian" ;;
95
+ *) echo -e " ${YELLOW}Install:${NC} See documentation for $cmd" ;;
96
+ esac
97
+ fi
98
+ fi
99
+ return 1
100
+ fi
101
+ }
102
+
103
+ # Check yq version
104
+ check_yq_version() {
105
+ if command -v yq &> /dev/null; then
106
+ local version_output=$(yq --version 2>&1)
107
+ if echo "$version_output" | grep -q "mikefarah"; then
108
+ return 0
109
+ else
110
+ echo -e " ${RED}[WRONG VERSION]${NC} yq - You have the Python version, need Mike Farah's yq v4"
111
+ if $FIX; then
112
+ echo -e " ${YELLOW}Fix (macOS):${NC} brew install yq"
113
+ echo -e " ${YELLOW}Fix (Linux):${NC} sudo wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O /usr/local/bin/yq && sudo chmod +x /usr/local/bin/yq"
114
+ fi
115
+ ((ERRORS++))
116
+ return 1
117
+ fi
118
+ fi
119
+ return 1
120
+ }
121
+
122
+ # Check Node.js version
123
+ check_node_version() {
124
+ if command -v node &> /dev/null; then
125
+ local version=$(node --version | sed 's/v//' | cut -d. -f1)
126
+ if [[ $version -ge 18 ]]; then
127
+ return 0
128
+ else
129
+ echo -e " ${RED}[OLD VERSION]${NC} node - Found v$version, need v18+"
130
+ if $FIX; then
131
+ echo -e " ${YELLOW}Fix:${NC} Use nvm to install Node.js 20: nvm install 20 && nvm use 20"
132
+ fi
133
+ ((ERRORS++))
134
+ return 1
135
+ fi
136
+ fi
137
+ return 1
138
+ }
139
+
140
+ echo -e "${YELLOW}Required Dependencies:${NC}"
141
+ echo ""
142
+
143
+ check "node" "Node.js 18+ for NPX and CLI" \
144
+ "brew install node" \
145
+ "curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs" \
146
+ "required"
147
+ check_node_version
148
+
149
+ check "npm" "npm package manager" \
150
+ "brew install node" \
151
+ "sudo apt install npm" \
152
+ "required"
153
+
154
+ check "bash" "Bash shell for scripts" \
155
+ "(pre-installed)" \
156
+ "(pre-installed)" \
157
+ "required"
158
+
159
+ check "yq" "YAML processor for configuration" \
160
+ "brew install yq" \
161
+ "sudo apt install yq" \
162
+ "required"
163
+ check_yq_version
164
+
165
+ check "git" "Version control" \
166
+ "brew install git" \
167
+ "sudo apt install git" \
168
+ "required"
169
+
170
+ echo ""
171
+ echo -e "${YELLOW}Recommended Dependencies:${NC}"
172
+ echo ""
173
+
174
+ check "docker" "Container runtime" \
175
+ "Download Docker Desktop from docker.com" \
176
+ "curl -fsSL https://get.docker.com | sudo sh" \
177
+ "optional"
178
+
179
+ check "jq" "JSON processor (for StatusLine)" \
180
+ "brew install jq" \
181
+ "sudo apt install jq" \
182
+ "optional"
183
+
184
+ check "make" "Build automation" \
185
+ "xcode-select --install" \
186
+ "sudo apt install make" \
187
+ "optional"
188
+
189
+ echo ""
190
+
191
+ # Check Docker running (if installed)
192
+ if command -v docker &> /dev/null; then
193
+ if docker info &> /dev/null; then
194
+ echo -e " ${GREEN}[OK]${NC} Docker daemon is running"
195
+ else
196
+ echo -e " ${YELLOW}[WARNING]${NC} Docker is installed but not running"
197
+ if $FIX; then
198
+ echo -e " ${YELLOW}Fix:${NC} Start Docker Desktop or run: sudo systemctl start docker"
199
+ fi
200
+ fi
201
+ fi
202
+
203
+ echo ""
204
+ echo -e "${CYAN}────────────────────────────────────────────────────────────${NC}"
205
+
206
+ if [[ $ERRORS -eq 0 ]]; then
207
+ echo -e "${GREEN}All required prerequisites are installed!${NC}"
208
+ echo ""
209
+ echo "You can now install Claude Craft:"
210
+ echo " npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony"
211
+ echo ""
212
+ exit 0
213
+ else
214
+ echo -e "${RED}Missing $ERRORS required prerequisite(s).${NC}"
215
+ echo ""
216
+ if ! $FIX; then
217
+ echo "Run with --fix to see installation commands:"
218
+ echo " ./check-prerequisites.sh --fix"
219
+ fi
220
+ echo ""
221
+ exit 1
222
+ fi
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="Angular"
@@ -37,7 +37,7 @@ set -euo pipefail
37
37
  #-------------------------------------------------------------------------------
38
38
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
39
39
  SCRIPT_NAME="$(basename "$0")"
40
- VERSION="4.3.0"
40
+ VERSION="4.4.0"
41
41
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
42
42
 
43
43
  # Couleurs
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="CSharp"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="Flutter"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="Laravel"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="PHP"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="Python"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="React"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="ReactNative"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="Symfony"
@@ -5,7 +5,7 @@
5
5
 
6
6
  set -euo pipefail
7
7
 
8
- VERSION="4.3.0"
8
+ VERSION="4.4.0"
9
9
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
10
10
  I18N_DIR="$(dirname "$SCRIPT_DIR")/i18n"
11
11
  TECH_NAME="VueJS"
package/README.md CHANGED
@@ -2,6 +2,19 @@
2
2
 
3
3
  A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks.
4
4
 
5
+ ## What's New in v4.4
6
+
7
+ - **Comprehensive Documentation for Juniors**: 32 new documentation files
8
+ - [QUICKSTART.md](docs/QUICKSTART.md): Get started in 5 minutes
9
+ - [FAQ.md](docs/FAQ.md): 50+ frequently asked questions
10
+ - [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md): Common problems and solutions
11
+ - [BMAD-PRACTICAL-GUIDE.md](docs/BMAD-PRACTICAL-GUIDE.md): BMAD v6 step-by-step
12
+ - [RALPH-GUIDE.md](docs/RALPH-GUIDE.md): Ralph Wiggum configuration
13
+ - **Complete Reference Documentation**: All 127+ commands and 34 agents documented
14
+ - **Example Projects**: symfony-api, flutter-app, fullstack-saas
15
+ - **Complete Workflow Guides**: Idea → Production in 5 languages
16
+ - **Prerequisites Check Script**: `./Dev/scripts/check-prerequisites.sh`
17
+
5
18
  ## What's New in v4.3
6
19
 
7
20
  - **Complete i18n for BMAD v6**: All 18 BMAD commands translated to ES, DE, PT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@the-bearded-bear/claude-craft",
3
- "version": "4.3.0",
3
+ "version": "4.4.0-next.bcb55f4",
4
4
  "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
5
5
  "main": "cli/index.js",
6
6
  "bin": {