v1.1.2

Author: CoderLuii

CONTRIBUTING.md

@@ -10,19 +10,89 @@ Contributions welcome. Here's how.
 4. Push it (`git push origin feature/something`)
 5. PR it
 
+## Development Setup
+
+Build locally:
+
+```bash
+# Full variant (default)
+docker build -t holyclaude .
+
+# Slim variant
+docker build --build-arg VARIANT=slim -t holyclaude:slim .
+```
+
+Then swap the image in your compose file:
+
+```yaml
+image: holyclaude          # instead of coderluii/holyclaude:latest
+```
+
+**Build times:** Full takes 15-25 minutes cold, slim takes 8-12 minutes. Cached rebuilds are much faster if you only changed files outside the layer you're modifying.
+
+## Testing Changes
+
+```bash
+docker compose up -d
+```
+
+Verify:
+- `docker ps` shows `(healthy)` after ~30 seconds
+- `curl -sf http://localhost:3001/` returns 200
+- `docker logs holyclaude` shows no errors
+
+If you changed the entrypoint or bootstrap, delete the sentinel to re-trigger first-boot:
+
+```bash
+rm ./data/claude/.holyclaude-bootstrapped
+docker compose restart holyclaude
+```
+
+## Variants
+
+HolyClaude builds two variants from one Dockerfile using a `VARIANT` build arg:
+
+- **full** (default) includes pandoc, ffmpeg, libvips, deployment CLIs (wrangler, vercel, netlify), PDF libraries, data science tools, and more
+- **slim** is the core tools only, smaller download
+
+If you're adding a new tool or package, decide which variant it belongs to. Full-only packages go inside the `if [ "$VARIANT" = "full" ]` conditional blocks in the Dockerfile.
+
+## Key Files
+
+| File | What it does |
+|------|-------------|
+| `Dockerfile` | Single-stage build with full/slim split via `VARIANT` build arg |
+| `docker-compose.yaml` | Minimal quick-start compose |
+| `docker-compose.full.yaml` | Full compose with all options documented |
+| `scripts/entrypoint.sh` | UID/GID remapping, workspace fix, triggers bootstrap, hands off to s6-overlay |
+| `scripts/bootstrap.sh` | First-boot only: copies settings and memory template, configures git |
+| `scripts/notify.py` | Apprise notification helper for stop/error hooks |
+| `config/settings.json` | Default Claude Code settings baked into the image |
+| `config/claude-memory-full.md` | Runtime CLAUDE.md for full variant |
+| `config/claude-memory-slim.md` | Runtime CLAUDE.md for slim variant |
+| `s6-overlay/s6-rc.d/` | Service definitions for CloudCLI and Xvfb |
+
 ## What to contribute
 
 - Bug fixes (always welcome)
 - New features (open an issue first to discuss)
 - Documentation improvements
-- Test coverage
+- New tools or packages (mention the size impact in your PR)
 
 ## What NOT to do
 
 - Don't open a PR without testing locally
 - Don't include credentials or API keys
 - Don't change the code style (follow existing patterns)
 
+## PR Checklist
+
+- [ ] Built and tested locally (full variant at minimum)
+- [ ] `docker ps` shows healthy after startup
+- [ ] CloudCLI responds on port 3001
+- [ ] README updated if adding/removing tools
+- [ ] Mentioned size impact if adding new packages
+
 ## Questions?
 
 Open an issue or start a discussion. We're friendly.

Dockerfile

@@ -187,5 +187,9 @@ RUN chmod +x /etc/s6-overlay/s6-rc.d/cloudcli/run \
 # ---------- Working directory ----------
 WORKDIR /workspace
 
+# ---------- Health check ----------
+HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
+  CMD curl -sf http://localhost:3001/ || exit 1
+
 # ---------- s6-overlay as PID 1 ----------
 ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

README.md

@@ -809,7 +809,7 @@ Your data persists in `./data/claude` and `./workspace` — upgrading only repla
 To pin a specific version instead of `latest`:
 
 ```yaml
-image: coderluii/holyclaude:1.1.1   # instead of :latest
+image: coderluii/holyclaude:1.1.2   # instead of :latest
 ```
 
 <p align="right">

docs/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to HolyClaude will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.1.2] - 03/26/2026
+
+### Added
+- Docker HEALTHCHECK instruction for container health monitoring
+- Bootstrap now backs up existing `settings.json` and `CLAUDE.md` before overwriting on re-bootstrap
+- Expanded CONTRIBUTING.md with build commands, testing steps, file map, and PR checklist
+
 ## [1.1.1] - 03/26/2026
 
 ### Fixed

scripts/bootstrap.sh

@@ -19,6 +19,7 @@ echo "[bootstrap] Running first-boot initialization..."
 mkdir -p "$CLAUDE_HOME/.claude"
 
 # ---------- Copy settings.json ----------
+[ -f "$CLAUDE_HOME/.claude/settings.json" ] && cp "$CLAUDE_HOME/.claude/settings.json" "$CLAUDE_HOME/.claude/settings.json.bak"
 cp "$SOURCE_DIR/settings.json" "$CLAUDE_HOME/.claude/settings.json"
 echo "[bootstrap] Copied settings.json"
 
@@ -27,6 +28,7 @@ VARIANT="full"
 if [ -f /etc/holyclaude-variant ]; then
     VARIANT=$(cat /etc/holyclaude-variant)
 fi
+[ -f "$CLAUDE_HOME/.claude/CLAUDE.md" ] && cp "$CLAUDE_HOME/.claude/CLAUDE.md" "$CLAUDE_HOME/.claude/CLAUDE.md.bak"
 cp "$SOURCE_DIR/claude-memory-${VARIANT}.md" "$CLAUDE_HOME/.claude/CLAUDE.md"
 echo "[bootstrap] Copied CLAUDE.md (${VARIANT} variant)"