feat(v2.0.0): migrate to Claude Code v2.1.4+ architecture (#22)

2026-07-04 10:53:16 -04:00 · 2026-02-16 00:36:41 +01:00
parent f52664867d
commit e7512689c1
17 changed files with 1630 additions and 75 deletions
@@ -0,0 +1,180 @@
+# ClaudeForge Testing Scripts
+
+This directory contains validation and rollback scripts for the v2.0.0 migration.
+
+## Scripts
+
+### `validate_migration.sh`
+
+Validates that the ClaudeForge v2.0.0 migration completed successfully.
+
+**Tests:**
+1. File existence (skill, command, agent)
+2. v2.1.4 syntax validation (`permissions:` fields)
+3. Hooks configuration (SessionStart, PreToolUse, PostToolUse)
+4. Fork-safe mode enabled
+5. Python modules integrity
+6. Legacy syntax cleanup
+7. Documentation updates
+8. Example files unchanged
+
+**Usage:**
+```bash
+cd /path/to/ClaudeForge
+./test/validate_migration.sh
+```
+
+**Expected Output:**
+```
+=== ClaudeForge v2.1.4 Migration Validation ===
+
+Test 1: File Existence
+----------------------
+✓ Skill file exists
+✓ Command file exists
+✓ Agent file exists
+
+[... more tests ...]
+
+===================================
+Validation Complete
+===================================
+Passed: 18
+Failed: 0
+
+✅ All tests passed! Migration successful.
+```
+
+---
+
+### `rollback.sh`
+
+Rolls back ClaudeForge installation from v2.0.0 to v1.0.0 using automatic backups.
+
+**What it does:**
+- Searches for timestamped backups created by the installer
+- Restores skill, command, and agent from backups
+- Provides alternative manual rollback instructions if no backups found
+
+**Usage:**
+```bash
+cd /path/to/ClaudeForge
+./test/rollback.sh
+```
+
+**Expected Output:**
+```
+=== ClaudeForge Rollback to v1.x ===
+
+Searching for skill backup...
+Found backup: claudeforge-skill.backup.20260107_120000
+✓ Restored skill from: claudeforge-skill.backup.20260107_120000
+
+[... more restorations ...]
+
+====================================
+Rollback Summary
+====================================
+Components restored: 3
+
+✅ Rollback complete!
+
+Next steps:
+1. Restart Claude Code
+2. Test with: /enhance-claude-md
+```
+
+---
+
+## Testing Workflow
+
+### Before Installation
+
+1. **Backup manually** (extra safety):
+   ```bash
+   cp -r ~/.claude/skills/claudeforge-skill ~/.claude/skills/claudeforge-skill.manual.backup
+   ```
+
+2. **Note your current version**:
+   ```bash
+   grep "^name:" ~/.claude/skills/claudeforge-skill/SKILL.md
+   ```
+
+### After Installation
+
+1. **Run validation**:
+   ```bash
+   ./test/validate_migration.sh
+   ```
+
+2. **Test functionality**:
+   ```bash
+   claude
+   /enhance-claude-md
+   ```
+
+3. **Check hooks** (restart Claude Code first):
+   - Look for "Guardian: Checking for CLAUDE.md updates..." on startup
+
+### If Something Goes Wrong
+
+1. **Run rollback**:
+   ```bash
+   ./test/rollback.sh
+   ```
+
+2. **Or restore manual backup**:
+   ```bash
+   rm -rf ~/.claude/skills/claudeforge-skill
+   cp -r ~/.claude/skills/claudeforge-skill.manual.backup ~/.claude/skills/claudeforge-skill
+   ```
+
+---
+
+## Test Matrix for Installation
+
+| Scenario | Test Steps | Expected Result |
+|----------|-----------|-----------------|
+| **Fresh Install** | 1. No existing ClaudeForge<br>2. Run `./install.sh`<br>3. Validate | All files installed with v2.1.4 syntax |
+| **Upgrade from v1.x** | 1. Have v1.x installed<br>2. Run `./install.sh`<br>3. Validate | Auto-backup created, v2.0 installed |
+| **Version Check** | 1. Claude Code 2.1.4+<br>2. Run installer | Version detected, no warnings |
+| **Version Check** | 1. Claude Code < 2.1.0<br>2. Run installer | Warning displayed about limited features |
+| **Rollback** | 1. Run `./test/rollback.sh`<br>2. Restart Claude | v1.x restored, no hooks |
+
+---
+
+## Continuous Integration
+
+These test scripts can be integrated into CI/CD:
+
+```yaml
+# .github/workflows/validate-migration.yml
+name: Validate Migration
+
+on:
+  push:
+    branches: [feature/migrate-v2.1.4-architecture]
+
+jobs:
+  test-migration:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run migration validation
+        run: |
+          # Install to temporary location
+          export HOME=/tmp/test-home
+          ./install.sh <<< "1"
+
+          # Run validation
+          ./test/validate_migration.sh
+```
+
+---
+
+## Notes
+
+- Test scripts are designed to be idempotent (can run multiple times)
+- All scripts exit with proper codes (0 = success, 1 = failure)
+- Scripts provide detailed output for debugging
+- Compatible with both macOS and Linux