raven-registry-sync

/raven-registry-sync

Syncs all registered Raven projects to the current engine version.

Source of truth: raven-core/VERSION
Registry: ~/.raven/registry.json (backed up to giggsoinc/raven-registry)

---

Usage

/raven-registry-sync              → interactive: shows report, asks before updating
/raven-registry-sync --dry-run    → report only, no changes made
/raven-registry-sync --all        → update all stale projects without prompting
/raven-registry-sync --project NAME → update one specific project
/raven-registry-sync --check      → CI mode: exit 1 if any project stale

---

Steps

1. Locate raven-core (checked in order — first hit wins)

   for candidate in "${RAVEN_CORE_PATH:-}" "./raven-core" "$(pwd)/raven-core" ~/projects/raven-core; do
     if [ -n "$candidate" ] && [ -f "$candidate/registry/raven-sync.py" ]; then
       RAVEN_CORE="$candidate"
       break
     fi
   done
   SYNC_SCRIPT="$RAVEN_CORE/registry/raven-sync.py"
   

   Set RAVEN_CORE_PATH env var to override on unusual layouts. If none found → STOP with: "raven-core not found — checked $RAVEN_CORE_PATH, ./raven-core, ~/projects/raven-core"

2. Run the sync script with the flags passed by the user:

   python3 "$SYNC_SCRIPT" [FLAGS]
   

3. Show output — the script produces a full report:

   ────────────────────────────────────────────────────────────
     Raven Sync — current version: v2.8.0
   ────────────────────────────────────────────────────────────
   
     ✅ Up to date (1)
        my-project                    v2.8.0
   
     ⚠️  Stale — needs update (2)
        my-service             v2.7.0 → v2.8.0
        Dev-Claude-Arch           unknown → v2.8.0
   
     ❌ Path not found (0)
   

4. After sync completes, confirm:

   • Which projects were updated
   • Which were committed and pushed
   • Registry GitHub status

---

What Gets Updated Per Project

Component	Destination
Engine scripts (4 py files)	.claude/scripts/
MCP server (server.py)	.claude/mcp/
Andie skill	.claude/skills/andie/
Andie Jr skill	.claude/skills/andie-jr/
Tools landscape	.claude/skills/tools-landscape/
Version stamp	.raven/raven_version
Git commit	Auto-committed
Git push	Auto-pushed (if remote exists)