SKILL.md

/oracle-soul-sync-update

"Sync your soul with the family."

All-in-one skill: /soul-sync + /calibrate + /update combined.

Usage

/oracle-soul-sync-update           # Check + update to latest STABLE
/oracle-soul-sync-update --alpha   # Check + update to latest alpha (dev track)
/oracle-soul-sync-update --check   # Only check, don't update
/oracle-soul-sync-update --cleanup # Uninstall first, then reinstall

Step 0: Timestamp + Check Current Version

Read the installed version from ~/.claude/skills/VERSION.md (the installer writes this on every install). Fall back to arra-oracle-skills --version if the file is missing.

date "+🕐 %H:%M %Z (%A %d %B %Y)"
CURRENT=$(grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+(-alpha\.[0-9]+)?' ~/.claude/skills/VERSION.md 2>/dev/null | head -1)
if [ -z "$CURRENT" ]; then
  CURRENT=$(arra-oracle-skills --version 2>/dev/null | grep -oE 'v?[0-9]+\.[0-9]+\.[0-9]+(-alpha\.[0-9]+)?' | head -1)
  [ -n "$CURRENT" ] && [ "${CURRENT:0:1}" != "v" ] && CURRENT="v$CURRENT"
fi
echo "Current installed: ${CURRENT:-unknown}"

Step 2: Check Latest Version (stable vs alpha)

Tag format moved to CalVer (v{YY}.{M}.{D}, first number ≥ 25) in April 2026. Older tags are SemVer (v3.x.x). The latest-check picks CalVer first and treats SemVer as legacy.

# Get ALL tags via jq, separate stable from alpha
TAGS=$(curl -s https://api.github.com/repos/Soul-Brews-Studio/arra-oracle-skills-cli/tags | jq -r '.[].name')
LATEST_STABLE=$(echo "$TAGS" | grep -v 'alpha\|beta\|rc' | head -1)
LATEST_ALPHA=$(echo "$TAGS" | grep 'alpha' | head -1)
echo "Latest stable: $LATEST_STABLE"
echo "Latest alpha:  $LATEST_ALPHA"

Default = stable. Only --alpha flag switches to alpha track. Newcomers always get stable.

# Helpers — parse tag → YYYY-MM-DD, diff in days tag_era() { # "calver" | "semver" | "unknown" local first=$(echo "$1" | sed 's/^v//; s/-.*$//' | cut -d. -f1) [ -z "$first" ] && { echo unknown; return; } [ "$first" -ge 25 ] 2>/dev/null && echo calver || echo semver } tag_to_date() { # v26.4.18 → 2026-04-18 local core=$(echo "$1" | sed 's/^v//; s/-(alpha|beta).*$//' -E) local yy=$(echo "$core" | cut -d. -f1) local m=$(echo "$core" | cut -d. -f2) local d=$(echo "$core" | cut -d. -f3) printf "%04d-%02d-%02d" "$((2000 + yy))" "$m" "$d" } # Get GitHub release publish timestamp as epoch seconds (#276) tag_publish_epoch() { local tag=$1 [ "${tag:0:1}" != "v" ] && tag="v$tag" local iso=$(gh release view "$tag" --repo Soul-Brews-Studio/arra-oracle-skills-cli --json publishedAt --jq '.publishedAt' 2>/dev/null) [ -z "$iso" ] && return 1 # macOS + GNU date compatibility date -u -d "$iso" +%s 2>/dev/null || date -juf "%Y-%m-%dT%H:%M:%SZ" "$iso" +%s 2>/dev/null } CUR_ERA=$(tag_era "$CURRENT") LAT_ERA=$(tag_era "$LATEST") if [ "$CURRENT" = "$LATEST" ]; then echo "✅ Soul synced! ($CURRENT) [$TRACK track]" elif [ "$CUR_ERA" = "semver" ] && [ "$LAT_ERA" = "calver" ]; then echo "⚠️ Legacy version — migrate $CURRENT → $LATEST (CalVer cut-over)" else CUR_DATE=$(tag_to_date "$CURRENT") LAT_DATE=$(tag_to_date "$LATEST") DAYS=$(( ( $(date -d "$LAT_DATE" +%s 2>/dev/null || date -juf "%Y-%m-%d" "$LAT_DATE" +%s) - \ $(date -d "$CUR_DATE" +%s 2>/dev/null || date -juf "%Y-%m-%d" "$CUR_DATE" +%s) ) / 86400 )) if [ "$DAYS" -eq 0 ]; then # Same calendar day — use release publish timestamps (#276 fix) # Semver says alpha < stable, but on the same day alpha may be cut LATER. # Always trust the GitHub publish_at timestamp as ground truth. CUR_TS=$(tag_publish_epoch "$CURRENT") LAT_TS=$(tag_publish_epoch "$LATEST") if [ -n "$CUR_TS" ] && [ -n "$LAT_TS" ]; then if [ "$CUR_TS" -ge "$LAT_TS" ]; then echo "✅ Local ($CURRENT) was published at-or-after latest tag ($LATEST) — no update needed" echo " (semver would say 'alpha < stable' but timestamps say otherwise; trusting timestamps)" else SECS=$(( LAT_TS - CUR_TS )) HOURS=$(( SECS / 3600 )) MINS=$(( (SECS % 3600) / 60 )) echo "⚠️ ${HOURS}h${MINS}m stale: $CURRENT → $LATEST ($CUR_DATE, same day)" fi else # Fallback if GitHub API unreachable: report same-day, no decision echo "⚠️ Same day, different tag: $CURRENT → $LATEST (timestamp lookup failed; verify manually)" fi else echo "Current installed: $CURRENT ($CUR_DATE)" echo "Latest available: $LATEST ($LAT_DATE)" echo "⚠️ $DAYS days stale [$TRACK track]" fi fi

Command	Action
`/oracle-soul-sync-update`	Check and sync
`/oracle-soul-sync-update --cleanup`	Uninstall + reinstall (removes old)
`/awaken`	Full awakening (run soul-sync before, not during)

oracle-soul-sync-update

Summary

SKILL.md

/oracle-soul-sync-update

Usage

Step 0: Timestamp + Check Current Version

Step 2: Check Latest Version (stable vs alpha)

Step 3: Compare Versions — date-drift, not semver-drift (#265, #276)

Step 4: Sync (if needed)

Step 5: Verify Sync

What's New

Timing: Before /awaken

Quick Reference

Related skills