chore: add migration/ bundle for cross-machine setup
Bundles state that lives OUTSIDE the xenia-rs repo so a fresh clone on
another machine can be brought up to identical configuration via
migration/setup.sh:
- claude-memory/ ~/.claude/projects/-home-fabi-RE-Project-Sylpheed/memory/
(103 files, 1.1 MB - MEMORY.md + every
project_xenia_rs_*.md from audits
addis_signext through audit-058)
- project-root/dot-claude/ <project-root>/.claude/settings.json
(Stop hook + permissions)
- project-root/ppc-manual/ <project-root>/ppc-manual/
(PowerPC reference docs, 397 files, 3.7 MB)
- project-root/run-canary.sh <project-root>/run-canary.sh
- README.md Human-readable setup checklist
- setup.sh Idempotent installer (also reclones
xenia-canary at pinned HEAD 6de80dffe)
- MANIFEST.md Per-file mapping + per-file-not-bundled
restoration recipe
Excluded from bundle (not shippable via git):
- Sylpheed ISO (7.8 GB; copyright; manual copy required)
- sylpheed.db (395 MB; regenerable from XEX via analysis tooling)
- target/ build artifacts (rebuild on target)
- audit-runs probe firehoses (.log/.stdout/.stderr ~11 GB; rerun if needed)
- audit-runs memory dumps (.bin ~4.5 GB; rerun audit-026/027/029 if needed)
- xenia-canary checkout (setup.sh reclones from
git.mc02.dev/fabi/Xenia-Canary.git at HEAD 6de80dffe)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
MechaCat02
136
migration/setup.sh
Executable file
136
migration/setup.sh
Executable file
@@ -0,0 +1,136 @@
|
||||
#!/usr/bin/env bash
|
||||
# Idempotent installer for the cross-machine snapshot bundle.
|
||||
# Run from inside xenia-rs/migration/ on a fresh clone.
|
||||
#
|
||||
# Restores the parts of the working state that live OUTSIDE the xenia-rs
|
||||
# git repo:
|
||||
# 1. Claude auto-memory directory
|
||||
# 2. project-root .claude/settings.json (Stop hook + permissions)
|
||||
# 3. project-root ppc-manual/
|
||||
# 4. project-root run-canary.sh
|
||||
# 5. xenia-canary clone (if missing)
|
||||
#
|
||||
# Does NOT restore the Sylpheed ISO (manual) or sylpheed.db (regenerate
|
||||
# via analysis tooling after first build). See migration/README.md.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# Resolve paths from this script's location.
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)" # xenia-rs/
|
||||
ROOT_DIR="$(cd "$REPO_DIR/.." && pwd)" # project root (parent of xenia-rs)
|
||||
|
||||
echo "==> Cross-machine setup"
|
||||
echo " script: $SCRIPT_DIR"
|
||||
echo " repo: $REPO_DIR"
|
||||
echo " root: $ROOT_DIR"
|
||||
echo
|
||||
|
||||
# ---------- 1. Auto-memory ----------
|
||||
# Path is derived from Claude Code's cwd-sanitized scheme: every '/' in
|
||||
# the absolute working directory becomes '-'. If the project root path
|
||||
# differs from the original (/home/fabi/RE Project Sylpheed), the memory
|
||||
# directory name MUST differ to match this machine's cwd.
|
||||
CWD_SANITIZED="$(printf '%s' "$REPO_DIR" | tr '/' '-' | sed 's/^-//')"
|
||||
MEMORY_TARGET="$HOME/.claude/projects/-${CWD_SANITIZED}/memory"
|
||||
|
||||
# But for backward-compat (memory files reference the original absolute
|
||||
# paths), the original directory name is also restored unconditionally.
|
||||
MEMORY_TARGET_ORIG="$HOME/.claude/projects/-home-fabi-RE-Project-Sylpheed/memory"
|
||||
|
||||
for target in "$MEMORY_TARGET" "$MEMORY_TARGET_ORIG"; do
|
||||
if [ -d "$target" ] && [ "$(ls -A "$target" 2>/dev/null | wc -l)" -gt 0 ]; then
|
||||
echo "==> [skip] memory dir already populated: $target"
|
||||
else
|
||||
echo "==> Installing auto-memory: $target"
|
||||
mkdir -p "$target"
|
||||
cp -a "$SCRIPT_DIR/claude-memory/." "$target/"
|
||||
echo " -> $(ls "$target" | wc -l) files restored"
|
||||
fi
|
||||
done
|
||||
|
||||
# ---------- 2. Project-root .claude/settings.json ----------
|
||||
if [ -f "$ROOT_DIR/.claude/settings.json" ]; then
|
||||
echo "==> [skip] $ROOT_DIR/.claude/settings.json already exists"
|
||||
else
|
||||
echo "==> Installing project-root .claude/settings.json (Stop hook + permissions)"
|
||||
mkdir -p "$ROOT_DIR/.claude"
|
||||
cp "$SCRIPT_DIR/project-root/dot-claude/settings.json" "$ROOT_DIR/.claude/settings.json"
|
||||
fi
|
||||
|
||||
# ---------- 3. ppc-manual ----------
|
||||
if [ -d "$ROOT_DIR/ppc-manual" ]; then
|
||||
echo "==> [skip] $ROOT_DIR/ppc-manual already exists"
|
||||
else
|
||||
echo "==> Installing ppc-manual (PowerPC reference docs)"
|
||||
cp -a "$SCRIPT_DIR/project-root/ppc-manual" "$ROOT_DIR/ppc-manual"
|
||||
fi
|
||||
|
||||
# ---------- 4. run-canary.sh ----------
|
||||
if [ -f "$ROOT_DIR/run-canary.sh" ]; then
|
||||
echo "==> [skip] $ROOT_DIR/run-canary.sh already exists"
|
||||
else
|
||||
echo "==> Installing run-canary.sh helper"
|
||||
cp "$SCRIPT_DIR/project-root/run-canary.sh" "$ROOT_DIR/run-canary.sh"
|
||||
chmod +x "$ROOT_DIR/run-canary.sh"
|
||||
fi
|
||||
|
||||
# ---------- 5. xenia-canary clone ----------
|
||||
CANARY_DIR="$ROOT_DIR/xenia-canary"
|
||||
CANARY_REMOTE="https://git.mc02.dev/fabi/Xenia-Canary.git"
|
||||
CANARY_HEAD="6de80dffe261b368ecefee36c9b2b337335228c0"
|
||||
|
||||
if [ -d "$CANARY_DIR/.git" ]; then
|
||||
echo "==> [skip] xenia-canary already cloned at $CANARY_DIR"
|
||||
echo " HEAD: $(git -C "$CANARY_DIR" rev-parse HEAD)"
|
||||
else
|
||||
echo "==> Cloning xenia-canary into $CANARY_DIR"
|
||||
if git clone "$CANARY_REMOTE" "$CANARY_DIR"; then
|
||||
git -C "$CANARY_DIR" checkout "$CANARY_HEAD" || \
|
||||
echo " [warn] could not check out pinned HEAD $CANARY_HEAD; using whatever HEAD the clone defaulted to"
|
||||
else
|
||||
echo " [warn] xenia-canary clone failed; you can clone manually later"
|
||||
echo " git clone $CANARY_REMOTE $CANARY_DIR"
|
||||
echo " git -C $CANARY_DIR checkout $CANARY_HEAD"
|
||||
fi
|
||||
fi
|
||||
|
||||
# ---------- Final checklist ----------
|
||||
cat <<EOF
|
||||
|
||||
==> Setup complete. Remaining manual steps:
|
||||
|
||||
1. Sylpheed ISO (cannot ship via git):
|
||||
Copy your local copy of
|
||||
"Project Sylpheed - Arc of Deception (USA, Europe) (En,Ja).iso"
|
||||
into $ROOT_DIR/
|
||||
|
||||
2. Build xenia-rs:
|
||||
cd "$REPO_DIR"
|
||||
cargo build --release
|
||||
|
||||
3. Build xenia-canary Debug (only if you intend to run cross-runtime probes):
|
||||
cd "$CANARY_DIR"
|
||||
cmake --preset linux-debug # or whatever invocation your canary tree expects
|
||||
cmake --build build/
|
||||
|
||||
4. Regenerate sylpheed.db (analyzer reads XEX from the ISO):
|
||||
cd "$REPO_DIR"
|
||||
# Check current --help for exact subcommand; the analysis crates are
|
||||
# under crates/xenia-analysis/ and crates/xenia-app/src/main.rs
|
||||
cargo run --release --bin xenia-rs -- analyze \\
|
||||
"$ROOT_DIR/Project Sylpheed - Arc of Deception (USA, Europe) (En,Ja).iso"
|
||||
|
||||
5. Switch back to whatever branch you want to continue work on. The audit
|
||||
history (audit-findings.md + audit-runs/) and migration/ bundle are
|
||||
already on chore/portable-snapshot. Either:
|
||||
- keep working on chore/portable-snapshot (simplest), OR
|
||||
- merge it into master and continue on master.
|
||||
|
||||
6. Start Claude Code. Memory loads automatically when cwd matches:
|
||||
cd "$REPO_DIR"
|
||||
claude
|
||||
Read MEMORY.md first; the last paused audit is AUDIT-058 with
|
||||
AUDIT-059 recommended in its memory file.
|
||||
|
||||
EOF
|
||||
Reference in New Issue
Block a user